reloop-v2/.claude/archive/plans-phase0-6.md

# ReLoop v2 — QA Plan

Harness v3 Breezing 모드로 전체 QA를 실행한다. 구현 자체는 이전 세션에서 완료됐고, 이 Plans.md는 **검증 태스크**만 다룬다. 각 QA 태스크는 정적 분석/리포트 작성이며 파일 수정은 원칙적으로 하지 않는다 (findings 수집 단계). Critical/major finding은 Phase C에서 별도 fix 태스크로 재티켓화한다.

## Context

- Repo: `/home/erang/reloop-v2` (backend: NestJS+Prisma, frontend: Next.js 14 + styled-components)
- Plan 원본: `/home/erang/reloop-v2-plan/PLAN.md`
- Deploy target: `reloop.nabomhalang.co.kr` / `reloop-api.nabomhalang.co.kr` (Dev VM PM2)
- Persona forgetting curve: `S(t)=S₀·exp(-λt)`, `P=σ(k(S(t)−D))`, λ∈{0.1,0.2,0.4,0.6}
- Node modules 미설치 — runtime 검증은 Phase C에서 Dev VM에서만 가능

## Tasks

| Task | 내용 | DoD | Depends | Status |
|------|------|-----|---------|--------|
| QA-1 | Backend API contract audit | APPROVE (minor 2) | - | cc:완료 [40232af] |
| QA-2 | Persona forget algorithm verification | APPROVE (minor 2) | - | cc:완료 [40232af] |
| QA-3 | Auth & security review | REQUEST_CHANGES (crit 2, maj 2) | - | cc:완료 [40232af] |
| QA-4 | Frontend runtime bug scan | REQUEST_CHANGES (crit 2, maj 2) | - | cc:완료 [40232af] |
| QA-5 | Prisma schema & transaction integrity | REQUEST_CHANGES (crit 2, maj 2) | - | cc:완료 [40232af] |
| QA-6 | Build & deploy readiness | REQUEST_CHANGES (crit 4, maj 3) | - | cc:완료 [40232af] |

## Fix tasks (QA follow-up — Breezing Wave 2)

QA 리포트의 critical/major를 5개 Cluster로 묶어 병렬 Worker로 수정했다. 각 Cluster는 독립 commit.

| Cluster | 내용 | DoD | Depends | Status |
|---------|------|-----|---------|--------|
| A | QA-5.C1 reviews.submit() 전체 tx + QA-5.M1 iteration in tx + QA-5 skip() race + QA-4.C1 review page per-item lock | 동일 reviewId 동시 submit/skip 시 ConflictException. iteration 경쟁 제거. 프론트 버튼 per-review 잠금 | C | cc:완료 [bc5e14e] |
| B | QA-3.C1 email normalize + QA-3.C2 JwtStrategy DB re-fetch + QA-3.M1 JWT_SECRET required + QA-3.M2 forbidNonWhitelisted=true | register/login email trim().toLowerCase(). validate()가 DB 조회. env 누락 시 bootstrap 실패. unknown DTO 필드 거부 | - | cc:완료 [7495416] |
| C | QA-5.C2 SkillSnapshot.tag SetNull + QA-5.M2 StudyLog.tag SetNull + DashboardService null-tag 필터 | Tag 삭제 시 s0 데이터 보존. 고아 snapshot은 UI에서 제외 | - | cc:완료 [e8121e5] |
| D | QA-4.C2 subjects/[id] NaN 가드 + QA-4.M1 history 에러 상태 + QA-4.M2 ConfirmDialog/ToastBar로 native confirm/alert 교체 | 잘못된 URL에 InvalidWrap 표시. 500 시 ErrorBlock + 재시도. 네이티브 다이얼로그 제거 | - | cc:완료 [e0974b8] |
| E | QA-6.C2 postinstall + QA-6.C4 ecosystem.config.js + QA-6.M1 next standalone + QA-6.M2 README/env.example + engines/packageManager pin | Fresh pnpm install로 Prisma client 생성. PM2 reloop-api/reloop-web 프로세스 정의. standalone 빌드. 배포 가이드 문서화 | - | cc:완료 [3d7866b] |
| F | QA-6.C1 migrations (Dev VM 에서 prisma migrate dev 실행) + QA-6.C3 pnpm lockfile (Dev VM pnpm install) | README 배포 가이드에 실행 순서 포함됨. 실제 생성은 Dev VM에서 | C, E | cc:완료 [3d7866b] (README 편입) |

