Files
clean-architecture-frontend…/docs/architecture/static-delivery.md
T
DongHyeonka e632b230e3 docs: 옮긴 문서를 가리키는 링크와 경로를 새 위치로 고친다
문제: 앞 커밋이 기록·설계서·결정 기록을 옮겨서, 그 문서를 가리키는
상대 링크 182개와 살아 있는 문서·코드 주석의 경로 23곳이 없는 곳을
가리킨다.

고른 방법: 기계적으로 바꾼다.
- 상대 링크: 모든 .md(기록 포함)에서 옮기기 전 트리로 대상을 풀고,
  대상이나 문서 자신이 옮겨졌으면 새 위치 기준 상대 경로로 다시 쓴다.
  옮기기 전에도 없던 대상은 건드리지 않는다. 기록 본문에서 고친 것은
  링크 대상뿐이다(백엔드 1단계와 같은 예외).
- 경로 글자: 살아 있는 문서와 코드·설정 주석의 `docs/architecture/…`,
  `docs/superpowers/…`, `decisions/VD-…`를 새 경로로 바꾼다. 기록 본문과
  CHANGELOG.md는 쓴 때의 경로를 그대로 둔다. review-evidence.md와
  review-ledger.json의 `docs/superpowers/specs/…`는 이 트리가 아닌 검토
  작업 공간의 출처 표시라 그대로 둔다.

위험: 경로 글자를 바꾼 곳은 주석과 문서뿐이고 실행 코드의 경로 상수는
없다. 문서 지도(docs/README.md)의 옛 폴더 행은 뒤 커밋이 다시 쓴다.

검증: `git grep -n -E "docs/superpowers|architecture/decisions"`가 기록,
CHANGELOG.md, 출처 표시 두 곳, docs/README.md·README.md(뒤에서 다시
쓴다) 밖에서 0건.
2026-11-08 17:25:41 +09:00

3.4 KiB

Static asset and runtime-config delivery

정본 안내 (non-authoritative for runtime capability decisions)

Runtime Config/boot, Fetch HTTP client, Router, Query/Mutation, realtime 공통 경계, Web Worker, Service Worker, offline command와 Background Sync의 구현 결정은 프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계가 정본이다. 본 문서의 해당 서술이 정본과 충돌하면 정본을 따른다.

This Mermaid view is a repository-local implementation projection. The PASS_SCOPED reviewer evidence applies only to the canonical static-delivery draw.io scope recorded in review-ledger.json.

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

In this repository the workflow deploys nothing. The upload, pointer switch and smoke steps above belong to the project's provider adapter, which fills the deployment job between promotion and production_gate. After it has deployed the promoted release, FE-GATE-019 probes the live headers and checks that the host serves that release; while the slot is empty FE-GATE-019 is UNVERIFIED (reviews 13-05, 1101/13-01, release-cache-rollback.md).

Rollback changes the active pointer only after confirming that the prior immutable release has a coherent HTML/assets/config/API/manifest tuple.

Serve the app over HTTP/2 or later. The entry preloads every initial JavaScript file in parallel (initialJsFiles in config/performance/budgets.json bounds how many; the current count is initialJavascript.files in config/scale/feature-shape-ceilings.json, which goes with the sample feature). Over HTTP/1.1 they queue for six connections per host, and the first screen on Fast 3G came about one second later than with the initial chunks grouped (2026-11-03). Over HTTP/2 the difference was under 100 ms, so the template keeps the chunks split. A product that can only serve HTTP/1.1 groups its initial chunks in vite.config.ts and measures again whenever the shell changes ("초기 청크 수와 HTTP/1.1" in performance-evidence.md, review 1101/14.4).

Serve JavaScript compressed (gzip, brotli or zstd). The bundle budget counts gzip bytes; uncompressed, the initial JavaScript is about three times larger. Both premises are declared in config/hosting/cache-policy.json (transport.alpnProtocols, hashedAsset.contentEncodings), and the live probe of FE-GATE-019 fails a host that does not meet them (review 1103/13-02). Every condition the host has to meet, and what checks each one, is in 「운영 환경이 지켜야 할 조건」 in release-cache-rollback.md.