diff --git a/CHANGELOG.md b/CHANGELOG.md index 477db6ab..eaecde1b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,8 +7,8 @@ - **[보안]** 복사한 프로젝트도 가져가야 하는 보안·개인정보 수정이다. - **[계약]** 백엔드, 배포 설정, CI, 또는 기능 코드가 함께 바뀌어야 하는 변경이다(헤더, 변수, 게이트, 공개 포트). - 표시가 없으면 템플릿 안에서 끝나는 수정이다. -- 괄호 안 ID는 리뷰 발견 ID다. `MMDD/NN-MM`으로 적는다. `MMDD`는 리뷰 폴더 `docs/reviews/YYYY-MM-DD-maturity-review/`의 월일이고, 근거와 재현 조건은 그 폴더의 영역 문서에 있다. 라운드마다 `NN-MM`을 새로 매기므로 같은 `14-02`라도 라운드가 다르면 다른 결함이다. `F-N`은 그 라운드 `FOLLOW-UP.md`의 ID다. `tests/unit/changelog-review-ids.test.ts`가 라운드 없는 ID를 막는다. -- 0.2.0의 커밋 해시는 브랜치 `fix/maturity-review-2026-09-25` 기준이다. 그 뒤 절은 절 머리에 기준 브랜치를 적는다. 병합 방식에 따라 `main`에서는 해시가 다를 수 있으니 ID로 찾는다. 0.2.0의 커밋 제목은 라운드 없이 ID만 적었다(`git log --grep '03-03'`). +- 괄호 안 ID는 리뷰 발견 ID다. `MMDD/NN-MM`으로 적는다. `MMDD`는 리뷰 폴더 `docs/reviews/YYYY-MM-DD-maturity-review/`의 월일이고, 근거와 재현 조건은 그 폴더의 영역 문서에 있다. 복사한 프로젝트가 README대로 `docs/reviews/`를 지웠다면 이 폴더와 `PRODUCT.md`는 원본 템플릿 repo에서 찾는다. 라운드마다 `NN-MM`을 새로 매기므로 같은 `14-02`라도 라운드가 다르면 다른 결함이다. `F-N`은 그 라운드 `FOLLOW-UP.md`의 ID다. `tests/unit/changelog-review-ids.test.ts`가 라운드 없는 ID를 막는다. +- 0.2.0의 커밋 해시는 브랜치 `fix/maturity-review-2026-09-25`에서 만들었고, `main`에서도 같은 해시로 찾을 수 있다(2026-11-03에 52개 모두 확인). 그 뒤 절은 절 머리에 기준 브랜치를 적는다. 0.2.0의 커밋 제목은 라운드 없이 ID만 적었다(`git log --grep '03-03'`). ## 미출시 — 브랜치 `fix/ui-design-audit-2026-11-01` @@ -64,7 +64,36 @@ | [계약] | 전송 전 거절의 원인이 진단에 남고, 연결 실수·멱등 키 위반은 `VALIDATION_REJECTED` 대신 `UNKNOWN_CLIENT_FAILURE`로 나온다. 그 실패의 화면 문구가 "요청을 처리할 수 없습니다."로 바뀐다 (1101/03-02) | `src/adapters/http/` | `4da0466` | | [계약] | Vitest가 CI에서 skip·todo·only가 남은 실행을 실패시킨다(`-t`나 `file:line`으로 좁힌 실행은 제외). quarantine 주석이 붙은 skip도 실패한다(`docs/testing/frontend-platform-testing-strategy.md` 16.5절) (1101/10-04) | `vitest.config.ts`, `tests/support/` | `95e7d11` | | [계약] | 시각 회귀 허용치가 비율 0.2%에서 절대 50 px로 바뀌었다. 전에는 잘린 선택 상자(UI-04, 1,145 px)도 통과했다 (1101/11-03) | `playwright.visual.config.ts` | `5ce3db9` | -| [계약] | file-transfer 레시피 번들 예산이 55,700 → 56,100 gzip B로 올랐다(측정 56,031). 01-01·01-04·02-01·0929/01-01 수정분이다. 예산 인상은 소유자가 다시 검토한다 | `config/recipes/frontend-capability-recipes.json` | `95e4445` 외 | +| [계약] **BREAKING** | `useApplicationMutation`이 raw `{ execute, definitionId }` 입력을 받지 않는다. `useServerStateScope()`의 scope로 만든 `BoundMutation`(definitionVersion·operationId·requiresIdempotencyKey·owner·duplicatePolicy·invalidate)을 넘기고 `execute(input, { signal, intent })`로 부른다. raw query는 남았다. raw query는 세션이 바뀌면 이전 결과가 보이지 않는다(JSDoc에 위험 표기). LEGACY 실행 분기는 legacy 전용 테스트 때문에 남겼다 (1101/08-03) | `src/presentation/adapters/query/application-query.ts`, `tests/helpers/legacy-application-query-harness.ts` | `1fa5f3e` | +| [계약] **BREAKING** | recipe의 browser-file·OPFS·storage durability·cache 타입 중 `src`와 이름이 같은 34개는 `src` 타입을 다시 내보낸다. fake는 `src` port를 구현하고 `BrowserDataResult`를 돌려준다. `MemoryDurableObjectStore` 생성자가 바뀌었고 `DurableObjectDataClass`·`DurableObjectIntegrity`·`DurableObjectRead`·`ObjectStoreRecoverySummary`는 지웠다. offline-indexeddb recipe를 쓰는 프로젝트만 해당 (0929/05-03) | `recipes/frontend-capabilities/` | `e1a4580` | +| [계약] | 제품은 `runtime-adapters.ts`를 고치지 않는다. 추가 capability(`FeaturePlatformCapabilities` 확장, indexedDb 포함)와 인증 프로필별 자격증명 제공자는 `src/bootstrap/product-composition.ts`에서, 제품 인증 프로필과 런타임 설정 키(zod)는 `src/contracts/product-contracts.ts`에서 돌려준다. 자격증명 순서는 scope fence → ANONYMOUS → 제품 제공자 → 세션 → fence 재확인이다. 그동안 `runtime-adapters.ts`·`feature-adapter-contribution.ts`·`rest-profiles.ts`·`release-artifacts.ts`·`runtime-config-schema.ts`에 넣은 제품 코드를 이 두 파일로 옮긴다 (1101/09-02) | `src/bootstrap/product-composition.ts`, `src/contracts/product-contracts.ts`, `src/bootstrap/runtime-adapters.ts` | `da1e128` | +| [계약] | 기능 계약에 route id `APP_HOME`을 선언하면 플랫폼 홈을 대신한다. 둘이 선언하면 두 기능 id를 적고 실패한다. `src/contexts//context-layout.tsx`가 `CONTEXT_LAYOUT`을 내보내면 그 context의 라우트가 AppShell 대신 그 레이아웃 아래에 놓인다. 레이아웃은 skip link와 `
` 하나를 가져야 한다 (1101/09-03) | `src/contracts/routes.ts`, `src/contexts/bounded-context-module.ts`, `scripts/generate-product-feature-index.ts` | `ca16187` | +| [계약] | context 라우트 적재 때 기능 계약에 없는 handle routeId가 있으면 route id·context id·기능 id를 담은 오류로 실패한다 (1101/09-06) | `src/contexts/bounded-context-module.ts`, `src/apps/deployable-app-module.ts` | `d6e4e51` | +| [계약] | 인증 프로필 `REFERENCE_EXTERNAL_BEARER`의 새 이름은 `EXTERNAL_BEARER`다. 옛 이름은 한 릴리스 동안 `@deprecated` 별칭으로 남는다 (1101/16-03) | `src/contracts/rest-profiles.ts` | `6c5818f` | +| [계약] | `CREDENTIAL_HEADER_NAMES`에 `x-xsrf-token`을 더했다. 짝 백엔드(Spring `CookieCsrfTokenRepository`)의 기본 CSRF 헤더다 (1101/09-02) | `src/contracts/rest-profiles.ts` | `183a4a3` | +| [계약] | V2 Envelope에 `data` 키가 없으면 `null`로 읽는다. `meta.requestId`·`traceId`는 선택이다. 짝 백엔드는 null 필드를 생략한다 (백엔드 리뷰 1101/02-02) | `src/adapters/http/schema-registry.ts` | `969979d` | +| [계약] | V2: 422 `IDEMPOTENT_REQUEST_MISMATCH`·400 `IDEMPOTENCY_KEY_INVALID`가 `effect: "NOT_APPLIED"`와 진단 reason을 싣는다. 409의 `Retry-After`는 `retryAfterMs`로 실린다(V3 PROBLEM 실패도 같다). 결과 불명 요청을 같은 키로 다시 보낼 때 그 시각까지(최대 5초) 기다린다. 응답 code의 정본은 백엔드 템플릿 `docs/web/http-contract.md` §2다 (백엔드 리뷰 1101/02-01) | `src/adapters/http/client.ts`, `src/adapters/http/feature-http-binding.ts`, `src/presentation/adapters/query/application-query.ts` | `93782b0`, `47fec5c` | +| [계약] | V2 클라이언트가 짝 백엔드의 400 `VALIDATION_FAILED`(필드 목록 `details: [{field, code, message}]`)를 422와 같은 `VALIDATION_REJECTED`·`validationIssues`로 읽는다. 필드 검증 거절(422와 이 400)은 `effect: "NOT_APPLIED"`다. 전에는 결과 불명으로 붙들어 폼에서 값을 고쳐도 다시 저장할 수 없었다. 그 밖의 400·409는 그대로 결과 불명이다 (백엔드 리뷰 1101/02-01) | `src/adapters/http/client.ts`, `src/contracts/errors.ts` | `02e35d2`, `64e98ee` | +| [계약] | V3 실행 결과에 선택 필드 `sentRequestId`가 생겼다. 서버가 `x-correlation-id`를 돌려주지 않으면 `AppFailure.requestId`는 보낸 값이다. 결과 불명·조회 실패 화면에 "지원 참조" 줄이 보인다 (0929/03-04) | `src/adapters/http/http-execution-v3.ts`, `src/adapters/http/feature-http-binding.ts` | `849d000` | +| [계약] | `ResumableUploadPort.upload()`: part 발급(BFF)이 401/403으로 거절하면 recovery가 `RESUME` 대신 `NONE`(`retryable: false`)이다. 세션 만료·권한 회수라 재인증 전에는 다시 불러도 같다. object store PUT 403은 그대로 `RESUME`이다 (0929/01-01) | `src/adapters/browser-transfer/resumable-upload/resumable-upload-runtime.ts` | `c5f87aa` | +| [계약] | realtime stream coordinator의 effect·recovery·close 마감 실패가 `IDLE_TIMEOUT` 대신 `APPLY_FAILED`/`APPLY`, `PROVIDER_UNAVAILABLE`/`RECOVER`, `PROVIDER_UNAVAILABLE`/`CLOSE`로 나온다. `RealtimeObservation.reason`도 같다 (1101/04-02) | `src/adapters/realtime/stream-coordinator.ts` | `1196b86` | +| [계약] | OPFS journal 목록이 손상 행을 건너뛰고 `corruptRows`로 센다. reconcile은 `corruptTransactions`를 보고한다. 손상 때문에 끝나지 못한 승인된 LOGOUT·ACCOUNT_DELETION은 partition을 지우고 `partitionDeleted`를 보고한다. `OpfsJournalPort.removePartition`과 worker gateway `removePartition`이 필수 메서드로 추가됐다 (0929/05-01) | `src/adapters/storage/opfs/` | `72edb55` | +| [계약] | `MessageArguments`가 catalog 문자열의 `{이름}`에서 파라미터를 만든다(값은 string 또는 number). `MessageParameters`는 값 타입을 좁히는 덮어쓰기이고, `ParameterlessMessageKey`는 자리표시자 없는 키만이다 (0929/08-03) | `src/presentation/i18n/message-contract.ts` | `ff33d58` | +| [계약] | `check:i18n`은 catalog parity와 raw backend 메시지만 검사한다. 화면 문구 literal은 ESLint `screenTextSelectors`가 잡는다. 한글 주석은 통과하고, 영어 JSX 문구·접근성 이름은 실패한다. template literal·삼항식·객체 prop 문구는 못 본다 (0929/08-02) | `eslint.config.ts`, `scripts/check-i18n.ts` | `855d22a` | +| [계약] | design-system primitive를 `src/presentation/design-system/primitives/<컴포넌트>.tsx`로 나눴다. `design-system/index.ts`의 export 목록은 같다. 파일을 직접 import하던 코드는 경로를 바꾼다 (1101/08-08) | `src/presentation/design-system/primitives/`, `vite.config.ts` | `6dd4bc1`, `51941a5` | +| [계약] | `token-contract.ts`에 `PRODUCT_LOADED_FONT_FAMILIES`가 생겼다. 첫 글꼴 규칙이 이 목록의 글꼴을 허용한다 (1101/12-04) | `src/presentation/design-system/tokens/token-contract.ts`, `scripts/lib/design-system-rules.ts` | `b4ccada` | +| [계약] | 지금 diff와 맞지 않는 breaking 증거 행이 있으면 `check:registries`가 그 행을 적고 실패한다. `update:registry-baseline`이 그런 행을 지운다. 다운스트림은 오래된 행을 지우거나 한 번 재승인한다 (0929/07-01) | `scripts/lib/registry-compatibility.ts`, `scripts/update-registry-baseline.ts` | `4ada84e` | +| [계약] | FE-REG-ROUTE가 `paramsSchema`·`searchSchema`를 허용 목록으로 보지 않고, `loadingSurface`는 kebab-case 형식만 본다. 기능 라우트를 더해도 governance를 고치지 않는다. 다운스트림은 목록에 더해 둔 값을 지운다 (0929/07-03) | `config/contracts/registry-governance.json`, `scripts/check-registries.ts` | `e8d7fb4` | +| [계약] | 레지스트리 분류기가 무효화 그래프(topics·namespaces·edges)에 원소를 더하기만 한 변경을 additive로 본다. 빼거나 바꾸면 그대로 breaking이다. 이런 추가에 적어 둔 breaking 증거 행은 stale로 실패하니 `update:registry-baseline`으로 지운다 (0929/07-02) | `scripts/lib/registry-compatibility.ts` | `605fd17` | +| [계약] | 레지스트리 기준선을 한 번 재승인했다. FE-REG-API·FE-REG-SCHEMA `source`를 1101/15-01 뒤 위치로 고쳤고, 그 전 승인 뒤 쌓인 변경도 함께 승인했다. 다운스트림은 동기화 뒤 한 번 재승인한다 (1101/15-01) | `config/contracts/registry-baseline.json` | `70d0ac1` | +| [계약] | staging·production 승인(FE-GATE-027)이 `example.com`·`example.net`·`example.org`와 그 하위 도메인, `.example`·`.invalid`·`.test` endpoint를 거절한다. 프로필을 고치지 않은 운영 빌드는 두 위반으로 거절된다. CI에서 endpoint는 `config/runtime/.json`에 커밋한다 (1101/13-02) | `src/contracts/deployment-admission.ts` | `7b34756` | +| [계약] | staging·production 승인이 자리표시자 계약 신원(digest `PLACEHOLDER_CONTRACT_PACKAGE_DIGEST`)을 거절한다. `findAdmissionViolations`가 세 번째 인자로 계약 패키지를 받는다. `--config` 수정본 검사는 패키지를 보지 않는다 (1101/16-01) | `src/contracts/deployment-admission.ts`, `scripts/check-release-admission.ts` | `1269992` | +| [계약] | workflow의 promotion과 production_gate 사이에 deployment 배포 슬롯 job이 생겼다(job 10개). 슬롯이 비어 있으면 FE-GATE-019가 UNVERIFIED다. FE-GATE-019는 다시 빌드하지 않고 `--release-root .release/promoted-release`를 보며, 배포된 `release-manifest.json`의 buildId·releaseId가 후보와 다르면 FAIL이다. 예전에 PASS하던 FE-GATE-019가 이제 UNVERIFIED 또는 FAIL이다 (1101/13-01) | `.gitea/workflows/quality-gates.yml`, `config/ci/gates.json` | `de379ea` | +| [계약] | `src/contracts/zod-validator.ts`의 `zodValidator`로 zod 스키마를 `RuntimeValidator`로 바꾼다. 검증을 일부러 생략할 때는 `unvalidatedPayload(schemaId, reason)`(`src/contracts/unvalidated-payload.ts`)를 쓴다. 이 검증기에는 `validation: "NONE"` 표시가 붙고, `listUnvalidatedPayloads(composed)`가 조립 결과에서 생략 목록을 만들어 플랫폼 개요 화면이 보여 준다 (1101/07-03) | `src/contracts/zod-validator.ts`, `src/contracts/unvalidated-payload.ts` | `d3ddc89`, `8b7c6eb` | +| [계약] | `pnpm create:feature [--context ] [--package --digest --revision ]`로 기능 뼈대를 만든다. FE-GATE-020이 `test:feature-scaffold`(생성한 기능으로 merge 게이트 15개)를 돈다. `test:sample-removal`은 샘플을 지운 뒤 기능을 생성해 게이트를 다시 돈다 (1101/16-01) | `scripts/create-feature.ts`, `scripts/test-feature-scaffold.ts`, `config/ci/gates.json` | `d166aa3` | +| [계약] | `verify:documentation`(FE-GATE-017)이 입구 문서 4개의 src 최상위 폴더 설명과 `layers.md`의 아키텍처 규칙 이름을 검사한다(`sourceStructure`). `docs/README.md` 1절 현재 계약 문서에 적힌 repo 경로·링크·package script·FE-GATE ID가 실제로 있는지도 검사한다(`documentReferences`). 수동 접근성 범위는 route ID 목록 대신 라우트별 기록 파일로 검사하므로 라우트를 더해도 README·체크리스트를 고치지 않는다. 참조 기능을 지운 복사본은 그 파일을 가리키는 문서를 고쳐야 통과한다 (1101/14-03, 1101/14-05) | `scripts/verify-documentation-readiness.ts`, `docs/README.md` | `61baf96`, `16202fd` | +| [계약] | 규모 설계서를 `docs/architecture/scale-architecture.md`(현재 계약, 절 번호 유지)로 옮겼다. 절마다 현재 계약·기록만 상태와 코드와 다른 점을 적었다. 코드 주석 `Spec §N` 87곳은 `scale-architecture.md §N`으로 바꿨고, 문서 이름 없는 `spec §` 참조는 `tests/unit/deletable-history-documents.test.ts`가 막는다. 지울 수 있는 기록 목록에서 `docs/reviews/adapters/`를 뺐다(INVENTORY와 remediation ledger가 그 안의 리뷰로 링크한다). 복사한 프로젝트는 이 폴더를 지우지 않는다 (1101/14-01) | `docs/architecture/scale-architecture.md`, `README.md`, `docs/README.md`, `tests/unit/deletable-history-documents.test.ts` | `0a7fbed`, `b26517e` | +| [계약] | 레시피 번들 예산을 측정값 + 3%를 100 B 단위로 올린 값으로 다시 정했다: file-transfer 57,800, offline-indexeddb 38,500, realtime 42,200, service-worker-pwa 10,100. 3%를 넘는 증가는 커밋 본문에 이유를 적고 같은 규칙으로 올린다. 규칙은 `docs/architecture/optional-adapter-recipes.md`에 있다. 그 전에 file-transfer가 이 브랜치에서 55,700 → 56,100으로 한 번 올랐다 (0929/05-04) | `config/recipes/frontend-capability-recipes.json` | `95e4445` 외, `313f9ba` | ### 그 밖의 수정 @@ -80,13 +109,25 @@ - 화면: 검색값만 바뀌면 포커스·스크롤·`route.changed`를 건드리지 않는다 (1101/08-02). h2·h3·h4 제목 크기·굵기 (1101/08-04), 한국어 단어 단위 줄바꿈 (1101/08-06), 상태 화면·오류 요약의 제목 수준 지정 (1101/08-05), 예제 화면의 `lang="ko-KR"` (1101/08-07), 폼 저장 실패와 결과 불명 화면의 지원 참조 (0929/08-04) - 진단: context·feature 오류 경계와 라우트 모듈 실패가 진단에 남고, 지원 참조가 `build:incident` 형식이다 (1101/09-09). REST 보안 프로필 오류가 operation과 깨진 조건을 말한다 (1101/16-03) - 테스트·운영 도구: guardian이 실패하면 stdin을 기다리지 않고 바로 끝난다 (G-1). SW e2e가 제품이 이미 켠 worker와 빌드가 만든 사전 캐시 목록을 쓴다 (0929/11-03, 0929/06-04). 이벤트 계약 검증이 실제 이벤트 행으로 고정됐다 (1101/10-01). 규모 측정 기준선을 1101/15-01 뒤 코드로 다시 쟀다. 측정용 기능 복사본은 외부 패키지를 고정하고 선언한다 (`9333595`, 1101/07-04). reference feature를 지워 설치 기능이 0개여도 타입 검사와 `create-application.ts` 커버리지가 통과한다 (`e4ace51`, 1101/15-01) +- 문서: 새 기능 추가 매뉴얼 `docs/manual/`(한국어)을 더했다. 0~11단계마다 정할 것, 판단 기준, 잡는 검사와 못 잡는 것을 적고, 결정표·기능 폴더 밖 파일·`create:feature` 인자·전역 ID·패턴·오류 메시지 참조를 둔다. 두 템플릿 공통 원칙은 design-docs repo `conventions/feature-design-principles.md`에 있다. `verify:documentation`이 매뉴얼의 경로·명령·게이트 ID를 검사한다 (1101/16-01) +- 성능: 갤러리 전용 primitive를 초기 청크에서 빼 초기 JS를 2,718 B 줄였다. 초기 청크는 16 → 25개가 됐다. HTTP/1.1로 호스팅하면 청크 수를 다시 본다 (1101/08-08) +- 테스트: 플랫폼 component 테스트가 스타터 화면 대신 테스트 전용 페이지(`tests/helpers/fixture-feature.tsx`)를 쓴다. 스타터 화면을 바꾸는 제품은 `tests/component/starter-*.test.tsx`를 함께 지운다. HTTP 시나리오 증거(FE-GATE-007)와 기능 API 타입 음성 fixture(FE-GATE-003)는 샘플을 지워도 남는다. `tests/mocks/handlers/reference-resources.ts`는 `tests/features/reference-feature/reference-resource-handlers.ts`로 옮겼다 (0929/10-02) +- 테스트: 기능 테스트가 `createHttpScenarioHandler(<설치 계약>, { scenario, payload })`로 공유 MSW 시나리오를 쓴다. 기능을 더해도 카탈로그와 기능 밖 테스트를 고치지 않는다. `tests/mocks/**`는 플랫폼 소유다 (1101/16-02, 1101/16-01) +- 참조 기능: 샘플 페이지가 경로 문자열 대신 `referenceRouteUrl(routeId, input)`으로 링크를 만들고 route 입력 cast를 없앴다. `REFERENCE_FEATURE_ROUTE_CODECS`는 `presentation/reference-route-codecs.ts`로 옮겼다. 목록 링크 href가 `?limit=20`이 붙은 정식 URL이 된다 (1101/16-04) +- 저장소: OPFS purge가 여러 페이지를 다 지우면 끝났다고 보고하고 chunk sweep을 한다. 전에는 한 번 더 불러야 끝났다 (README 13.6) +- 운영 도구: 적재에 실패한 레지스트리 source는 "missing" 대신 그 오류 메시지를 적는다. `check:feature-index` 예외 이유를 실제 사용처로 고쳤다 (1101/12-05). 워커를 싣는 빌드의 SW 스크립트 헤더 검사를 테스트로 고정했다 (0929/06-05) ### 알려진 제한 -- `config/contracts/registry-baseline.json`의 FE-REG-API·FE-REG-SCHEMA `source`가 1101/15-01 뒤에도 `src/features/installed-feature-contracts.ts`를 가리킨다. 승인 digest가 걸려 있어 소유자가 재승인할 때 고친다. `check:registries`는 통과한다. -- 0929/03-01의 백엔드 계약(처리 중 재전송의 status·code, 충돌 409 code 목록)은 이 repo에서 끝나지 않았다. -- OPFS의 LOGOUT·ACCOUNT_DELETION purge가 두 페이지 이상이면, 다 지워도 `moreObjectsAvailable: true`를 보고하고 chunk sweep을 하지 않는다. 한 번 더 부르면 끝난다. 이 브랜치 전부터 있던 동작이고 코드로만 확인했다 (1101 README 13.6). -- 실제 Gitea runner에서는 돌리지 않았다(SPEC U-1). 시각 테스트의 글꼴 패키지 설치 단계는 workflow에 넣지 않았다. nginx 예시는 실행해 보지 않았다. +- 백엔드 응답 code 정본(`clean-architecture-backend-template/docs/web/http-contract.md`)은 아직 백엔드 repo에 커밋되지 않았다. 그래서 프론트 계약 문서는 커밋 SHA 대신 결정일로 기준을 적었다. 백엔드 application 층이 쓰기 뒤에 `VALIDATION_FAILED`를 던지면 "적용 안 됨" 판정이 틀린다. 지금 백엔드는 이 code를 요청 바인딩 단계에서만 낸다. +- 백엔드 필드 검증 code(`NOT_BLANK`, `SIZE` 등)가 폼 문구 표에 없어 "입력값을 확인해 주세요." 기본 문구가 나온다. V3 실행기 진단에는 problem code가 없다. +- context 레이아웃의 skip link와 `
`은 타입 주석·문서·테스트로만 지킨다. 실행 검사는 없다 (1101/09-03). +- OPFS: lease 밖(FINISH~commit)에서 다른 탭이 같은 partition에 쓰는 경합은 검증하지 않았다 (0929/05-01). +- realtime: live-poll handoff coordinator의 마감 4곳은 아직 `IDLE_TIMEOUT`이다 (1101/04-02 범위 밖). +- 등록 라우트가 없는 URL에서 적재가 실패하면 진단 route_id가 `NOT_FOUND`다 (1101/09-09). +- `ui-gallery-page.tsx`는 component 테스트 커버리지가 0%다. e2e와 시각 테스트만 본다. +- `create:feature --context reference-context`로 만들면 참조 기능 라우팅 테스트가 깨진다. 생성 명령은 기본으로 새 context를 만든다. +- 실제 Gitea runner와 실제 HTTPS 호스트에서는 돌리지 않았다(SPEC U-1). FE-GATE-019 배포 슬롯은 주입한 fetcher로만 시험했다 (1101/13-01). 시각 테스트의 글꼴 패키지 설치 단계는 workflow에 넣지 않았다. nginx 예시는 실행해 보지 않았다. ## 0.2.0 — 태그 `v0.2.0` (2026-09-27) diff --git a/docs/reviews/2026-11-01-maturity-review/README.md b/docs/reviews/2026-11-01-maturity-review/README.md index c4b71561..542a86eb 100644 --- a/docs/reviews/2026-11-01-maturity-review/README.md +++ b/docs/reviews/2026-11-01-maturity-review/README.md @@ -443,3 +443,74 @@ | 13-01 | (c) live probe가 배포된 `buildId`·`releaseId`를 승격 후보와 비교한다. `production_gate`는 다시 빌드하지 않고 후보 `dist`를 본다. 비어 있는 배포 슬롯 job을 선언하고, 비어 있으면 `UNVERIFIED`로 끝난다 | 지금 PASS는 "떠 있는 이전 release가 맞다"는 거짓 PASS다. CD 자동화(로드맵 6)의 전제다 | (b) 비교만(운영 단계가 항상 FAIL), (d) 별도 workflow(Gitea에서 run 간 artifact 전달 미검증) | | 13-02 | 예약 이름(`example.*`, `.example`, `.invalid`, `.test`)을 공개 대상 승인에서 거절하고 README 예시 URL을 빈칸으로 바꾼다 | 자리표시자 endpoint가 운영 승인을 받는다 | 프로필 기본값 비우기(예시로 읽히지 않고 세 프로필을 다 바꿔야 함) | | 13.6 OPFS 여러 페이지 purge | 고친다. 0929/05-02의 "건너뛴 객체가 있으면 true" 규칙은 지키고, 페이지 넘김 때문에 생긴 true만 없앤다 | 다 지웠는데 남았다고 보고하고 sweep을 건너뛴다 | — | + +### 14.2 결과 (2026-11-03, 브랜치 `fix/ui-design-audit-2026-11-01`) + +결정마다 RED 테스트를 먼저 쓰고 고쳤다. "충족"은 그 테스트와 아래 14.5의 게이트가 통과했다는 뜻이다. + +| ID | 상태 | 커밋 | 막는 테스트·검증, 결정과 다르게 한 것 | +|---|---|---|---| +| 09-02 | 충족 | `da1e128`, `3e58cad`, `183a4a3` | 제품 소유 파일 `src/bootstrap/product-composition.ts`, `src/contracts/product-contracts.ts`. 자격증명 순서 테스트(`tests/unit/runtime-adapters-credential-order.test.ts`). 짝 백엔드 CSRF 헤더 `x-xsrf-token`을 닫힌 헤더 목록에 더했다 | +| 09-03 | 충족 | `ca16187` | `APP_HOME` 대체와 `context-layout.tsx`. 레이아웃의 skip link·`
`은 실행 검사가 없다(14.4) | +| 08-08 | 충족 | `6dd4bc1`, `51941a5` | 초기 JS 203,818 → 201,100 B(−2,718). 초기 청크는 결정 때 예상한 21이 아니라 25개다. boot closure 그룹이 갤러리 primitive를 다시 초기로 끌어와 그룹으로 줄이지 못했다 | +| 08-03 | 충족 | `1fa5f3e` | 공개 overload에서 raw mutation 입력을 뺐다(**BREAKING**). LEGACY 실행 분기는 legacy 전용 테스트 4건 때문에 남겼다. raw query는 세션 교체 때 트리를 내려 이전 결과가 보이지 않음을 테스트로 고정하고 남겼다 | +| 0929/01-01 ④ | 충족 | `c5f87aa` | 새 출처 필드 대신 발급 실패 분기가 직접 `NONE`을 만든다. 출처 필드는 공개 타입 `BrowserDataFailure`를 바꾸고, WeakSet 표시는 숨은 결합이라서다 | +| 0929/03-04 | 충족 | `849d000` | `sentRequestId`. 응답 없는 실패 화면에 "지원 참조" 줄이 새로 보인다 | +| 0929/05-01 | 충족 | `72edb55` | `corruptRows`, `REMOVE_PARTITION`. lease 밖 다른 탭 경합은 미검증(14.4) | +| 0929/05-03 | 충족 | `e1a4580` | 이름이 겹친 34개를 `src` 재수출로 바꿨다(**BREAKING**). `MemoryStructuredOfflineStore`는 recipe 전용 fake로 남겼다 | +| 0929/05-04 | 충족 | `313f9ba` | 측정값 + 3%를 100 B 단위로 올렸다. 규칙과 측정 표는 `docs/architecture/optional-adapter-recipes.md` | +| 0929/06-05 | 충족 | `1b6c9a5` | 구현은 `629c8f0`에 이미 있었다. 테스트만 더했다 | +| 0929/07-01 | 충족 | `4ada84e` | 맞지 않는 증거 행을 적고 실패한다. 오래된 증거 14행을 지웠다 | +| 0929/07-02 연장 (결정 1) | 충족 | `605fd17` | 무효화 그래프에 더하기만 한 변경은 additive | +| 0929/07-03 | 충족 | `e8d7fb4`, `70d0ac1` | 기준선 재승인 1회(digest `3c3702b5…`, 승인자 `DongHyeonka`). 이전 승인 뒤 쌓인 08-13·05-01·13-15·06-05 변경과 `source` 경로 수정도 같이 승인했다 | +| 0929/08-02 | 충족 | `855d22a` | ESLint 선택자. template literal·삼항식·객체 prop 문구는 못 본다 | +| 0929/08-03 | 충족 | `ff33d58`, `6255f05` | 타입 비용 Types +0.9%, Instantiations +3.8% | +| 0929/10-02 | 충족 | `ca74caa`, `498ae87` | 샘플을 지워도 남는 증거가 4 → 20개 | +| 04-02 | 충족 | `1196b86` | live-poll handoff 마감 4곳은 범위 밖이라 `IDLE_TIMEOUT` 그대로(14.4) | +| 09-06 (3) | 충족 | `d6e4e51` | 적재 때 route id·context id·기능 id를 적고 실패 | +| 16-03 | 충족 | `6c5818f` | 옛 이름은 `@deprecated` 별칭 한 줄. 테스트가 그 한 줄만 남았는지 본다 | +| 12-04 | 충족 | `b4ccada` | `PRODUCT_LOADED_FONT_FAMILIES` | +| 12-05 | 충족 | `6ceb847` | 이유 문구만 고쳤다 | +| 10-04 | 유지 | — | 정책 변경 없음 | +| registry-baseline `source` | 충족 | `70d0ac1` | 0929/07-03 재승인과 같이 | +| 13-01 | 충족(단위 테스트) | `de379ea` | 배포 슬롯 job과 `--release-root`. 실제 runner·HTTPS 호스트에서는 돌리지 않았다(14.4) | +| 13-02 | 충족 | `7b34756` | 예약 이름 거절 | +| 13.6 | 충족 | `c4052f0` | 여러 페이지를 다 지운 purge가 끝났다고 보고한다 | + +개선 순서 3(매뉴얼·생성 명령): + +| ID | 상태 | 커밋 | 막는 테스트·검증 | +|---|---|---|---| +| 14-03 | 충족 | `61baf96` | 입구 문서 4개가 같은 src 9폴더를 말하고 `verify:documentation`이 검사한다 | +| 14-05 | 충족 | `16202fd` | 현재 계약 문서의 경로·링크·script·FE-GATE ID 실재 검사. 문서의 route ID 목록을 지웠다 | +| 1101/07-03 | 충족 | `d3ddc89`, `8b7c6eb` | 공유 `zodValidator`, `unvalidatedPayload(schemaId, reason)`. 생략 목록 계산은 부팅 경로 밖에 둬 기능 1개 증가를 1 KiB 아래(+958 B)로 지켰다 | +| 16-02 | 충족 | `5d064b8` | `createHttpScenarioHandler(<설치 계약>)`. `tests/mocks/**`는 플랫폼 소유 | +| 16-04 | 충족 | `ee81c44` | 기능 안에 `"/examples/` 링크 문자열과 route 입력 cast 0건 | +| 14-01 | 충족 | `0a7fbed`, `b26517e` | 설계서를 `docs/architecture/scale-architecture.md`로 옮기고 절 상태를 적었다(현재 계약 51, 기록만 4, 차이 메모 18절). 차이는 타입·머리 주석·테스트 이름으로 대조했고 동작은 실행하지 않았다. 이름 없는 참조는 리뷰가 센 68곳이 아니라 87곳(74파일)이었다. 지운 뒤 실험: 끊긴 링크 148 → 0, 이름 없는 참조 87 → 0. INVENTORY가 링크하는 리뷰가 지우기 범위 안이라 지우기 목록에서 `docs/reviews/adapters/`를 뺐다 | +| 16-01 | 충족 | `7450e1f`, `6ea9e4a`, `1269992`, `d166aa3` | `pnpm create:feature`. FE-GATE-020의 `test:feature-scaffold`가 생성한 기능으로 merge 게이트 15개를 돈다. `test:sample-removal`이 샘플을 지운 뒤 생성 단계를 다시 돈다(결정 4). 자리표시자 계약 신원은 공개 대상 승인이 거절한다(결정 2) | + +짝 백엔드 계약 맞추기(백엔드 리뷰 `1101/02-01`·`02-02`, 이 repo의 같은 번호와 다르다): `969979d`, `93782b0`, `47fec5c`, `3b7d73a`, `02e35d2`, `64e98ee`. 응답 code의 정본은 백엔드 템플릿 `docs/web/http-contract.md` §2다. + +### 14.3 이번에 새로 찾은 것 + +| 무엇 | 근거 | 처리 | +|---|---|---| +| V2 클라이언트가 필드 검증 거절(422, 400 `VALIDATION_FAILED`)을 결과 불명으로 붙들어, 폼에서 값을 고쳐도 다시 저장할 수 없었다 | 재현 테스트(`64e98ee` 본문). V3 참조 경로는 `classifyProblem`이 `NOT_APPLIED`라 재현되지 않았다 | 고쳤다(`64e98ee`). 판정 근거는 "백엔드가 이 code를 요청 바인딩 단계에서만 낸다"는 추론이다 | +| 적재에 실패한 레지스트리 source를 "missing registry source"로만 적어, 기능 계약의 깨진 import가 파일 없음처럼 보였다 | U6·U3 후속을 합칠 때 실제로 겪었다 | 고쳤다(`3ea7c37`, 새 테스트) | +| 등록 라우트가 없는 URL에서 적재가 실패하면 진단 `route_id`가 `NOT_FOUND`다 | NOT_FOUND splat이 모든 URL에 맞아 gateway의 `?? routeModule.id`를 쓰지 않는다 | 남김(14.4) | +| `tests/e2e/reference-route.spec.ts`가 세 엔진에서 실패했다. 0929/08-02가 목록 h1을 "참조 기능"으로 바꿨는데 테스트는 영어 route 제목을 기다렸다. 그 수정 때 e2e를 돌리지 않았다 | 14.5 첫 e2e 실행. 화면은 정상(스크린샷) | 고쳤다(`87aebf4`) | +| `check:remediation-ledger`가 기준 커밋에서도 4건 실패했다(게이트 밖) | 예산 1건은 `313f9ba`로 풀렸다. 테스트가 TR-02~04 ID를 적지 않는 3건은 남았다 | 남김 | + +### 14.4 남은 문제와 위험 + +- 백엔드 응답 code 정본(`docs/web/http-contract.md`)이 백엔드 repo에 아직 커밋되지 않았다. 프론트 계약 문서는 SHA 대신 결정일로 기준을 적었다. +- "검증 거절은 적용 안 됨" 판정: 백엔드 application 층이 쓰기 뒤 `VALIDATION_FAILED`를 던지면 틀린다. 필드 목록 없는 400 `VALIDATION_FAILED`와 그 밖의 400·409는 여전히 결과 불명이다. +- 백엔드 필드 검증 code(`NOT_BLANK`, `SIZE` 등)가 폼 문구 표에 없어 기본 문구가 나온다. V3 실행기 진단에 problem code가 없다. +- 09-03: 레이아웃의 skip link·`
`은 실행 검사가 없다. 플랫폼 라우트와 같은 경로의 기능 라우트를 검사하지 않는다. +- 09-02 이식: env.ts의 FE-REG-ENV 행과 tech-log의 부트 전 BFF owner 설치는 아직 템플릿 파일 수정이 필요하다. 다운스트림 이식은 하지 않았다. +- 0929/05-01: lease 밖(FINISH~commit) 다른 탭 경합은 검증하지 않았다. +- 13-01: 실제 runner·HTTPS 호스트 probe는 돌리지 않았다. +- 04-02: live-poll handoff 마감 4곳은 `IDLE_TIMEOUT` 그대로다. +- `ui-gallery-page.tsx` component 커버리지 0%(e2e·시각만). +- 초기 청크 25개. HTTP/1.1 호스팅이면 다시 본다. +- `create:feature --context reference-context`는 참조 라우팅 테스트를 깬다. 생성한 `context-module.ts`는 테스트가 실행하지 않는다.