From 1eaa6447dc980023085fca1d50056f1f97ee8127 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 05:22:31 +0900 Subject: [PATCH] =?UTF-8?q?docs(perf):=20=EC=B4=88=EA=B8=B0=20JS=20?= =?UTF-8?q?=EC=98=88=EC=82=B0=20=ED=8F=AD=EC=9D=98=20=EA=B7=BC=EA=B1=B0?= =?UTF-8?q?=EC=99=80=20=EB=90=98=EB=8F=8C=EB=A6=BC=20=EA=B7=9C=EC=B9=99?= =?UTF-8?q?=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: D7이 초기 JS 예산을 204,800 → 206,848 B로 올렸다(`287dc6f`). 드릴 (FE-GATE-020, 생성 기능 둘)이 넘은 양은 665 B(CI env)인데 2,048 B를 올렸다. 문서는 올린 뒤 여유만 적고 왜 그 폭인지, 언제 다시 내리는지를 적지 않는다. 재검토 조건 "예산을 또 넘을 때"는 이번 상향의 조건과 같아서, 내릴 조건이 없다. 다음 담당자는 예산을 넘었을 때 올릴지 줄일지 문서에서 알 수 없다. 고른 방법: 메인 세션 결정 D9를 따른다. 206,848 B를 그대로 두고 `docs/operations/performance-evidence.md`의 예산 항목에 세 가지를 적는다. - 폭의 근거: 드릴 측정값 205,465 B(CI env, `bbde570`) + 기능 하나의 상한 1 KiB = 206,489 B를 KiB 단위로 올림해 202 KiB = 206,848 B. 드릴 위 여유 1,383 B가 기능 하나와 올림 359 B로 나뉜다. 템플릿 자신의 몫은 이 규칙에 없다. - 되돌림 규칙: D7의 재검토 조건마다 드릴을 다시 재고, 204,800 B 이하이면 같은 규칙으로 내린다. - 사용자가 이 결정을 뒤집을 수 있다. 버린 대안(리뷰 15-01의 대안): 예산을 드릴 + 256 B로 되돌리기(다음 템플릿 변경마다 넘는다), 테스트로 예산 값을 여유 규칙에 묶기(D9가 고르지 않았다). 위험·한계: 규칙은 문서에만 있다. 예산 값을 규칙 밖으로 바꿔도 실패하는 테스트는 없다(리뷰 대안 c는 고르지 않았다). 205,465 B는 2026-11-06의 한 번 측정이고, 다음 측정은 "다시 볼 때"에 한다. 결정 기록 자체는 오케스트레이터가 2026-11-06 리뷰 README에 적는다. 이 문서는 그 파일을 가리킨다. 검증: 문서만 바꿨다. desktop batch에서 확인. corepack pnpm verify:documentation (새로 적은 경로 `docs/reviews/2026-11-06-maturity-review/README.md`와 FE-GATE-020을 본다) node scripts/run-vitest.ts run tests/unit/documentation-readiness.test.ts tests/unit/template-feature-removal-documents.test.ts Refs: 1106/15-01 --- docs/operations/performance-evidence.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index 081b6f40..fe5b48f1 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -51,6 +51,17 @@ Performance evidence is deliberately split by measurement context: 넘을 때, 또는 1103/13-03(zod 갱신, 약 7 KB)을 정할 때. 그때 03-01·02-01의 런타임 검사를 빌드 시점으로 옮기는 것부터 본다. 이 상향은 13-03을 정하지 않는다. 결정 기록은 `docs/reviews/2026-11-05-maturity-review/README.md` 16절이다. + - 폭의 근거(1106/15-01, 결정 D9): 예산은 드릴 측정값에 기능 하나의 상한 + (`perFeatureGzipBytes` 상한 1 KiB)을 더해 KiB 단위로 올림한 값이다. 드릴은 + CI env에서 205,465 B였다(2026-11-06, `bbde570`, FE-GATE-020). 205,465 + + 1,024 = 206,489 B를 올림하면 202 KiB = 206,848 B다. 그래서 드릴 위의 여유 + 1,383 B는 기능 하나(1,024 B)와 올림(359 B)이다. 이 규칙에 템플릿 자신이 더 + 쓸 몫은 없다. 템플릿 변경이 이 여유를 쓰면 그만큼 기능 몫이 준다. + - 되돌림 규칙: 위 "다시 볼 때"마다 드릴을 다시 잰다. 드릴 측정값이 204,800 B + 이하이면 같은 규칙(드릴 + 1 KiB를 KiB 단위로 올림)으로 예산을 내린다. 그때 + 규칙의 값은 201 KiB 이하다. + - D9(206,848 B를 그대로 둔다)는 메인 세션이 2026-11-06에 정했다. 사용자가 뒤집을 + 수 있다. 결정 기록은 `docs/reviews/2026-11-06-maturity-review/README.md`다. - 기능 실행부(`feature-runtime.ts`)는 라우트에 들어갈 때 받는 lazy chunk다. lazy chunk 예산은 파일마다 120 KiB(`lazyChunkGzipBytes`)다.