klaus/sodalive-backend-spring-boot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
f3a558f659d66bf88237fb0069d4364f28b5e9a4
sodalive-backend-spring-boot/docs/20261109_감지번역공급자공통화/plan-task.md
T

26 KiB
Raw Blame History

언어 감지·번역 공급자 공통화 구현 계획

항목 내용
작성일 2026-11-09
상태 구현·검증·독립 리뷰·리소스 정리 완료
요구사항 prd.md, LP-001~010 및 확정 구현 계약
활성 Goal 없음

목표와 제약

별도 감지·번역 인터페이스와 독립 공급자 순서 설정으로 새 구현체를 도메인 변경 없이 추가할 수 있게 한다. 기존 Kotlin 1.6.21 / Java 17 / Spring Boot 2.7.14 / RestTemplate / JPA를 사용한다. AWS SDK·실제 adapter·새 의존성·DDL·공개 API·워커 스케줄/재시도·커뮤니티 revision 정책은 변경하지 않는다. 새 공급자 selector를 vendor처럼 등록하거나 실제 성공 결과를 selector 이름으로 저장하지 않는다. 별도 worktree 없이 현재 작업 트리에서 진행한다. 구현 위임 범위에서는 commit/staging/push하지 않는다. 부모 세션은 ULW의 명시적 커밋 지시에 따라 검증 완료 후 원자적 커밋을 만들며 push하지 않는다.

실행 순서

공통 계약·설정 → 감지/번역 연결과 fixture 갱신 → 기능별 회귀·HTTP/DB QA → 독립 리뷰 순서다. 생산 코드/fixture 간 공유 의존성이 있어 구현 에이전트 한 명이 순차 진행한다. 부모는 별도 QA·최종 리뷰를 맡는다.

Phase 1: 공급자 독립 실행과 캐시

  • Task 1.1: 공통 공급자 구조 구현 (P1-T1)

Objective: 두 기능의 독립 우선순위, 실패 전환, 실제 provider 저장과 공통 cache 선택을 완성한다. 시작 조건: PRD 확정, 기존 64건 baseline 통과, Oracle 계약 검토 및 Plan 순서 검토 완료. 완료 증거: 새 테스트의 의미 있는 RED/GREEN, 기존 fixture 회귀, 기능 범위 빌드/정적 검사. 범위 밖: 실 AWS 연동, 실행 중 설정 변경, 범용 plugin framework, 새로운 DB 경합 해결 정책.

Files (src/main/kotlin/kr/co/vividnext/sodalive 기준):

  • Create: i18n/translation/LanguageProviderProperties.kt, LanguageDetectionProvider.kt, DetectedLanguage.kt, ProviderTranslationResult.kt, TranslationLanguages.kt, PapagoLanguageDetectionProvider.kt, TranslationCoordinator.kt.
  • Modify: content/LanguageDetectionCacheService.kt, content/LanguageDetectEvent.kt.
  • Modify: i18n/translation/TranslationJobWorker.kt, TranslationReadModelMaterializer.kt, PapagoTranslationService.kt, ResourceTranslationJobScheduler.kt, TranslationJobScheduler.kt.
  • Modify: v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt (언어 helper 참조만).
  • Modify: src/main/resources/application.yml (독립 순서 설정과 환경변수).

Tests (src/test/kotlin/kr/co/vividnext/sodalive 기준):

  • Add focused tests in i18n/translation/: 공급자 순서 설정, TranslationCoordinator, PapagoLanguageDetectionProvider, 독립 순서 Spring wiring 및 보조 공급자 캐시 저장/materialization 통합 시나리오.
  • Update: content/LanguageDetectionCacheServiceTest.kt, CreatorCommunityLanguageDetectTest.kt, CreatorCommunityLanguageDetectionCacheConcurrencyTest.kt.
  • Update: i18n/translation/TranslationJobWorkerTest.kt 및 생성자 변경의 직접 영향 fixture.
  • Update where required: v2/creator/channel/community/translation/CreatorCommunityTranslationServiceTest.kt, explorer/profile/creatorCommunity/CreatorCommunityTranslationEndToEndTest.kt.
  • Preserve: i18n/translation/PapagoTranslationServiceTest.kt의 17개 HTTP/chunk 회귀 assertion.