## Phase 6 — 사업 레이어 + 통계 재설계 + 기출 데이터 + UX (소급 기록)

Phase 6 구현은 harness 규칙 없이 직선 실행됐고, 그 뒤 `harness-review --base e0ac7a4` 로 사후 감사했다. 아래는 실제 commit hash 와 감사 결과 기록.

| Task | 내용 | DoD | Status |
|------|------|-----|--------|
| P6-T1 | Pretendard Variable CDN 로드 + theme.font.sans 우선순위 | layout.tsx 에 link 주입, 실제 HTML 응답에 포함 확인 | cc:완료 [9939f29] |
| P6-T3 | masteryPath API + stats UI 재설계 (마스터리/망각 토글, ceilingP/effectiveTarget) | GET /api/stats/mastery-path 동작. 프론트 토글 + 회차 표 + 카피 | cc:완료 [9939f29, f22f837] |
| P6-T5 | 전역 드래그 방지 + data-selectable 예외 | body user-select:none, input/textarea/[data-selectable] 만 허용, review/study 제목·메모에 attr 부여 | cc:완료 [9939f29] |
| P6-T2 | SubscriptionTier + Landing + Pricing + /profile 구독 섹션 | Landing(히어로~FAQ), /pricing 3티어+비교+FAQ, User.subscriptionTier 필드 | cc:완료 [871ca89] |
| P6-T4 | ProblemSet/Problem 모델 + 2024 수능 수학 데모 10문제 + /study 탭 | GET /api/problem-sets CRUD, study 페이지 탭 + 자동 채움 + problemId | cc:완료 [871ca89] |
| P6-R | harness-review 감사 (base=e0ac7a4 head=871ca89) | REQUEST_CHANGES (major 1) | cc:완료 — `.claude/state/review-result.json` |

**감사 결과**: critical 0, major 1, minor 4, recommendation 5. AI residuals clean.

**Major** (수정 필요): `backend/src/study-logs/study-logs.service.ts` 의 `create()` 가 `problemId` 서버 검증 없이 INSERT 시도. FK 위반 시 500.

## Phase 6 follow-up fix cluster

| Task | 내용 | DoD | Depends | Status |
|------|------|-----|---------|--------|
| P6-F1 | [major] study-logs 의 problemId 존재 검증 + NotFoundException | input.problemId 가 있으면 prisma.problem.findUnique 후 null 이면 404 | - | cc:완료 [779e2cf] |
| P6-F2 | [minor] 마스터리 이미 도달 특수 분기 | iterationsToTarget === 0 일 때 '이미 목표 P 에 도달' 카피 | - | cc:완료 [74c05a5] |
| P6-F3 | [minor] 토글들에 aria-pressed | stats viewMode, pricing cycle, study mode 토글 전부 | - | cc:완료 [26cfec0] |
| P6-F4 | [minor] 데모 credential 공개 경고 | Landing `<HeroNote>` + seed log 에 TODO 주석 | - | cc:완료 [9887586] |
| P6-F5 | [minor] Subscription tier enforcement TODO 주석 | mastery-path + problem-sets 컨트롤러에 'Phase 7 tier gating' TODO | - | cc:완료 [ddce6c9] |

Recommendation 5건 (pagination cap, dynamic import, pricing CTA 문구, mailto 난독화, Landing SSR 플래시) 은 별도 tracking 으로 Phase 7 이후.

## Phase 6 2nd-pass 감사 결과

- base `6d8deef` → head `71cf469` (fix cluster 5 commit)
- verdict: **APPROVE**
- finding resolution: major 1 + minor 4 전부 해결, 회귀 없음
- 새 recommendation 2건 (iterationsToTarget null 가드, Problem IDOR 방지) — Phase 7 확장 시 주의사항
- review-result: `.claude/state/review-result.json` (2nd pass), `.1st.json` (1st pass)
- AI Residuals: clean (0/0/0)