sodalive-backend-spring-boot/docs/20260226_콘텐츠시리즈상세차단오류메시지수정.md

2026-02-26 콘텐츠/시리즈 상세 차단 오류메시지 수정

구현 체크리스트

• 콘텐츠 상세(getDetail) 차단 예외 메시지 키를 전용 차단 키로 변경
• 시리즈 상세(getSeriesDetail) 차단 예외 메시지 키를 전용 차단 키로 변경
• SodaMessageSource에 콘텐츠/시리즈 차단 전용 메시지 키 추가
• 정적 진단 및 테스트로 변경 영향 검증

검증 기록

1차 구현

• 무엇: AudioContentService.getDetail의 차단 예외 키를 content.error.blocked_access로 변경하고, ContentSeriesService.getSeriesDetail의 차단 예외 키를 series.error.blocked_access로 변경했다. SodaMessageSource에 두 키를 추가해 한국어 기준으로 각각 "콘텐츠 접근이 차단되었습니다.", "시리즈 접근이 차단되었습니다."를 반환하도록 반영했다.
• 왜: 기존에는 차단 상황에서도 invalid_content_retry/invalid_series_retry를 사용해 오류 의미가 모호했고, 요청 사항대로 차단 상황을 명확한 문구로 안내해야 했기 때문이다.
• 어떻게:
  • lsp_diagnostics (AudioContentService.kt, ContentSeriesService.kt, SodaMessageSource.kt) 실행: 실패 (현재 실행 환경에 Kotlin LSP 미구성으로 .kt 진단 불가)
  • ./gradlew test 실행: 성공
  • ./gradlew ktlintCheck 실행: 성공
  • ./gradlew build 실행: 성공