Files
sodalive-backend-spring-boot/docs/20261116_메타데이터번역신속반영/reviews/related-content-title-review.md
T

7.9 KiB

상세 연관 콘텐츠 제목 번역 검증과 리뷰

항목 내용
대상 MT-015~016 / P3-T1, P3-GATE / 미커밋 working tree
일자 2026-11-17
기준 PRD, 계획
상태 기능 검증 완료, 독립 리뷰 APPROVE

범위와 구현 근거

AudioContentService.getDetail에서 네 관련 필드의 ID를 중복 제거하고 현재 LangContext locale의 저장 번역을 한 번 조회한다. 비어 있지 않은 title만 immutable DTO copy로 반영하고 원문 기반 navigation/쿼리/ID/cover/각 요청의 목록 순서를 유지한다. 새 번역 생성·job·스키마·의존성·공개 API는 추가하지 않는다. 제품 변경은 서비스 18줄 추가와 응답 할당 4줄 교체다.

자동 검증

  • 기존 HTTP baseline: 15건 성공.
  • RED: 신규 HTTP 포함 21건 중 1건 실패. expected title=en 가 이전, actual title=가 이전, ID와 cover 일치.
  • GREEN: 아래 focused 명령에서 38건 성공(HTTP 21, service 16, retry 1), 실패/오류/skip 0. 부모가 XML 세 파일을 직접 확인했다.
  • 테스트 두 표현식의 포맷 실패를 수정한 뒤 실제 HTTP QA 및 ktlintCheck, bootJar를 실행해 exit 0을 확인했다. 테스트 동작은 변경하지 않았다.
./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 -I "$TMPDIR/qa.init.gradle" runRelatedContentQa ktlintCheck bootJar --console=plain

자동 검증 산출물: build/test-results/test/TEST-kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest.xml, TEST-kr.co.vividnext.sodalive.content.AudioContentServiceTest.xml, TEST-kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest.xml. HTTP 테스트 timestamp는 2026-11-17T03:26:24이며 이후 변경은 인자 줄바꿈뿐이다.

부모가 직접 실행한 HTTP QA

위 두 번째 명령은 임시 Java runner가 기존 Spring test context와 fixture를 사용하고 Java HttpClient로 실제 Tomcat 서버를 호출한다. 외부 공급자·principal은 테스트 대체이며 controller/service/JPA/트랜잭션은 실제 코드다. H2 DB에서 fixture를 커밋한 후 요청했다. 검증 시 원본 runner: /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/content-translation.TfjAph/RelatedContentQa.java. 임시 runner는 종료 시 삭제하며 실제 응답 발췌와 판정은 이 문서에 보존한다.

시나리오 실행 기대/관찰 판정
현재 언어 저장 번역 같은 /audio-content/1?timezone=UTC에 en→ja→en GET 모두 200. 네 필드의 제목이 각 locale로 전환되고 ID·cover가 유지됨 PASS
혼합 fallback en 제목 삭제/빈 문자열/공백, ja만 남은 항목을 함께 GET 모두 원문 제목. 공급자는 본문 최초 번역 3회만, job 0개 PASS
인접/빈 관계 /audio-content/6?timezone=UTC GET 200, 이전/다음 null, 두 목록 [], 본문 translated.title은 English title PASS

실제 호출과 응답 발췌:

QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
previousContent={"contentId":2,"title":"en 가 이전","coverUrl":"https://cdn.test/related-0.png"}
nextContent={"contentId":3,"title":"en 하 다음","coverUrl":"https://cdn.test/related-1.png"}
creatorOtherContentList=[{"contentId":3,"title":"en 하 다음"},{"contentId":4,"title":"en creator only"},{"contentId":2,"title":"en 가 이전"}]
sameThemeOtherContentList=[{"contentId":5,"title":"en theme only"},{"contentId":2,"title":"en 가 이전"},{"contentId":3,"title":"en 하 다음"}]
translated={"title":"English title","detail":"English detail","tags":"#Healing"}

QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=ja status=200
previousContent={"contentId":2,"title":"ja 가 이전","coverUrl":"https://cdn.test/related-0.png"}
nextContent={"contentId":3,"title":"ja 하 다음","coverUrl":"https://cdn.test/related-1.png"}
creatorOtherContentList=[{"contentId":4,"title":"ja creator only"},{"contentId":2,"title":"ja 가 이전"},{"contentId":3,"title":"ja 하 다음"}]
sameThemeOtherContentList=[{"contentId":5,"title":"ja theme only"},{"contentId":3,"title":"ja 하 다음"},{"contentId":2,"title":"ja 가 이전"}]
translated={"title":"Japanese title","detail":"Japanese detail","tags":"#Japanese"}

QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
QA PASS locale switching: all four fields, IDs/covers, main translation

QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
previousContent.title="가 이전", nextContent.title="하 다음"
creatorOtherContentList titles=["가 이전","하 다음","creator only"]
sameThemeOtherContentList titles=["하 다음","theme only","가 이전"]
QA PASS mixed fallback: originals, no related provider calls/jobs

QA GET http://localhost:59748/audio-content/6?timezone=UTC locale=en status=200
{"previousContent":null,"nextContent":null,"creatorOtherContentList":[],"sameThemeOtherContentList":[],"translated":{"title":"English title","detail":"English detail","tags":"#Healing"}}
QA PASS empty relations: null neighbors, empty lists, translated main
QA CLEANUP: Spring HTTP server and database context closed
BUILD SUCCESSFUL in 50s

목록은 기존 rand 정렬이므로 서로 다른 요청 사이 순서는 달라질 수 있다. 각 요청에서 조회된 순서를 바꾸지 않는 것은 코드의 map/copy와 대조했다. 배치 1회/중복 ID 제거/빈 관계 조회 0회는 실제 repository spy로 반환을 stub하지 않고 HTTP 테스트에서 검증했다.

실행 한계 및 자원

  • LSP 도구가 제공되지 않아 Kotlin 컴파일과 ktlint로 대체했다.
  • 전체 테스트, 운영 MySQL JSON, 실제 AWS/Papago, 실제 로그인·배포는 실행하지 않았다. 전체 테스트는 사용자 실행 ./gradlew test다.
  • 기존 Gradle 9 deprecation, duplicate JSONObject, macOS Netty DNS 경고를 변경하거나 suppress하지 않았다.
  • 임시 QA Java 컴파일에는 runtime classpath에 없는 API guardian annotation 관련 경고 4건이 있었지만 컴파일/실행은 성공했다. 제품 의존성은 변경하지 않았다.
  • Tomcat 종료 시 Hikari housekeeper 경고 뒤 JPA close와 Hikari Shutdown completed가 출력됐고 QA JVM이 정상 종료했다. 별도 상주 서버는 만들지 않았다.
  • 구현자의 p3-t1.JgkJkn 임시 root 부재를 확인했다. QA PID 85049 부재 및 TCP 59748 listener 없음도 확인했다.
  • 승인 후 부모 content-translation.TfjAph root의 QA 실행기·init script·class·임시 보고서와 별도 ulw 노트를 삭제하고 경로 부재를 확인했다(exit 0). 검증 응답/리뷰 결과는 이 문서에 보존했으며 공유 캐시·작업 외 파일은 변경하지 않았다.

독립 리뷰

2026-11-17 단일 Oracle reviewer 판정: APPROVE, 신뢰도 높음, 차단 사항 없음.

  • MT-015/016: 네 필드의 요청 언어 번역과 fallback, 지역 번역 맵을 통한 요청 간 격리, distinct 배치 조회를 확인했다.
  • ID·cover·개수·null 및 각 조회 결과의 순서, 원문 제목 navigation을 보존하며 관련 공급자 호출/job/API/DB/의존성 변경이 없음을 확인했다.
  • 테스트는 실제 HTTP/JPA 계약을 검증하며 mock echo·prose pin·테스트 전용 제품 seam이 없다. 배치 횟수 spy는 PRD의 명시적 제약을 검증한다.
  • reviewer가 XML의 38건 성공과 구현 보고서 RED, QA 문서·Java runner·Gradle init script를 직접 대조했다. 리뷰에서 테스트를 재실행하지 않았다.
  • 잔여 한계: H2는 운영 MySQL 검증을 대체하지 않으며 실제 공급자·인증·전체 테스트는 미검증이다.