sodalive-backend-spring-boot/docs/20260709_팬톡_작성수정_응답보강/plan-task.md

팬톡 작성/수정 응답 보강 Plan/Task

시나리오 계약

• Happy path: 인증 사용자가 POST /explorer/profile/cheers를 호출하면 HTTP 200과 함께 $.data.fanTalkId, $.data.writerId, $.data.content, $.data.creatorReplies=[]가 반환된다. Real surface: MockMvc controller test.
• Edge: 인증 사용자가 PUT /explorer/profile/cheers로 내용을 수정하면 HTTP 200과 함께 수정 후 content가 $.data.content에 반환된다. Real surface: MockMvc controller test.
• Adjacent regression: 기존 V2 FanTalk 탭 CreatorChannelFanTalkResponse.from(domain) 매핑과 조회 controller 응답은 유지된다. Real surface: 기존 CreatorChannelFanTalkControllerTest, DTO/facade unit test.

Phase 1: 문서와 RED 테스트

• Task 1.1: PRD/plan-task 작성
  • 파일 경로: docs/20260709_팬톡_작성수정_응답보강/prd.md, docs/20260709_팬톡_작성수정_응답보강/plan-task.md
  • RED: 문서 작업은 TDD 예외. TDD 예외 사유: 코드 동작 변경 전 요구사항 고정 문서다.
  • GREEN: 요구사항, non-goal, 시나리오, 검증 명령을 문서화한다.
  • REFACTOR: 문서 경로와 명령 유효성을 확인한다.
  • 검증 기록: docs/20260709_팬톡_작성수정_응답보강/prd.md, docs/20260709_팬톡_작성수정_응답보강/plan-task.md를 생성해 endpoint 유지, legacy 직접 수정, CreatorChannelFanTalkResponse 반환 범위를 문서화했다.
• Task 1.2: 작성/수정 응답 RED 테스트 추가
  • 파일 경로: src/test/kotlin/kr/co/vividnext/sodalive/explorer/ExplorerControllerTest.kt, src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/fantalk/application/CreatorChannelFanTalkFacadeTest.kt
  • RED: ./gradlew test --tests kr.co.vividnext.sodalive.explorer.ExplorerControllerTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.application.CreatorChannelFanTalkFacadeTest --no-daemon 실행 시 신규 기대 동작이 미구현이라 실패해야 한다.
  • GREEN: 구현 후 같은 명령이 통과해야 한다.
  • REFACTOR: 기존 FanTalk 탭 controller 테스트를 함께 실행한다.
  • RED 검증 기록: 신규 controller 테스트 추가 직후 같은 명령을 실행했고, ExplorerService.writeCheers/modifyCheers가 Unit 반환이라 CannotStubVoidMethodWithReturnValue로 2개 테스트 실패를 확인했다.

Phase 2: 최소 구현

• Task 2.1: legacy cheers 응답 매핑 구현
  • 파일 경로: src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/fantalk/dto/CreatorChannelFanTalkTabResponse.kt
  • RED: legacy CreatorCheers를 CreatorChannelFanTalkResponse로 만들 수 없어 테스트가 실패한다.
  • GREEN: CreatorChannelFanTalkResponse.from(CreatorCheers, cloudFrontHost)를 추가한다.
  • REFACTOR: 기존 domain 기반 from 매핑을 변경하지 않는다.
  • GREEN 검증 기록: CreatorChannelFanTalkResponse.from(CreatorCheers, cloudFrontHost)를 추가해 작성자 ID/닉네임/프로필 URL/content/UTC 생성 시각/빈 creatorReplies를 매핑했다.
• Task 2.2: 작성/수정 서비스 반환값 변경
  • 파일 경로: src/main/kotlin/kr/co/vividnext/sodalive/explorer/ExplorerService.kt, src/main/kotlin/kr/co/vividnext/sodalive/explorer/ExplorerController.kt
  • RED: controller/service가 Unit을 반환해 data가 비어 있다.
  • GREEN: 저장/수정 후 CreatorChannelFanTalkResponse를 반환한다.
  • REFACTOR: 메시지와 기존 검증 흐름을 유지한다.
  • GREEN 검증 기록: ExplorerService.writeCheers, ExplorerService.modifyCheers가 저장/수정된 CreatorCheers를 CreatorChannelFanTalkResponse로 반환하도록 변경했고, ExplorerController의 기존 ApiResponse.ok(service..., message) 흐름은 유지했다.

