문제: 앞 커밋이 기록·설계서·결정 기록을 옮겨서, 그 문서를 가리키는 상대 링크 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건.
63 lines
3.4 KiB
Markdown
63 lines
3.4 KiB
Markdown
# 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 저장소 정합형 구현 결정 폐쇄 상세 설계](../design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)가 정본이다.
|
|
> 본 문서의 해당 서술이 정본과 충돌하면 정본을 따른다.
|
|
|
|
|
|
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`.
|
|
|
|
```mermaid
|
|
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`](../operations/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`](../operations/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`](../operations/release-cache-rollback.md#운영-환경이-지켜야-할-조건).
|