# Phase 6 FanTalk 관리 리뷰

## 1. 리뷰 정보

| 항목 | 내용 |
|---|---|
| 리뷰 대상 | Phase 6 / FanTalk 2개 operation |
| 기준 commit 또는 working tree | `2f93e2c9` + 현재 Phase 6~7 working tree |
| 리뷰 일자 | 2026-07-28 |
| 리뷰어 | Codex |
| 기준 문서 | `prd.md`, `plan-task.md`, `api-contract.openapi.json` |
| 리뷰 상태 | 후속 수정 및 Gate 완료 |

## 2. 리뷰 목적과 범위

### 목적

- PRD Feature F와 OpenAPI FanTalk 2개 operation을 관리자/public v2 query policy, controller, facade, 테스트에 대조한다.
- pagination 보정과 reply JSON/side-effect 경계를 점검한다.

### 포함 범위

- 관리자 FanTalk controller/facade/repository/DTO와 관련 테스트
- 공개 v2 `CreatorChannelFanTalkQueryPolicy`
- OpenAPI FanTalk path/parameter/schema와 plan Phase 6

### 제외 범위

- 공개 v2 정책 변경

## 3. 판정 기준

| 심각도 | 기준 |
|---|---|
| Blocker | cross-owner reply 또는 데이터 손실 |
| High | 승인된 공개 v2 parity나 주요 조회 계약 위반 |
| Medium | reply request schema·오류 계약의 제한된 위반 |
| Low | 유지보수성 또는 문서 정합성 문제 |

## 4. 검토한 근거

| 근거 | 판정 |
|---|---|
| OpenAPI `FanTalkPage`/`FanTalkSize` `:520`~`:521` | page는 0 이상, size는 20..50으로 보정 |
| `CreatorChannelFanTalkQueryPolicy.kt:8`~`:12`, `:23`~`:28` | 공개 v2가 실제로 같은 보정을 수행 |
| `AiCharacterAdminFanTalkFacade.kt:30`~`:55` | 관리자는 범위 밖 값을 400으로 거부하고 size 1도 허용 |
| `AiCharacterAdminFanTalkQueryTest.kt:120`~`:189` | size 1 성공과 -1/0/51 거부를 테스트가 반대 계약으로 고정 |
| OpenAPI `FanTalkReplyCreateRequest` `:1238`~`:1242` | `content` required, `additionalProperties: false` |
| `AiCharacterAdminFanTalkController.kt:27`~`:33` | reply를 기본 `@RequestBody` DTO binding으로 수신 |
| reply contract test `:50`~`:100` | blank/malformed/missing은 검증하지만 미지 필드는 검증하지 않음 |

### 실행한 검증

| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|---|---|---|
| query policy·facade·test 정적 대조 | 성공 | pagination 구현과 테스트가 PRD/OpenAPI에 반대임을 확인 |
| reply schema/binding 정적 대조 | 성공 | unknown-field strict 경계 누락 확인 |
| Gradle/컴파일/테스트 | 실행 | `P6-R1` RED/GREEN focused test 수행 |
| `P6-R1` RED | 성공 | pagination 400과 reply unknown-field 허용으로 4건 실패 확인 |
| `P6-R1` GREEN | 성공 | focused 재실행 `BUILD SUCCESSFUL in 3m 14s` |
| `P6-R1-GATE` FanTalk/common 회귀 | 성공 | `BUILD SUCCESSFUL in 1m 36s` |
| `P6-R1-GATE` lint/diff | 성공 | `ktlintCheck` `BUILD SUCCESSFUL in 35s`, `git diff --check` 출력 없음 |

## 5. 발견 사항 요약

| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|---|---|---|---|---|---|
| `REV-027` | High | 처리 완료 | 관리자 목록 pagination이 공개 v2 보정 정책과 반대 | `Task 6.6` | `P6-R1-GATE` |
| `REV-028` | Medium | 처리 완료 | reply body가 미지 JSON 필드를 허용 | `Task 6.6` | `P6-R1-GATE` |

## 6. 발견 사항 상세

