Files
sodalive-backend-spring-boot/docs/20261116_메타데이터번역신속반영/plan-task.md
T

50 KiB
Raw Blame History

메타데이터 자동 번역 신속 반영 구현 계획

항목 내용
상태 연관 콘텐츠 제목 번역 포함 구현·기능 검증·독립 리뷰 완료
작성일 2026-11-16
요구사항 prd.md
현재 활성 Goal 없음
다음 Goal 없음

목표와 제약

기존 DB 큐에서 감지 후 작업 등록, 최초+5회 재시도, 요청 시 실패 재개, AWS 번역 우선과 1초 워커를 제공한다. Kotlin 1.6.21, Java 17, Spring Boot 2.7.14와 기존 패키지/스키마/API/캐시를 유지한다. 새 worktree, 커밋, 배포, 외부 유료 호출은 만들지 않는다. 시작 작업 트리는 깨끗했고 현재 브랜치는 test다. 단일 구현 Goal 안에서 파일이 겹치지 않는 작업을 분담하며, Gradle 실행은 부모가 직렬로 관리한다. 전체 테스트는 사용자 실행 ./gradlew test이며 에이전트는 기능별 테스트, ktlintCheck, bootJar만 실행한다.

Phase 1: 번역 수명주기와 요청 연결

  • Task 1.1: 순서·재시도·신속 처리 구현

Goal P1-T1: 감지 성공부터 실패 소진 후 재요청까지 번역 상태가 요구사항대로 이어진다.

  • 시작 조건: MT-001~007 확정, PRD와 이 계획 준비.
  • 완료 증거: 아래 RED/GREEN, 트랜잭션 저장/롤백과 재개 검증, 기능별 회귀 통과.
  • 범위 밖: 감지 자체 새 재시도, 외부 API/브로커 추가, 운영 데이터 일괄 변경, 응답 스키마 변경.

작업 A: 공통 큐와 워커

파일:

  • src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobScheduler.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobRepository.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorker.kt
  • src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobSchedulerTest.kt
  • src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorkerTest.kt
  • 같은 테스트 패키지의 DB 재시도 통합 테스트.

계약: 기존 scheduleMissingTranslation 시그니처를 유지한다. 기존 FAILED 행만 원자적으로 재개하고 현재 원문 해시를 사용한다. 진행 중 작업과 완료 작업은 요청으로 초기화하지 않는다. 워커는 최초 실행 뒤 5회 재시도하며 1/5/15/15/15분 지연을 사용한다. 기본 fixedDelay는 1000ms이며 5개 그룹 처리와 SKIP LOCKED claim을 유지한다.

재개 DB 경계는 TranslationJobRepository.restartFailedJob(jobId: Long, now: LocalDateTime): Int 조건부 update다. id와 FAILED 조건으로 4개 필드를 함께 변경하며 persistence context를 자동 clear하지 않는다.

  • RED: 기존 행의 상태별 재개, 동시 재개, 5회 재시도 경계와 1초 설정의 실패 테스트 작성.
  • RED 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest'에서 의도한 assertion 실패 확인.
  • GREEN: 기존 상태 전이와 DB 경합 경계에서 최소 구현.
  • GREEN 확인: 동일 focused 테스트와 추가 DB 통합 테스트 통과.
  • REFACTOR: 새 중복만 정리하고 캐시/부분 실패 회귀를 기능별 실행.

작업 B: 언어 감지와 콘텐츠 수정

파일:

  • src/main/kotlin/kr/co/vividnext/sodalive/content/LanguageDetectEvent.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/admin/content/AdminContentService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/creator/admin/content/CreatorAdminContentService.kt
  • 직접 생성자를 쓰는 해당 기능의 테스트 fixture.
  • src/test/kotlin/kr/co/vividnext/sodalive/content/의 감지 트랜잭션 통합 테스트 및 관련 관리자 수정 테스트.

계약: 일반 메타데이터 감지 성공 후 ResourceTranslationJobScheduler를 같은 트랜잭션에서 직접 호출한다. 커뮤니티의 기존 revision/hash 검증과 after-commit 경로는 보존한다. 관리자 제목/설명 변경과 크리에이터 관리자 태그 없는 제목/설명 변경도 커밋 후 번역 이벤트를 발행한다.

  • RED: 실제 DB로 감지 후 작업 존재/롤백, 태그 없는 관리자 텍스트 수정의 작업 요청 누락을 재현.
  • RED 확인: 해당 신규 감지 테스트와 관련 관리자 기능 테스트에서 의도한 실패 확인.
  • GREEN: 기존 서비스/리스너에 최소 연결 수정.
  • GREEN 확인: 감지·관리자 수정 focused 테스트 통과.
  • REFACTOR: 커뮤니티 감지/동시성 기능 회귀를 별도 실행하고 기존 보호 확인.

작업 C: 공급자 기본 순서

파일:

  • src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt
  • src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderSpringConfigurationTest.kt
  • 필요한 production 기본값 소유 테스트.
  • docs/20261109_감지번역공급자공통화/provider-guide.md

계약: 번역 AWS/Papago, 감지 Papago/AWS. 기존 캐시와 fallback 유지.

  • RED: 기본 Spring 설정에서 실제 coordinator가 AWS 번역을 선택하고 감지는 Papago를 선택하는 실패 테스트.
  • RED 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'의 선택 결과 실패 확인.
  • GREEN: production 순서와 현재 가이드 변경.
  • GREEN 확인: 같은 테스트 및 provider/coordinator 관련 기능 회귀 통과.
  • REFACTOR: 과거 이력은 보존하고 현재 실행 안내만 정합성 확인.

작업 D: 조회 시 실패 재개

파일:

  • src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/content/theme/AudioContentThemeService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/content/category/CategoryService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/chat/character/controller/ChatCharacterController.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/chat/original/service/OriginalWorkTranslationService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt
  • 해당 기능의 기존/신규 focused 테스트.

최종 HTTP/DB 연결 확인 파일: src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt. 실제 관리자 controller multipart 요청과 Spring 서비스/이벤트/DB를 실행하고 동일 FAILED 행 재개와 필드별 작업 저장을 검증한다. 외부 공급자는 호출하지 않고 비동기 executor를 테스트에서 동기 실행하여 커밋 후 동작을 결정적으로 확인한다.