Interfaces: PRD의 확정 구현 계약을 그대로 적용한다. 설정 validation은 각 capability의 등록 구현체 목록과 대조한다. 후보 구현체는 설정 순서로 정렬하고, 첫 성공 뒤 중단한다. catch 밖의 repository 오류는 그대로 전파한다. DB 스키마를 유지하고 cache key의 provider 값에는 실제 성공 adapter 이름을 사용한다.

  • RED: 기존 behavior를 보존하는 fixture 갱신 후, 두 가짜 공급자의 순서·실패 전환·저장 귀속 테스트를 작성한다.
  • RED 확인: 신규 타입의 unresolved symbol 오류는 RED로 계산하지 않는다. 필요한 최소 선언으로 컴파일한 뒤 누락된 순서/전환/캐시 동작 때문에 실패하는 assertion을 실제로 확인한다.
  • GREEN: PRD 계약을 충족하는 최소 두 coordinator 및 설정/adapter 연결을 구현한다.
  • GREEN 확인: 새 focused 테스트에서 독립 순서·캐시·폴백·모두 실패·설정 오류가 통과한다.
  • REFACTOR: 이번 변경의 중복만 정리하고 기존 focused·DB 경합·revision·chunk 테스트를 회귀 실행한다.

P1-T1 결과: 새 테스트 21건과 기존 64건을 포함한 85건이 기능별 실행에서 모두 통과했다. LanguageDetectionCacheService의 insertIfAbsent → locking read와 커뮤니티 경합·revision assertion은 유지했다. 번역 worker/materializer는 같은 coordinator cache lookup을 사용하며 저장 provider/version은 실제 성공 adapter 값이다. 기본 production bean은 Papago뿐이며 테스트 secondary는 @Primary 없이 list 주입으로 등록된다. 전체 테스트·운영 MySQL·실 API 호출은 수행하지 않았다. 명령/RED·GREEN/한계는 아래 실행 증거에 누적했다.

구현상 보존 항목:

  1. 감지 cache 트랜잭션, insertIfAbsent 이후 locking read 승자 반환, cache hit 무호출.
  2. listener의 AFTER_COMMIT/REQUIRES_NEW, domain별 languageCode 가드, 커뮤니티 lock/refresh/revision 및 afterCommit 요청.
  3. worker는 외부 번역을 DB 저장 트랜잭션 밖에서 실행하고, 성공 vendor 기준 저장 직전 재조회·저장한다.
  4. materializer의 조회에는 외부 호출이 없고, 현재 원문 검증·read model 저장 방식은 유지한다.
  5. 테스트의 latch·동시 경합·stale revision assertions는 삭제/완화하지 않는다. 새 seam으로 fixture만 옮긴다.

검증 명령:

./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest'
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest'
./gradlew --no-daemon --offline ktlintCheck bootJar
  • Task 1.2: 확장 방법 문서화 (P1-T2)

Objective: 새 공급자 추가에 필요한 구현체·빈·설정·테스트 절차를 개발자가 바로 적용할 수 있게 한다. 시작 조건: 실제 구현 계약과 설정 key 확정. Files: docs/20261109_감지번역공급자공통화/provider-guide.md. 완료 증거: 현재 설정과 일치하는 예시, 감지/번역별 순서 변경, 미등록 vendor 시작 실패, AWS 미구현 명시. TDD 예외: 문서 변경이며 실제 코드/config/테스트와 대조한다. 범위 밖: 미구현 AWS 코드 예제를 작동 코드처럼 제공하거나 가짜 SDK 계약 작성.

P1-T2 결과: provider-guide.md를 작성하고 실제 interface/생성자/config/test와 대조했다. 구현체+빈+해당 기능 순서 설정만으로 확장하며 기존 business 호출자는 수정하지 않는 경로를 문서화했다. 독립 환경변수, AWS/secondary의 현재 미구현·테스트 전용 경계, cache-first 및 오류·검증 한계를 명시했다. 문서 추가 후 별도 Gradle 실행은 하지 않았고 코드 검증은 P1-T1의 fresh 결과를 사용했다.

  • Phase Gate: 통합 검증·리뷰 (P1-GATE)

Objective: 가짜 공급자만 추가해 실패 전환·순서 교체·저장·재사용이 관측됨을 확인한다. 시작 조건: P1-T1/P1-T2 완료. 완료 증거: 아래 시나리오 통과, 독립 리뷰의 차단 이슈 없음, 임시 리소스 정리 영수증. TDD 예외: 독립 실행 확인·리뷰로, 새 구현은 추가하지 않는다.

