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
3.7 KiB
정적 자산과 runtime 설정 전달
정본 안내
Runtime Config/boot, Fetch HTTP client, Router, Query/Mutation, realtime 공통 경계, Web Worker, Service Worker, offline command와 Background Sync의 지금 구현은 프론트엔드 애플리케이션 기반과
src/bootstrap/이 정본이다. 설계 배경(기록)은 프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계다(1112/02-06).
이 Mermaid 그림은 repo 안에서 구현을 옮겨 그린 투영(projection)이다.
PASS_SCOPED 리뷰 증거는 review-ledger.json에 적힌 정본 static-delivery
draw.io 범위에만 적용된다.
sequenceDiagram
participant CI
participant ImmutableRelease
participant ActivePointer
participant Browser
CI->>ImmutableRelease: upload hashed assets
CI->>ImmutableRelease: upload release manifest
CI->>ImmutableRelease: upload runtime config
CI->>ImmutableRelease: probe asset reachability
CI->>ActivePointer: atomically switch HTML
Browser->>ActivePointer: fetch revalidated HTML
Browser->>ImmutableRelease: fetch no-store config and manifest
Browser->>ImmutableRelease: fetch immutable hashed assets
CI->>Browser: boot, route, API, and reload-loop smoke
이 repo에서 workflow는 아무것도 배포하지 않는다. 위의 업로드, pointer 전환,
smoke 단계는 프로젝트의 provider adapter가 맡는다. 그 adapter가 promotion과
production_gate 사이의 deployment job을 채운다. adapter가 promotion된
release를 배포하고 나면, FE-GATE-019가 실제 응답 header를 검사하고 host가 그
release를 서빙하는지 확인한다. 그 자리가 비어 있는 동안 FE-GATE-019는
UNVERIFIED다(리뷰 0925/13-05, 1101/13-01,
release-cache-rollback.md).
rollback은 이전 불변 release의 HTML·asset·config·API·manifest 묶음이 서로 맞는지 확인한 뒤에만 active pointer를 바꾼다.
앱은 HTTP/2 이상으로 서빙한다. 진입점은 모든 초기 JavaScript 파일을 병렬로
미리 불러온다(preload). 몇 개까지 허용할지는 config/performance/budgets.json의
initialJsFiles가 정한다. 지금 개수는
config/scale/feature-shape-ceilings.json의 initialJavascript.files이고, 이
값은 feature가 없는 지금 템플릿 빌드에서 잰 것이다. HTTP/1.1에서는 host마다 연결이 여섯 개라
파일이 줄을 선다. 그래서 Fast 3G에서 첫 화면이 초기 chunk를 묶었을 때보다 약
1초 늦게 떴다(2026-11-03). HTTP/2에서는 차이가 100 ms 미만이었다. 그래서
템플릿은 chunk를 나눈 채로 둔다. HTTP/1.1로만 서빙할 수 있는 제품은
vite.config.ts에서 초기 chunk를 묶는다. 그리고 shell이 바뀔 때마다 다시
잰다(performance-evidence.md의
「초기 청크 수와 HTTP/1.1」, 리뷰 1101/14.4).
JavaScript는 압축해서(gzip, brotli, zstd 중 하나) 서빙한다. 번들 budget은
gzip 바이트를 센다. 압축하지 않으면 초기 JavaScript가 약 세 배 커진다. 두
전제는 config/hosting/cache-policy.json에 선언되어 있다
(transport.alpnProtocols, hashedAsset.contentEncodings). FE-GATE-019의
실제 host 검사(live probe)는 이 전제를 지키지 않는 host를 실패시킨다(리뷰
1103/13-02). host가 지켜야 할 조건 전부와 각 조건을 무엇이 검사하는지는
release-cache-rollback.md의
「운영 환경이 지켜야 할 조건」에 있다.