계약: 기존 번역 요청 진입점에서 현재 원문과 대상 locale의 FAILED를 재개한다. 이전 번역 행이 있어도 요청이 전달된다. 원문 fallback과 기존 번역 응답을 유지하고, 관계없는 목록 전체에 번역 요청을 추가하지 않는다.

추가 공통 파일: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/ResourceTranslationJobScheduler.kt. 읽기 전용 상위 트랜잭션에서도 저장 가능한 restartFailedResourceTranslations(resourceType, resourceIds: Collection<Long>, targetLanguage) REQUIRES_NEW 진입점을 사용한다. FAILED 후보가 없으면 원문을 불필요하게 추출하지 않으며, 현재 원문에 해당하는 작업만 재개한다. 커뮤니티 쓰기 잠금 안에서는 이 REQUIRES_NEW 읽기 진입점을 호출하지 않고 기존 REQUIRED 예약으로 처리한다. 계획 검토에서 제안된 모든 projection/list의 광범위한 변경은 채택하지 않고 PRD의 기존 번역 요청 경계로 한정한다.

  • RED: 이전 번역이 존재하는 상태에서도 조회가 현재 원문의 FAILED를 재개하는 실패 테스트.
  • RED 확인: 변경 기능의 focused 테스트에서 의도한 실패 확인.
  • GREEN: 기존 요청 분기의 예약 위치를 조정한다.
  • GREEN 확인: 각 기능 focused 테스트 통과.
  • REFACTOR: 실제 DB 재개 주기와 기존 응답 유지 확인.

Phase 1 Gate

Goal P1-GATE: MT-001~007과 직접 영향 기능의 검증/리뷰 증거를 판정한다.

  • 시작 조건: P1-T1의 구현과 focused RED/GREEN 완료.

  • TDD 예외 사유: Gate는 기존 구현 검증/리뷰이며 새 동작을 추가하지 않는다.

  • 완료 증거: 기능별 테스트, lint/bootJar, DB 동작 QA, 단일 독립 리뷰와 문서 갱신.

  • 범위 밖: 전체 테스트, 실 AWS/Papago/IAM 및 운영 MySQL/배포 검증.

  • 번역 공통 패키지 및 언어 감지 캐시 기능 회귀.

  • 콘텐츠/관리자 수정·시리즈·테마·카테고리·캐릭터/원작·커뮤니티의 직접 영향 기능별 회귀.

  • ./gradlew --no-daemon ktlintCheck bootJar 통과.

  • 실제 트랜잭션의 저장/롤백, 실패 소진 후 조회/수정 재개, 캐시 재사용 QA.

  • 한 명의 리뷰어가 요구사항/동시성/테스트 증거 검토, 지적 사항 해결.

  • PRD/계획 완료 상태와 미검증 범위 기록.

검증 기록

후속 Goal P1-T4: 콘텐츠 상세 조회의 언어 감지 선행

  • 시작 조건: MT-010 확정, getDetail의 null/blank 언어 분기 누락과 기존 감지 후 번역 경로 확인.
  • 목표: 미감지 콘텐츠 상세 조회가 커밋 후 언어 감지를 거쳐 기존 번역 job 등록으로 이어진다.
  • 완료 증거: null/빈 문자열/공백 회귀 RED/GREEN, 실제 트랜잭션의 언어/job 저장, 기존 상세 번역 회귀 통과.
  • 범위 밖: API/DB 스키마 변경, 새 감지 job 시스템, 다른 리소스 조회 수정, 운영 일괄 복구, 관련 없는 리팩터링.
  • 구현 파일: src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt.
  • 테스트 파일: src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt.
  • 기존 회귀: src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AudioContentReadRetryTest.kt, src/test/kotlin/kr/co/vividnext/sodalive/content/MetadataLanguageDetectTransactionTest.kt, src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt.
  • RED: 기존 HTTP/DB 테스트에 미감지 상세 조회 시나리오를 추가한다.
  • RED 확인: focused test에서 언어/job 미저장 assertion 실패를 확인한다.
  • GREEN: 기존 이벤트와 활성 tag 값을 사용하는 미감지 분기를 추가한다.
  • GREEN 확인: 동일 focused test에서 상세 원문 응답과 감지 후 번역 job 저장을 확인한다.
  • REFACTOR: 불필요한 정리 없이 관련 회귀 및 ktlintCheck/bootJar 결과를 기록한다.

진행 기록:

  • 2026-11-17 변경 전: 아래 4개 클래스 focused 명령 exit 0(42초), 28건 실패/skip 0. 기존 동작의 baseline을 확인했다.
  • 2026-11-17 RED: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest.shouldDetectMissingLanguageAfterDetailHttpGetCommits*' --console=plain — exit 1(32초). 3개 입력 모두 HTTP 200과 원문 응답을 유지하지만 커밋 후 감지 언어가 저장되지 않아 실패했다. 증거: build/detail-language-evidence/red.xml, red.log.
  • 2026-11-17 GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --console=plain — exit 0(42초), 4건 통과. 증거: build/detail-language-evidence/green.xml, green.log.
  • 2026-11-17 관련 회귀: 아래 4개 클래스 focused 명령에 ktlintCheck bootJar --console=plain을 함께 실행했다. 테스트 31건 실패/skip 0과 bootJar 성공 후, 새 테스트의 인자 줄바꿈 2곳에서 lint가 실패했다(exit 1, 62초). 해당 줄바꿈만 수정했다.
  • 2026-11-17 최종 변경 검증: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' ktlintCheck --console=plain — exit 0(40초), HTTP 4건 통과, Kotlin 테스트 컴파일과 전체 ktlintCheck 성공. production 변경은 없어 bootJar를 반복 실행하지 않았다.
  • HTTP/DB 관찰: 실제 GET /audio-content/{id}?timezone=Asia/Seoul을 MockMvc로 실행했다. null/빈 문자열/공백 각각 HTTP 200, 원문 제목·미리보기 설명·활성 태그 응답을 확인했다. 커밋 전 감지 호출/번역 job 0건, 커밋 후 별도 트랜잭션 재조회에서 ko와 title/detail/tags × en/ja의 PENDING job 6건을 확인했다. 감지 stub은 전체 설명과 활성 태그가 정확히 전달될 때만 성공한다.
  • 검증 한계: 테스트 executor는 동기 실행으로 커밋 경계를 결정적으로 검증하며 실제 외부 AWS/Papago와 운영 MySQL은 호출하지 않았다. LSP 진단 도구가 제공되지 않아 Kotlin 컴파일과 ktlint를 사용했다. 전체 테스트는 미실행, 사용자 실행 명령은 ./gradlew test다. 독립 리뷰 결과 대기.

