Files
clean-architecture-frontend…/config/scale/feature-shape-ceilings.json
T
DongHyeonka 241a246354 fix(create-feature): 생성 기능이 scope fence로 끝난 요청을 실패로 보고하지 않는다
생성 기능의 입력(create<Base>FeatureInput)은 실패한 읽기를 telemetry
warning(<base>.list.failed 등)으로 보낸다. 그런데 abort 판정이
REQUEST_ABORTED 하나뿐이다. 로그아웃·계정 전환의 scope fence로 끝난
요청은 SCOPE_GENERATION_CHANGED로 오므로 실패로 보고된다. 테스트 전략
7.1절은 abort를 telemetry 실패로 세지 않는다고 적는다.

고른 방법: abort 판정을 src/contracts/errors.ts의 isAbortFailure 하나로
두고(REQUEST_ABORTED, SCOPE_GENERATION_CHANGED), 생성 입력이 그것을
부른다. 생성 입력 시험에 fence 경우를 더한다. 버린 대안: 생성 템플릿에
kind 둘을 적기(판정이 기능마다 사본이 된다).

생성 기능 API가 isAbortFailure를 가져오면서 기능 모양 측정의 초기
JavaScript가 바뀌었다(context 하나당 4 B → 21 B, 허용치 16 B를 넘어 기록 시험이
실패했다). 생성 코드를 바꾼 변경과 같은 커밋에서 측정 스크립트(--initial-baseline
--write)로 기록을 다시 썼다.

위험·한계: 이미 생성한 기능은 바뀌지 않는다. CHANGELOG에 그 두 줄을
옮기는 안내를 적는다. isAbortFailure는 contracts의 새 export다(추가만).

검증: tests/unit/abort-failure.test.ts, create-feature.test.ts의 새
시험이 고치기 전 코드에서 실패하고 고친 뒤 통과한다. 생성 기능 안의 새
시험은 FE-GATE-020 scaffold 드릴이 돈다(PR 본문).

Refs: 1112/01-03
2026-11-13 04:08:19 +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": 6355,
"perFeatureGzipBytes": 528,
"perContextGzipBytes": 21
}
}