docs(recommendation): 응원 크리에이터 검토 기록을 갱신한다

docs/20260710_메인_홈_추천_응원크리에이터_스냅샷/reviews/phase-6-review.md

@@ -0,0 +1,101 @@
+# Phase 6 리뷰 보고서
+
+## 1. 리뷰 정보
+
+| 항목 | 내용 |
+|---|---|
+| 리뷰 대상 | Phase 6 / Task 6.1~6.3 |
+| 기준 commit 또는 working tree | 현재 `5123494e` 기준 working tree와 plan-task 기존 검증 기록 |
+| 리뷰 일자 | 2026-07-31 |
+| 리뷰어 | Codex |
+| 기준 문서 | PRD Non-Goals·Feature D, `plan-task.md` Phase 6 |
+| 리뷰 상태 | 보완 완료 |
+
+## 2. 리뷰 목적과 범위
+
+- 홈 API URL과 `cheerCreators` item의 공개 필드가 유지되는지 확인한다.
+- 완료 처리된 API 스키마 회귀 테스트가 비어 있지 않은 item 계약을 직접 고정하는지 확인한다.
+
+## 3. 판정 기준
+
+- DTO 구현은 맞지만 회귀 테스트가 필드 계약을 검출하지 못하는 경우 완료 증거 누락인 Low로 판정한다.
+
+## 4. 검토한 근거
+
+- 코드: `HomeRecommendationResponse.kt`, `HomeRecommendationFacade.kt`, `HomeRecommendationQueryPort.kt`
+- 테스트: `HomeRecommendationControllerTest`, `HomeRecommendationResponseTest`
+- 기존 실행 증거: plan-task의 2026-07-10, 2026-07-31 검증 기록
+- 사용자 지시에 따라 Gradle compile/test는 실행하지 않았다.
+
+## 5. 발견 사항 요약
+
+| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
+|---|---|---|---|---|---|
+| `REV-P6-001` | Low | 보완 완료 | `cheerCreators` item의 정확한 3개 필드 계약이 테스트로 고정되지 않았다 | Task R6.1 | `P6-R1` |
+
+## 6. 발견 사항 상세
+
+### REV-P6-001 — `cheerCreators` item의 정확한 3개 필드 계약이 테스트로 고정되지 않았다
+
+- **심각도:** Low
+- **상태:** 확정
+- **관련 요구사항:** Feature D, Non-Goals, Task 6.1
+- **소유 Task:** Task R6.1
+
+**관찰 내용**
+
+응답 DTO는 기존 `HomeCreatorItem`을 사용해 `creatorId`, `creatorNickname`, `creatorProfileImage`를 유지한다. 그러나 `HomeRecommendationResponseTest`는 `cheerCreators = emptyList()`로 직렬화하고, controller 테스트는 배열 존재만 확인한다. 따라서 item 필드가 추가·삭제·개명되어도 현재 두 assertion은 통과할 수 있다.
+
+**영향**
+
+향후 DTO 변경에서 공개 API 스키마 회귀가 focused test를 빠져나갈 수 있다. 현재 DTO 자체의 계약 위반은 확인되지 않았다.
+
+**권장 조치**
+
+비어 있지 않은 item을 사용해 값과 정확한 필드 수 3을 직렬화 및 controller 계층에서 고정한다.
+
+**판정 기록**
+
+- 2026-07-31 — 관련 테스트 fixture와 JSON assertion을 대조해 확정했다.
+- 2026-07-31 — `cheerCreators` item 직렬화와 홈 API 응답의 정확한 3개 필드 계약을 테스트로 추가했다. focused API test는 fixture 보정 후 `BUILD SUCCESSFUL`, 관련 `git diff --check`는 출력 없음으로 보완 완료했다.
+
+## 7. 확정 항목의 plan·goal 전환
+
+- `plan-task.md` Phase 6에 Task R6.1 / `P6-R1`을 추가했다.
+
+## 8. 리뷰 종료 판정
+
+| 판정 항목 | 결과 | 근거 |
+|---|---|---|
+| 리뷰 범위 전체 확인 | 충족 | DTO·facade·API 테스트 대조 완료 |
+| 후보 항목 판정 완료 | 충족 | `REV-P6-001` 확정 |
+| 확정 항목 plan 반영 | 충족 | Task R6.1 |
+| 검증 명령과 결과 기록 | 충족 | 정적 검토와 기존 실행 기록 참조 |
+
+**최종 결론:** 보완 완료
+
+**남은 항목:** 없음
+
+---
+
+## 9. 2차 리뷰 기록 — 2026-07-31
+
+- **리뷰 대상:** Phase 6 / Task 6.1~6.3·Task R6.1, `5123494e` 기준 미커밋 working tree.
+- **검토 근거:** `HomeRecommendationResponseTest.kt:61-67,117-123`, `HomeRecommendationControllerTest.kt:529-549`, `HomeRecommendationFacade.kt`, `HomeRecommendationQueryService.kt`.
+- **검증 방법:** `cheerCreators` 실제 item의 `creatorId`, `creatorNickname`, `creatorProfileImage` 값과 정확한 3개 필드 계약, 기존 API URL·DTO 유지, 대상일 snapshot fixture를 정적 대조했다. Gradle compile/test는 실행하지 않았다.
+- **발견 사항:** 확정 발견 사항 없음.
+- **plan·goal 전환:** 전환 항목 없음.
+- **최종 결론:** 확정 발견 사항 없음.
+- **남은 항목:** 없음.
+
+---
+
+## 10. 3차 리뷰 기록 — 2026-07-31
+
+- **리뷰 대상:** Phase 6 / Task 6.1~6.3·Task R6.1, `5123494e` 기준 미커밋 working tree.
+- **검토 근거:** `HomeRecommendationController.kt`, `HomeRecommendationResponse.kt:20-51`, `HomeRecommendationFacade.kt:50-95,294-298`, `HomeRecommendationControllerTest.shouldKeepCheerCreatorItemSchemaOnHomeRecommendations`, `HomeRecommendationResponseTest`의 정확한 필드 집합 assertion.
+- **검증 방법:** 기존 `GET /api/v2/home/recommendations` URL과 `cheerCreators` item의 `creatorId`, `creatorNickname`, `creatorProfileImage` 3개 필드만 유지되는지, 대상일 스냅샷 fixture가 실제 조회 경로와 일치하는지 정적으로 대조했다. Gradle compile/test는 실행하지 않았다.
+- **발견 사항:** 확정 발견 사항 없음.
+- **plan·goal 전환:** 전환 항목 없음.
+- **최종 결론:** 확정 발견 사항 없음.
+- **남은 항목:** 없음.