From 8c39e773768a388d0f899b7361440dc3becb83da Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 3 Nov 2026 20:48:19 +0900 Subject: [PATCH] =?UTF-8?q?docs(delivery):=20=EC=A0=95=EC=A0=81=20?= =?UTF-8?q?=EB=B0=B0=ED=8F=AC=20=EB=AC=B8=EC=84=9C=EC=97=90=20HTTP/2=20?= =?UTF-8?q?=EC=84=9C=EB=B9=99=20=EC=A0=84=EC=A0=9C=EB=A5=BC=20=EC=A0=81?= =?UTF-8?q?=EB=8A=94=EB=8B=A4=20(1101/14.4)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 3f9c087은 초기 청크를 묶지 않는 근거로 "템플릿은 HTTP/2 이상으로 서빙한다"를 정했다. 그런데 이 전제는 작업 기록인 performance-evidence.md 에만 있다. 호스팅을 정하는 사람이 읽는 현재 계약 문서(static-delivery.md) 에는 서빙 프로토콜 이야기가 없다. 고른 방법: static-delivery.md 끝에 한 단락을 더한다. HTTP/2 이상으로 서빙한다는 것, HTTP/1.1에서 늦어지는 정도(Fast 3G 약 1초), HTTP/2에서의 차이(100 ms 미만), HTTP/1.1만 되는 제품이 할 일을 적고 측정 기록으로 링크한다. 버린 대안: README의 배포 절에 적기. README는 배포 변수와 명령을 다루고, 호스트 동작은 static-delivery.md가 다룬다. 위험·한계: 수치는 2026-11-03 한 번의 측정이다. 셸이 바뀌면 달라진다. 검증: node scripts/verify-documentation-readiness.ts PASS_SCOPED --- docs/architecture/static-delivery.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/architecture/static-delivery.md b/docs/architecture/static-delivery.md index ebbfde80..44e0b685 100644 --- a/docs/architecture/static-delivery.md +++ b/docs/architecture/static-delivery.md @@ -39,3 +39,13 @@ that the host serves that release; while the slot is empty FE-GATE-019 is 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 about 26 initial +JavaScript files in parallel. 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).