문제
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 통과.