### REV-027 — FanTalk pagination 보정 불일치

- **심각도:** High
- **상태:** 처리 완료
- **관련 요구사항:** PRD Feature F, 공개 v2 응답/query policy parity
- **관련 계약:** page default 0·최소 0 보정, size default 20·20..50 보정
- **소유 Task:** `Task 6.6`, `P6-R1`

**관찰 내용**

관리자 facade는 음수 page, size 0, size 51을 400으로 거부하고 size 1을 허용한다. 공개 v2 policy와 OpenAPI는 각각
page 0, size 20, size 50으로 보정해야 하며 size 1도 20으로 올려야 한다. 현재 query 테스트가 잘못된 구현을 의도한
동작으로 고정한다.

**후속 수정 결과**

관리자 목록 facade가 공개 v2 `CreatorChannelFanTalkQueryPolicy`를 재사용하도록 변경되어 `page < 0 -> 0`,
`size < 20 -> 20`, `size > 50 -> 50` 보정이 actual endpoint 테스트로 고정됐다.

**영향**

OpenAPI client가 보정 계약을 신뢰하면 관리자 endpoint에서 예상하지 못한 400을 받으며, size 1 요청의 응답 metadata도
계약과 달라진다.

**권장 조치**

공개 v2 query policy와 동일한 정규화를 적용하고 기존 pagination 테스트를 경계값 기반으로 교정한다.

### REV-028 — FanTalk reply unknown-field 미거부

- **심각도:** Medium
- **상태:** 처리 완료
- **관련 요구사항:** OpenAPI request schema 준수, 잘못된 request no-side-effect
- **관련 계약:** `FanTalkReplyCreateRequest.additionalProperties: false`
- **소유 Task:** `Task 6.6`, `P6-R1`

**관찰 내용**

controller의 기본 DTO binding은 malformed/missing content는 거부하지만 계약 밖 필드를 무시한다. repository 전역 설정에
unknown property 실패 설정이 없고 현재 contract test도 extra field를 다루지 않는다.

**후속 수정 결과**

reply controller는 raw JSON 문자열을 facade로 넘기고, facade가 `FAIL_ON_UNKNOWN_PROPERTIES` strict reader로
`AiCharacterAdminFanTalkReplyRequest`를 역직렬화한다. 미지 필드 요청은 400 `common.error.invalid_request`, reply insert
0건, `LanguageDetectEvent` 0회로 actual endpoint 테스트에 고정됐다.

**권장 조치**

reply body만 strict parse하고 미지 필드가 있으면 400 `common.error.invalid_request`, reply insert 0건,
`LanguageDetectEvent` 0회를 actual endpoint로 고정한다.

## 7. plan·goal 전환

`plan-task.md` Phase 6에 두 finding을 함께 처리하는 `Task 6.6` / `P6-R1`과 `P6-R1-GATE`를 추가했다. 기존
`P6-GATE` 완료 이력은 유지한다.

## 8. 리뷰 종료 판정

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| operation/path 대조 | 충족 | FanTalk 2개 route 존재 |
| 공개 v2 pagination parity | 충족 | 공개 v2 query policy 재사용과 경계값 actual test 통과 |
| reply ownership/storage 추적 | 충족 | active owner root 선검증과 target creator 저장 확인 |
| reply JSON schema | 충족 | unknown-field 400/no insert/no event actual test 통과 |
| 실행 검증 | 충족 | focused, FanTalk/common 회귀, lint, diff 성공 |

**최종 결론:** Phase 6 후속 리뷰 종료

**남은 항목:** 없음. 다음 Goal은 `P7-R1`이다.

## 9. 2차 정적 리뷰 및 판정 — 2026-07-28

### 리뷰 정보와 범위

- 기준 commit/working tree: `2f93e2c9` + 현재 working tree
- 기준 문서: PRD Feature F, plan Phase 6, OpenAPI FanTalk 2개 operation
- 검토 범위: 관리자 root/reply query, 공개 v2 pagination policy, reply strict JSON·owner/root/active 검증,
  writer/creator 저장과 언어 감지 event 테스트