시나리오 이진 통과 조건 표면
S1 기존 동작 파파고 단독 및 기존 64건 회귀 유지 실제 서비스 HTTP mock + 기존 H2 integration
S2 독립 순서·전환 기능별 설정 교체가 다른 기능에 영향 없음, 첫 성공 이후 호출 0회 Spring context와 fake adapters, 부모 driver
S3 저장·재사용 보조 공급자 실제 이름으로 저장, 이후 모든 외부 호출 0회, materializer 결과 일치 실제 H2 repository 재조회
S4 실패·설정 모두 실패 시 안전한 결과, 빈/중복/unknown 설정 시작 실패, DB 오류를 공급자 실패로 숨기지 않음 focused tests 및 부모 context driver
S5 파파고 감지 분리 감지 HTTP 형식과 결과를 유지하고 listener는 vendor를 모름 실제 RestTemplate loopback 또는 controlled HTTP 경계

검증 기록

  • 변경 전 baseline: 번역 package, 감지 cache, 커뮤니티 감지/경합 및 번역 service 60건 통과, exit 0, 1m38s.
  • 추가 baseline: CreatorCommunityTranslationEndToEndTest 4건 통과, exit 0, 2m38s. 합계 64건.
  • Oracle는 두 coordinator, cache-first, 실제 provider 귀속, 기존 DB/트랜잭션 보존 설계를 검토했다.
  • LSP 도구 미제공. Kotlin 컴파일/ktlint로 보완하며 성공한 LSP 진단으로 표현하지 않는다.
  • 전체 테스트는 실행하지 않는다. 사용자 명령: ./gradlew test.
  • RUN_TMP: /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV. 모든 실행의 임시 자원은 이 작업 소유 root 아래에 두고 종료 시 삭제한다. 공유 Gradle 캐시나 다른 daemon은 건드리지 않는다.
  • 구현 child root: implementation.F9mSBa (위 RUN_TMP 하위, parent 존재 확인 후 mktemp -d 생성). 모든 shell 실행은 이 child로 TMPDIR/NODE_COMPILE_CACHE/BUN_RUNTIME_TRANSPILER_CACHE_PATH를 지정한다. 정리 완료: 검증 프로세스 종료 확인 후 이 child만 삭제했다. 아래 영수증 참조. parent/shared cache는 유지한다.
  • 실행 판정: 기존 승인 문서를 재사용하며 새 planning/worktree/리뷰 dispatch는 하지 않는다. P1-GATE는 부모가 판정한다.

P1-T1 실행 증거 (2026-11-09)

모든 Gradle 실행은 --no-daemon --offline, tool timeout 600000ms로 시작했다. 무필터 test/check/build는 실행하지 않았다. 아래 명령 전에 다음 환경변수를 child root로 지정했다. 로그는 child 안에서만 보관하며 정리 시 삭제한다.

export TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV/implementation.F9mSBa
export NODE_COMPILE_CACHE="$TMPDIR" BUN_RUNTIME_TRANSPILER_CACHE_PATH="$TMPDIR"

RED-1 (9건, 9실패, exit 1, 7m40s): 컴파일 가능한 최소 계약과 첫 adapter만 호출하는 coordinator로 실행했다. 설정 순서·잘못된 설정 거부·폴백·안전한 전체 실패·guard·캐시 조회 누락 assertion이 실패했다. unresolved symbol이나 컴파일 실패는 없었다.

./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'

RED-2 / 부분 GREEN (19건, 7실패, exit 1, 9m01s): RED-1의 9건은 GREEN. 감지의 다음 공급자 미호출·예외 전파·보조 cache-first 누락 3건이 행동 RED였다. raw 감지 stub의 HTTP 미호출 3건과 Spring context의 쉼표 목록 변환 문제 1건도 관측했다. 설정은 @Value String → split/trim으로 고쳐 별도 변환 서비스 의존을 제거했다.

./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'

H2 첫 실행 (4건, 2실패, exit 1, 3m27s): Spring 독립 순서 2건 GREEN, 감지 fallback 누락은 행동 RED. 번역 테스트는 H2의 기존 MySQL FOR UPDATE SKIP LOCKED syntax 오류로 worker 결과까지 도달하지 못했으므로 이 SQL 오류는 행동 RED로 계산하지 않았다. production query는 바꾸지 않고 test spy로 claim만 대체했다.

./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'

