fix(content): 무료 콘텐츠 포인트 사용 조건을 보정한다

docs/20260731_무료_콘텐츠_포인트_결제_불가/reviews/phase-1-review.md

@@ -0,0 +1,229 @@
+# Phase 1 코드 리뷰 보고서
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 1 / `P1-T1`, `P1-GATE` |
+| 기준 commit 또는 working tree | `eb0ff7537e5fa6b083be21df3319be0ff2ecda51` + staged working tree |
+| 리뷰 일자 | 2026-07-31 |
+| 리뷰어 | Codex |
+| 기준 문서 | `docs/20260731_무료_콘텐츠_포인트_결제_불가/prd.md`, `plan-task.md` |
+| 리뷰 상태 | 판정 완료 |
+
+## 2. 리뷰 목적과 범위
+
+### 목적
+
+- `POINT-001~004`, `POINT-007~008` 구현과 완료 증거가 일치하는지 확인한다.
+- 대상 소비자 응답과 변경 제외 관리자 응답이 각각 확정 계약을 유지하는지 확인한다.
+
+### 포함 범위
+
+- 코드: Phase 1에서 변경한 consumer response mapper와 `AudioContentService`
+- 테스트: Phase 1의 unit/facade test와 AI 캐릭터 관리자 controller test
+- 문서: PRD Phase 1 요구사항, `P1-T1`, `P1-GATE`, Progress
+
+### 제외 범위
+
+- Phase 2 POINT 전용 repository 조건
+- legacy 상세 외 legacy 목록·추천·랭킹 API
+- compile과 test 재실행
+
+## 3. 판정 기준
+
+| 심각도 | 기준 |
+|---|---|
+| Blocker | 보안·데이터 손실 위험, 핵심 흐름 불능, 완료 판정을 무효화하는 문제 |
+| High | 확정 요구사항 또는 공개 API 계약 위반 |
+| Medium | 제한된 조건의 기능 회귀 또는 핵심 계약의 자동 검증 누락 |
+| Low | 문서 정합성 또는 비핵심 회귀 증거 누락 |
+
+## 4. 검토한 근거
+
+### 문서와 코드
+
+- 요구사항: `POINT-001~004`, `POINT-007~008`
+- 계획: `P1-T1`, `P1-GATE`
+- 코드:
+  - `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt:970`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/content/overview/dto/ContentOverviewPageResponse.kt:49`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/content/all/dto/MainContentAllTabResponse.kt:63`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/content/recommendation/dto/AudioRecommendationsResponse.kt:72`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/common/dto/CreatorChannelAudioContentResponse.kt:35`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt:270`
+  - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentMapper.kt:69`
+- 테스트:
+  - `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt:286`
+  - `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentControllerTest.kt:495`
+
+### 실행한 검증
+
+| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
+|---|---|---|
+| `git diff --cached --check` | 성공 | 출력 없음 |
+| staged diff와 `rg` 기반 호출·assertion 대조 | 성공 | 6개 소비자 조립 경계는 모두 `stored && price > 0` 적용 |
+| `./gradlew --no-daemon tasks --all` | 성공 | `BUILD SUCCESSFUL`, exit code 0 |
+| compile/test | 미실행 | 사용자 지시에 따라 기존 성공 기록만 확인 |
+
+## 5. 발견 사항 요약
+
+| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
+|---|---|---|---|---|---|
+| `REV-P1-001` | Medium | 수정 완료 | 소비자 테스트가 저장값 false 조건을 증명하지 않음 | `Task 1.2` | `P1-R1` |
+| `REV-P1-002` | Low | 수정 완료 | 관리자 회귀 테스트가 무료 원본값 유지 조건을 증명하지 않음 | `Task 1.2` | `P1-R1` |
+| `REV-P1-003` | Medium | 수정 완료 | legacy 상세 test가 유료·저장값 true positive 계약을 증명하지 않음 | `Task 1.3` | `P1-R2` |
+
+## 6. 발견 사항 상세
+
+### REV-P1-001 — 소비자 테스트가 저장값 false 조건을 증명하지 않음
+
+- **심각도:** Medium
+- **상태:** 수정 완료
+- **관련 요구사항:** `POINT-002`, `POINT-004`
+- **소유 Task:** `Task 1.2`, `P1-R1`
+
+**관찰 내용**
+
+변경된 소비자 테스트는 주로 `price == 0, stored == true → false`와
+`price > 0, stored == true → true`만 검증한다. 따라서 구현이 실수로 `price > 0`만 반환해도 해당 두 조건은 통과한다.
+PRD 성공 기준인 `stored == false → false`를 자동으로 구분할 수 없다.
+
+**근거**
+
+- 코드: 각 소비자 조립 경계는 현재 `stored && price > 0`으로 올바르게 구현되어 있다.
+- 테스트: Phase 1 변경 test에는 각 변경 경계의 `price > 0, stored == false` assertion이 없다.
+- 문서: PRD `POINT-002`와 성공 기준은 저장값 false가 가격과 무관하게 false일 것을 요구한다.
+
+**영향**
+
+현재 production 동작 결함은 확인되지 않았다. 다만 저장값 조건이 제거되는 회귀가 발생해도 Phase 1 test가 탐지하지 못한다.
+
+**권장 조치**
+
+각 변경 경계의 기존 test fixture에 `price > 0, stored == false` 사례를 최소 추가하고 `P1-GATE`를 재검증한다.
+
+**판정 기록**
+
+- 2026-07-31 — staged 구현식은 정상이나 확정 계약의 자동 검증 누락으로 판정해 `P1-R1`로 전환했다.
+- 2026-07-31 — `P1-R1`에서 대상 소비자 경계에 `price > 0, stored == false` assertion을 추가하고 focused test, `P1-GATE`, `ktlintCheck` 성공을 확인했다.
+
+### REV-P1-002 — 관리자 회귀 테스트가 무료 원본값 유지 조건을 증명하지 않음
+
+- **심각도:** Low
+- **상태:** 수정 완료
+- **관련 요구사항:** `POINT-007`, `POINT-008`
+- **소유 Task:** `Task 1.2`, `P1-R1`
+
+**관찰 내용**
+
+계획과 Progress는 관리자 상세의 “무료·저장값 true → true” 확인을 완료 증거로 기록했지만,
+`AiCharacterAdminAudioContentControllerTest`의 공통 fixture는 `price = 100`이다. 상세 assertion은 저장값 true 전달만 검증하며
+무료 조건에서 소비자 보정이 관리자 경계로 번지지 않았는지는 증명하지 않는다. 관리자 목록의 동일 조건 assertion도 없다.
+
+**근거**
+
+- 코드: `AiCharacterAdminAudioContentMapper`는 현재 `content.isPointAvailable`을 그대로 전달한다.
+- 테스트: 관리자 helper의 `price = 100`, 상세의 `isAvailableUsePoint == true` assertion.
+- 문서: `P1-T1`과 구현 Progress는 무료 관리자 원본값 유지 확인을 완료 증거로 기록한다.
+
+**영향**
+
+현재 관리자 mapper의 기능 결함은 확인되지 않았다. 그러나 완료 기록과 실제 test fixture가 불일치하며 관리자 제외 계약의
+핵심 경계가 회귀 test로 고정되지 않았다.
+
+**권장 조치**
+
+관리자 목록·상세 fixture를 `price == 0, stored == true`로 구성해 목록 `isPointAvailable`과 상세
+`isAvailableUsePoint`가 true를 유지하는지 검증한다.
+
+**판정 기록**
+
+- 2026-07-31 — 구현은 정상이나 완료 증거 불일치가 확인되어 `P1-R1`로 전환했다.
+- 2026-07-31 — `P1-R1`에서 관리자 목록·상세 fixture를 `price == 0, stored == true`로 보강하고 원본 true 유지 assertion 통과를 확인했다.
+
+### REV-P1-003 — legacy 상세 test가 유료·저장값 true positive 계약을 증명하지 않음
+
+- **심각도:** Medium
+- **상태:** 수정 완료
+- **관련 요구사항:** `POINT-002`, `POINT-003`
+- **소유 Task:** `Task 1.3`, `P1-R2`
+
+**관찰 내용**
+
+`AudioContentServiceTest` 상세 회귀 test는 무료·저장값 true와 유료·저장값 false가 false인 것만 검증한다.
+`price > 0, stored == true → true` assertion이 없어 legacy 상세 구현이 항상 false로 회귀해도 해당 test가 통과한다.
+
+**근거**
+
+- 코드: `AudioContentService` 상세 응답은 현재 `audioContent.isPointAvailable && audioContent.price > 0`으로 올바르게 구현되어 있다.
+- 테스트: `AudioContentServiceTest` 상세 포인트 assertion은 false 사례 2건만 포함한다.
+- 문서: `P1-T1`은 각 응답 경계의 유료·저장값 true 유지를 완료 증거로 요구한다.
+
+**영향**
+
+현재 production 동작 결함은 확인되지 않았다. 다만 legacy 상세의 positive 계약이 회귀 test로 고정되지 않았다.
+
+**권장 조치**
+
+기존 상세 test에 유료·저장값 true 응답 assertion을 추가해 세 계약 조건을 완성한다.
+
+**판정 기록**
+
+- 2026-07-31 — staged production 구현은 정상이나 legacy 상세 positive 회귀 증거 누락으로 판정해 `P1-R2`로 전환했다.
+- 2026-07-31 — `P1-R2`에서 legacy 상세 test에 유료·저장값 true assertion을 추가해 세 계약 조건을 고정하고 focused test, P1-GATE 단위 범위, `ktlintCheck` 성공을 확인했다.
+
+## 7. 확정 항목의 plan·goal 전환
+
+- 신규 회귀 수정 Task: `plan-task.md`의 `Task 1.2`
+- 후속 goal: `P1-R1`
+- objective: 소비자 응답의 저장값 false 조건과 무료 관리자 응답의 원본값 유지 조건을 자동 회귀 테스트로 증명한다.
+- 추가 회귀 수정 Task: `plan-task.md`의 `Task 1.3`
+- 추가 후속 goal: `P1-R2`
+- objective: legacy 상세의 유료·저장값 true positive 계약을 자동 회귀 테스트로 증명한다.
+
+## 8. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| 리뷰 범위 전체 확인 | 충족 | Phase 1 production/test/document diff와 관련 mapper 확인 |
+| 후보 항목 판정 완료 | 충족 | 3건 모두 판정 완료 |
+| 확정 항목 plan 반영 | 충족 | `Task 1.2`, `P1-R1`, `Task 1.3`, `P1-R2` |
+| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 보류 없음 |
+| 검증 명령과 결과 기록 | 충족 | 정적 검증 기록, test 미실행 사유 명시 |
+
+**최종 결론:** 수정 완료
+
+**남은 항목:** 없음
+
+## 9. 수정 후 검증 기록
+
+기존 기록을 삭제하거나 덮어쓰지 않고 차수별로 누적한다.
+
+### 1차 수정 검증 — 2026-07-31
+
+- 무엇을: `REV-P1-001`, `REV-P1-002`의 수정 내용과 회귀 증거를 재검토했다.
+- 왜: 소비자 저장값 false 계약과 관리자 무료 원본값 유지 계약의 자동 검증 누락을 해소했는지 확인하기 위해서다.
+- 어떻게:
+  - staged diff와 `rg` — 6개 소비자 조립 경계의 유료·저장값 false assertion 확인.
+  - staged diff — 관리자 목록·상세의 무료·저장값 true fixture와 true assertion 확인.
+  - `git diff --check`, `git diff --cached --check` — 출력 없음.
+  - `./gradlew --no-daemon tasks --all` — `BUILD SUCCESSFUL`, exit code 0.
+  - compile/test — 사용자 지시에 따라 재실행하지 않고 `plan-task.md`의 기존 성공 기록만 확인.
+- 판정: `REV-P1-001`, `REV-P1-002` 수정 완료.
+- 남은 항목: `REV-P1-003`, `P1-R2`.
+
+### 2차 수정 검증 — 2026-07-31
+
+- 무엇을: `REV-P1-003`의 수정 내용과 회귀 증거를 재검토했다.
+- 왜: legacy 상세의 유료·저장값 true positive 계약이 자동 검증으로 고정됐는지 확인하기 위해서다.
+- 어떻게:
+  - `AudioContentServiceTest` — 무료·저장값 true → false, 유료·저장값 false → false, 유료·저장값 true → true assertion 확인.
+  - `AudioContentService` — 응답식 `audioContent.isPointAvailable && audioContent.price > 0`과 세 assertion 대조.
+  - `plan-task.md`의 기존 완료 기록 — focused test `BUILD SUCCESSFUL`(14s), P1-GATE 단위 범위
+    `BUILD SUCCESSFUL`(2m 26s), `ktlintCheck` `BUILD SUCCESSFUL`(14s) 확인.
+  - `git diff --check`, `git diff --cached --check` — 출력 없음.
+  - `./gradlew --no-daemon tasks --all` — `BUILD SUCCESSFUL`, exit code 0.
+  - compile/test — 사용자 지시에 따라 이번 재검토에서는 실행하지 않음.
+- 판정: `REV-P1-003` 수정 완료.
+- 남은 항목: 없음.