홈(`src/presentation/pages/home-page.tsx`)이 페이지 템플릿 대신 자기 `section.ui-page`와 `PageHeader`를 쓰고, 시작 링크를 `<Link className="ui-button …">`으로 `LinkButton`을 손으로 다시 만든다. `PRODUCT.md`는 홈이 파생 서비스에 남는다고 적는다. 그래서 그대로 복제되고 개발자가 따라 하는 예가 된다. `LinkButton`의 variant·size가 바뀌면 홈만 어긋난다. 고른 방법: `StandardPage`(heading 슬롯에 eyebrow·제목·설명)와 `LinkButton variant="primary"/"secondary"`로 바꾼다. 준비 목록, 런타임 요약, 시작 링크는 템플릿의 본문 자리에 `home-page__sections`(블록 사이 `--space-6`)로 묶어 둔다. 템플릿 본문 자리에는 간격이 없어, 묶지 않으면 런타임 요약이 카드에 붙는다(첫 골든에서 보고 고쳤다). component 시험이 홈의 링크가 standard 템플릿 안의 `ui-button ui-button--primary`인지 본다. 위험·한계: 머리말과 본문 사이는 템플릿 간격(`--space-5`)이라 홈의 세로 간격이 조금 바뀐다. 시각 골든은 이 커밋에서 다시 찍고 이유를 PR 본문에 적는다. 홈이 템플릿과 `LinkButton`을 쓰면서 번들러가 청크 둘을 합쳤다. 초기 JS는 파일 17 → 15개, gzip 194,397 → 194,143 B, Service Worker precache 자산은 24 → 22개다. `config/scale/feature-shape-ceilings.json`은 측정 스크립트 (`node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write`, desktop)가 쓴 그대로다. 검증: `tests/component/starter-pages.test.tsx`와 시각 골든은 desktop에서 돌린다(PR 본문). Refs: 1112/04-06
61 lines
4.6 KiB
JSON
61 lines
4.6 KiB
JSON
{
|
|
"schemaVersion": 1,
|
|
"baseline": "config/scale/feature-shape-growth.json",
|
|
"ceilings": {
|
|
"contextMaxFeatures": 200,
|
|
"appMaxContexts": 20
|
|
},
|
|
"summary": "상한은 개수를 제한할 뿐, 검증된 수용량이 아니다. 앱 하나의 실제 한계는 먼저 초기 JavaScript budget이고, 그다음 typecheck 메모리다. Service Worker를 켜면(SERVICE_WORKER: ACTIVE) 그 전에 precache 자산 수 상한(SERVICE_WORKER_BOUNDS.assets)이 올 수 있다. 기능마다 lazy 청크가 늘고 그 전부를 precache하기 때문이다. 기능 하나가 더하는 파일 수는 아래 serviceWorkerPrecache에 있다. 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": "Service Worker precache",
|
|
"verified": "Service Worker를 켜면(SERVICE_WORKER: ACTIVE) dist/assets의 해시 파일을 모두 precache한다. 아래 serviceWorkerPrecache에 지금 템플릿 빌드의 파일 수(assets), 첫 feature가 한 번 더하는 수(firstFeatureAssets), 기존 context에 feature 하나를 더할 때 느는 수(perFeatureAssets), 두 번째 context가 더하는 수(perContextAssets)가 있다. tests/unit/feature-shape-growth.test.ts가 unit 실행마다 Initial JavaScript와 같은 빌드로 잰다",
|
|
"condition": "Initial JavaScript와 같은 빌드. 그 빌드는 Service Worker를 끈 것이라, 켠 빌드는 등록 코드의 파일만큼 더 많다",
|
|
"notVerified": "feature가 몇 개까지 precache 자산 수 상한(src/contracts/service-worker.ts의 SERVICE_WORKER_BOUNDS.assets) 안에 드는지. 상한에서 assets와 firstFeatureAssets를 빼고 perFeatureAssets로 나눈 값이다(새 context마다 perContextAssets를 더한다). 상한과 precache 범위는 Service Worker 계약이다"
|
|
},
|
|
{
|
|
"axis": "Routes",
|
|
"verified": "feature 하나에 3개(list, detail, create). 충돌 없이 조합된다",
|
|
"condition": "위와 같음",
|
|
"notVerified": "runtime의 router 매칭 비용"
|
|
}
|
|
],
|
|
"initialJavascript": {
|
|
"gzipBytes": 194143,
|
|
"files": 15,
|
|
"firstFeatureGzipBytes": 6192,
|
|
"perFeatureGzipBytes": 521,
|
|
"perContextGzipBytes": 28
|
|
},
|
|
"serviceWorkerPrecache": {
|
|
"assets": 22,
|
|
"firstFeatureAssets": 14,
|
|
"perFeatureAssets": 12,
|
|
"perContextAssets": 0
|
|
}
|
|
}
|