H2 RED / 부분 GREEN (21건, 2실패, exit 1, 7m20s): 감지 fallback과 H2 secondary 감지 귀속은 GREEN. 기존 worker가 Papago 실패 뒤 secondary를 호출하지 않아 secondary memory 재조회가 null인 행동 RED를 확인했다. 다른 1건은 HTTP form Content-Type에 실제 UTF-8 charset이 붙는 테스트 기대값 오류로, 행동 RED로 계산하지 않았다. 실제 요청의 charset을 정확히 기대하도록 수정했으며 공급자 요청 형식은 기존과 같다.

./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'

GREEN 및 최종 회귀: 아래 각 실행은 XML의 tests/failures/errors/skipped를 확인했다. 총 85건 = 기존 64 + 신규 21, 최종 각 실행 모두 failure/error/skipped 0, exit 0이다. 최초 package GREEN도 51건, 7m27s였다.

실행 결과 소요
번역 package + 감지 cache (아래 첫 명령, 최종 재실행) 51/51 45s
커뮤니티 감지 + 최초 cache 경합 14/14 (12 + 2) 2m23s
커뮤니티 번역 service + 레거시 end-to-end 20/20 (16 + 4) 52s
ktlintCheck + bootJar 성공, exit 0 1m20s 
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest'
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest'
./gradlew --no-daemon --offline ktlintCheck bootJar

신규 21건의 구성은 TranslationCoordinator 6, 설정 unit 3, 감지 coordinator 5, Papago 감지 HTTP 3, 실제 Spring 설정 2, 실제 H2 저장/worker/materializer 2다. 기존 Papago chunk 17건은 수정 없이 통과했다. ktlintCheck 초기 실행은 import/들여쓰기/줄 길이로 exit 1 (1m44s)이었으며 모든 수정을 apply_patch로 적용했다. 중간 ktlintCheck는 exit 0 (38s), 최종 ktlintCheck+bootJar도 exit 0이다. 자동 formatter는 사용하지 않았다. 기존 unrelated 테스트의 Kotlin unchecked cast/불필요한 !! 경고와 Gradle 9 deprecation 경고는 유지했다.

검증 한계/판정: 제공된 LSP/diagnostics 도구는 없다. Kotlin 컴파일과 ktlint로 보완했다. H2 integration은 실제 DB round-trip, worker 결과, materializer 표시와 무호출 cache 재사용을 검증하지만, H2 미지원 MySQL claim SQL 한 곳은 test spy이며 운영 MySQL claim 동시성을 새로 증명하지 않는다. 실제 유료 API·운영 DB·전체 테스트는 실행하지 않았다. 사용자 전체 검증 명령은 ./gradlew test다. 부모의 독립 Java driver와 ONE reviewer는 P1-GATE에서 수행하며 이 구현자가 대신 완료 표시하지 않는다.

부모 Java QA용 실제 생성자/바인딩

javap -classpath build/classes/kotlin/main으로 아래 생성자와 메서드가 존재함을 확인했다. 클래스 패키지는 content service/listener를 제외하면 kr.co.vividnext.sodalive.i18n.translation이다.

LanguageProviderProperties(String detectionOrder, String translationOrder)
LanguageProviderProperties()  // 두 기능 모두 papago
getDetectionOrder(): List<String>
getTranslationOrder(): List<String>
TranslationCoordinator(List<TranslationProvider>, LanguageProviderProperties, TranslationMemoryRepository)
findCached(String sourceHash, String sourceLanguage, String targetLanguage): TranslationMemory?
translate(TranslateRequest): ProviderTranslationResult
LanguageDetectionCacheService(LanguageDetectionResultRepository, List<LanguageDetectionProvider>, LanguageProviderProperties)
detectWithCache(String): DetectedLanguage?
PapagoLanguageDetectionProvider(String papagoClientId, String papagoClientSecret)
ProviderTranslationResult(TranslateResult, String providerName, String providerVersion)
DetectedLanguage(String detectedLanguage, String providerName)
TranslationJobWorker(TranslationJobRepository, TranslationMemoryRepository, TranslationCoordinator,
    TranslationReadModelMaterializer, PlatformTransactionManager)
TranslationReadModelMaterializer(TranslationSourceExtractor, TranslationCoordinator,
    ContentTranslationRepository, AiCharacterTranslationRepository, ContentThemeTranslationRepository,
    SeriesTranslationRepository, SeriesGenreTranslationRepository, OriginalWorkTranslationRepository,
    CategoryTranslationRepository, CreatorCommunityRepository, CreatorCommunityTranslationRepository, EntityManager)

