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 가 이전, actualtitle=가 이전, 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.TfjAphroot의 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 검증을 대체하지 않으며 실제 공급자·인증·전체 테스트는 미검증이다.