전체 검증 기록

• 작업 시작 전 확인: rg -n "explorer/profile/cheers|CreatorChannelFanTalkResponse|writeCheers|modifyCheers"로 대상 controller/service/DTO 위치를 확인했다.
• RED: ./gradlew test --tests kr.co.vividnext.sodalive.explorer.ExplorerControllerTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.application.CreatorChannelFanTalkFacadeTest --no-daemon 실행 결과 신규 테스트 2개가 CannotStubVoidMethodWithReturnValue로 실패해 기존 서비스 반환 타입이 Unit임을 확인했다.
• GREEN/인접 회귀: ./gradlew test --tests kr.co.vividnext.sodalive.explorer.ExplorerControllerTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.application.CreatorChannelFanTalkFacadeTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.adapter.in.web.CreatorChannelFanTalkControllerTest --no-daemon 실행 결과 BUILD SUCCESSFUL in 1m을 확인했다.
• Diff 검증: git diff --check 실행 결과 출력 없이 통과했다.
• 포맷 검증: ./gradlew ktlintCheck --no-daemon 실행 결과 BUILD SUCCESSFUL in 1m 21s를 확인했다.
• 문서 명령 검증: ./gradlew tasks --all --no-daemon 실행 결과 BUILD SUCCESSFUL in 20s를 확인했다.
• 전체 회귀 검증: ./gradlew test --no-daemon 실행 결과 BUILD SUCCESSFUL in 8m 56s를 확인했다.
• 리뷰 게이트 1차 결과: 목표 검증/QA/컨텍스트 마이닝은 PASS였지만, 보안 리뷰와 코드 품질 리뷰에서 PUT /explorer/profile/cheers가 작성자/크리에이터가 아닌 인증 사용자에게도 cheersId 기반 응답 데이터를 반환할 수 있다는 IDOR성 정보 노출 지적이 나왔다.
• 보안 RED: ExplorerServiceTest.shouldRejectModifyCheersForNonWriterAndNonCreator 추가 직후 ./gradlew test --tests kr.co.vividnext.sodalive.explorer.ExplorerServiceTest --no-daemon 실행 결과 AssertionFailedError로 실패해 비작성자/비크리에이터 요청이 예외 없이 데이터를 받을 수 있음을 확인했다.
• 보안 GREEN: ExplorerService.modifyCheers에서 isWriter, isCreator를 계산하고 둘 다 아니면 SodaException(messageKey = "common.error.invalid_request")를 던지도록 수정했다. 이후 ./gradlew test --tests kr.co.vividnext.sodalive.explorer.ExplorerServiceTest --tests kr.co.vividnext.sodalive.explorer.ExplorerControllerTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.application.CreatorChannelFanTalkFacadeTest --tests kr.co.vividnext.sodalive.v2.api.creator.channel.fantalk.adapter.in.web.CreatorChannelFanTalkControllerTest --no-daemon 실행 결과 BUILD SUCCESSFUL in 1m 12s를 확인했다.
• 최종 포맷 검증: 보안 수정 후 ./gradlew ktlintCheck --no-daemon 실행 결과 BUILD SUCCESSFUL in 1m 47s를 확인했다.
• 최종 문서 명령 검증: 보안 수정 후 ./gradlew tasks --all --no-daemon 실행 결과 BUILD SUCCESSFUL in 30s를 확인했다.
• 최종 diff 검증: 보안 수정 후 git diff --check 실행 결과 출력 없이 통과했다.
• 최종 전체 회귀 검증: 보안 수정 후 ./gradlew test --no-daemon 실행 결과 BUILD SUCCESSFUL in 14m 53s를 확인했다.