검증 명령:

./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest'
./gradlew --no-daemon ktlintCheck bootJar

후속 Gate P1-T4-GATE

  • 시작 조건: P1-T4의 RED/GREEN과 관련 회귀 완료.
  • 완료 증거: HTTP 응답/DB 저장 결과, 변경 diff 확인, 단일 독립 리뷰, 임시 자원 정리.
  • 범위 밖: 전체 테스트(사용자 실행 ./gradlew test), 실제 AWS/Papago 호출, 운영 MySQL/배포.
  • TDD 예외 사유: 구현 후 증거 검토이며 신규 동작은 추가하지 않는다.
  • 기능 검증·lint/build·리뷰 결과와 미검증 범위를 기록한다.
  • 2026-11-17 Gate: 단일 독립 리뷰 APPROVE, 차단 사유 없음. 실제 트랜잭션/이벤트 연결, null/empty/blank HTTP 회귀, 전체 설명·활성 태그 사용, 기존 번역 재개와 롤백 보존을 확인했다. git diff --check 통과. 프로덕션 변경은 상세 조회 조건문 한 곳이며, 커밋·배포는 하지 않았다.
  • 2026-11-17 커밋 전 재검증: 위 4개 클래스 focused 명령에 ktlintCheck --console=plain을 함께 실행해 exit 0(82초), 테스트 31건 실패/오류/skip 0을 확인했다. ktlintCheck는 UP-TO-DATE, git diff --check 통과. 전체 테스트와 외부 AWS/Papago·운영 MySQL은 미검증이며, 전체 테스트 사용자 실행 명령은 ./gradlew test다.

후속 Goal P1-T3: 콘텐츠 태그 미번역 fallback과 기존 완료 작업 복구

  • 시작 조건: MT-008/009 및 Papago 동일 결과 성공 정책 확정.
  • 완료 증거: AWS 동일/쉼표 공백 결과와 캐시 배제, Papago 결과 저장, 기존 완료 작업 재개 후 재요청 안정성, 비대상 필드 보호.
  • 범위 밖: 일반 문장 번역 품질 판단, # 제거/태그 형식 변경, AWS 실계정 비교, 운영 일괄 재번역, 원문 hash 변경.
  • 공통 결과 검증 파일: i18n/translation/{TranslateRequest,TranslationCoordinator,SourceTextNormalizer,TranslationJobWorker,TranslationReadModelMaterializer}.kt (루트 src/main/kotlin/kr/co/vividnext/sodalive/).
  • 캐시 갱신 파일: 같은 패키지의 TranslationMemory.kt. 기존 AWS 미번역 캐시가 있는데 새 AWS 결과가 정상인 경우 같은 행의 번역 텍스트만 갱신한다. 정상 캐시와 Papago 확인 결과는 덮어쓰지 않는다.
  • 복구 파일: 같은 패키지의 TranslationJobScheduler.kt, TranslationJobRepository.kt, ResourceTranslationJobScheduler.kt 및 직접 생성자 fixture.
  • scoped flag: TranslateRequest.rejectUnchangedAwsResult: Boolean = false, TranslationCoordinator.findCached(..., rejectUnchangedAwsResult: Boolean = false). worker/materializer에서 CONTENT/tags만 true로 전달한다.
  • 비교 함수: SourceTextNormalizer.hasSameCommaSeparatedText(first: String, second: String): Boolean; 기존 normalize를 각 쉼표 요소에 적용하고 순서대로 비교한다. 기존 normalize/hash 동작은 그대로다.
  • 복구 판단: 현재 job 언어/hash 일치, CONTENT/tags/COMPLETED, 저장된 content_translation tags가 원문과 동일한 경우만 검사한다. scoped cache가 저장된 rendered tags와 정확히 같으면 이미 확인된 정상 결과로 보존하고, 그 외에는 조건부 COMPLETED→PENDING으로 복구한다. 작업 ID를 보존하고 retryCount/error/nextRetryAt를 초기화한다.
  • 현재 원문 태그가 비어 있지 않은데 저장된 응답 행 또는 tags가 누락된 완료 작업도 워커 재조립 대상으로 처리한다. 캐시가 있으면 외부 호출 없이 복구하며 정상 번역된 응답은 유지한다.
  • read 복구는 기존 ResourceTranslationJobScheduler 재개 경계에서 COMPLETED CONTENT/tags 후보만 추가 조회해 현재 source와 대조한다. 다른 리소스/필드와 PENDING/RUNNING을 초기화하지 않는다.
  • RED: coordinator의 scoped 동일 결과/캐시, 실제 worker+materializer 경계, 이전 완료 작업과 Papago 동일 결과 보존 회귀를 작성하고 실패 확인.
  • GREEN: 최소 결과 판정과 조건부 완료 작업 복구 구현, 같은 focused 테스트 통과.
  • REFACTOR: 직접 영향 번역/감지/read/관리자/커뮤니티 테스트, ktlintCheck/bootJar, DB 시나리오와 단일 gate 리뷰 완료.

후속 Goal P1-T2: 감지도 AWS 우선으로 전환

  • 시작 조건: 사용자가 기존 감지 캐시 유지와 AWS/Papago 순서를 승인했다.
  • 완료 증거: Spring 기본 감지 AWS 선택, 실제 AWS adapter SDK 응답 처리, AWS 실패 시 Papago, 기존 Papago 캐시 무호출 재사용.
  • 범위 밖: 감지 알고리즘/confidence/지원 언어/캐시 무효화/번역·재시도 재설계.
  • production 파일: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt.
  • 테스트 파일: 같은 i18n/translation 테스트 패키지의 LanguageProviderSpringConfigurationTest.kt, LanguageProviderIdTest.kt, LanguageDetectionProviderTest.kt, LanguageProviderCacheEndToEndTest.kt.
  • 문서: 기존 PRD 및 docs/20261109_감지번역공급자공통화/provider-guide.md.
  • RED: 기본 설정의 AWS 감지와 fallback/cache 회귀 기대를 작성하고 의도한 실패 확인.
  • GREEN: detectionOrder만 AWS/Papago로 변경하고 관련 감지·설정·캐시 테스트 통과.
  • REFACTOR: 현재 가이드 갱신, ktlintCheck/bootJar, 후속 delta 리뷰와 임시 자원 정리.
  • 검증 명령: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProvider*Test' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'.