- 검증 방식: 코드·문서·테스트 정적 대조. 컴파일과 테스트는 실행하지 않았다.

### 발견 사항과 판정

확정 발견 사항 없음.

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 목록 query/pagination | 충족 | 공개 v2 `CreatorChannelFanTalkQueryPolicy` 재사용 |
| reply JSON | 충족 | strict reader와 blank/malformed/unknown-field 거부 |
| root/ownership | 충족 | active owner root만 조회하고 nested/cross-owner를 저장 전 차단 |
| writer/event | 충족 | target creator를 writer/creator로 저장하고 언어 감지 event 발행 |
| plan 전환 | 해당 없음 | Phase 6 신규 Task 불필요 |

**최종 결론:** Phase 6 추가 수정 없음

**남은 항목:** 없음. `P7-R2` 통합 재판정에서 기존 FanTalk/common 회귀만 확인한다.

## 10. 3차 정적 리뷰 및 판정 — 2026-07-28

### 리뷰 범위와 방식

- 기준 commit/working tree: `2f93e2c9` + 현재 working tree
- 기준 문서: PRD Feature F, plan Phase 6, OpenAPI FanTalk 2개 operation
- 검토 범위: 관리자 목록·답변 facade, 공개 v2 pagination policy, strict JSON, root ownership과 event 테스트
- 검증 방식: 코드·문서·테스트 정적 추적. 컴파일과 테스트는 실행하지 않았다.

### 발견 사항과 판정

확정 발견 사항 없음.

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 목록 query | 충족 | 공개 v2 page/size 보정 정책 재사용 |
| reply JSON | 충족 | malformed/blank/unknown-field 저장 전 거부 |
| root/ownership | 충족 | active owner root만 허용하고 nested/cross-owner 차단 |
| writer/event | 충족 | target creator 저장과 언어 감지 event 유지 |
| plan 전환 | 해당 없음 | Phase 6 신규 Task 불필요 |

**최종 결론:** Phase 6 추가 수정 없음

**남은 항목:** `P7-R3`에서 FanTalk/common 회귀를 통합 재검증한다.

## 11. 4차 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위와 방식

- 기준 commit/working tree: `2f93e2c9` + 현재 working tree
- 기준 문서: PRD Feature F, plan Phase 6, OpenAPI FanTalk 2개 operation
- 검토 범위: 관리자 root/reply 목록, pagination policy, strict reply JSON, root ownership·event
- 검증 방식: 코드·schema·테스트 정적 대조. 컴파일과 테스트는 실행하지 않았다.

### 발견 사항과 판정

확정 발견 사항 없음.

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 목록/pagination | 충족 | 공개 v2 query policy와 root/reply owner query 유지 |
| reply JSON | 충족 | malformed·blank·unknown field를 저장 전에 거부 |
| root/ownership | 충족 | active owner root만 답변 허용 |
| writer/event | 충족 | target creator를 writer/creator로 저장하고 언어 감지 발행 |
| plan 전환 | 해당 없음 | Phase 6 신규 Task 불필요 |

**최종 결론:** Phase 6 추가 수정 없음

**남은 항목:** 없음.

## 12. 5차 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위

- OpenAPI FanTalk 2개 operation과 controller/facade/query 구현
- reply request의 required/non-null, malformed·unknown·blank 입력 처리
- pagination 보정, root ownership, writer/event 경계

### 판정

| 판정 항목 | 결과 | 근거 |
|---|---|---|
| 목록/pagination | 충족 | 공개 v2 query policy 보정과 owner root/reply query 유지 |
| reply JSON | 충족 | request는 non-null `String content` 하나이며 null/malformed/blank/unknown을 저장 전 거부 |
| root/ownership | 충족 | active owner root만 답변 허용 |
| primitive nullability | 해당 없음 | FanTalk JSON request에 primitive 필드가 없음 |
| plan 전환 | 해당 없음 | Phase 6 신규 Task 불필요 |