LanguageDetectListener는 기존 repository/service/EntityManager/publisher 주입을 유지하고 마지막 Papago 인증 String 2개만 제거했다. HTTP 테스트 reflection 대상은 listener가 아니라 PapagoLanguageDetectionProvider.restTemplate이다. 설정은 component의 두 생성자 인자에 각각 @Value("\${sodalive.language-providers.detection-order:papago}"), @Value("\${sodalive.language-providers.translation-order:papago}")가 붙는다. application.yml의 독립 환경변수는 LANGUAGE_PROVIDERS_DETECTION_ORDER, LANGUAGE_PROVIDERS_TRANSLATION_ORDER다. Spring context 테스트는 두 가짜 bean의 실제 순서 변경과 빈/중복/unknown 설정 시작 실패를 확인한다.

이 구현자가 변경한 전체 파일

생산 Kotlin 경로 prefix: src/main/kotlin/kr/co/vividnext/sodalive/.

A i18n/translation/DetectedLanguage.kt
A i18n/translation/LanguageDetectionProvider.kt
A i18n/translation/LanguageProviderProperties.kt
A i18n/translation/PapagoLanguageDetectionProvider.kt
A i18n/translation/ProviderTranslationResult.kt
A i18n/translation/TranslationCoordinator.kt
A i18n/translation/TranslationLanguages.kt
M content/LanguageDetectEvent.kt
M content/LanguageDetectionCacheService.kt
M i18n/translation/PapagoTranslationService.kt
M i18n/translation/ResourceTranslationJobScheduler.kt
M i18n/translation/TranslationJobScheduler.kt
M i18n/translation/TranslationJobWorker.kt
M i18n/translation/TranslationReadModelMaterializer.kt
M v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt

테스트 Kotlin 경로 prefix: src/test/kotlin/kr/co/vividnext/sodalive/.

A i18n/translation/LanguageDetectionProviderTest.kt
A i18n/translation/LanguageProviderCacheEndToEndTest.kt
A i18n/translation/LanguageProviderPropertiesTest.kt
A i18n/translation/LanguageProviderSpringConfigurationTest.kt
A i18n/translation/PapagoLanguageDetectionProviderTest.kt
A i18n/translation/TranslationCoordinatorTest.kt
M content/CreatorCommunityLanguageDetectTest.kt
M content/CreatorCommunityLanguageDetectionCacheConcurrencyTest.kt
M content/LanguageDetectionCacheServiceTest.kt
M i18n/translation/TranslationJobWorkerTest.kt
M v2/creator/channel/community/translation/CreatorCommunityTranslationServiceTest.kt

나머지 3개: src/main/resources/application.yml 수정, docs/20261109_감지번역공급자공통화/plan-task.md 갱신, docs/20261109_감지번역공급자공통화/provider-guide.md 추가. 합계 29개다. 부모가 만든 prd.md는 읽기만 했으며 이 구현자는 변경하지 않았다. CreatorCommunityTranslationEndToEndTest.kt는 기존 생성자 영향이 없어 변경하지 않고 4건을 그대로 실행했다. 의존성·DDL·AWS 코드·git index/commit/branch/worktree는 변경하지 않았다.

소유 임시 자원 정리 영수증

  • 삭제 대상: /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV/implementation.F9mSBa.
  • 모든 Gradle 명령이 종료된 뒤 lsof -nP +D "$TMPDIR"에서 열린 파일이 없음을 확인했다 (출력 없음, exit 1). process 목록에서도 이 child를 사용하는 Gradle/test/compiler 프로세스가 없었다. 다른 프로젝트의 daemon은 종료하지 않았다.
  • 정확한 child 경로를 test로 대조한 후 해당 child만 rm -rf -- "$TMPDIR"로 삭제했다. 이어진 test ! -e "$TMPDIR"와 parent ls -ld가 exit 0이었다 (2026-11-09 15:22 KST).
  • child의 일회성 로그/임시 파일만 제거했다. parent, 부모 QA 소유 형제 경로, 공유 Gradle/Kotlin cache는 유지했다. 이 문서의 명령/횟수/실패 원인/최종 결과는 로그 삭제 전에 기록했다.