후속 회귀 Goal P1-R1: 다른 원문 언어의 FAILED 보존

  • 시작 조건: gate reviewer가 MT-003의 현재 원문 한정 재개 누락을 확인했다.

  • 완료 증거: 같은 해시/다른 원문 언어 작업은 직접 예약과 번역 행 없는 조회 모두에서 재개되지 않는다.

  • 범위 밖: 작업 고유 키/스키마 변경, 이전 언어 데이터 변환, materializer 재설계.

  • 파일: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobScheduler.kt, src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobRetryIntegrationTest.kt, src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/OriginalWorkReadRetryTest.kt.

  • RED: 두 경로의 다른 원문 언어 FAILED 보존 회귀 테스트 추가.

  • RED 확인: 두 테스트 클래스에서 FAILED 기대/PENDING 실제 실패 확인.

  • GREEN: FAILED 재개 조건에 정규화된 현재 원문 언어 일치 추가.

  • GREEN 확인: 두 테스트 클래스 및 직접 영향 scheduler/read/HTTP 테스트 통과.

  • REFACTOR: lint/build 및 차단 사항 delta 재검토 완료.

  • 2026-11-16 기준 상태: Java 17.0.15, 작업 트리 깨끗함, 기존 브랜치 test에서 작업한다.

  • 구현 전 ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest': exit 0, 16초. 기존 Gradle 9 호환성 deprecation 안내가 출력됐다.

  • 전체 테스트는 미실행이며 사용자 실행 명령은 ./gradlew test다.

  • 2026-11-16 RED: worker/scheduler/retry DB/provider Spring/provider ID/coordinator 43건 중 14건이 의도한 assertion으로 실패했다. 기본 600000ms, 조기 FAILED, 기존 FAILED 미재개, Papago 우선이 각 실패 원인이며 컴파일은 성공했다.

  • 2026-11-16 공급자 GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderIdTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest': exit 0, 37초. 기본 AWS 선택, Papago 감지 유지, fallback와 실제 H2 캐시/조회 결과 보존을 확인했다.

  • 2026-11-16 연결 RED와 큐 GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest.shouldRequestTranslationAfterCommitWhenMetadataIsUpdatedWithoutTags*' --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest': exit 1, 감지 10건·조회 10건·관리자 수정 8건이 의도한 assertion으로 실패했다. 같은 실행의 worker 13건/scheduler 3건/retry DB 9건은 모두 통과했다. H2에서 기존 FAILED 재개, 동시 요청, RUNNING 선점 뒤 오래된 요청 보호, 자동 재개 금지를 확인했다. H2 claim은 운영 쿼리의 SKIP LOCKED 옵션만 제거한 테스트이며 MySQL 잠금 동작 검증이 아니다.

  • 2026-11-16 연결 GREEN: 감지 10건, 조회 15건, 관리자 수정 8건, HTTP 1건 통과. 이후 번역/감지 회귀 191건과 직접 영향 기능 회귀 67건(HTTP 1건 중복)을 실행해 총 257개 고유 사례에서 실패/오류/skip 0을 확인했다.

  • 2026-11-16 최종 lint/build: 첫 main/test 인자 줄바꿈 위반을 변경 부분에서 수정한 뒤 ktlintCheck/bootJar 및 직접 수정 기능 49건을 함께 실행해 exit 0을 확인했다. HTTP test는 이벤트 발행을 끊는 변이로 DB assertion RED도 확인하고 원상 복구했다.

  • 정확한 회귀 명령·QA 관찰값·원본 증거 경로·H2/Redis 로그 한계는 검증 기록에 보존한다. 현재 단일 독립 reviewer 판정 대기다.

  • 2026-11-16 P1-R1: reviewer가 일반 예약 경로에서 이전 원문 언어의 FAILED도 재개하는 누락을 확인했다. 직접 scheduler와 번역 행 없는 원작 조회 2건의 RED를 확인하고 원문 언어 일치 guard를 추가했다. 직접 영향 74건과 ktlintCheck/bootJar는 exit 0이며 추가 2건을 포함한 고유 검증 사례는 259건이다. delta 재검토 대기.

  • 2026-11-16 최종 Gate: 동일 독립 reviewer가 P1-R1 수정과 RED/GREEN/XML 74건 및 lint/build 증거를 대조해 APPROVE했다. 차단 사항 없음. 전체 테스트와 운영 MySQL/외부 공급자 검증은 별도이며 커밋·배포는 하지 않았다.

  • 2026-11-16 P1-T2: 감지 AWS 우선 변경 전 기본값/실제 SDK adapter/기존 캐시 관련 7개 assertion RED를 확인했다. detectionOrder 한 줄 변경 후 명시된 감지·공급자·캐시 기능 테스트 49건(8개 클래스, 실패/오류/skip 0) 및 ktlintCheck/bootJar가 exit 0이다. 후속 delta 리뷰 대기.

  • 2026-11-16 P1-T2 최종: 독립 reviewer APPROVE. 현재 가이드의 잔여 PAPAGO 우선 테스트 설명도 AWS로 정정했다. 이전 기능 검증 기록과 완료 상태를 보존하며, 후속 감지 변경까지 완료했다.

  • 2026-11-16 P1-T3 forward RED: H2 JSON을 로딩하는 fixture cleanup 실패를 bulk cleanup으로 고친 뒤, ContentTagTranslationIntegrationTest 8건 중 6건이 AWS 원문 동일 결과/캐시를 성공으로 인정하는 원인으로 실패했다. 설정 오류를 RED 증거로 간주하지 않았다.

  • 2026-11-16 P1-T3 forward GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest': exit 0, 29건. 콘텐츠 태그에만 적용한 판정과 Papago 결과 저장/캐시 조립을 확인했다.

  • 2026-11-16 P1-T3 repair RED: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.CompletedContentTagRepairTest': 27건 중 11건이 COMPLETED 재개 누락으로 실패했다. 정상 번역/다른 필드/다른 언어/진행 상태/Papago 동일 결과 보호 16건은 통과했다.

  • 2026-11-16 P1-T3 repair GREEN: 완료 작업 복구 27건과 forward 9건 통과. 이후 기존 미번역 AWS 캐시 뒤 정상 AWS 결과 갱신 실패를 추가 RED로 확인하고 같은 캐시 행의 translatedText만 갱신했다.

  • 2026-11-16 P1-T3 최종 검증: 공통 회귀 232건 통과 후 새 조건문 braces lint 3건을 수정했다. 조회→worker→재조회 연속 DB 사례까지 추가한 최종 직접 영향 회귀 104건과 ktlintCheck/bootJar가 exit 0이다. 고유 사례 277건이며 명령/증거/한계는 태그 fallback 검증 기록에 있다. 독립 리뷰 대기.

  • 2026-11-16 P1-T3 최종 Gate: 단일 독립 reviewer가 MT-008/009와 전체 태그 처리/캐시/완료 복구/경합 보호 및 실행 증거를 확인해 APPROVE했다. 차단 사항 없음. 이번 태그 후속 변경은 커밋·배포하지 않았다.

  • 2026-11-16 커밋 전 검증: 사용자 커밋 요청에 따라 번역·감지 및 직접 영향 기능을 함께 재실행했다. 33개 클래스 261건의 실패/오류/skip 0, ktlintCheck/bootJar는 UP-TO-DATE, 전체 명령은 exit 0(2분 3초)이다. 정확한 명령은 검증 기록의 커밋 전 재검증 절에 남긴다. 전체 테스트는 미실행이며 사용자 실행 명령은 ./gradlew test다.

  • 2026-11-17 P1-T3 커밋 전 재검증: 번역 패키지와 직접 영향 감지·커뮤니티·OSIV 기능 32개 클래스 277건을 실행해 실패/오류/skip 0을 확인했다. ktlintCheck/bootJar는 UP-TO-DATE, 명령은 exit 0(1분 17초), git diff --check도 통과했다. 정확한 명령은 태그 검증 기록의 커밋 전 재검증 절에 남긴다. 전체 테스트와 실제 외부 공급자·운영 MySQL은 미검증이며 전체 테스트는 사용자 실행 ./gradlew test로 구분한다.