사용자 요청에 따라 Gradle, 컴파일, 테스트는 실행하지 않았다.

**최종 결론:** Phase 6 신규 수정 없음

**남은 항목:** 없음.

## 13. 팬 작성 FanTalk 원글 삭제 후속 검토 — 2026-07-29

### 확인 결과

- **`REV-049` / High / 구현 대기:** 신규 v2 관리자 경계에 target 채널의 팬 작성 FanTalk root를 삭제할
  operation이 없다.
- 삭제는 팬 작성 root row만 `isActive=false`로 변경하고 연결 creator reply row는 유지한다.
- target AI가 작성한 row, reply row, 다른 채널 root는 거부하며 이미 비활성인 같은 target 팬 root는 성공 no-op이다.
- 캐릭터 직접 댓글 삭제는 v2 미사용 API로 별도 구현하지 않는다.

### plan 전환

- 신규 Task: `Task 6.7` / `P6-R2`
- Gate: `P6-R2-GATE`
- 범위 밖: hard delete·cascade, FanTalk 원글 작성, public v2 endpoint 변경

사용자 요청에 따라 Gradle, 컴파일, 테스트는 실행하지 않았다.

**최종 결론:** Phase 6 팬 작성 FanTalk 원글 삭제 구현 필요

**다음 Goal:** `P6-R2`.

## 14. 팬 작성 FanTalk 원글 삭제 구현 검토 — 2026-07-29

### 구현 결과

- `DELETE /api/v2/admin/ai-characters/{characterId}/fan-talks/{fanTalkId}`를 추가했다.
- target 채널의 팬 작성 root만 `CreatorCheers.isActive=false`로 변경한다.
- 연결 creator reply row는 변경하지 않고, 목록·`fanTalkCount`에서는 삭제된 root가 제외된다.
- target AI 작성 root, reply row, 다른 채널 root, 비활성 target, 누락 ID는 400/no mutation으로 거부한다.
- 같은 target의 이미 비활성인 팬 root는 200 no-op으로 처리한다.

### 실행한 검증

| 명령 | 결과 | 핵심 증거 |
|---|---|---|
| `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.fantalk.AiCharacterAdminFanTalkDeleteTest` | 성공 | RED 6건 미구현 route 실패 확인 후 GREEN focused `BUILD SUCCESSFUL in 29s` |
| `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.AiCharacterAdminAuthorizationTest` | 성공 | DELETE 인가 matrix 보강 후 `BUILD SUCCESSFUL in 29s` |
| `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.fantalk.*' --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.AiCharacterAdminAuthorizationTest --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.AiCharacterAdminErrorContractTest` | 성공 | FanTalk/common 영향 범위 회귀 `BUILD SUCCESSFUL in 58s` |
| `./gradlew ktlintCheck` | 성공 | `BUILD SUCCESSFUL in 14s` |
| `git diff --check` | 성공 | 출력 없음 |

**최종 결론:** `REV-049` 처리 완료. Phase 6 후속 Gate 완료.

**다음 Goal:** `P7-R6`.

## 15. 6차 통합 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위와 방식

- 기준 문서: PRD Feature F, OpenAPI FanTalk 3개 operation
- 검토 범위: FanTalk controller의 query/JSON mapping, reply strict parser·저장 경계와 관련 테스트
- 기준 상태: 현재 working tree
- 검증 방식: 문서·코드·테스트 정적 대조. 사용자 요청에 따라 Gradle, 컴파일, 테스트는 실행하지 않았다.

### `REV-054` — High — 처리 완료

- OpenAPI는 reply POST의 requestBody media type을 `application/json` 하나로 정의하고 415 response를 선언한다.
- reply controller mapping에는 `consumes = [MediaType.APPLICATION_JSON_VALUE]`가 없다.
- body를 `String`으로 받으므로 미지원 media type이 mapping 단계에서 차단되지 않고 handler/parser까지 진입할 수 있다.
- 기존 reply 계약·생성·ownership 테스트는 `application/json` 요청만 사용해 415 `Accept` header와
  insert/event no-side-effect를 고정하지 않는다.