P1-GATE 부모 독립 실행 검증

  • 부모가 최종 production/test diff, 신규 interface/coordinator/config 및 fixture 변환을 직접 읽었다. 기존 concurrency/revision assertion은 삭제·완화되지 않았다.
  • fresh 명령: 아래 실행에서 :test가 실제 재실행됐고 exit 0, BUILD SUCCESSFUL in 2m이었다. ktlintCheck/bootJar는 직전 성공 산출물과 일치하여 UP-TO-DATE였다.
./gradlew --no-daemon --offline test --rerun \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
  --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
  --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
  --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
  --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
  --tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
  ktlintCheck bootJar
  • 부모가 XML 15개를 직접 확인했다. 총 85건, failures/errors/skipped 모두 0.
  • 별도 임시 Java ProviderQa를 Java 17로 컴파일하고 실제 Spring AnnotationConfigApplicationContext에서 실행했다. 실제 공통 설정·coordinator와 테스트 전용 papago/aws adapter, 메모리 repository 대역을 사용했다. 이 driver는 DB 검증이 아니며 DB 저장/재조회는 위 H2 테스트가 담당한다.
부모 runtime QA 관측 결과
감지 aws,papago / 번역 papago,aws 감지 aws, 번역 papago만 호출
감지 papago,aws / 번역 aws,papago 감지 papago, 번역 aws만 호출
파파고 예외 후 보조 성공 detect:papago → detect:aws, translate:papago → translate:aws; 성공 provider는 aws
보조 cache 재사용 감지·번역 provider 호출 0회
모든 provider 실패 감지 null, 번역 cause 없는 고정 실패 메시지
unknown/duplicate/empty 설정 실제 Spring context 초기화 실패
  • driver 출력: QA PASS: independent Spring-configured provider chains; all contexts closed; no external requests (exit 0).
  • 별도 PapagoDetectionQa에서 실제 추출된 Papago adapter와 RestTemplate을 loopback HTTP 서버에 연결했다. test-only interceptor로 목적지를 127.0.0.1로 바꿨으며 운영 endpoint/설정은 변경하지 않았다. 원문 공백·한글·&의 form 직렬화, POST, 가짜 인증 헤더, 성공 언어 반환, blank 결과 null, HTTP 500 전파의 3개 응답 시나리오를 검증했다. 출력: QA PASS: 3 loopback HTTP scenarios; server stopped; no paid API requests (exit 0).
  • 모든 Spring context와 loopback 서버는 finally/try-with-resources에서 종료됐다. 부모 driver·추출 라이브러리·로그는 최종 정리에서 소유 RUN_TMP만 제거한다.
  • git diff --check exit 0. LSP·전체 테스트·실제 유료 API·운영 MySQL 미검증 범위는 기존 기록과 같다.
  • 독립 최종 reviewer 판정: APPROVE, 확정 발견 사항 없음. 미추적 파일을 포함한 전체 변경과 XML 15개(85건 통과)를 직접 대조했다. 리뷰 보고서.
  • 원자적 커밋은 (1) 공통 계약·순서 설정·raw 감지/coordinator와 해당 unit/HTTP 테스트, (2) 기존 감지/worker/materializer 연결과 fixture·통합 테스트, (3) 요구사항·계획·가이드·리뷰 문서로 나눈다. 첫 단위는 기존 호출자와 독립적으로 컴파일 가능하며, 두 번째 단위는 생성자/fixture 변경을 함께 보존한다.
  • 코드 커밋: 320adb03 (공통 계약·설정·기반 테스트), f7fadf7a (기존 흐름 연결·캐시·통합 테스트). 두 커밋의 변경 Kotlin pre-commit ktlint와 메시지 규칙 사전/사후 검사 모두 통과했다. 코드 커밋 후 production/test 미커밋 diff가 없고 문서 디렉터리만 남음을 확인했다. push하지 않는다.
  • 부모 소유 리소스 정리: 모든 driver/context/server/Gradle 실행이 종료됐고 lsof -nP +D "$RUN_TMP" 출력이 없었다. 사전 생성·내용 확인한 language-providers.06uAbV만 삭제하고 test ! -e exit 0을 확인했다. 출력: CLEANUP PASS: owned language-providers.06uAbV removed; shared caches untouched. 임시 Java/class/추출 라이브러리/로그가 함께 제거됐으며 필요한 증거는 이 문서에 보존했다. 작업 임시 노트도 문서에 이관 후 삭제한다. 다른 작업의 파일·프로세스·캐시에는 조치하지 않았다.
Reference in New Issue View Git Blame Copy Permalink