TSK-009-00 Epic: UI/UX expectation tracking and 95% coverage gate

[ClarusIubar]

목적

UI/UX가 기대와 다르게 동작하는 항목을 이슈, Wiki, 자동 테스트, 수동 QA 근거로 추적하고, TypeScript와 FastAPI Python 모두 95% 이상 커버리지 게이트를 통과시키는 체계를 만든다.

작업 원칙

• 구현은 child issue별 목적형 브랜치에서만 진행한다.
• 첫 PR은 baseline 측정만 수행하고 95% hard gate를 즉시 켜지 않는다.
• 사용자-facing copy, API path/response shape, DB schema, Kakao/Naver OAuth 성공 경로는 변경하지 않는다.
• UI/UX 기대 동작은 UIUX-### ID로 추적한다.
• 자동화가 불완전한 실제 iPhone Safari/WebView 항목은 수동 QA 근거를 남긴다.
• checklist는 PR 링크, merge SHA, CI 링크, 검증 출력 근거 없이 닫지 않는다.

Child Issues

• TSK-009-01 Test coverage baseline #324 TSK-009-01 Test coverage baseline
• TSK-009-02 UI/UX expectation matrix #325 TSK-009-02 UI/UX expectation matrix
• TSK-009-03 Playwright E2E harness #326 TSK-009-03 Playwright E2E harness
• TSK-009-04 Critical UI flow E2E #327 TSK-009-04 Critical UI flow E2E
• TSK-009-05 TypeScript coverage 95 #328 TSK-009-05 TypeScript coverage 95
• TSK-009-06 FastAPI coverage 95 #329 TSK-009-06 FastAPI coverage 95
• TSK-009-07 QA workflow Wiki traceability #330 TSK-009-07 QA workflow Wiki traceability

완료 체크리스트

• TypeScript coverage baseline과 최종 95% gate 근거 기록
• FastAPI Python coverage baseline과 최종 95% gate 근거 기록
• Playwright E2E 도입 및 모바일 핵심 흐름 자동화
• UI/UX expectation matrix Wiki 작성
• README/Wiki/CI workflow에 QA 실행 흐름 반영
• 각 child issue에 PR URL, merge SHA, CI URL, 검증 결과 기록
• Dependabot open alert 0건 확인
• Code scanning open alert 0건 확인

최종 검증 명령

• npm.cmd run check:numeric-literals
• npm.cmd run lint
• npm.cmd run typecheck
• npm.cmd run test:unit
• npm.cmd run test:integration
• npm.cmd run test:regression
• npm.cmd run test:e2e
• npm.cmd run test:coverage:ts
• python -m pytest --cov=app --cov-fail-under=95 tests
• npm.cmd run build
• git diff --check
• UTF-8 integrity check

진행 근거

• TSK-009-01 Test coverage baseline #324 완료: TSK-009-01 Add coverage baseline #331
• TSK-009-02 UI/UX expectation matrix #325 완료: TSK-009-02 Add UIUX expectation matrix #332
• TSK-009-03 Playwright E2E harness #326 완료: TSK-009-03 Add Playwright E2E harness #333
• TSK-009-04 Critical UI flow E2E #327 완료: TSK-009-04 Automate critical UI flows #334