Phase 2: 콘텐츠 상세의 동기 번역

  • Task 2.1: 최초 상세 응답에 번역 결과 제공

Goal P2-T1: 미번역 콘텐츠 상세 조회가 요청 언어의 제목·설명·태그를 동기 번역해 저장하고 같은 HTTP 응답으로 제공하며, 실패해도 원문과 기존 재시도를 유지한다.

  • 시작 조건: MT-011~014 사용자 승인, 변경 전 상세/worker/tag 테스트 통과.
  • 완료 증거: 아래 RED/GREEN 및 직접 영향 회귀, 실제 HTTP 응답과 별도 DB 재조회.
  • 범위 밖: 목록·다른 리소스의 처리 변경, 새로운 큐/의존성/스키마, 운영 데이터 및 유료 공급자 호출, 커밋/배포, 공급자 timeout 설정 변경.
  • 실행: subagent-driven-development의 단일 구현 단위로 순차 TDD. 파일/DB를 공유하므로 구현자를 병렬 실행하지 않는다. 부모가 후속 실제 HTTP QA와 단일 gate 리뷰를 담당한다.

Files:

  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt의 상세 번역 분기와 응답 languageCode 매핑.
  • Create: src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationService.kt의 상세 전용 동기 조립 경계.
  • Create: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationMemoryService.kt에 worker의 기존 캐시·번역·저장 로직 이동.
  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorker.kt의 공용 메모리 서비스 사용.
  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationReadModelMaterializer.kt의 CONTENT 저장에 짧은 row lock을 사용하고, TranslationSourceExtractor.kt의 콘텐츠 원문 태그를 상세의 활성 태그 기준과 일치시킨다.
  • 필요 시 저장 경합의 최소 보정: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationMemoryRepository.kt, src/main/kotlin/kr/co/vividnext/sodalive/content/translation/ContentTranslationRepository.kt.
  • Test: src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationHttpIntegrationTest.kt 신규 Spring HTTP/DB 통합 테스트.
  • Test fixture: 같은 테스트 디렉터리의 ContentDetailTranslationTestConfiguration.kt에 전용 profile의 HTTP/DB 구성과 외부 공급자 대체를 둔다.
  • Update: src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt의 비동기 감지 기대를 승인된 동기 계약으로 변경한다. 관리자 수정 사례를 보존한다.
  • Update: 위 번역 테스트 패키지의 AudioContentReadRetryTest.kt, TranslationJobWorkerTest.kt, TranslationJobRetryIntegrationTest.kt, ContentTagTranslationIntegrationTest.kt, LanguageProviderCacheEndToEndTest.kt 및 src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt 등 영향받는 직접 생성자/Spring import fixture만 갱신한다.

Interfaces 및 구현 기준:

  • AudioContentDetailTranslationService.resolve(contentId: Long, targetLanguage: String): AudioContentDetailTranslationResult는 원문 언어와 nullable TranslatedContent를 반환한다. HTTP DTO는 변경하지 않는다.
  • TranslationMemoryService.ensureMemory(resourceType, fieldKey, sourceText, sourceLanguage, targetLanguage)는 기존 TranslationJobWorker.ensureMemory의 의미를 보존한다. 캐시/태그 판정을 복제하지 않는다.
  • 상세 번역은 Spring proxy의 NOT_SUPPORTED 경계로 상세 트랜잭션과 분리하고 짧은 별도 트랜잭션에서 감지 결과/메모리/최종 payload를 저장한다. commit 오류는 트랜잭션 밖에서 처리한다. 외부 번역 중 DB write lock을 유지하지 않는다.
  • 감지는 전체 제목·설명·활성 태그로 기존 LanguageDetectionCacheService를 호출한다. 언어 저장 시 현재 값과 원문을 재확인하며 다른 요청이 저장한 언어를 덮어쓰지 않는다. 외부 트랜잭션의 managed entity에는 따로 저장한 언어를 다시 할당하지 않고 반환값을 응답에 사용한다.
  • 기존 번역이 있으면 반환하고 기존 FAILED/태그 복구 의미를 유지한다. 없으면 요청 언어의 누락 필드만 동기 번역하고 TranslationReadModelMaterializer로 완성한다. 동일 언어/미지원 언어·빈 필드는 기존 규칙대로 처리한다.
  • 동기 성공에 새 요청 언어 job은 필수로 만들지 않는다. 동기 실패 시 기존 scheduler로 등록/재개하고 원문 반환한다. 언어 감지 실패는 기존 after-commit 이벤트를 이용한다. 새로운 감지 재시도 체계는 만들지 않는다.
  • 동시 요청/worker의 유일키 경쟁은 별도 트랜잭션의 canonical winner 재조회 또는 기존 DB 원자 연산으로 처리한다. 일반 무결성 오류를 성공으로 처리하지 않는다. 중복 provider 호출 자체를 막는 새 분산 lock은 추가하지 않는다.
  • worker의 claim/상태 변경/6회 시도/backoff는 변경하지 않는다. materialize의 false를 완성된 번역으로 반환하지 않는다.

