From 2fef27d57f7a0561e69b8a2fb11fce746f926e53 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 01:33:38 +0900 Subject: [PATCH] =?UTF-8?q?build(perf):=20=EC=B4=88=EA=B8=B0=20JS=20?= =?UTF-8?q?=ED=8C=8C=EC=9D=BC=20=EC=83=81=ED=95=9C=EC=97=90=20=EA=B8=B0?= =?UTF-8?q?=EB=8A=A5=20=ED=95=98=EB=82=98=EA=B0=80=20=EB=8D=94=ED=95=A0=20?= =?UTF-8?q?=EC=97=AC=EC=9C=A0=EB=A5=BC=20=EB=91=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 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 --- config/performance/budgets.json | 2 +- docs/operations/performance-evidence.md | 8 ++++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/config/performance/budgets.json b/config/performance/budgets.json index d7f66a62..18d08dc8 100644 --- a/config/performance/budgets.json +++ b/config/performance/budgets.json @@ -2,7 +2,7 @@ "schemaVersion": 1, "bundle": { "initialJsGzipBytes": 204800, - "initialJsFiles": 26, + "initialJsFiles": 32, "lazyChunkGzipBytes": 122880 }, "lab": { diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index c7bd5bd9..36608b1b 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -167,8 +167,12 @@ the example can never serve as production evidence. - HTTP/2에서는 (나)도 Fast 3G 85 ms, Fast 4G 22 ms 차이다(위 둘째 표). 그래서 템플릿은 HTTP/2 이상으로 서빙한다고 본다. 초기 파일 수는 -`config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 초기 -파일을 늘리는 변경은 그 값을 같이 고치고, 이유를 같은 변경에 적는다. HTTP/1.1로만 서빙해야 하는 +`config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 상한은 +템플릿 그대로의 수(26)에 6을 더한 32다. 기능의 지연 페이지가 셸과 같은 구성요소 +(`Button`, `SearchField` 등)를 쓰면 그 구성요소가 별도 공유 청크로 떨어져 초기 +파일이 하나 는다(1103 X2 #4). 상한을 현재 수와 같게 두면 그런 기능 하나로 게이트가 +실패한다. HTTP/2에서 파일 하나는 거의 비용이 없다(위 표). 32를 넘으면 상한을 올리기 +전에 `vite.config.ts`의 청크 그룹으로 공유 청크를 묶을지 본다. HTTP/1.1로만 서빙해야 하는 제품은 (나)처럼 초기 청크를 묶는 그룹을 `vite.config.ts`에 넣는다. 그 목록은 셸을 바꿀 때마다 위 방법으로 다시 잰다.