- 외부 HTTP 요청 수용 범위와 명시된 415가 달라 High로 판정한다.

### plan 전환

- 신규 Task: `Task 6.8` / `P6-R3`
- Gate: `P6-R3-GATE`
- 최소 수정: reply POST mapping에 JSON `consumes` 추가
- 완료 조건: 정상 JSON 축약 응답 회귀, 미지원 media type의 KO/EN/JA 415 envelope, `Accept` header,
  reply insert/event 0회
- 범위 밖: strict parser·root/ownership·언어 감지, 목록/삭제, OpenAPI·legacy/public API 변경

### `P6-R3` / `P6-R3-GATE` 처리 결과

- RED: production 변경 전 `AiCharacterAdminFanTalkReplyContractTest`에 KO/EN/JA `text/plain` reply POST 415 matrix를
  추가했고, focused 명령은 3개 invocation이 415 기대 실패로 `BUILD FAILED in 33s`였다.
- GREEN: reply POST mapping에 `consumes = [MediaType.APPLICATION_JSON_VALUE]`만 추가했다. strict parser,
  root/ownership, 언어 감지, 목록/삭제, OpenAPI schema는 변경하지 않았다.
- Gate: 같은 focused 명령은 `BUILD SUCCESSFUL in 41s`, FanTalk/common 영향 범위와
  `AiCharacterAdminErrorContractTest` 회귀는 `BUILD SUCCESSFUL in 47s`였다.

**최종 결론:** `REV-054` 처리 완료. Phase 6은 `P6-R4` 완료 전 종결할 수 없다.

**다음 Goal:** `P6-R4`.

## 16. FanTalk 답변 수정 계약 검토 — 2026-07-29

### 리뷰 범위와 근거

- 요청: FanTalk 답변을 수정하는 V2 관리자 API 추가, 레거시 `PUT /explorer/profile/cheers` 계약 유지
- 레거시 근거: `ExplorerController.modifyCheers`, `ExplorerService.modifyCheers`, `PutWriteCheersRequest`,
  `CreatorChannelFanTalkResponse`
- 현재 V2 근거: FanTalk controller/facade/repository/DTO와 목록·답변 작성·팬 원글 삭제 3개 operation
- 검증 방식: 문서·레거시·현재 V2 코드 정적 대조와 `./gradlew tasks --all` 프로젝트 인식 확인. 사용자 지시에 따라
  컴파일·테스트·lint는 실행하지 않았다.

### `REV-059` — High — FanTalk 답변 수정 V2 관리자 operation 부재

- 처리 전 V2 관리자 FanTalk에는 선택한 AI 캐릭터가 작성한 기존 reply의 내용이나 활성 상태를 수정할 route가 없었다.
- 레거시 request는 `cheersId`와 optional/nullable `content`, `isActive`를 받고 non-null 값만 반영한다. 두 필드를
  함께 입력할 수 있고 `{}` 또는 explicit null은 성공 no-op이다.
- 레거시는 비활성 row도 조회하므로 `isActive=true` 재활성화가 가능하고, 수정 시 `languageCode`와 event를 변경하지 않는다.
- 성공 `data`는 `CreatorChannelFanTalkResponse`이며 reply row를 매핑하므로 `fanTalkId`는 reply ID,
  `creatorReplies`는 빈 배열이다.
- 관리자 V2에서는 위 계약에 `characterId`, root `fanTalkId`, `replyId` path를 적용하고 target AI가 writer이자
  creator이며 지정한 활성 root의 direct child인 reply로 소유 경계를 강화해야 한다.

### 확정 계약과 plan 전환

- 신규 operation:
  `PUT /api/v2/admin/ai-characters/{characterId}/fan-talks/{fanTalkId}/replies/{replyId}`