시나리오 계약:

사례 통과 조건 검증 표면
최초 조회와 재조회 첫 HTTP 200의 translated.title/detail/tags와 저장 payload 일치, 재조회는 공급자 재호출 없이 같은 결과 RANDOM_PORT 상세 GET, 별도 DB 트랜잭션
언어 미감지와 경계 null/empty/blank 언어를 감지 후 같은 요청에서 번역, 동일 언어/미지원 언어는 원문, 빈 필드는 빈 문자열 상세 GET 및 감지 캐시/콘텐츠 DB
실패와 복구 공급자/저장 실패 시 원문 HTTP 200, outer commit 성공, 기존 job 등록 후 worker로 복구 상세 GET, 실제 persistence 실패, job/worker/재조회
인접 동작과 경합 기존 AWS 태그 fallback·캐시·worker 정책 보존, 동시 요청 저장 후 고유 키당 한 행과 재사용 가능한 번역 기존 focused tests, latch 기반 별도 트랜잭션
  • RED: 최초 동기 응답, 언어 감지, 실패 fallback을 실제 서비스/DB에 연결한 HTTP 테스트로 작성한다. 공급자만 대체하며 로직은 실제로 실행한다.
  • RED 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --console=plain에서 번역 없는 응답의 의도한 assertion 실패를 확인한다.
  • GREEN: 공유 메모리 로직과 상세 전용 경계로 최소 구현한다. 필요 경합/실패 회귀를 먼저 RED로 확인한다.
  • GREEN 확인: 같은 focused 명령에서 첫 응답/저장/재사용/실패/경합을 통과한다.
  • REFACTOR: 생성자 fixture와 기존 비동기 감지 계약만 갱신하고 직접 영향 회귀를 실행한다. 승인 범위 밖 파일 정리는 하지 않는다.

Phase 2 Gate

Goal P2-GATE: 상세 API의 승인된 동작과 기존 번역 회귀, 빌드/포맷, 단일 독립 리뷰 및 임시 자원 정리를 완료한다.

  • 시작 조건: P2-T1 체크박스와 RED/GREEN 증거 완료.
  • 완료 증거: 아래 명령과 HTTP 관찰 결과, 단일 리뷰에 차단 사유 없음, 소유 임시 디렉터리/프로세스 제거.
  • TDD 예외 사유: 검증/리뷰 Goal이며 새 기능을 구현하지 않는다.
  • 범위 밖: 전체 테스트, 실제 외부 공급자·운영 MySQL·배포 검증.
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --console=plain
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --console=plain
./gradlew --no-daemon ktlintCheck bootJar --console=plain
  • 실제 상세 GET 응답과 committed DB/재시도 결과를 기록한다.
  • 직접 영향 회귀 및 ktlintCheck/bootJar 성공 또는 외부 제한의 근거를 기록한다. LSP 도구는 제공되지 않아 Kotlin 컴파일과 ktlint로 대체한다.
  • 단일 reviewer의 요구사항/트랜잭션/동시성/테스트 검토를 완료한다.
  • 임시 RUN_TMP, 테스트/QA 자원을 정리하고 PRD/계획 상태를 완료로 기록한다.
  • 전체 테스트는 에이전트 미실행이며 사용자 실행 명령은 ./gradlew test다.

