diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index 9faa1659..be7cf23e 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -12,25 +12,47 @@ Performance evidence is deliberately split by measurement context: ## 번들 예산의 기준선과 여유 -리뷰 13-14. 예산은 `config/performance/budgets.json`에 있고 -`scripts/check-bundle.ts`가 강제한다. 템플릿 기본 화면만으로 초기 JS 예산의 -96%를 쓴다. 첫 기능을 추가하기 전에 아래 숫자를 보고 예산을 정한다. +리뷰 0925/13-14, 1101/15-02. 예산은 `config/performance/budgets.json`에 있고 +`scripts/check-bundle.ts`(FE-GATE-012, merge 단계)가 강제한다. 템플릿 기본 +화면만으로 초기 JS 예산의 98.9%를 쓴다. 첫 기능을 추가하기 전에 아래 숫자를 +보고 예산을 정한다. | 항목 | 값 | |---|---| | 초기 JS 예산 | 204,800 gzip bytes(200 KiB) | -| 템플릿 기준선(2026-09-25 측정) | 196,573 gzip bytes. 빌드 ID가 번들에 들어가므로 빌드마다 수백 바이트 달라진다(196,386~196,623 관측) | -| 여유 | 약 8,200 bytes(4%) | -| lazy chunk 예산 | 파일마다 122,880 gzip bytes(120 KiB). 기준선의 가장 큰 lazy chunk는 약 8 KB | +| 템플릿 기준선(2026-11-01, 커밋 `298201f`) | 202,509~202,522 gzip bytes, 16개 파일. local 프로필, `VITE_BUILD_ID`가 `local-build`일 때와 CI 모양(`gitea--`)일 때다. 빌드 ID가 번들에 들어가므로 빌드마다 수십~수백 바이트 다르다 | +| 여유 | 약 2,280 bytes(1.1%) | +| 기능 하나를 더할 때 | 참조 기능 모양 복사본 하나에 약 +650~750 bytes(`298201f` 측정, 상한은 `tests/unit/feature-shape-growth.test.ts`의 1 KiB). 기능 실행부(`feature-runtime.ts`)는 라우트에 들어갈 때 받는 lazy chunk다 | +| lazy chunk 예산 | 파일마다 122,880 gzip bytes(120 KiB). 기준선의 lazy JS는 17개, 합계 28,204 bytes이고 가장 큰 것은 `use-reference-feature` 8,386 bytes다 | -초기 JS 9개 파일 중 세 개가 대부분이다. `index` 93.5 KB, `design-system` -65.6 KB, `preload-helper` 28.5 KB(zod 포함). 나머지 여섯은 합쳐 9 KB 정도다. +청크 이름으로 크기를 판단하지 않는다. rolldown은 공용 청크에 안에 든 모듈 +하나의 이름을 붙인다. 예를 들어 `render-boot-failure` 청크(58.6 KB)의 대부분은 +react-dom이고, `design-system` 청크(48.2 KB)에는 react-router가 들어 있다. +아래는 출처별 크기다. sourcemap 빌드에서 minify된 바이트를 원래 모듈에 나눠 +붙이고 묶음마다 따로 gzip했다. 따로 압축하므로 합은 실제 합계와 조금 다르다. + +| 출처 | minify bytes | 단독 gzip bytes | +|---|---:|---:| +| react-dom + scheduler | 181,673 | 56,545 | +| react-router | 94,271 | 30,697 | +| zod | 70,512 | 18,607 | +| @tanstack/* | 24,751 | 7,286 | +| react | 7,869 | 2,961 | +| 그 밖의 npm(lucide-react) | 2,329 | 1,142 | +| 템플릿 `src` | 265,529 | 78,883 | + +템플릿 `src` 중 큰 것은 `src/contracts` 17.8 KB, `src/adapters/http` 8.0 KB, +`src/presentation/i18n`(문구 카탈로그) 7.6 KB, `src/bootstrap` 7.4 KB, +`src/presentation/design-system` 5.1 KB다. 측정 조건: -- 초기 파일은 Vite manifest의 entry와 그 static import다 - (`scripts/lib/classify-vite-bundle.ts`). dynamic import chunk는 lazy다. -- 합계는 JavaScript만 센다. CSS(`index-*.css`, 8.5 KB gzip)는 예산에 들어가지 +- 초기 파일은 Vite manifest의 entry, 그 static import, entry가 직접 dynamic + import하는 chunk(`boot`, `render-boot-failure`)와 그 static import다 + (`scripts/lib/classify-vite-bundle.ts`). entry는 앱 그래프의 평가 실패를 + 보고하려고 그 둘을 dynamic import로 읽을 뿐이고, 첫 화면에 항상 필요하다 + (0925/09-03). 그 밖의 dynamic import chunk는 lazy다. +- 합계는 JavaScript만 센다. CSS(`index-*.css`, 8.6 KB gzip)는 예산에 들어가지 않는다. - gzip은 Node `zlib.gzipSync` 기본 수준(6)으로 잰다 (`scripts/lib/release-candidate.ts`). 호스팅이 brotli로 보내면 전송 크기는 더