- request: optional/nullable `content`, `isActive`; 동시 입력과 빈 객체 no-op 허용, JSON-only·미지 필드 거부
- response: 레거시 `CreatorChannelFanTalkResponse` 필드 형태
- inactive reply 재활성화 허용, inactive root·cross-target/root·팬 작성 row·direct-parent mismatch는 400/no mutation
- 신규 Task: `Task 6.9` / `P6-R4`
- Gate: `P6-R4-GATE`
- OpenAPI 상태: 전체 37개 operation 모두 `implemented`

### 구현 결과와 Gate

- RED: `AiCharacterAdminFanTalkReplyUpdateTest`와 `AiCharacterAdminFanTalkReplyUpdateContractTest` 신규 15건이
  미구현 route 404로 `BUILD FAILED in 49s`였다.
- GREEN: 신규 PUT route, JSON `consumes`, strict request DTO, active root와 target AI writer/creator direct reply를
  검증하는 repository query, non-null field만 반영하는 facade를 추가했다.
- Gate: focused 재실행은 `BUILD SUCCESSFUL in 42s`, FanTalk/common/legacy 영향 범위 회귀는
  `BUILD SUCCESSFUL in 1m 2s`, OpenAPI status 집계는 37개 모두 `implemented`, `ktlintCheck`는
  `BUILD SUCCESSFUL in 25s`, `git diff --check`는 출력이 없었다.

**최종 결론:** `REV-059` 처리 완료. Phase 6의 P6-R3/P6-R4 후속 보완은 완료됐다.

**다음 Goal:** `P7-R8`.

## 17. 7차 통합 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위와 방식

- 기준 문서: PRD Feature F, OpenAPI FanTalk 4개 operation
- 검토 범위: 목록 pagination, 답변 작성·수정 JSON 경계, 팬 root 삭제, target/root/reply ownership
- 검증 방식: 현재 working tree의 문서·코드·관련 테스트를 정적으로 대조했다. 사용자 요청에 따라 컴파일과 테스트는
  실행하지 않았다.

### 판정

| 항목 | 결과 | 근거 |
|---|---|---|
| route/operation | 충족 | FanTalk 4개 OpenAPI operation과 controller mapping 일치 |
| JSON request | 충족 | 답변 작성·수정의 JSON-only mapping과 strict unknown-field 거부 유지 |
| ownership/state | 충족 | active root, target AI direct reply, fan root soft delete 조건 유지 |
| 7차 multipart finding 영향 | 없음 | FanTalk에는 multipart request가 없음 |

### finding 및 plan 전환

- 신규 Phase 6 finding 없음.
- Phase 6 신규 Task/Gate 없음.

**최종 결론:** Phase 6 추가 수정 없음

**남은 항목:** `P7-R9` 통합 재판정.

## 18. 8차 통합 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위와 방식

- 기준 문서: PRD Feature F/Edge Cases, OpenAPI FanTalk DELETE description, `api-contract.md`
- 검토 범위: FanTalk root delete facade/repository와 `AiCharacterAdminFanTalkDeleteTest`
- 기준 상태: 현재 working tree
- 리뷰어/상태: Codex / 판정 완료
- 검증 방식: 문서·코드·테스트 소스 정적 대조. 사용자 지시에 따라 컴파일과 테스트는 실행하지 않았다.

### `REV-070` — Low — 비활성 팬 root 삭제 설명 상충

- OpenAPI `api-contract.openapi.json:785`와
  `AiCharacterAdminFanTalkDeleteTest.kt:76-101`은 같은 target의 이미 비활성인 팬 root 삭제를 성공 no-op으로
  정의한다. `api-contract.md:229-231`도 같은 결과를 설명한다.
- 반면 PRD `prd.md:227-228`은 비활성 root를 400 거부 대상으로 묶고, `api-contract.md:41`도 “활성 root만”이라고
  적어 같은 문서 안에서 뒤쪽 no-op 설명과 상충한다.
- 기계 계약인 OpenAPI와 현재 구현·회귀가 일치하므로 runtime 변경보다 설명 문서를 no-op 계약에 맞추는 최소 보완이
  적절하다. 실행 오류가 아니라 문서 불일치이므로 Low로 판정한다.
