build(perf): 초기 JS 파일 상한에 기능 하나가 더할 여유를 둔다

문제
initialJsFiles 상한이 템플릿 그대로의 수(26)와 같다(1b8cb12). 기능의 지연
페이지가 셸과 같은 구성요소(Button, SearchField)를 쓰면 그 구성요소가 공유
청크로 떨어져 초기 파일이 하나 는다. 매뉴얼의 검색 폼 예제를 따른 기능
하나로 FE-GATE-012가 "27 > budget 26"으로 실패했다(리뷰 조치 X2 #4).

고른 방법
- 상한을 32(지금 26 + 6)로 둔다. 템플릿은 HTTP/2 서빙을 요구하고
  (1103/13-02, FE-GATE-019), 그때 파일 하나의 비용은 거의 없다(15 영역
  측정). 상한은 청크가 통째로 쪼개지는 회귀를 막는 용도다.
- performance-evidence.md에 이유와, 넘었을 때 먼저 청크 그룹을 볼 것을
  적는다.
- 버린 대안: 상한을 지금 수로 두고 제품마다 올리기. 템플릿 소유 파일을
  기능마다 고치게 된다.

위험·한계
- 합계 바이트 예산(204,800 B)은 그대로다. 여유는 1,873 B다.

검증
- performance-budgets·bundle-artifact-contract 테스트 14건,
  verify:documentation 통과.

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-05, README.md 14.6 X2 #4
This commit is contained in:
DongHyeonka
2026-11-05 01:33:38 +09:00
parent 72c6e9db4a
commit 2fef27d57f
2 changed files with 7 additions and 3 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
"schemaVersion": 1, "schemaVersion": 1,
"bundle": { "bundle": {
"initialJsGzipBytes": 204800, "initialJsGzipBytes": 204800,
"initialJsFiles": 26, "initialJsFiles": 32,
"lazyChunkGzipBytes": 122880 "lazyChunkGzipBytes": 122880
}, },
"lab": { "lab": {
+6 -2
View File
@@ -167,8 +167,12 @@ the example can never serve as production evidence.
- HTTP/2에서는 (나)도 Fast 3G 85 ms, Fast 4G 22 ms 차이다(위 둘째 표). - HTTP/2에서는 (나)도 Fast 3G 85 ms, Fast 4G 22 ms 차이다(위 둘째 표).
그래서 템플릿은 HTTP/2 이상으로 서빙한다고 본다. 초기 파일 수는 그래서 템플릿은 HTTP/2 이상으로 서빙한다고 본다. 초기 파일 수는
`config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 초기 `config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 상한은
파일을 늘리는 변경은 그 값을 같이 고치고, 이유를 같은 변경에 적는다. HTTP/1.1로만 서빙해야 하는 템플릿 그대로의 수(26)에 6을 더한 32다. 기능의 지연 페이지가 셸과 같은 구성요소
(`Button`, `SearchField` 등)를 쓰면 그 구성요소가 별도 공유 청크로 떨어져 초기
파일이 하나 는다(1103 X2 #4). 상한을 현재 수와 같게 두면 그런 기능 하나로 게이트가
실패한다. HTTP/2에서 파일 하나는 거의 비용이 없다(위 표). 32를 넘으면 상한을 올리기
전에 `vite.config.ts`의 청크 그룹으로 공유 청크를 묶을지 본다. HTTP/1.1로만 서빙해야 하는
제품은 (나)처럼 초기 청크를 묶는 그룹을 `vite.config.ts`에 넣는다. 그 목록은 제품은 (나)처럼 초기 청크를 묶는 그룹을 `vite.config.ts`에 넣는다. 그 목록은
셸을 바꿀 때마다 위 방법으로 다시 잰다. 셸을 바꿀 때마다 위 방법으로 다시 잰다.