Files
clean-architecture-frontend…/config/scale/feature-shape-ceilings.json
T
DongHyeonka 309631e419 docs(config): 설정 파일의 사람이 읽는 설명 칸을 한국어로 옮긴다
문제: recipe 카탈로그(config/recipes/frontend-capability-recipes.json),
runbook 등록(config/runbooks/runbooks.json), 규모 상한
(config/scale/feature-shape-ceilings.json), 짝 백엔드 pin의 `fact`,
secret scan 허용 이유의 설명 칸이 영어다. 소유자 결정(2026-11-07):
레지스트리의 설명 칸은 번역하되 그 칸을 읽는 테스트를 먼저 찾는다.

고른 방법: 칸마다 읽는 코드를 찾아, 비었는지만 보거나 자유 문자열로
산출물에 복사하는 칸만 옮긴다. 키, 배열 길이, 순서, 식별자·상태·경로·
명령·숫자는 그대로다.
- 옮기지 않은 칸: registry-baseline.json의 `trigger`·`compatibilityRole`
  (승인 파일이 그 사본의 digest를 고정한다), 승인·변경 증거 파일의
  `reason`(쓴 때의 기록), benchmark-baseline.json의 승인 이유,
  feature-shape-ceilings의 `axes[].axis`(테스트가 영어 리터럴로
  비교한다), 값이나 이름뿐인 칸. config/ci/는 정리 3단계·CI 세션
  범위라 보지 않았다.

위험: scripts/drill-runbook.ts의 복구 확인 항목 이름은 아직 영어라 설정과
코드의 언어가 다르다. 비교하지는 않는다.

검증: 다섯 파일 모두 HEAD와 키 경로·순서·배열 길이가 같다.
json-schema·runbook-contract·feature-shape-growth·backend-contract-pin
시험을 desktop에서 돌렸다.
2026-11-08 21:57:47 +09:00

49 lines
3.1 KiB
JSON

{
"schemaVersion": 1,
"baseline": "config/scale/feature-shape-growth.json",
"ceilings": {
"contextMaxFeatures": 200,
"appMaxContexts": 20
},
"summary": "상한은 개수를 제한할 뿐, 검증된 수용량이 아니다. 앱 하나의 실제 한계는 먼저 초기 JavaScript budget이고, 그다음 typecheck 메모리다. 400개 feature는 재지 않았다(D-18이 선택 사항으로 둔다).",
"axes": [
{
"axis": "Typecheck of one app",
"verified": "100개 feature까지 선형이다. feature 하나에 instantiation 약 101k, tsc 메모리 31 MB",
"condition": "create:feature가 --with-create --keyed로 만드는 feature의 사본(2026-11-07부터. 그 전에는 참조 샘플 사본), tsconfig.app.json, 기준선에 기록된 host",
"notVerified": "200개 feature(context 하나를 꽉 채운 수)와 그 이상. 같은 기울기라면 4,000개(20 x 200)에는 125 GB 규모가 필요하다"
},
{
"axis": "Production build",
"verified": "100개 feature에서 몇 초 안에 끝난다",
"condition": "위와 같음",
"notVerified": "100개 초과"
},
{
"axis": "Initial JavaScript",
"verified": "15-01: boot 때는 각 feature의 선언(route 표, 메시지, 무효화 식별자)만 로드된다. runtime 쪽 절반은 그 feature의 route와 함께 로드된다. 아래 initialJavascript에는 네 가지가 있다. feature가 없는 지금 템플릿 빌드, 첫 feature가 한 번 더하는 크기(firstFeatureGzipBytes: 모든 feature가 함께 쓰는 코드가 초기 chunk에 들어간다), 기존 context에 feature 하나를 더할 때 늘어나는 크기(perFeatureGzipBytes), 두 번째 context가 더하는 크기(perContextGzipBytes)다. tests/unit/feature-shape-growth.test.ts가 unit 실행마다 이것을 잰다. feature 하나는 1 KiB, context 하나는 512 B로 제한하고, 기록이 빌드와 맞지 않으면 실패한다. 25개·100개 사본 측정은 source commit 시점의 기준선에 있다(15-01 전: 사본 하나당 +3,922 B)",
"condition": "위와 같음. 여기에 vite.config.ts의 feature-declarations·feature-platform chunk 그룹",
"notVerified": "feature가 몇 개 들어가는지. 초기 budget(config/performance/budgets.json)에서 initialJavascript.gzipBytes와 firstFeatureGzipBytes를 빼고 perFeatureGzipBytes로 나눈 값이다(새 context마다 perContextGzipBytes를 더한다). platform 자체가 budget 대부분을 쓴다"
},
{
"axis": "Lazy JavaScript",
"verified": "feature 하나에 gzip 약 6.7 KB, 파일 9개. 모든 파일이 lazy chunk budget 120 KiB보다 훨씬 작다",
"condition": "위와 같음",
"notVerified": "lazy 파일이 많을 때의 다운로드 비용"
},
{
"axis": "Routes",
"verified": "feature 하나에 3개(list, detail, create). 충돌 없이 조합된다",
"condition": "위와 같음",
"notVerified": "runtime의 router 매칭 비용"
}
],
"initialJavascript": {
"gzipBytes": 194354,
"files": 17,
"firstFeatureGzipBytes": 6327,
"perFeatureGzipBytes": 539,
"perContextGzipBytes": 4
}
}