- 이 판정은 OpenAPI를 기계 계약 원본으로 두고 구현·테스트와 일치하는 쪽을 유지한 결과다. PRD의 400 문장이 최신 제품
  의도라면 `P6-R5`를 실행하기 전에 OpenAPI와 runtime/test까지 변경하는 별도 범위로 재확정해야 한다.

### plan 전환

| 항목 | 내용 |
|---|---|
| 신규 Task | `Task 6.10` / `P6-R5` |
| Gate | `P6-R5-GATE` |
| 변경 | PRD와 `api-contract.md`의 상충 문장만 OpenAPI/runtime no-op 계약에 동기화 |
| TDD 예외 | 문서 전용 Task이며 OpenAPI·구현·test 소스 정적 대조로 검증 |
| 범위 제한 | runtime/test/OpenAPI·legacy/public 변경 없음 |

**최종 결론:** Phase 6 문서 보완 필요 — `REV-070` 확정

**다음 Goal:** `P6-R5` (`P5-R10-GATE` 완료 후).

## 19. 8차 후속 문서 정합화 및 Gate — 2026-07-29

- 무엇을: `REV-070`의 FanTalk 비활성 팬 root 삭제 설명 상충을 정리했다.
- 왜: OpenAPI·구현·`AiCharacterAdminFanTalkDeleteTest`는 같은 target의 이미 비활성인 팬 root 삭제를 200 `data:null` no-op으로 고정하지만 PRD 일부 문장이 400 거부로 설명했기 때문이다.
- 어떻게: PRD Edge Cases와 `api-contract.md` 삭제 설명을 같은 target 비활성 팬 root no-op, creator root·reply·다른 target·미존재 root 400으로 동기화했다. runtime/test/OpenAPI는 변경하지 않았다.
- 결과: 문서-only 보완으로 `REV-070` 처리 완료. 정적 대조와 diff check 결과는 `P7-R10-GATE`에 통합 기록한다.

**최종 결론:** `REV-070` 처리 완료. Phase 6 후속 Gate 완료.

**남은 항목:** 없음.

## 20. 9차 정적 리뷰 및 판정 — 2026-07-29

### 리뷰 범위와 방식

- 기준 문서: PRD Feature F/Edge Cases, OpenAPI FanTalk 4개 operation
- 검토 범위: 목록, 답변 작성·수정, 팬 root 삭제, target/root/direct reply ownership
- 검증 방식: 현재 working tree의 문서·production·test 소스를 정적으로 대조했다. 사용자 지시에 따라 컴파일과
  테스트는 실행하지 않았다.

### 판정 및 plan 전환

- FanTalk 4개 operation과 pagination, strict JSON, target AI reply ownership, root 삭제 no-op 계약을 대조했다.
- 기존 완료 finding 이후 신규 확정 finding은 없다.
- Phase 6 신규 Task/Gate 없음.

**최종 결론:** Phase 6 추가 수정 없음.

**남은 항목:** Phase 3 보완 뒤 `P7-R11` 통합 재판정.

## 21. 10차 정적 리뷰 및 판정 — 2026-07-30

### 리뷰 범위와 방식

- 기준 문서: PRD Feature F, OpenAPI FanTalk 4개 operation
- 검토 범위: 목록, creator reply 작성·수정, 팬 root 삭제와 target/root/direct reply ownership
- 검증 방식: 현재 working tree의 문서·production·test 소스를 정적으로 대조했다. 사용자 지시에 따라 컴파일과
  테스트는 실행하지 않았다.

### 판정

- FanTalk 4개 operation과 controller mapping, 공개 v2 page/size 보정·응답 필드가 일치한다.
- 답변 작성은 active root와 target creator writer/creator를, 수정은 target의 active root direct reply를 검증한다.
- 팬 root row-only soft delete와 동일 target 비활성 root 성공 no-op 계약이 문서·구현에 일치한다.
- 신규 확정 finding이 없어 Phase 6 회귀 수정 Task/Gate를 추가하지 않는다.

**최종 결론:** Phase 6 요구사항 충족, 추가 수정 없음.

**남은 항목:** 없음.