From 3f9c0877985ee8337d0e7282d3b17db2d558cb49 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 3 Nov 2026 20:47:08 +0900 Subject: [PATCH] =?UTF-8?q?docs(performance):=20=EC=B4=88=EA=B8=B0=20?= =?UTF-8?q?=EC=B2=AD=ED=81=AC=20=EC=88=98=EC=9D=98=20HTTP/1.1=20=EB=B9=84?= =?UTF-8?q?=EC=9A=A9=EC=9D=84=20=EC=9E=AC=EA=B3=A0=20=EB=AC=B6=EC=A7=80=20?= =?UTF-8?q?=EC=95=8A=EB=8A=94=20=EA=B7=BC=EA=B1=B0=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 문제 08-08은 초기 JS 바이트를 줄이는 대신 초기 파일을 16개에서 25개(entry 포함 26개)로 늘렸고, "HTTP/1.1 호스팅이면 다시 본다"를 남겼다. vite preview도 HTTP/1.1이다. 비용을 잰 적이 없어 위험이 열려 있었다. 고른 방법 - 지금 빌드와 묶은 빌드 두 가지를 쟀다. (가) 08-08이 나눈 초기 primitive 청크 4개(field·button·select·page-templates)를 하나로. (나) 묶을 수 있는 초기 청크 14개를 하나로(entry·preload-helper·boot, 부트 실패 화면 closure, 15-01 그룹은 뺐다). 같은 커밋을 임시 복사본에서 그룹 하나만 더해 빌드했다. - 측정: vite preview(HTTP/1.1, gzip), Chromium CDP 네트워크 에뮬레이션 (DevTools Fast 3G·Fast 4G 값), 새 context·캐시 없음, 첫 화면 = boot 셸이 사라지고 route h1이 들어온 시각. 세 빌드를 번갈아 7번씩, 중앙값. HTTP/2(node:http2, 자체 서명 인증서, gzip)도 같은 방법으로 쟀다. - 결과(Fast 3G / Fast 4G 중앙값) - 지금 26개 202,782 B: 5,887 / 1,874 ms - (가) 23개 201,818 B: 5,426 / 1,764 ms - (나) 13개 198,673 B: 4,930 / 1,535 ms - HTTP/2: 지금 4,793 / 1,444, (가) 4,769 / 1,440, (나) 4,708 / 1,422 ms - 판단: 묶지 않는다. 측정값과 판단을 performance-evidence.md에 적고, vite.config.ts의 "재검토" 주석이 그 절을 가리키게 한다. - (가)·(나)는 이 빌드의 청크 안 모듈 목록을 그대로 적어 만들었다. 규칙으로 고를 방법이 없었다. boot 정적 closure는 design-system 배럴을 지나 갤러리 전용 primitive까지 잡는다. rolldown `$initial` 태그는 entry가 앱을 dynamic import로 읽어서(09-03) 아무것도 잡지 않는다. boot.tsx를 entry로 더하면 manifest 분류가 lazy 화면까지 초기로 센다(28개, 216,820 B, 예산 초과). - 고정 목록은 셸이 쓰는 primitive가 바뀔 때마다 맞춰야 하고, 낡아도 실패하는 검사가 없다. 08-08이 같은 이유로 manualChunks 이름 고정을 버렸다. - 템플릿은 HTTP/2 이상 서빙을 전제로 본다. HTTP/1.1로만 서빙하는 제품은 (나) 같은 그룹을 넣고 셸을 바꿀 때마다 다시 잰다고 문서에 적었다. 버린 대안 - (나)를 고정 목록으로 넣기: HTTP/1.1에서 Fast 3G 0.96초 빠르지만 숨은 결합이다(위). - (가)만 넣기: 0.46초. 같은 이유. 위험·한계 - HTTP/1.1로 서빙하는 다운스트림은 첫 화면이 Fast 3G에서 약 1초 늦다. 이 커밋은 그 비용을 없애지 않고 숫자와 전제를 적는다. 호스팅 HTTP 버전을 검사하는 게이트는 없다(FE-GATE-019 probe 밖). - 측정은 이 머신의 loopback과 CDP 에뮬레이션이다. 연결 수립(TCP·TLS) 비용은 CDP 지연에 들어가지 않는다. loadavg는 HTTP/1.1 측정 6~20, HTTP/2 측정 3~6이라 두 표끼리는 비교하지 않는다. 각 표 안은 번갈아 재서 비교할 수 있다. 검증 - 빌드 바이트: classify-vite-bundle + gzipSync(check:bundle과 같은 계산). 지금 빌드는 기준 202,770 B(local-build)와 맞다. - 측정 스크립트와 로그는 커밋하지 않았다(worktree의 .tmp/ra/, 일회성). - node scripts/verify-documentation-readiness.ts: PASS_SCOPED. - npx eslint vite.config.ts, npx tsc --project tsconfig.node.json --noEmit 통과. --- docs/operations/performance-evidence.md | 61 +++++++++++++++++++++++++ vite.config.ts | 7 +-- 2 files changed, 65 insertions(+), 3 deletions(-) diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index be7cf23e..6bf1c888 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -96,3 +96,64 @@ threshold-decision references, and contain only non-negative route-ID samples. The environment threshold must be a positive integer equal to the approved decision embedded in the input. Invalid metadata fails as `FAIL_UNVERIFIED`; the example can never serve as production evidence. + +## 초기 청크 수와 HTTP/1.1 + +리뷰 1101/14.4. 08-08은 초기 JS 바이트를 줄이는 대신 초기 파일 수를 늘렸다 +(`vite.config.ts`의 `moduleSideEffects` 주석). HTTP/1.1에서 브라우저는 한 +호스트에 연결을 6개까지만 연다. 파일이 많으면 요청이 줄을 서서 왕복이 는다. +그래서 지금 빌드와 작은 초기 청크를 하나로 묶은 빌드를 쟀다(2026-11-03, +커밋 `ec7435c`). + +| 빌드 | 초기 JS 파일(entry 포함) | 초기 JS gzip(B) | 첫 화면까지 JS 요청 | Fast 3G 첫 화면 | Fast 4G 첫 화면 | +|---|---:|---:|---:|---:|---:| +| 지금 | 26 | 202,782 | 27 | 5,887 ms | 1,874 ms | +| (가) 08-08이 나눈 초기 primitive 청크 4개(`field`·`button`·`select`·`page-templates`)를 하나로 | 23 | 201,818 | 24 | 5,426 ms | 1,764 ms | +| (나) 묶을 수 있는 초기 청크 14개를 하나로 | 13 | 198,673 | 14 | 4,930 ms | 1,535 ms | + +같은 빌드를 HTTP/2로 서빙하면(`node:http2`, 자체 서명 인증서, gzip) 차이가 +거의 없다. + +| 빌드 | Fast 3G 첫 화면 | Fast 4G 첫 화면 | +|---|---:|---:| +| 지금 | 4,793 ms | 1,444 ms | +| (가) | 4,769 ms | 1,440 ms | +| (나) | 4,708 ms | 1,422 ms | + +측정 조건: + +- `vite preview`(HTTP/1.1, gzip 응답)로 띄우고 Chromium으로 잰다. 네트워크는 + CDP `Network.emulateNetworkConditions`에 DevTools 프리셋 값을 넣었다. Fast + 3G는 지연 562.5 ms·내려받기 180,000 B/s, Fast 4G는 165 ms·1,012,500 B/s다. +- 매번 새 browser context에서 캐시 없이 `/`를 연다. 첫 화면은 boot 셸이 + 사라지고 `#main-content h1[data-route-heading]`가 DOM에 들어온 시각이다 + (`performance.now()`). +- 세 빌드를 번갈아 7번씩 재고 중앙값을 적었다. 7번의 범위는 지금 5,866~6,077 ms, + (가) 5,384~5,652 ms, (나) 4,891~5,032 ms다(Fast 3G). loadavg는 HTTP/1.1 + 측정 때 6~20, HTTP/2 측정 때 3~6이었다. 그래서 두 표끼리는 비교하지 않는다. +- CDP 지연은 요청마다 붙는다. 연결 수립(TCP·TLS) 비용은 따로 재지 않았다. +- (나)에서 묶지 않은 것: entry·`preload-helper`·`boot`, 부트 실패 화면이 쓰는 + 모듈(`render-boot-failure`·react·react-dom·`jsx-runtime`·`operation-id`· + `diagnostics`·`boot-messages`, 09-03), 15-01의 `feature-declarations`· + `feature-platform`. + +판단: 지금은 묶지 않는다. + +- HTTP/1.1에서는 묶는 편이 빠르다. Fast 3G에서 (가) 0.46초, (나) 0.96초 + 빨라지고 초기 JS도 조금 준다. +- 그러나 (가)·(나)는 이 빌드의 청크 안 모듈 목록을 그대로 적어 만들었다. + 규칙으로 고르는 방법은 찾지 못했다. + - 모듈 그래프로 boot의 정적 closure를 따라가면 design-system 배럴을 지나 + 갤러리 전용 primitive까지 잡힌다. 그 primitive가 다시 초기 청크로 간다. + - rolldown의 `$initial` 태그는 entry가 앱을 dynamic import로 읽어서(09-03) + 아무것도 잡지 않는다. + - `boot.tsx`를 entry로 더하면 manifest 분류가 lazy 화면까지 초기로 센다 + (28개, 216,820 B로 예산 초과). +- 고정 목록은 셸이 쓰는 primitive가 바뀔 때마다 다시 맞춰야 한다. 목록이 + 낡아도 실패하는 검사가 없다. 08-08이 같은 이유로 `manualChunks` 이름 고정을 + 버렸다. +- HTTP/2에서는 (나)도 Fast 3G 85 ms, Fast 4G 22 ms 차이다(위 둘째 표). + +그래서 템플릿은 HTTP/2 이상으로 서빙한다고 본다. HTTP/1.1로만 서빙해야 하는 +제품은 (나)처럼 초기 청크를 묶는 그룹을 `vite.config.ts`에 넣는다. 그 목록은 +셸을 바꿀 때마다 위 방법으로 다시 잰다. diff --git a/vite.config.ts b/vite.config.ts index 6794e7f2..86bdfe88 100644 --- a/vite.config.ts +++ b/vite.config.ts @@ -161,9 +161,10 @@ export default defineConfig(({ mode }) => { * * Trade: at 08-08 the initial JavaScript fell by 2,718 gzip bytes * and the initial chunks rose from 16 to 25. The entry preloads them - * in parallel, so over HTTP/2 they add no round trip. Revisit when - * the app is served over HTTP/1.1, where every chunk costs a - * connection slot. + * in parallel, so over HTTP/2 they add no round trip. Over HTTP/1.1 + * they queue for six connections; 1101/14.4 measured that cost and + * why the chunks stay split ("초기 청크 수와 HTTP/1.1" in + * docs/operations/performance-evidence.md). */ treeshake: { moduleSideEffects: [