Commit Graph
5 Commits
Author SHA1 Message Date
DongHyeonka 2fef27d57f 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
2026-11-05 01:33:38 +09:00
DongHyeonka 1b8cb126c6 build(perf): 초기 JS 파일 상한을 26개로 올린다
문제
fix/r1103-release(15-05)는 초기 JS 파일 수 상한을 그 브랜치의 개수(25)로
두었다. fix/r1103-examples(15-01)는 플랫폼 구성 화면이 실행부 레지스트리
조립 모듈을 동적으로 받게 했다. 그 결과 그 모듈과 초기 그래프가 함께 쓰는
installed-product-manifest(198 B gzip)가 따로 떨어져 초기 파일이 하나
늘었다. 두 브랜치를 합친 빌드는 26개이고 check:bundle이
"initial JavaScript files 26 > budget 25"로 실패한다.

고른 방법
- 상한을 26으로 올린다. performance-evidence.md의 규칙대로 초기 파일을
  늘린 이유를 같은 변경에 적는다. 이 파일은 15-01(lab 게이트 회복)의
  결과이고, 템플릿은 HTTP/2 서빙을 전제로 한다(13-02).
- 버린 대안: manualChunks로 그 모듈을 초기 청크에 묶기. 198 B 하나 때문에
  청크 그룹 규칙이 하나 늘고, 셸을 바꿀 때마다 다시 재야 한다.

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

검증
- check:bundle PASS(26/26 파일).
- performance-budgets·bundle-artifact-contract 테스트 통과.

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-05 15-01
2026-11-04 23:13:56 +09:00
DongHyeonka 46dfe23f69 fix(bundle): 예산을 넘으면 넘은 한도와 초과량을 출력하고 초기 파일 수를 막는다
문제: 초기 JS가 예산을 넘으면 check:bundle은
"Bundle budget or manifest integrity failed: " 한 줄만 쓰고 콜론 뒤가
비어 있었다. 측정값과 한도는 artifacts/performance/bundle.json에만 있어
예산 실패인지 manifest 무결성 실패인지, 몇 바이트 넘었는지 알 수 없었다.
또 초기 JS 파일 수에는 상한이 없어 08-08처럼 파일을 16개에서 25개로
늘리는 변경도 모든 게이트를 통과했다. 템플릿은 HTTP/2를 전제로 초기
청크를 나눠 두었는데, 파일 수를 늘리는 결정이 어디에도 드러나지 않았다.

고른 방법: 예산 실패와 무결성 실패를 다른 문장으로 쓴다. 예산 실패는
넘은 한도마다 측정값·한도·초과량을 한 줄로 쓴다
(describeBundleBudgetFailures). config/performance/budgets.json에
initialJsFiles(지금 25)를 두고 check:bundle이 entry를 포함한 초기 파일
수를 센다. bundle.json 스키마는 측정값·한도·결과와 자가 검사 fixture를
하나씩 더 가진다. 두 변경은 같은 함수와 스키마를 고치므로 한 커밋에
넣었다.
버린 대안: 파일 수를 문서에만 적기. 08-08이 그 상태에서 파일을 늘렸다.

위험·한계: 초기 파일을 하나라도 늘리는 변경은 이제 budgets.json을 같이
고쳐야 통과한다. 그것이 목적이다. HTTP/2 확인 자체는 이 커밋에 없다
(13-02에서 probe에 넣는다).

검증: tests/unit/check-bundle-output.test.ts가 손으로 만든 빌드 출력에
check-bundle.ts를 돌려 통과·초기 바이트 초과·lazy 초과·파일 수 초과·
무결성 실패의 출력을 본다(고치기 전 4건 실패). bundle-artifact-contract,
performance-budgets 통과. 실제 빌드에서 check:bundle PASS(25 / 25 files).

Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-03, 15-05
2026-11-04 20:22:27 +09:00
donghyeon-ka 6b4b956d51 fix: authenticate field performance evidence context 2026-07-25 22:30:14 +09:00
donghyeon-ka b1625252d5 feat: enforce web vitals performance budgets 2026-07-25 21:26:51 +09:00