P2 진행 기록

  • 2026-11-17 baseline: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --console=plain — exit 0, 37초. 기존 상세/worker/tag 동작이 통과했다. Gradle 9 호환 deprecation 안내는 기존 상태다.
  • 2026-11-17 계획 결정: 같은 상세 감지 기능의 연속 작업이므로 신규 문서 디렉터리 대신 이 PRD/계획에 P2를 추가했다. 기존 완료 기록은 보존한다. 계획 agent 제안 중 성공 시 무조건 job 예약·여러 리뷰·추가 추상화는 채택하지 않고 승인된 최소 범위로 제한한다.
  • 2026-11-17 P2-T1 RED: 신규 RANDOM_PORT HTTP 테스트 7건 중 5건이 expected: <English title> but was: <null>로 실패했다(exit 1, 34초). production 변경 전 최초 응답·감지 null/empty/blank·cache-only 요구 부재를 확인했다. 테스트 구성 오류 3회는 RED 근거에 포함하지 않는다.
  • 2026-11-17 P2-T1 추가 RED: AudioContentDetailTranslationHttpIntegrationTest.shouldRestartOnlyExistingFailedJobAfterSynchronousSuccess에서 번역 성공 후 기존 FAILED가 유지되어 expected: <PENDING> but was: <FAILED>로 실패했다(exit 1, 38초). 성공 시에도 새 job 없이 기존 FAILED/태그 유지보수만 수행하도록 보완했다.
  • 2026-11-17 P2-T1 GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --tests 'kr.co.vividnext.sodalive.osiv.OsivLazyLoadingRegressionTest' --console=plain — exit 0, 3분 5초. 30개 클래스 277건, 실패/오류/skip 0. 부모가 build/reports/tests/test/index.html 및 신규 HTTP 15건/worker 13건 XML을 직접 확인했다.
  • 2026-11-17 P2-GATE 1차 lint/build: ./gradlew --no-daemon ktlintCheck bootJar --console=plain — exit 1, 21초. 새 Kotlin 코드의 인자 줄바꿈/130자 초과로 ktlintMainSourceSetCheck 실패. bootJar 완료로 간주하지 않으며 변경된 파일의 포맷만 수정한다.
  • 구현 상세: NOT_SUPPORTED 상세 경계와 짧은 REQUIRES_NEW 저장으로 commit 실패를 격리한다. 실제 CHECK 제약 위반에서 원문 HTTP 200과 job 복구를 확인했다. 동시 상세 2건/worker 1건은 실제 H2 유일키 충돌 후 메모리 3행·payload 1행으로 수렴했다. H2 JSON fixture는 converter 문자열 재조회용 varchar이며 운영 MySQL JSON/잠금 검증은 아니다.
  • 2026-11-17 포맷/정리: 변경 파일의 줄바꿈·130자 제한만 수정했다. 상세 변경으로 고아가 된 AudioContentService의 ResourceTranslationJobScheduler 생성자 의존성을 제거하고 직접 생성자 테스트 2곳을 맞췄다. ContentTranslationRepository는 목록 사용처가 있어 유지했다. ./gradlew --no-daemon ktlintCheck --console=plain — exit 0, 21초.
  • 2026-11-17 부모 QA/빌드: 임시 Gradle init task로 기존 테스트 context와 fixture를 띄우고 Java HttpClient에서 상세 GET을 직접 호출했다. 최초 번역·DB 저장·재조회, 미감지 언어, 공급자 실패→worker 복구, 실제 DB CHECK 실패→worker 복구가 모두 HTTP 200과 기대 번역으로 확인됐다. 첫 실행은 bootJar/컴파일과 모든 기능 assertion은 성공했으나 임시 QA runner의 afterTestClass 호출을 context 종료 뒤에 둬 종료 코드 1이었다. runner 종료 순서만 수정했다.
  • 2026-11-17 최종 QA/생성자 회귀: ./gradlew --no-daemon -I "$RUN_TMP/qa.init.gradle" runContentDetailQa test --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain — exit 0. 실제 HTTP QA 전체 통과, 생성자 정리 영향 테스트 17건 실패/skip 0. 277건 전체 기능 범위는 앞선 실행 결과이며 포맷/미사용 생성자 제거 후 변경 영향만 재검증했다.
  • 최종 실제 HTTP 응답·QA 관찰·리뷰 판정은 동기 상세 검증 기록에 보존한다. LSP 도구·실제 공급자·운영 MySQL은 미검증, 전체 테스트는 사용자 실행 ./gradlew test다.
  • 2026-11-17 P2-GATE 리뷰: 단일 Oracle reviewer APPROVE. MT-011~014 충족, API/DB/worker 정책 보존과 실제 HTTP/DB 실패·경합 증거를 확인했고 차단 사항이 없다. 구매 전 translated.detail이 전체 payload인 기존 계약을 변경하지 않았음을 확인했다. 운영 MySQL JSON/1062/잠금 및 실제 공급자 지연은 미검증 범위다. 신규 테스트 명령 예시는 docs/agent-guides/실행명령어.md에 추가했다.
  • 2026-11-17 P2-GATE 정리 완료: 부모 QA runner/test worker/Gradle wrapper가 없고 HTTP 포트 58600에 listener가 없음을 확인했다. 검증 결과와 응답 발췌를 문서에 보존한 뒤 부모 RUN_TMP의 Java/init script·class·로그·notepad를 삭제하고 디렉터리 부재를 확인했다(exit 0). 구현자 임시 root 2개도 제거했으며 공유 캐시/기존 IDE daemon은 건드리지 않았다. 커밋·배포는 하지 않았다.
  • 2026-11-17 P2 커밋 전 재검증: 사용자 커밋 요청에 따라 상세 동기 번역·번역 패키지·감지·OSIV 직접 영향 범위 30개 클래스 277건을 재실행해 실패/오류/skip 0을 확인했다. ktlintCheck와 bootJar는 UP-TO-DATE, 전체 명령은 exit 0(2분 22초), git diff --check도 통과했다. 정확한 명령은 동기 상세 검증 기록의 커밋 전 재검증 절에 남긴다. 전체 테스트·실제 공급자·운영 MySQL은 미검증이며 전체 테스트는 사용자 실행 ./gradlew test다.

Phase 3: 상세 연관 콘텐츠의 저장된 번역 제목

목표: 상세의 이전화/다음화와 두 추천 목록에서 요청 언어에 맞는 저장된 제목이 표시된다. 설계: 기존 조회 결과의 ID를 모아 ContentTranslationRepository로 한 번 조회하고 OtherContentResponse를 copy한다. 원문 기반 탐색·정렬과 DTO 스키마를 보존하며, 공통 서비스나 새 의존성을 추가하지 않는다. 기준: PRD MT-015~016. 기존 상세 번역 작업의 연속 수정이므로 문서를 재사용한다.

  • Task 3.1: 연관 콘텐츠 제목 번역 누락 수정

Goal P3-T1: 네 응답 필드의 title은 현재 언어의 비어 있지 않은 저장 번역이며 없으면 기존 원문이다.

  • 시작 조건: 사용자 최소 범위 승인, 기존 코드 및 HTTP 테스트 확인.
  • 완료 증거: 실제 결함의 RED, 동일 HTTP 테스트 GREEN, 직접 영향 회귀.
  • 범위 밖: 새 번역 생성, 공급자/작업 큐 변경, navigation 정렬 변경, DTO 확장, 전체 테스트.

Files:

  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt
  • Test: src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationHttpIntegrationTest.kt
  • Test configuration: src/test/kotlin/kr/co/vividnext/sodalive/content/ContentDetailTranslationTestConfiguration.kt

Interfaces: findByContentIdInAndLocale(contentIds, locale)와 기존 OtherContentResponse(contentId, title, coverUrl)를 사용한다.

  • RED: 기존 HTTP 테스트를 먼저 실행한 뒤 네 필드의 번역 선택과 fallback 회귀를 같은 테스트 클래스에 추가한다.
  • RED 확인: 새 번역 시나리오가 원문 제목 반환 assertion으로 실패함을 확인한다.
  • GREEN: getDetail에서 중복 제거한 관련 ID의 번역을 일괄 조회하고 비어 있지 않은 제목만 응답에 적용한다.
  • GREEN 확인: 같은 HTTP 테스트를 실행해 모든 필드가 기대 번역 또는 원문인 것을 확인한다.
  • REFACTOR: 직접 영향 기능 테스트 및 Kotlin 컴파일/ktlint 검증을 수행한다. 새 추상화나 무관한 정리는 하지 않는다.

