Files
clean-architecture-frontend…/docs/security/browser-boundary.md
T
DongHyeonka 06ffafa25e docs: 살아 있는 문서의 낡은 문장을 지금 코드와 정본에 맞춘다
2026-11-07~08의 정리(문서 이동, 참조 기능 삭제, CI 재편) 뒤 살아 있는
문서가 지금 코드와 다른 말을 한다.

- 현재 계약 문서 둘과 스타터 문서가 기록(docs/design/)을 정본으로
  가리킨다. 정본을 frontend-application-foundation.md·src/bootstrap/,
  패턴 표·계층 규칙으로 바꾸고 설계서는 배경으로 둔다(1112/02-06).
- 실시간 대응표 둘(짝 백엔드 출구, poll attempt 결과)이 기록에만 있었다.
  optional-adapter-recipes.md로 옮기고 코드 주석·매뉴얼 03·설계서 머리
  블록이 옮긴 곳을 가리킨다(1112/09-02).
- 실행 격리 변수 목록을 설계 기록이 아니라 scripts/lib/run-isolation.ts로
  가리킨다(1112/08-17).
- 계약 소유 절 이름(「판단 규칙」), pin 대조 시험의 게이트(005·007),
  drift 검사 범위(1112/02-07). INVENTORY 머리의 손 숫자와 지킬 수 없는
  꼬리 문장(1112/02-08).
- 검증 안내: 검사기를 바꾸면 FE-GATE-029, 문서면 desktop
  verify:documentation(1112/08-05, 08-04). FE-GATE-012는 merge 단계다
  (08-16). N6이 알리는 파일을 좁혀 적는다(08-10). 한 파일 시험은
  verify.sh exec(08-11). 문서 검사 범위의 손 사본을 정본 한 곳으로(08-07).
- create:feature 참조의 Next: 3과 되돌리기(08-08), 손으로 옮긴 숫자
  (08-19), 라운드 없는 리뷰 ID 17곳에 0925를 붙인다(08-15).
- secret scan 범위 설명(1112/07-03), lab이 기능 라우트를 읽는 문장
  (1103/16-06), README 동기화 기준점·제품 소유 파일·선택 기능 결함 몫
  (0929/14-02, 14-03, 13-10), 커밋을 다시 지은 모든 통합의 해시 대조
  (1106/14-02).

고른 방법: 문장을 코드에 맞춘다. 표는 옮기고 숫자는 정본을 가리킨다.
버린 대안: 기록 문서 본문 고치기(기록은 머리 블록만 고친다).

위험·한계: 문서 검사 범위 목록을 지운 ci-quality-gates.md는 이제
docs/README.md 5절과 gates.md 7절을 읽어야 한다. 매뉴얼 02 7절 업로드
예의 declare module 문제(1112/09-01)는 고치는 방향이 check:architecture
규칙과 부딪쳐 결정 대기로 남긴다.

검증: scripts/verify.sh docs(노트북) 통과. desktop verify:documentation과
FE-GATE-005(문서를 읽는 시험)는 PR 본문에 적는다.

Refs: 1112/02-06, 1112/02-07, 1112/02-08, 1112/07-03, 1112/08-04,
 1112/08-05, 1112/08-07, 1112/08-08, 1112/08-10, 1112/08-11, 1112/08-15,
 1112/08-16, 1112/08-17, 1112/08-19, 1112/09-02, 1103/16-06, 0929/14-02,
 0929/14-03, 0929/13-10, 1106/14-02
2026-11-12 23:36:14 +09:00

2.1 KiB

브라우저 보안 경계

브라우저 bundle은 공개된다. 그래서 다음은 기본으로 금지한다: 비밀값, 토큰 수명 주기 관리, raw HTML 주입, 동적 코드 실행, 믿을 수 없는 script URL, 공개된 production source map.

선언된 header 집합은 config/hosting/security-headers.json이다. hosting 검증은 이 선언과 실제 응답을 비교한다. CSP는 일부러 unsafe-inline과 unsafe-eval을 뺀다. production 코드와 빌드된 asset은 이 기준선에서도 동작해야 한다. tests/e2e/production-csp.spec.ts(test:e2e의 일부, FE-GATE-008)는 이 header로 빌드를 서빙한다. 그리고 securitypolicyviolation 이벤트나 console 오류가 나면 실패한다(리뷰 0925/13-08). zod는 첫 object schema에서 Function("")을 시험 삼아 실행한다. 그러면 정책이 부트할 때마다 이것을 위반으로 보고한다. src/contracts/zod.ts는 jitless를 켜서 이 시험을 건너뛴다. schema를 만드는 모든 모듈은 z를 그 파일에서 import한다. 그래서 bundler가 chunk를 어떤 순서로 평가하든 이 설정이 첫 schema보다 먼저 적용된다. entry 모듈에서 z.config를 부르면 너무 늦다. 새 schema 코드에서는 z를 zod가 아니라 src/contracts/zod.ts에서 import한다. 기본으로 꺼진 기능은 프로젝트가 그 기능을 고를 때 CSP에 항목을 더해야 한다. 선택형 adapter recipe의 9단계를 본다. connect-src 'self' https:는 script가 모든 HTTPS origin에 닿게 둔다. 이것을 runtime config의 API_BASE_URL과 TELEMETRY_ENDPOINT origin으로 좁히려면 배포할 때 환경마다 header를 만들어야 한다. 그 값들은 배포마다 정해지기 때문이다(scripts/generate-runtime-config.ts). 그런 header 생성기는 아직 없다. 배포하는 프로젝트는 provider adapter를 만들 때 함께 더해야 한다.

route guard는 UX 힌트일 뿐이다. 클라이언트 검증은 백엔드의 인가(authorization)나 검증을 대신하지 않는다.