docs(i18n): 시리즈 상세 동기 번역 요구사항과 검증 결과를 기록한다

This commit is contained in:
2026-11-17 14:35:28 +09:00
parent 536a5a6fe5
commit d436fd6bff
4 changed files with 185 additions and 2 deletions
@@ -2,7 +2,7 @@
| 항목 | 내용 |
|---|---|
| 상태 | 연관 콘텐츠 제목 번역 포함 구현·기능 검증·독립 리뷰 완료 |
| 상태 | 시리즈 상세 동기 번역 포함 구현·기능 검증·독립 리뷰 완료 |
| 작성일 | 2026-11-16 |
| 요구사항 | [prd.md](prd.md) |
| 현재 활성 Goal | 없음 |
@@ -393,3 +393,79 @@ Interfaces: `findByContentIdInAndLocale(contentIds, locale)`와 기존 `OtherCon
- 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`다.
## Phase 4: 시리즈 상세의 동기 감지·번역
**목표:** 첫 시리즈 상세 응답에 요청 언어의 제목·소개·키워드가 저장 후 반환된다.
**기준:** PRD MT-017~018, 사용자 "시리즈 자체만" 승인. 열린 요구사항 없음.
**설계:** 콘텐츠 상세의 NOT_SUPPORTED + REQUIRES_NEW 패턴을 시리즈 resolver에 적용한다.
기존 감지 캐시, TranslationMemoryService, TranslationReadModelMaterializer와 SERIES 이벤트/재시도 경로를 재사용한다.
새 worktree 없이 깨끗한 `test` 브랜치의 기존 작업 위치에서 수행하며 커밋은 하지 않는다.
- [x] **Task 4.1: 시리즈 상세 동기 번역 연결**
**Goal P4-T1:** 시리즈 메타데이터의 미감지·미번역을 같은 HTTP 응답 전에 처리하고 실패 시 원문과 기존 복구를 유지한다.
- 시작 조건: 승인된 MT-017~018 및 콘텐츠 상세의 구현·HTTP 테스트 조사 완료.
- 완료 증거: 요구 동작의 RED/GREEN, 실제 HTTP 및 DB 재조회, 직접 영향 회귀 통과.
- 범위 밖: 하위 콘텐츠 신규 번역, 공개 스키마/공급자 설정/DB 변경, 콘텐츠 resolver 리팩터링, 전체 테스트.
Files:
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesDetailTranslationService.kt`
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesService.kt`
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationReadModelMaterializer.kt`
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/content/ContentSeriesDetailTranslationHttpIntegrationTest.kt`
- Test configuration: `src/test/kotlin/kr/co/vividnext/sodalive/content/ContentDetailTranslationTestConfiguration.kt`
- Test fixture: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/ContentSeriesReadRetryTest.kt`
- Test command guide: `docs/agent-guides/실행명령어.md`
Interfaces:
- `ContentSeriesDetailTranslationService.resolve(seriesId: Long, targetLanguage: String): ContentSeriesDetailTranslationResult`
- 결과는 `languageCode: String?`, `translated: TranslatedSeries?`, `detectionQuery: String?`를 가진다.
- snapshot은 기존 extractor와 동일하게 title/introduction/keywords(`joinToString(", ")`)를 사용한다.
- 감지 query는 제목·전체 소개·공백으로 이은 키워드의 비어 있지 않은 텍스트를 합친다.
- 외부 호출은 쓰기 잠금 밖에서 수행한다. 감지 저장과 materialize 직전에 Series 잠금 및 snapshot 비교로 원문 경합을 막는다.
- materializer의 `upsertSeries`도 기존 content와 같은 부모 row 잠금으로 worker/상세의 upsert를 직렬화한다.
- 기존 서비스의 번역 블록을 resolver 호출로 교체하고 감지 실패는 기존 SERIES LanguageDetectEvent로 넘긴다.
- 기존 empty keywords의 원문 fallback, 하위 콘텐츠의 batch 조회, 장르·권한·원문 응답을 보존한다.
- [x] **RED:** 기존 상세 HTTP baseline을 확인하고 시리즈 첫 응답/언어 미감지의 HTTP·DB 회귀 테스트를 작성한다.
- [x] **RED 확인:** 아래 새 클래스 실행에서 translated 누락 및 languageCode 미저장 assertion 실패를 확인한다.
- [x] **GREEN:** resolver와 상세 조립 연결, materializer 잠금 및 직접 생성자 fixture만 최소 수정한다.
- [x] **GREEN 확인:** 같은 클래스에서 캐시/빈 필드/동일·미지원 언어/실패 복구/경합/하위 목록 보존을 검증한다.
- [x] **REFACTOR:** 새 코드의 불필요한 부분만 정리하고 아래 직접 영향 회귀 및 lint/build를 검증한다.
### 시나리오 계약
1. 첫 응답·재사용: 실제 GET에서 200과 요청 locale의 translated가 반환되고 별도 DB 재조회와 일치한다. 두 번째 조회는 공급자 추가 호출이 없다.
2. 감지·경계: null/빈 문자열/공백 언어는 감지 결과를 커밋하고 같은 응답에서 번역한다. 동일/미지원 언어는 번역하지 않고 캐시/빈 필드는 기존 정책을 따른다.
3. 실패·경합: 공급자/실제 저장 실패에도 원문 200과 복구 job이 남고 worker 후 재조회가 성공한다. 동시 원문 수정은 덮어쓰거나 오래된 번역으로 저장하지 않는다. worker/상세가 하나의 번역 행으로 수렴한다.
4. 인접 회귀: 시리즈 원문/장르/응답 스키마와 하위 콘텐츠의 저장 번역/원문 선택은 그대로이며 하위 콘텐츠 신규 번역 호출·job은 없다. 콘텐츠 상세와 기존 FAILED 재개 테스트가 통과한다.
```bash
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --console=plain
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentSeriesReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --console=plain
./gradlew --no-daemon ktlintCheck bootJar --console=plain
```
### Phase 4 Gate
**Goal P4-GATE:** 실제 시리즈 상세 HTTP/DB 결과, 직접 영향 회귀와 최소 변경 범위를 검증하고 종료한다.
- 시작 조건: P4-T1 완료.
- 완료 증거: 부모가 직접 Java HttpClient로 실제 테스트 서버 호출, 응답/DB 대조, 테스트 XML, lint/build, 단일 독립 리뷰.
- 범위 밖: 운영 MySQL/실제 유료 공급자/실제 인증/배포 검증 및 전체 테스트.
- TDD 예외 사유: 구현이 아닌 검증 작업. 실제 HTTP/DB 결과와 diff/명령 출력을 대조한다.
- [x] 실제 HTTP에서 첫 응답·재사용, 감지, 실패·worker 복구 및 하위 목록 보존을 확인한다.
- [x] 관련 테스트 XML 및 ktlintCheck/bootJar 확인. LSP 도구 미제공 시 Kotlin 컴파일 대체를 기록한다.
- [x] 단일 독립 리뷰의 차단 사항을 해소하고 승인받는다.
- [x] 소유 임시 파일·QA 서버·캐시를 정리하고 부재를 확인한다.
- 종료 조건: 위 시나리오의 HTTP/DB 결과와 관련 테스트가 통과하고 빌드/진단 한계, 리뷰 승인, 임시 자원 정리가 기록되면 즉시 종료한다.
- 전체 테스트는 사용자 실행 `./gradlew test`로 분리한다.
### P4 진행 기록
- 2026-11-17 조사/승인: 시리즈 상세에는 감지 없이 저장 번역 조회 또는 job 예약만 있음을 확인했다. 사용자는 시리즈 자체만 동기 처리하도록 승인했다. 명확성 Goal/Scope/Constraints/Success/Context 모두 1.0, 최종 모호성 0.00, 열린 질문 없음. 기존 P1~P3 완료 기록을 보존하고 후속 goal로 추가했다.
- 2026-11-17 P4-T1 TDD: 기존 콘텐츠 HTTP baseline 21건 성공. 최초 시리즈 fixture의 필수 theme 누락을 수정한 뒤 production 수정 전 15건 중 12건의 의도한 RED를 확인했다. 첫 번역 null 및 미감지 언어 미저장이 원인이었다. 최소 구현 후 15건 GREEN, 지정 회귀 7개 클래스 총 82건 성공(exit 0, 1분 1초). 부모가 XML의 실패/오류/skip 0을 확인했다. 첫 GREEN의 컴파일 시간 제한은 성공으로 처리하지 않았으며 종료 확인 후 300초로 재실행했다.
- 2026-11-17 P4-GATE HTTP/lint 1차: 임시 Java HttpClient로 실제 서버 GET 8회/5개 시나리오를 확인했다. 최초 번역·재사용, 하위 저장 제목, 미감지 언어 저장, 공급자 실패 및 실제 CHECK 실패의 원문 200/worker 복구가 모두 PASS. 이어진 ktlintTestSourceSetCheck는 테스트 3파일의 포맷 14건으로 실패했고 bootJar는 미실행이다. 구현자가 포맷만 보정 중이다. [실제 응답과 테스트 증거](reviews/series-detail-review.md).
- 2026-11-17 P4-T1 완료/P4-GATE lint/build: 테스트 3파일의 줄바꿈/import 순서만 보정한 뒤 `./gradlew --no-daemon ktlintCheck bootJar --console=plain` 성공(exit 0, 26초). `git diff --check` 통과. 제품 코드와 테스트 동작 변경이 없어 82건과 실제 HTTP 증거는 유지한다. LSP 도구는 없으며 기존 Kotlin 컴파일/ktlint로 대체했다. 최종 독립 리뷰와 부모 임시 경로 정리가 남았다.
- 2026-11-17 P4-GATE 완료: 단일 Oracle 리뷰 APPROVE(신뢰도 높음), 차단 사항 없음. MT-017/018·원문 경합·실패 격리·하위 목록 보존과 XML 82건/부모 HTTP 증거의 일치를 확인했다. QA PID 1275/TCP 61019 종료와 구현자 root 부재 확인 후 부모 `series-translation.AH2ekJ`의 runner/classes/report/cache 및 별도 ulw 노트를 삭제하고 경로 부재를 확인했다(exit 0). 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 사용자 전체 테스트 명령은 `./gradlew test`다. 커밋하지 않았다.
- 2026-11-17 P4 커밋 전 재검증: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentSeriesReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' ktlintCheck bootJar --console=plain` exit 0(45초). XML 세 파일에서 38건(15/2/21) 성공, 실패/오류/skip 0을 확인했다. `ktlintCheck`와 `bootJar`는 UP-TO-DATE이며 `git diff --check`도 통과했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 전체 테스트는 사용자 실행 `./gradlew test`다.
@@ -3,7 +3,7 @@
| 항목 | 내용 |
|---|---|
| 작성일 | 2026-11-16 |
| 상태 | 상세 동기 번역 및 연관 콘텐츠 제목 번역 구현·기능 검증·독립 리뷰 완료 |
| 상태 | 콘텐츠·시리즈 상세 동기 번역 및 연관 제목 번역 구현·기능 검증·독립 리뷰 완료 |
| 구현 계획 | [plan-task.md](plan-task.md) |
| 결정권자 | 사용자 |
@@ -33,6 +33,8 @@
| MT-014 | 동기 경로와 worker가 같은 번역 정책을 사용한다. | worker의 캐시 조회·공급자 fallback·태그 정책·메모리 저장을 공유한다. 빈 필드, 기존 캐시, 동시 상세 요청과 worker의 저장 경합을 처리하며 다른 리소스의 큐 처리 의미는 유지한다. |
| MT-015 | 상세 연관 콘텐츠 제목에 현재 요청 언어의 저장된 번역을 표시한다. | previousContent, nextContent, creatorOtherContentList, sameThemeOtherContentList의 title에 LangContext 언어의 저장된 번역을 적용한다. 번역 행 없음·빈 제목·공백 제목은 원문이며 다른 언어 번역을 대신 사용하지 않는다. |
| MT-016 | 연관 콘텐츠의 조회 계약을 보존한다. | ID·순서·개수·coverUrl·null/빈 목록·기존 조회 조건을 유지한다. 이전/다음 선택은 원문 제목 기준이다. 연관 콘텐츠 번역을 새로 생성하거나 작업을 등록하지 않고, ID를 중복 제거하여 최대 한 번 일괄 조회한다. 본문 상세의 기존 동기 번역은 유지한다. |
| MT-017 | 시리즈 상세도 같은 응답 전에 언어 감지와 누락 번역을 완료한다. | `GET /audio-content/series/{id}`에서 null/빈 문자열/공백 언어는 제목·소개·키워드로 감지하고 저장한다. 요청 언어의 title/introduction/keywords 번역이 없으면 기존 감지 캐시·번역 메모리·materializer를 사용해 동기로 저장하고 기존 translated 필드에 반환한다. 저장된 번역은 재사용하고 같은 언어·미지원 언어는 번역하지 않는다. |
| MT-018 | 시리즈 동기 처리의 실패 격리와 조회 계약을 보존한다. | 감지·번역 실패에도 원문 상세를 반환하고 기존 감지 이벤트/번역 job 복구 경로를 사용한다. 시리즈 원문 필드, 장르, 권한, 응답 스키마를 유지한다. 하위 콘텐츠 목록은 저장된 제목 번역만 사용하며 신규 동기 번역을 생성하지 않는다. 동시 원문 변경을 덮어쓰지 않는다. |
## 구현 결정
@@ -65,3 +67,5 @@
- 2026-11-17 동기 번역 완료: 관련 277건 및 최종 생성자 정리 영향 17건, 실제 HTTP QA 4개 시나리오, Kotlin 컴파일·ktlintCheck·bootJar를 확인했다. 단일 독립 리뷰 APPROVE, 차단 사항 없음. [동기 상세 검증 기록](reviews/synchronous-detail-review.md)에 실제 응답·실패 복구·동시성 증거와 운영 MySQL/실제 공급자/전체 테스트의 미검증 범위를 구분했다.
- 2026-11-17 연관 콘텐츠 후속 승인: 사용자가 네 필드의 기존 title에 저장된 번역만 적용하고 번역 없음·공백은 원문으로 반환하는 최소 범위를 선택했다. 새 번역 생성과 응답 스키마 확장은 제외한다. P3-T1로 추적한다.
- 2026-11-17 연관 콘텐츠 후속 완료: 관련 테스트 38건, 실제 HTTP 5회/3개 시나리오, Kotlin 컴파일·ktlintCheck·bootJar 통과 및 단일 독립 리뷰 APPROVE를 확인했다. 작업 임시 자원은 정리했다. [연관 콘텐츠 검증 기록](reviews/related-content-title-review.md)에 응답·fallback·원문 탐색 보존과 미검증 범위를 기록했다.
- 2026-11-17 시리즈 상세 후속 승인: 사용자가 콘텐츠 상세와 같은 감지·동기 번역을 최소 구현으로 요청하고 인터뷰에서 "시리즈 자체만"을 선택했다. 제목·소개·키워드만 동기 처리하고 하위 콘텐츠는 저장 번역 조회를 유지한다. 콘텐츠 상세의 캐시 재사용·실패 시 원문과 기존 재시도 정책을 따른다. 추가 공급자 호출에 따른 첫 응답 대기는 동기 번역 범위에 한정한다. P4-T1/P4-GATE로 추적한다.
- 2026-11-17 시리즈 상세 후속 완료: 새 시리즈 HTTP 15건 포함 직접 영향 회귀 82건, 부모의 실제 HTTP 8회/5개 시나리오, ktlintCheck/bootJar 및 단일 독립 리뷰 APPROVE를 확인했다. 소유 QA 서버·임시 파일/캐시/노트를 정리했다. [시리즈 상세 검증 기록](reviews/series-detail-review.md)에 실패 이력과 미검증 범위를 구분했다.
@@ -0,0 +1,102 @@
# 시리즈 상세 동기 번역 검증과 리뷰
| 항목 | 내용 |
|---|---|
| 대상 | MT-017~018 / P4-T1, P4-GATE / 미커밋 working tree |
| 일자 | 2026-11-17 |
| 기준 | [PRD](../prd.md), [계획](../plan-task.md) |
| 상태 | HTTP/기능/lint/build 검증 완료, 독립 리뷰 APPROVE |
## 범위
시리즈 제목·소개·키워드의 언어 감지와 요청 언어 번역을 같은 상세 응답 전에 저장한다.
기존 콘텐츠 상세와 같은 트랜잭션 격리, 감지 캐시·번역 메모리·materializer·복구 job을 사용한다.
시리즈 원문·장르·권한·DTO와 하위 콘텐츠의 저장된 제목 번역 조회는 유지한다.
공급자 설정·의존성·DB 스키마·콘텐츠 상세 resolver는 변경하지 않았다.
## TDD와 기능별 검증
- 변경 전 콘텐츠 상세 HTTP baseline 21건 성공(exit 0, 27초).
- 최초 새 테스트 실행은 fixture의 필수 theme 누락으로 실패했다. fixture를 수정했으며 제품 RED로 인정하지 않았다.
- production 수정 전 시리즈 HTTP 15건 중 12건 실패(exit 1, 37초). 첫 translated.title은 기대 `English title` 대신 null, 미감지 3종은 DB의 기대 `ko` 대신 null/빈 문자열/공백이었다.
- 첫 GREEN 실행은 compileTestKotlin 중 도구 120초 제한으로 종료됐다. 종료 확인 후 300초 제한으로 실행하여 15건 모두 성공(exit 0, 2분 22초).
- 직접 영향 7개 클래스 82건 성공(exit 0, 1분 1초). 부모가 최종 XML 7개의 tests/failures/errors/skipped를 직접 확인했다.
| 테스트 클래스 | 성공 건수 | 실패/오류/skip |
|---|---:|---|
| AudioContentDetailTranslationHttpIntegrationTest | 21 | 0/0/0 |
| ContentSeriesDetailTranslationHttpIntegrationTest | 15 | 0/0/0 |
| MetadataLanguageDetectTransactionTest | 10 | 0/0/0 |
| ContentSeriesReadRetryTest | 2 | 0/0/0 |
| ContentTagTranslationIntegrationTest | 11 | 0/0/0 |
| TranslationJobRetryIntegrationTest | 10 | 0/0/0 |
| TranslationJobWorkerTest | 13 | 0/0/0 |
명령은 계획의 P4 검증 블록에 있다. XML은 `build/test-results/test/TEST-kr.co.vividnext.sodalive.` 접두사의 각 클래스 경로에 있다.
새 HTTP 테스트는 실제 응답과 별도 트랜잭션의 저장 결과를 비교한다. 감지 캐시, 빈 필드, 동일/미지원 언어,
감지 실패의 SERIES 이벤트, 원문 변경, 상세 2건/worker 1건의 저장 경합, 하위 제목 en→ja→en도 포함한다.
## 부모의 실제 HTTP QA
명령: `./gradlew --no-daemon -I "$TMPDIR/qa.init.gradle" runSeriesQa ktlintCheck bootJar --console=plain`.
임시 `SeriesQa.java`가 기존 테스트 context와 DB fixture를 사용해 Java HttpClient로 실제 Tomcat에 GET 8회를 보냈다.
인증 principal·외부 공급자만 테스트 대역이며 controller/service/JPA/트랜잭션은 실제 구현이다.
아래 응답 및 assertion 결과는 2026-11-17 13:58 KST 실행 출력에서 보존했다.
| 시나리오 | 관찰한 응답/DB 결과 | 판정 |
|---|---|---|
| 첫 번역·재사용 | series/1 GET 2회 200, 세 translated 필드 일치, 별도 repository 조회 title 일치, 공급자 총 3회/job 0개 | PASS |
| 하위 콘텐츠 저장 번역 | 첫 응답의 `기본 child`가 저장 번역 추가 후 `Stored child`, 부모 원문은 유지, 공급자 총 3회/job 0개 유지 | PASS |
| 미감지 원문 | series/2 GET 200, 같은 응답에 세 번역 필드, JDBC 재조회 language_code=ko, 전체 감지 query 일치 | PASS |
| 공급자 실패·복구 | series/3 GET 200/translated=null/원문 title, job 3개, worker 실행 후 GET 200/세 번역 필드 | PASS |
| 실제 저장 실패·복구 | series/4 CHECK 23513 후 GET 200/translated=null, 번역 0행/메모리 3행/job 3개, 제약 해제와 worker 후 GET 번역, 공급자 총 3회 | PASS |
실제 응답 발췌:
```text
QA PID=1275 PORT=61019
GET http://localhost:61019/audio-content/series/1 locale=en
status=200 content-type=application/json
title="원문 제목", introduction="원문 설명"
translated={"title":"English title","introduction":"English detail","keywords":["#Healing","#Calm"]}
translatedGenre="Stored genre"
QA PASS first-response/DB/reuse calls=3 jobs=0
QA PASS child stored-only/original preserved calls=3 jobs=0
QA PASS missing-language committed before response
GET http://localhost:61019/audio-content/series/3 locale=en
status=200 translated=null
worker 후 status=200 translated={"title":"English title","introduction":"English detail","keywords":["#Healing","#Calm"]}
QA PASS provider-failure original 200/jobs=3/worker recovery
SQL Error: 23513 / constraint qa_reject_series
QA PASS database-rollback isolation/worker cached recovery calls=3
QA CLEANUP context closed active=false
```
이 실행은 HTTP QA 이후 ktlintTestSourceSetCheck의 새 테스트 포맷 14건에서 exit 1로 종료됐다.
HTTP 결과는 PASS지만 전체 명령 또는 bootJar 성공으로 기록하지 않는다. 줄바꿈/import 정렬만 보정한다.
포맷 보정 뒤 `./gradlew --no-daemon ktlintCheck bootJar --console=plain`는 exit 0, 26초로 성공했다.
`git diff --check`도 통과했다. 테스트 3파일의 줄바꿈과 import 순서만 바뀌었으며 제품 동작/assertion은 동일하다.
기존 82건과 HTTP 증거를 재실행한 것으로 기록하지 않는다.
## 한계 및 정리
- 운영 MySQL JSON/잠금, 실제 AWS/Papago, 실제 로그인·배포·전체 테스트는 미검증이다. 전체 테스트는 사용자 실행 `./gradlew test`다.
- H2 JSON 래핑은 기존 테스트와 같은 varchar 변환기 왕복으로 검증한다. worker claim은 기존 H2 대역이며 운영 SKIP LOCKED를 재현하지 않는다.
- LSP 도구가 없어 Kotlin compileKotlin/compileTestKotlin과 ktlint로 대체한다. 첫 조회 대기 시간은 공급자 응답 시간에 좌우되며 동시 요청의 중복 공급자 호출은 가능하다.
- 기존 중복 JSONObject/Netty macOS DNS/Gradle deprecation 경고와 임시 Java runner의 apiguardian annotation 경고는 변경하지 않았다.
- 종료 시 Tomcat의 Hikari housekeeper 경고 이후 JPA 종료와 Hikari Shutdown completed를 확인했다. 부모가 PID 1275 부재와 TCP 61019 listener 부재를 확인했다(exit 0).
- 구현자 임시 root `p4-t1.5u5PX9` 부재를 부모가 확인했다. 리뷰 승인 후 부모 `series-translation.AH2ekJ`의 QA runner/init/classes/report/cache와 별도 ulw 노트를 삭제하고 두 경로 부재를 확인했다(exit 0). 응답·검증 기록은 이 문서와 계획에 보존했다. 공유 캐시는 삭제하지 않았다.
## 독립 리뷰
2026-11-17 단일 Oracle 리뷰: **APPROVE**, 신뢰도 높음, 차단 사항 없음.
- MT-017: 세 메타데이터 필드, 동기 감지/저장, 캐시 및 기존 번역 재사용, 동일·미지원 언어 제외를 확인했다.
- MT-018: 서비스 간 NOT_SUPPORTED와 REQUIRES_NEW, 실제 저장 rollback 후 원문 200과 복구, FAILED 재개 assertion 보존을 확인했다.
- 감지 저장·materialize의 snapshot/부모 잠금, 외부 managed entity 미갱신, worker/상세 수렴과 하위 저장 제목 계약을 확인했다.
- XML 7개의 82건과 부모 Java HttpClient의 8회/5개 시나리오 및 DB assertion을 대조했다. 포맷 보정 전후 증거 구분과 실행 한계에 불일치가 없었다.
- 리뷰어는 settled 테스트를 재실행하지 않았다. 확정 발견 사항 및 회귀 수정 Goal 전환 항목 없음.
관련 이력: `ff30ebac` 콘텐츠 상세 동기 번역, `081f22b2` 현재 원문 FAILED 재개, `f7fadf7a` 공급자/캐시 공통화.
새 시리즈 resolver는 이 정책들을 재사용하며 `d82185e9`의 시리즈 정책 호출/권한 흐름은 보존한다.
+1
View File
@@ -27,6 +27,7 @@
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest'
./gradlew bootJar
./gradlew ktlintCheck
./gradlew ktlintFormat