시나리오 계약

  1. 저장된 en/ja 제목: 실제 GET /audio-content/{id}?timezone=UTC를 en→ja→en으로 호출할 때 네 필드의 제목이 각 locale 값과 정확히 일치한다. ID·순서·coverUrl은 변하지 않는다.
  2. fallback: 번역 없음·다른 locale만 존재·빈 제목·공백 제목에서 해당 항목은 원문이다. 연관 콘텐츠 때문에 공급자 호출 또는 번역 job이 추가되지 않는다.
  3. 인접 회귀: 시리즈 없는 콘텐츠는 previousContent/nextContent가 null이고 관련 콘텐츠가 없으면 목록은 비어 있다. 본문 상세 번역과 기존 언어 감지·실패 복구 테스트는 통과한다.

Phase 3 Gate

Goal P3-GATE: 승인된 네 필드의 HTTP 동작과 최소 변경 범위를 독립 검토하고 종료한다.

  • 시작 조건: P3-T1 완료.
  • 완료 증거: 아래 focused tests, 실제 HTTP JSON 관찰, lint/build, 단일 리뷰 판정과 임시 자원 정리 기록.
  • 범위 밖: 운영 데이터 변경, 전체 테스트, 유료 공급자 호출.
  • TDD 예외 사유: Gate는 구현이 아니라 결과 검증이다.
  • 대체 검증 방법: HTTP 응답/테스트 결과/변경 diff 대조.
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain
./gradlew --no-daemon ktlintCheck bootJar --console=plain
  • 실제 HTTP 응답에서 세 시나리오의 결과를 확인하고 기록한다.
  • 직접 영향 테스트와 ktlintCheck/bootJar 결과를 기록한다. LSP 도구가 제공되지 않으면 Kotlin 컴파일/ktlint 대체 사실을 명시한다.
  • 단일 독립 리뷰에서 차단 사항이 없음을 확인한다.
  • 작업 소유 임시 파일과 QA 자원을 정리하고 문서 상태를 갱신한다.
  • 종료 조건: 위 시나리오가 실제 HTTP로 확인되고 관련 테스트 통과, 가능한 진단/빌드의 결과 및 한계 기록, 리뷰 승인과 임시 자원 정리가 끝나면 즉시 종료한다.
  • 전체 테스트는 사용자 실행 ./gradlew test이며 기능 범위 완료와 구분한다.

P3 진행 기록

  • 2026-11-17 조사/승인: 네 projection이 원문 title을 반환하고 상세 조립에 번역 적용이 없음을 확인했다. 기존 목록의 batch lookup 및 blank fallback을 재사용한다. 사용자가 저장된 번역만 적용하는 범위를 승인했다. 시작 작업 트리는 깨끗하다.
  • 2026-11-17 baseline: 기존 AudioContentDetailTranslationHttpIntegrationTest 15건 통과(exit 0, 29초).
  • 2026-11-17 P3-T1 RED: 테스트만 추가한 뒤 같은 HTTP 클래스 21건 중 1건 실패(exit 1, 38초). shouldLocalizeRelatedTitlesForEachRequestedLanguageWithoutChangingNavigation에서 previousContent의 기대 제목 en 가 이전 대신 가 이전 반환을 확인했다. ID와 coverUrl은 일치했다.
  • 2026-11-17 P3-T1 GREEN: 위 Gate의 세 클래스 focused 명령 exit 0(51초). 상세 HTTP 21건, AudioContentServiceTest 16건, AudioContentReadRetryTest 1건으로 38건 전부 통과(실패/오류/skip 0). 부모가 XML 세 파일을 직접 확인했다. en→ja→en, 네 필드의 fallback·ID·cover·null/빈 목록, distinct 배치 1회/빈 경우 0회, 관련 공급자 호출·job 추가 없음이 검증됐다. 랜덤 추천 목록은 ID별로 대조하고, 각 요청의 순서는 서비스 map이 보존한다.
  • 2026-11-17 lint/build 1차: ./gradlew --no-daemon ktlintCheck bootJar --console=plain exit 1(25초). 신규 HTTP 테스트 두 표현식의 130자 초과 및 인자 줄바꿈 오류로 ktlintTestSourceSetCheck 실패. 제품 로직의 실패는 아니며 bootJar 성공으로 기록하지 않는다. 해당 표현식의 포맷만 수정하고 재검증한다.
  • 2026-11-17 P3-GATE 부모 QA/lint/build: 인자 줄바꿈만 수정 후 ./gradlew --no-daemon -I "$TMPDIR/qa.init.gradle" runRelatedContentQa ktlintCheck bootJar --console=plain exit 0(50초). Kotlin 테스트 재컴파일, ktlintCheck 및 bootJar 성공. 임시 Java HttpClient에서 실제 Tomcat 포트 59748로 GET 5회를 호출해 en→ja→en, 혼합 fallback, 빈 관계와 본문 번역 보존을 확인했다. 기존 38건의 동작 검증은 그대로 유효하며 포맷 수정 후 실제 HTTP QA로 추가 확인했다. 상세 증거는 연관 콘텐츠 검증 기록에 보존한다.
  • 2026-11-17 P3-GATE 리뷰: 단일 Oracle reviewer APPROVE(신뢰도 높음), 차단 사항 없음. 네 필드의 요청 언어/fallback·조회 계약·번역 부작용 없음과 XML/실제 HTTP 증거를 확인했다. 부모가 QA PID 85049 부재, TCP 59748 listener 없음, 구현자 임시 root 부재를 확인했다.
  • 2026-11-17 P3-GATE 완료: 실제 응답 및 리뷰 결과를 문서에 보존한 뒤 부모 content-translation.TfjAph root의 QA Java/init script·class·보고서와 별도 ulw 노트를 삭제했다(exit 0). 경로 부재를 확인했으며 공유 캐시와 작업 외 파일은 유지했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이다. 전체 테스트는 사용자 실행 ./gradlew test다. 커밋은 하지 않았다.
  • 2026-11-17 P3 커밋 전 재검증: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' ktlintCheck bootJar --console=plain exit 0(1분 1초). XML 세 파일에서 38건(21/16/1) 성공, 실패/오류/skip 0을 확인했다. ktlintCheck와 bootJar는 UP-TO-DATE이며 git diff --check도 통과했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 전체 테스트는 사용자 실행 ./gradlew test다.