Files
clean-architecture-frontend…/tasks/todo.md
T

215 lines
13 KiB
Markdown

# Tasks: 성숙도 리뷰(2026-09-25) 전 항목 반영
작업 ID는 리뷰의 발견 ID다. 문제 설명·근거·검증 방법은 `docs/reviews/2026-09-25-maturity-review/<영역 문서>`의 같은 ID 항목을 본다. 결정은 `SPEC.md` "결정" 표(D-x), 실행 방식은 `tasks/plan.md`를 따른다.
## 모든 작업에 공통인 검증
- RED: 재현 테스트가 수정 전에 실패한다(문서만 바꾸는 작업은 제외)
- GREEN: 해당 테스트 파일 통과 — `node scripts/run-vitest.ts run <test file>`
- 게이트 통과 — `corepack pnpm check:architecture && corepack pnpm check:types && corepack pnpm lint && corepack pnpm test:unit && corepack pnpm test:component && corepack pnpm test:integration && corepack pnpm test:contract && corepack pnpm test:runtime-schema`
- adapter 파일을 추가·이동했으면 `docs/reviews/adapters/INVENTORY.md` 갱신 + `corepack pnpm check:adapter-inventory`
- 커밋 1개. 메시지에 발견 ID. 그 작업의 파일만 스테이징
---
## Phase 0 — 게이트·CI 기반 (순차, 레인 Z)
- [x] 10-01 새 clone에서 `test:unit` 통과 — 완료: `removal-fixture.test.ts`가 임시 폴더의 가짜 증거로 검사. 새 worktree에서 `test:unit` 통과
- [x] 00-01 fixture가 공유 `node_modules`의 pnpm 상태 파일을 덮어쓰지 않음 — 완료: 통합 테스트 전후 원본 상태 파일 해시 동일
- [x] 14-01 샘플 제거 게이트 복구 — 완료: 플랫폼 테스트 6개가 샘플 대신 테스트 전용 기능·platform route 사용. `test:sample-removal` PASS(13 testcase 성공)
- [x] 14-02 CI 계약 기준값 외부화 (D-13) — 완료: `config/ci/contract-baseline.json` + `update:ci-contract-baseline`. 샘플 제거 fixture가 `CI_CONTRACT_MODE` 없이 canonical `check:ci`·`check:registries` 통과
- [x] 12-02 · 13-01 workflow가 job의 모든 gate 실행 — 완료: workflow에 `ci:gate -- FE-GATE-027`. 계약 검사가 run step 누락 변형을 거부. `APP_PROFILE`≠`RELEASE_TARGET`이면 실패. 변수 문서화
- [x] 12-01 (repo 쪽, D-17) — 완료: push 트리거에 `main`. README에 CI 상태와 머지 전 로컬 명령
- [x] 12-04 · 09-11 CI 밖 테스트·검사 연결 — 완료: `tests/architecture`·`release`·`scripts`·`features` 최상위·`scale/browser-soak.contract`·`scripts/verify-extreme-scale`과 `check:adapter-inventory`, image fixture가 게이트에 연결. 고아 테스트를 잡는 계약 검사와 음성 fixture
### Checkpoint 0
- [x] 공통 게이트 + `check:ci` + `test:sample-removal` + `build` 통과
---
## 레인 A — browser-transfer (`01-adapters-browser-transfer.md`)
- [x] 01-01 PUT 401/403·만료 → capability 재발급 재시도
- [x] 01-04 같은 idempotency key 재사용 테스트 3개 — 완료: 변이 M1·M6·M7 검출
- [x] 01-02 완료·결과 불명 업로드 보고 — 완료: complete 성공 뒤 정리 실패도 성공 반환, `abort()` ALREADY_COMPLETED에 resourceId
- [x] 01-03 크기·진행 기반 전송 제한 — 완료: 1Mbit/s 모의에서 5MiB part 성공, 멈춘 연결은 idle 제한 안에 끊김
- [x] 01-05 recovery → 행동 1:1 — 완료: ABORT_PENDING과 CAS 충돌 실패값 구분, port 주석 표
- [x] 01-06 `maxClockSkewMs` — 하한 skew는 사용자 결정(2026-09-28)으로 문서 조건 유지, 상한만 반영
- [x] 01-07 vault 항목 `finally` 정리 — 검증 후 보완: 모든 종료 경로 0f35c98
- [x] 01-08 재개 시 정책 재검사 제거
- [x] 01-09 part 수 상한 × 전송 상한 교차 검사
- [x] 01-10 `UPLOAD_PART` 관측 1건 + 시도 수 bucket
- [x] 01-11 image probe 동시 상한·재사용
## 레인 B — browser-files / cache (`02-adapters-browser-files-cache.md`)
- [x] 02-01 preview 직후 abort → ABORTED, lease 증가 없음
- [x] 02-02 Cache Storage 익명 요청 규칙 테스트
- [x] 02-03 로그아웃 시 runtime dispose 문서·recipe
- [x] 02-04 lease 한도 초과 retryable
- [x] 02-05 `inspect()` 실제 보장
- [x] 02-06 취소와 handoff 성공 관측 구분
- [x] 02-07 조회당 `keys()` 1번·복사 2번 이하
- [x] 02-08 가려진 규칙 5개 단독 테스트 — 완료: 변이 5개 검출
- [x] 02-09 cross-tab 설계 문서 현행화
## 레인 C — HTTP·서버 상태·인증·텔레메트리 (`03-adapters-http-state.md`)
- [x] 03-01 · 08-03 결과 불명 쓰기의 같은 키 재전송 (D-1) — 완료: 504 뒤 재전송의 `Idempotency-Key` 동일, 근거 없는 "변경되지 않음" 확정 경로 없음
- [x] 03-02 401/403/429 분류 (D-2)
- [x] 08-01 폼 저장 실패 상태 분리 (D-2) — 완료: 401·403·429가 서로 다른 문구·행동, "입력 내용을 확인해 주세요" 제목 없음
- [x] 03-03 correlation id → `requestId`, 요청 식별자 헤더
- [x] 03-04 V3 422 필드 오류가 폼까지
- [x] 03-05 텔레메트리 keepalive 64KiB 분할
- [x] 10-03 KEYED·retryBudget 2 실행기 테스트 — 완료: 변이 M1b 검출
- [x] 13-11 텔레메트리 envelope에 `build_id`·`release_id`
- [x] 03-06 전송별 재시도·타임아웃 규칙 표
- [x] 03-07 전송 0회 미인증은 telemetry 0건
- [x] 03-08 HTTP 복구 runbook 현행화
## 레인 D — realtime (`04-adapters-realtime.md`)
- [x] 04-01 모든 세션 종료 경로에서 예산 초기화, offline 동안 예산 정지
- [x] 04-02 SSE Retry-After bridge
- [x] 04-03 미등록 이벤트 타입 → freshness UNKNOWN, 별도 사유
- [x] 04-04 닫기 책임 주석(또는 구독)
- [x] 04-05 큰 chunk 분할
- [x] 04-06 SSE idle timeout 테스트 — 완료: 변이 M7 검출
- [x] 04-07 reconnect·poll 관측 hook
- [x] 04-08 VD-28·설계 5.3 현행화
## 레인 E — 저장소·kernel (`05-adapters-storage-kernel.md`)
- [x] 05-01 OPFS reconcile vs 진행 중 put (D-3) — 완료: 공유 root 2런타임에서 put 성공이면 open 성공, reconcile은 행 건너뜀
- [x] 05-02 빈 receipt = 없음, reconcile 루프 계속 → GC 도달
- [x] 05-08 메모리 IndexedDB 대역 fidelity(DB 이름 분리·트랜잭션 직렬화·비활성 요청 예외 또는 헤더 명시)
- [x] 05-03 손상 governance에서도 LOGOUT/ACCOUNT_DELETION 삭제
- [x] 05-04 OPFS purge 뒤 partition 파일 0개
- [x] 05-05 sweep·prune이 손상 행 건너뜀
- [x] 05-06 future schema → INCOMPATIBLE/ONLINE_ONLY
- [x] 05-07 멈춘 put idle timeout으로 lock 해제
- [x] 05-09 OPFS runbook 현행화, 죽은 `EFFECT_UNKNOWN` 분기 정리
- [x] 05-10 objectId 문법 policy 연동, `stableJson` 한 벌
- [x] 05-11 IndexedDB 예외 매핑 한 벌, OPFS→indexeddb import 0
- [x] 05-12 binding 검증을 kernel 트랜잭션으로
- [x] 05-13 admission 중 versionchange 처리
- [x] 05-14 GC 유예 기준(또는 계약 주석)
## 레인 F — Service Worker / Web Push (`06-adapters-service-worker-push.md`)
- [x] 06-01 알림 클릭 `"data" in` — 완료: prototype accessor fake로 클릭 테스트 통과
- [x] 06-02 두 탭 push 경쟁 (D-4)
- [x] 06-04 kill switch 분기 테스트 — 완료: 변이 검출
- [x] 06-03 SW 비상 경로·운영 문서 (D-5)
- [x] 06-05 SW 관측 조립
- [x] 06-06 계정 전환 시 push fence 넘기기
- [x] 06-07 drain 시간 초과를 `CLIENT_DRAIN_TIMEOUT`으로
- [x] 06-08 fallback을 빌드 자산 경로로 한정
- [x] 06-09 거절 클릭 fallback이 base path 사용
- [x] 06-10 SW 빌드가 프로필 설정 사용(또는 불일치 실패)
## 레인 G — contracts (`07-contracts.md`)
- [x] 07-02 · 13-10 호환성 규칙·분류기·FE-GATE-014 (D-6)
- [x] 07-03 V2/V3 일치 테스트 (D-7)
- [x] 07-04 읽지 않는 registry 필드 연결 또는 삭제 — 완료: 변이 M1 검출
- [x] 07-05 diagnostics fixture를 `@ts-expect-error` 3개로
- [x] 07-06 `invokeValidator` 입력 검사
- [x] 07-07 `@deprecated`와 제거 조건
## 레인 H — presentation (`08-presentation.md`)
- [x] 07-01 · 08-02 오류 종류 38개 문구 + 누락 검출 테스트
- [x] 08-04 샘플 문구 catalog화 + `check:i18n` 범위 확대
- [x] 08-05 · 11-02 a11y·visual이 실제 화면을 검사(heading 대기, 보호 라우트는 로그인 후, 상태별)
- [x] 08-07 실패 화면 지원 참조·다음 행동
- [x] 08-08 스크롤 복원·해시 이동
- [x] 08-09 실패 시 결과 수 status 숨김
- [x] 08-10 언어 전환 시 폼 오류 재번역
- [x] 08-11 상태 화면 한 벌로
- [x] 08-12 Pagination 수정키 클릭 허용
- [x] 08-13 상세 경로와 정적 경로 충돌 제거
## 레인 I — 애플리케이션 코어·조립·빌드 입력 (`09-app-core.md`)
- [x] 09-01 기능 2개 이상 설치 타입 — 완료: 모양이 다른 두 기능 설치 typecheck fixture가 게이트에서 통과
- [x] 09-05 `needs` 검사 + IndexedDB capability 조립 예시
- [x] 00-02 local-draft가 제거 대상 런타임을 직접 import하지 않음 — 완료: 제거 검증 4개 PASS (Phase 0에서 새로 발견)
- [x] 09-02 `VITE_PRODUCT_FEATURES`를 생성기에서 (D-9)
- [x] 13-06 `VITE_*` 개별 참조 + 전체 객체 참조 lint 금지 + 허용 목록 밖 변수 build 실패
- [x] 13-07 하위 경로 배포 URL
- [x] 09-03 모듈 평가 실패도 부트 오류 화면 — 완료: F-2 eb5264c
- [x] 09-04 `BOOT_UNEXPECTED_FAILURE`, 원인 보존
- [x] 09-06 local-draft 도메인 규칙 적용
- [x] 09-07 · 14-03 기능 추가·제거 경로 (D-10), 문서 현행화 — 완료: F-3 606c191
- [x] 14-08 제거 스크립트 실패 보고·임시 폴더
- [x] 09-08 local-draft ABA 방지
- [x] 09-09 모르는 override 키 진단
- [x] 09-10 부트 실패 다시 시도 버튼
- [x] 09-12 local-draft fixture 복사본 제거
## 레인 J — 테스트 체계 (`10-tests-fast-layers.md`, `11-tests-browser-release-scale.md`)
- [x] 10-02 reference-page 첫 대기 안정화 — 완료: 부하 조건 20회 실패 0
- [x] 10-04 커버리지 정책·문서 일치, live 재시도 모듈 포함
- [x] 10-05 파일 하나 실행 문서, vitest `include`
- [x] 10-06 전역 `afterEach` 실제 타이머 복원
- [x] 10-07 테스트 문서 현행화
- [x] 11-04 실제 모양 기능 규모 측정 (D-18)
- [x] 11-05 SW 없는 구 탭 청크 복구 e2e
- [x] 11-06 reference E2E 데이터 단언 + 저장 성공·재시도
- [x] 11-07 성능 측정 반복·중앙값·strictPort
- [x] 11-08 모든 Playwright 설정 `forbidOnly`, quarantine 만료 검사
- [x] 00-03 테스트가 만든 임시 폴더를 지우지 않음(새 발견, 2026-09-26) — 완료: `repository-file-inventory`, `service-worker-web-push-remediation`, `removal-fixture`, `scripts/generate-product-feature-index` 테스트가 mkdtemp 폴더를 afterEach/finally에서 지운다. `test:unit` 전후 `/tmp` 항목 수가 같다
## 레인 K — CI·가드레일·릴리스 (`12-guardrails-ci.md`, `13-build-release-supply-chain.md`)
`config/ci/gates.json`과 생성 workflow는 이 레인과 Phase 0만 바꾼다.
- [x] 08-06 수동 a11y 게이트를 release 단계로 (D-8)
- [x] 11-01 · 13-03 drill 판정 정직화 (D-14) — 완료: JS 자산 없는 dist에서 FE-RB-002·005 실패, provider 없으면 UNVERIFIED, 016/025 중복 정리
- [x] 11-03 CPU 무관 scale tier를 PR 게이트에
- [x] 12-03 재수출 경유 경계 우회 차단
- [x] 12-10 · 12-08 정규식 import 규칙 → 그래프 규칙 (D-12)
- [x] 12-05 dependency-cruiser 실행 제거·문서 정정 (D-11)
- [x] 12-06 `import.meta.glob` 거부
- [x] 12-07 예외 범위 축소·이유·담당
- [x] 12-09 레이어 규칙 기준 파일 하나
- [x] 12-11 위반 메시지에 이유·해결 방향
- [x] 13-02 dist 공개 파일 권한
- [x] 13-04 `verify:promotion` 보관 모드
- [x] 13-05 hosting 헤더 fixture 모드는 UNVERIFIED, live는 배포 후 (D-14)
- [x] 13-08 운영 CSP 아래 e2e smoke — 완료: F-7 9dc95ca (3엔진 확인)
- [x] 13-09 `engineStrict`·`saveExact`를 `pnpm-workspace.yaml`로
- [x] 13-12 SBOM·provenance 증명 범위 표, 배포물 패키지 목록
- [x] 13-13 provider 없는 구성 문서화, 키 교체 절차
- [x] 13-14 번들 예산 기준선·여유·조건 문서
- [x] 13-15 README 설정 절, `public/config.json` 동기화 — 완료: F-6 063375e, F-5 edf44a2
## 레인 M — 템플릿 제품성·문서 (`14-template-product-docs.md`)
- [x] 14-04 CHANGELOG, README 업데이트 절, 로컬 태그 (D-15) — 완료: F-13 91de7cf, CHANGELOG 66bc083, 로컬 태그 v0.2.0
- [x] 14-05 `docs/README.md` 색인 (D-16)
- [x] 14-06 README 지원 범위 표·상태 어휘 대응표
---
## 통합 후 (순차, 레인 Z)
- [x] 12-12 `noUnusedLocals` (D-19)
- [x] 14-07 문서 수치·목록 현행화(게이트 수는 레인 K 결과 기준)
- [x] 리뷰 README 발견 색인의 상태를 "해결 · <커밋>"으로 갱신
### Checkpoint 최종
- [ ] 공통 게이트 + `check:ci` + `check:adapter-inventory` + `verify:documentation` + `test:sample-removal` + `build`
- [ ] 새 worktree(깨끗한 체크아웃)에서 공통 게이트 통과
- [ ] 발견 138건 모두 체크
## 사용자 몫 (SPEC "범위 밖")
- [ ] U-1 Gitea Actions 활성화·runner·required check
- [ ] U-2 수동 접근성 검토 10건
- [ ] U-3 태그 push
- [ ] U-4 작성자 외 기능 추가 기록, staging 공급망 smoke
- [ ] U-5 백엔드 멱등 키 계약 확인