Files
sodalive-backend-spring-boot/docs/20261117_관리자번역후보선택/plan-task.md
T

139 KiB
Raw Blame History

관리자 번역 후보 선택 — 구현 계획

상태: P1~P5 및 P7 로컬 구현·검증 완료. 승인된 DEC-11에 따라 활성화 플래그를 제거했고, 사용자의 직접 마무리 지시에 따라 부모가 코드·검증 기록·문서를 대조하고 최신 bootJar를 빌드해 P7-GATE를 종결했다. Production DDL/deploy는 수행하지 않았다. 후속 사용자 요청에 따른 커밋 검증은 문서 하단에 기록한다.

문서 항목 내용
작성일 2026-11-17
요구사항 기준 prd.md
API 기준 api-contract.md, 승인·9개 endpoint 구현 및 로컬 검증 완료
현재 Phase P1~P5 및 P7 완료, 운영 적용만 별도
현재 활성 Goal 없음 — 요청한 로컬 변경 완료
구현 시작 조건 충족 — 설계 승인 및 구현 시작 승인

목표

관리자가 모든 제공자의 새 후보를 검토해 선택한 일부 번역만 안전하게 적용하고, 다음 자동 번역이 변경되지 않은 승인 값을 덮어쓰지 않도록 한다.

현재 상태

Phase 상태 완료 Task 활성/다음 Goal 차단 또는 남은 조건
1 완료 2/2 P1-GATE 완료 snapshot·grouping 검토 보정 및 focused 검증 완료
2 완료 2/2 P2-GATE 완료 승인·무효화·완료 경합 보정 및 독립 검토 완료
3 완료 2/2 P3-GATE 완료 68개 focused 테스트·lint·독립 검토 PASS
4 완료 2/2 P4-GATE 완료 독립 후보·실제 전송 취소·검토 PASS
5 완료 2/2 + R1 P5-GATE 완료 최종 통합 차단 1건 보정 후 APPROVE
6 로컬 검증/배포 준비 완료 로컬 범위 완료 운영 단계만 대기 운영 MySQL·DDL·배포 미실행, 별도 활성화 단계는 DEC-11로 폐기
7 완료 1/1 P7-GATE 완료 부모 직접 검토·배포용 JAR 빌드 완료

한 번에 하나의 미완료 goal만 활성화한다. Future task status는 pending이며 체크박스는 완료 증거 전까지 미체크로 둔다. 모든 Goal ID, 테스트 class, 새 source path는 계획 항목이며 실제 구현이나 존재를 뜻하지 않는다.

범위

포함

  • CONTENT 단일 콘텐츠 및 SERIES 현재 연결된 활성 콘텐츠 전체의 title/detail/tags 후보 생성. 비활성 series member는 제외한다.
  • 전체 현재 supported non-source languages(ko, en, ja)와 등록된 각 provider의 독립 fresh call.
  • 실제 제목에서 자동 제안되는 공통 span의 서버 분석, 필수 사전 리뷰, 원문 span/group 편집, 개별 처리 제외.
  • Candidate persistence, 취소/생성 fencing, 한 번의 subset apply와 receipt.
  • Field-scoped approval provenance 및 CONTENT materialization/원본 변경과의 동시성 불변식.
  • /admin/audio-content/translation-requests 하위 API만. Frontend는 interaction contract까지만이며 코드 없음.

제외

  • 자유 형식의 translated text 편집, 새 provider, LLM, cloud batch, global cache flush, startup wait.
  • OriginalWork 동작, 다른 리소스의 read model writer 변경, 일반 job framework 추가, 광범위 scheduler 재작성.
  • 레거시 번역 값의 provider provenance 추정 또는 일괄 복구.
  • 같은 request에서 나눠 적용하는 multi-round partial apply; 한번 적용하면 request가 닫히고 미선택 후보는 폐기된다.
  • 이 문서 작성 단계의 source/SQL/tests/API 호출 또는 어떤 구현 변경.

기술적 제약 및 제안

  • 기술: Kotlin, Java 17, Spring Boot 2.7.14, JPA, MySQL. 신규 기능 root는 kr.co.vividnext.sodalive.v2.contenttranslation이며 lightweight hexagonal application/domain/port/adapter/dto 구조를 따른다.
  • 인증: 신규 API controller는 기존 ADMIN role과 ApiResponse.ok / SodaException(messageKey, errorProperty) convention을 사용한다. 신규 endpoint는 전부 PROPOSED다.
  • Existing TranslationProvider, AWS/Papago provider, transport/client, detection cache, RedissonClient는 재사용한다. Provider coordinator의 first-success fallback, memory cache 및 ensureMemory는 candidate 생성 경로에서 사용하지 않는다.
  • ContentTranslation.renderedPayload schema와 기존 API response는 유지한다. 세 신규 논리 테이블만 추가한다. 별도 fieldStates JSON/column은 추가하지 않는다.
  • CONTENT approval provenance와 보호 상태는 ContentTranslationOverride row로 표현한다. 과거 승인 이력이 없는 source/automatic translation provider는 UNKNOWN으로 반환한다.
  • Shared CONTENT source builder를 TranslationSourceExtractor와 AudioContentDetailTranslationService에서 재사용한다. title/detail/tags 원문, active tag 순서, 언어/fingerprint, provider inputs, 기존 memory hash가 일치해야 한다. 기존 normalized memory hash 계산은 변경하지 않는다.
  • Approval fingerprint는 원본 언어, field key, 정확한 raw 값의 versioned length-framed SHA-256이다. tags는 순서가 보존된 raw string vector를 length-frame하여 comma collision을 막는다.
  • 모든 ContentTranslation write는 Content 부모 lock 아래 field merge를 한다. Source mutation entrypoint도 수정 전 같은 lock을 얻는다. Lock 순서는 request → Series → CONTENT ID 오름차순 → locale read model/override다. Provider network I/O 중 DB transaction이나 CONTENT/Series lock을 보유하지 않는다.
  • 동시 dispatch/cancel은 request 행 transaction gate로 linearize한다. Gate가 network chunk dispatch를 먼저 승인한 경우 그 외부 호출은 이미 진행 중/비용 발생 가능 호출로 본다. 취소 transaction commit 이후에는 추가 승인을 내지 않고, 뒤늦은 결과를 publish하지 않는다.
  • Candidate worker는 새 feature 전용 persistent candidate rows, 짧은 atomic claim/lease/fencing transaction을 사용한다. Network call 사이에도 상태/fence/deadline을 확인한다. 60초 lease, chunk 전 갱신, stale fence publish 거부, crash 복구 최대 1회 제안. Exactly-once provider billing은 보장하지 않는다.
  • Provider 호출 timeout은 기존 AWS SDK와 현재 Papago transport 설정을 조사해 API call 한도를 제한한다. 제안 기본값은 connect 3초, read 15초, AWS API call 15초다. Transport별 read timeout이 API total wall-clock 상한을 보장한다고 주장하지 않으며 SDK hidden retry가 발생하지 않는지 검증한다. 새 transport나 광범위한 client 변경을 도입하지 않는다.
  • Current supported languages는 TranslationLanguages의 ko, en, ja. Request와 활성 membership을 먼저 저장한 뒤 동일 feature poller가 PREPARING을 claim한다. Existing source language가 유효하면 사용한다. 누락된 경우에만 기존 LanguageDetectionCacheService.detectWithCache를 사용하고 최종 field snapshot 저장 전 잠금 안에서 원문·언어·활성 membership을 재검증한다. 감지 실패·미지원 language·준비 중 source 변경은 명시적 preparation failure다.
  • 제목 그룹은 source language별로 분석한다. Exact substring, Unicode grapheme 경계, code point offset, lossless segment template를 사용한다. 계산 알고리즘 상세는 아래 Goal의 기술 acceptance criteria이며 제품 인터뷰 결정으로 가장하지 않는다.
  • 시각 컬럼은 MySQL TIMESTAMP 소수초 미지정, 초 단위로 제안한다. 각 상태 변경 시각은 한 번 초 정밀도로 normalize한 동일 값을 저장과 응답에 사용한다. 운영 DDL 작성 시 테이블/모든 컬럼에 COMMENT를 붙인다. SQL 실행은 이 계획에서 하지 않는다.
  • Rollout (DEC-11): controller와 후보 worker는 설정 없이 기동 시 등록하고 일반 queue는 항상 source language 포함 identity를 사용한다. 신규 writer의 작업 생성 전에 세 신규 테이블과 언어 포함 unique index를 준비하고, 구 writer/in-flight 작업을 drain한 뒤 구 unique index를 제거한다. OFF 호환 모드·추가 활성화 단계·자동 DDL은 없다. 관리자 화면 미사용을 일반 enqueue 정지로 간주하지 않는다.
  • Rollback은 첫 approval 이후 override-aware code version으로만 허용한다. Legacy writer는 override를 몰라 승인을 덮어쓸 수 있다.
  • 구현 Task는 TDD RED → RED 확인 → GREEN → GREEN 확인 → REFACTOR 및 직접 회귀를 수행한다. Provider test는 latch 제어와 실제 local test transport를 사용해 cancel race를 확인한다.
  • Agent 검증은 각 Goal의 focused --tests와 영향 범위 lint/bootJar만 수행한다. 무필터 전체 테스트는 실행하지 않는다. 사용자 전체 test 명령은 ./gradlew test다.

설계 제안

모듈과 responsibility

kr.co.vividnext.sodalive.v2.contenttranslation
  application/  요청 생성·리뷰·생성·취소·apply orchestration 및 트랜잭션 경계
  domain/       source snapshot, fingerprint, segment template, title grouping policy
  port/         store와 provider call gate 같이 application이 소유하는 외부 경계
  adapter/
    in/web/     ADMIN controller와 API mapping
    out/persistence/ entity, repository, atomic claim 및 locking query
    scheduler/  feature 전용 candidate poller
  dto/          API request/response DTO

새 generalized job abstraction은 만들지 않는다. Candidate row가 provider별 durable 작업 및 결과를 함께 표현한다. 기존 일반 TranslationJobWorker의 범위는 좁은 CONTENT 재료화 정합성 수정과 queue repair로 제한한다.

세 신규 persistence table (제안)

논리 테이블 및 unique rule 필수 데이터
translation_selection_request; unique (created_by, client_request_id) ID; scope type/ID; creator admin ID; client request UUID와 canonical request body SHA-256; request state와 monotonic revision; source language 및 per-content/per-field raw source snapshot/fingerprint; immutable 활성 content membership ID 목록; target language set; provider ID/version manifest; proposed/reviewed groups와 lossless segment templates; accepted generate revision; preparation attempt count/lease expiry/fence; terminal preparation error code; apply operation UUID/body hash/JSON receipt; created/updated/applied timestamps.
translation_candidate; unique (request_id, unit_key, provider_id, target_language) ID/request FK; deterministic unit key 및 unit kind/field/content/group; target language; provider ID/version; PENDING/RUNNING/SUCCEEDED/FAILED/DISCARDED; translated output의 JSON string array; sanitized stable error code; attempt count; lease expiry; monotonically increasing fence; created/updated/terminal timestamps.
content_translation_override; unique (content_id, locale, field_key) ID; content ID; locale; title/detail/tags field key; exact source fingerprint; approved translated text; provenance request ID; contributing candidate ID list (title common+residual 포함); approvedBy admin ID; approvedAt timestamp.

Timestamp columns은 기존 BaseEntity conventions에 맞는 MySQL TIMESTAMP seconds precision으로 만들고 created_at/updated_at 기본값·COMMENT 기준을 따른다. Candidate의 request FK는 RESTRICT로 두고 운영 중 request hard delete는 제공하지 않는다. Override는 content ID와 후보 provenance를 보존하되 기존 content 삭제 동작을 바꾸는 cascade는 추가하지 않는다. 필수 lookup/claim index: creator+clientRequestId unique; request state+lease+id; candidate request+state+lease+id; request+unit+provider+target unique; content+locale+field unique. 인덱스는 필요한 claim/read query에 한정한다.

request.snapshot/review manifest/receipt는 request row의 versioned JSON document다. Candidate output은 candidate row에 독립 JSON array로 저장한다. 새 migration artifact 작성 시 logical table과 모든 컬럼의 의미 및 DDL COMMENT를 넣는다. ContentTranslation에는 새 metadata column을 추가하지 않는다.

Request 및 candidate lifecycle

PREPARING → REVIEW_REQUIRED (series) 또는 READY_TO_GENERATE (single) → GENERATING → READY → APPLIED; 모든 미종결 단계에서 CANCELLED; prepare 실패는 terminal FAILED. Series는 모든 개별 항목 분석이어도 리뷰가 필수다. Reviewed grouping은 generate 전 READY_TO_GENERATE 상태에서도 다시 제출·수정 가능하며 generate가 manifest를 freeze한다. Admin revision은 grouping/generation/apply 같은 의미 있는 write에서만 증가하고 worker progress polling은 증가시키지 않는다. Generation manifest와 candidate rows를 하나의 transaction에 동결한다. Provider terminal failure도 candidate 상태로 남기고 모든 candidate terminal 뒤 요청을 READY로 전이한다.

Apply는 선택 항목이 하나 이상인 one-shot subset다. Request → 필요한 Series → CONTENT ID 오름차순 잠금 후 최신 source/membership/override/payload를 재조회하고 선택을 검증한다. 성공 시 전체 선택과 receipt를 함께 commit한다. 검증 거부는 아무 값도 쓰지 않고 request를 READY로 둔다. Request 잠금 안에서 저장된 operation ID/body hash 또는 accepted generate revision의 replay를 상태·revision 거부보다 먼저 판별한다. 새 mutation에만 현재 상태·revision 검증을 적용한다. 취소는 stale revision 검사를 요구하지 않으며 commit 뒤 새 dispatch 승인과 late publication을 금지한다.

PREPARING도 같은 poller가 60초 lease와 fence로 처리한다. 요청 생성 시 고정한 활성 member IDs는 바꾸지 않고, 언어 감지 후 최신 원문을 잠금 안에서 재검증해 최종 snapshot을 한 번 게시한다. 준비 중 취소·source/membership 변경이면 게시하지 않는다. Lease 만료 복구는 한 번, 두 번째 만료는 FAILED/PREPARATION_INTERRUPTED다. Provider 호출이 아직 lease를 소유하는지 chunk 직전에 검사하며, 만료된 fence가 스스로 lease를 연장하지 못한다.

Title grouping 및 lossless reconstruction 제안

  • 입력은 요청 생성 시 연결된 활성 series content 전체의 원본 title을 content ID 순으로 사용한다. 비활성 콘텐츠는 제외한다.
  • source language별 partition 내에서 정확히 반복되는 maximal substring 후보를 탐색한다. Unicode grapheme boundary만 후보 경계로 허용하고 API offset은 zero-based code point, end-exclusive다.
  • Auto proposal은 서로 다른 두 title 이상에 exact-identical하게 존재하는 span 중 lexical boundary에 맞고 Unicode letter 2개 이상 포함인 범위로 제한한다. 숫자/구두점 전용 반복은 자동 그룹하지 않는다.
  • 원본 grapheme 열의 pairwise longest-common-substring scan으로 maximal exact runs를 구한다. 동일 source-language의 전체 제목으로 각 후보를 확장하며 한 제목에서 여러 번 나오는 모호한 구간은 자동 선택하지 않는다. spanLength × (memberCount − 1) 내림차순, 길이 내림차순, 원문 code-point 사전순, member ID 순으로 정렬한다. 각 제목은 한 그룹에만 배정하고, 모든 member에서 겹치지 않는 추가 공통 구간만 허용한다. 모호한 제목은 individual로 남기며 새 library/LLM/EP regex는 사용하지 않는다.
  • 최종 grouping은 group들+individuals가 request scope를 정확히 한 번씩 덮어야 한다. Group member는 2개 이상이고 한 source language여야 한다. 관리자가 group, 원문 spans, 개별 제외를 generation 전에 수정한다. 변경을 generation 후 반영하려면 cancel 후 새 request를 생성한다.
  • Client는 각 member의 span offset을 보내지만 원문 text replacement는 보낼 수 없다. Server는 현재 snapshotted source에서 raw substring을 추출하고 모든 group member에서 동일한 문자열인지 확인한다. 겹침, 격자 boundary 분할, 누락/중복 coverage, 언어 혼합은 거부한다.
  • 각 title을 LITERAL | SHARED(part) | RESIDUAL(id) 순서로 분할한다. 모든 source code point는 정확히 한 번만 소유되고, segment source를 concat한 값은 원문과 완전히 같아야 한다. 문자가 없는 gap은 원문 literal로 보존한다. 문자가 있는 gap은 바깥쪽 공백·구두점만 literal로 분리하고 내부 공백·구두점·숫자를 포함한 나머지 구문 전체를 하나의 RESIDUAL로 유지한다. 내부 단어마다 번역 입력을 나누지 않는다. 각 segment 유형/ID를 reviewed template에 저장한다.
  • 공통 parts는 group+targetLanguage마다 하나의 provider candidate string array로 번역한다. Residual은 member 단위 string array이며 같은 request/provider/language 안에서 동일한 residual source를 deduplicate할 수 있다. 이전 memory는 읽지 않는다. 선택 후보를 같은 segment 순서로 조립하고 literal을 그대로 붙인다.
  • Group+language apply는 공통 후보 1개와 모든 member residual 선택을 요구한다. 공통 provider는 그룹 전체에서 동일하고 각 구성원 residual provider는 달라도 된다. Candidate 전체를 멤버별로 따로 선택하는 기능은 없다. 개별 결과가 필요하면 generation 전에 group에서 제외하거나 새 grouping을 저장한다.
  • 이 보수적 제안은 최대 반복 span을 제시할 뿐 문장 자연성을 보장하지 않는다. 관리자 전체 preview 검토 후 적용한다.

CONTENT source snapshot 및 override invariant

Source/entry point 제안된 integration
i18n/translation/TranslationSourceExtractor.kt Shared CONTENT snapshot builder를 소비하도록 CONTENT source 조립을 위임한다. Other resource extractor 변경은 하지 않는다.
content/AudioContentDetailTranslationService.kt 자체 tags/field/detection query 조립 제거 후 shared builder 사용. Existing payload shortcut 전에 stale override를 검사한다.
i18n/translation/TranslationReadModelMaterializer.kt CONTENT 경로만 CONTENT parent lock을 먼저 잡고 최신 source, locale payload, override를 재조회해 field merge한다. 다른 resource upsert는 불변이다.
content/AudioContentService.kt modify title/detail/tags source mutation에서 lock 후 field change comparison/invalidation, source fallback, normal refresh scheduling.
admin/content/AdminContentService.kt 관리자 title/detail mutation에 같은 hook.
creator/admin/content/CreatorAdminContentService.kt creator/admin title/detail/tags mutation에 같은 hook. Delegating AI admin route는 해당 경로를 검증한다.
creator/admin/content/series/CreatorAdminContentSeriesService.kt Membership add/remove는 Series parent lock 아래 수행해 title-group apply와 membership snapshot 검증이 직렬화된다. Order-only 변경은 membership set 변경이 아니다.
content/LanguageDetectEvent.kt 및 detection path CONTENT source language가 미설정인 경우에만 기존 detector를 사용. 잠금 후 최신 query/language를 재검증하고 language change는 모든 override field를 invalidate.
i18n/translation/TranslationJobScheduler.kt source language를 queue key/lookup identity에 추가. 완료 CONTENT field도 실제 현재 value stale/missing일 때만 해당 field repair 허용.
i18n/translation/TranslationJobWorker.kt materialize(false)를 successful completion으로 기록하지 않고 retryable/incomplete로 취급.

Exact source fingerprint는 sourceLanguage + fieldKey + exact raw field; tags의 ordered raw vector length-frame이다. 기존 memory hash/normalizer는 유지한다. Source mutation은 모든 해당 locale의 오직 변경 field override를 제거하고 rendered field를 최신 source fallback으로 설정한 뒤 자동 refresh를 같은 transaction에서 enqueue한다. Language change는 title/detail/tags를 모두 변경으로 취급한다. 변경되지 않은 field approval은 보호된다. A→B→A 변경에서 이미 제거한 approval은 복구되지 않는다.

Normal materializer는 lock 전에 memory를 resolve해도 좋지만 captured fingerprint를 lock 안에서 재검증한다. 현재 source와 일치하는 latest approval이 memory result보다 우선한다. 변경 field만 override invalidate/refresh한다. Detail read shortcut은 승인 fingerprint를 확인하고 stale approval을 반환하지 않는다. 동기 source mutation 시 payload fallback으로 reset하므로 direct list readers도 이전 값을 노출하지 않는다.

유효한 override가 있는 필드는 translation memory가 없어도 승인 값으로 완성할 수 있어야 한다. 기존 resolveTranslatedFields가 모든 memory를 먼저 요구해 조기 실패하는 순서를 CONTENT에 그대로 사용하지 않는다. 승인 확인·source 재검증 후 승인 없는 필드만 memory 필요 여부를 판정한다. 후보/관리자 승인이 global memory를 채우지 않는 설계에서도 동작해야 한다.

Group apply는 request lock → Series lock → 현재 연결 CONTENT locks ID 오름차순으로 가져온 뒤 활성 membership을 snapshot과 비교한다. 활성 상태 변경도 CONTENT lock으로 직렬화한다. Individual field는 선택된 content의 활성·연결 자격과 그 필드 fingerprint만 검사하며 무관한 필드 변경이나 다른 member의 추가는 적용을 막지 않는다. 잠금 전 관리 entity/association을 그대로 재사용하지 않는다. Concurrent explicit approvals은 같은 source에서 later committed approval wins이며 automatic writer는 valid approval을 덮어쓰지 않는다.

Provider cancellation 및 durability

  • 모든 등록 TranslationProvider를 직접 호출한다. TranslationCoordinator first-success fallback/translation memory는 금지한다. Provider ID/version은 manifest/candidate에 고정하고 실행 시 동일성을 검사한다. 누락 또는 version 변경은 FAILED/PROVIDER_CHANGED로 종결하며 다른 버전·provider로 대체하지 않는다. 출력 개수와 공백 검증 실패는 FAILED/INVALID_PROVIDER_RESULT다.
  • Candidate worker는 feature 전용 poller와 durable candidate status를 사용한다. Existing translation_job에 request/provider candidate workflow를 억지로 합치지 않는다. Existing provider clients, endpoints, SDKs, parsing을 재사용한다.
  • TranslateRequest에 선택적인 admin call control 계약을 더해 provider adapter의 각 outbound chunk 직전 dispatch gate를 요구한다. Gate 승인은 요청 state/revision, lease 및 fence를 짧은 DB transaction으로 확인한다. 승인된 호출은 취소와 경쟁 시 in-flight로 간주한다. HTTP/network I/O 동안 transaction이나 parent content lock은 없다.
  • Cancel transaction은 request 상태를 CANCELLED로 바꾸고 outstanding lease/token을 폐기한다. 취소 commit 뒤 새 chunk 승인은 거부한다. 취소 전에 승인된 chunk는 실제 전송이 취소 뒤여도 이미 진행 중인 작업에 포함한다. 취소 응답은 network 완료를 기다리지 않으며 late publication은 request/candidate/fence 재검증으로 거부한다.
  • Worker claim은 atomic row lock/claim, 60초 lease, chunk 전 renew, fence token, 한 번의 expired lease recovery를 쓴다. 그 이상 exhausted candidate를 실패 종결한다. 재시작 후 이미 provider에 도달한 요청이 반복돼 비용이 다시 발생할 수 있음을 운영 문서와 API cancellation semantics에서 밝힌다.
  • 기존 RedissonClient와 lock:translation-selection scheduler-wide lock을 사용한다. Redis dependency와 현재 ordinary TranslationJobWorker의 broad lock refactor를 추가하지 않는다. Persistent DB claim이 실제 소유권·fencing source다.
  • Detection 중 cancel은 추가 translation dispatch를 막는다. 기존 detection cache를 허용하고 supported source language를 다시 무조건 감지하지 않는다. Source detect network call의 bounded/cancelable call path도 검증한다.

Phase 1: 공유 snapshot과 grouping domain

Phase 결과: 기존 CONTENT source 조립과 feature source fingerprint가 일치하며 검토 전 제목 grouping 제안을 lossless template으로 만든다.

선행조건: 충족. PRD/API/design proposal 및 로컬 구현/focused tests 승인.

Task 1.1 — 공유 CONTENT snapshot 경계

Goal 실행 P1-T1: 모든 CONTENT translation consumer가 같은 source fields/tags order를 사용한다.

  • 시작 조건: 승인된 API design와 현재 extractor/detail 경로.
  • 완료 증거: 정확한 raw fingerprint 및 provider input 테스트, extractor와 detail source assembly 동일성 통과.
  • 범위 밖: Non-CONTENT extractor, existing memory normalization/hash 변화.

Files:

  • Create: src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/ContentSourceSnapshot.kt, src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/ContentTranslationSourceService.kt.
  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationSourceExtractor.kt, src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationService.kt.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/ContentSourceSnapshotTest.kt.

Interfaces: consumes AudioContent/active hashtags and supported language rules; produces immutable source snapshot, provider inputs, raw field fingerprints, existing memory-hash inputs.

  • RED: raw tags ordering/fingerprint collision and extractor/detail parity tests를 작성한다.
  • RED 확인: HTTP 태그 순서 assertion RED 및 도메인 tag-vector 경계 변이 assertion RED를 확인했다. 상세 명령은 Progress에 기록했다.
  • GREEN: CONTENT snapshot/fingerprint 조립을 공유하고 기존 normalized memory hash를 보존한다.
  • GREEN 확인: snapshot 14개와 상세 HTTP 22개 테스트 통과.
  • REFACTOR: 초기 ktlintCheck 통과, 독립 검토에서 발견한 pending 태그 순서를 RED/GREEN으로 보정했고 제한 재검토에서 ADDRESSED 판정을 받았다.

Task 1.2 — 반복 span 분석 및 lossless title template

Goal 실행 P1-T2: 실제 제목의 보수적 반복 공유 span과 원문 재구성 template을 결정적으로 계산한다.

  • 시작 조건: P1-T1 snapshot/type contract 완료.
  • 완료 증거: Unicode/title edge cases와 complete coverage invariant 검증.
  • 범위 밖: LLM, 새 dependency, EP regex, translation 자연성 자동 평가.

Files:

  • Create: src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/TitleGroupingAnalyzer.kt, src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/TranslationSelection.kt.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/TitleGroupingAnalyzerTest.kt.

Interfaces: consumes content IDs, source language, raw title; produces deterministic proposed group, exact part ranges and LITERAL/SHARED/RESIDUAL segment source template.

  • RED: 반복 구간·모호성·언어 분리·Unicode·검토 범위·재구성 행동 테스트를 작성했다.
  • RED 확인: TitleGroupingAnalyzerTest 21개 assertion RED를 확인했다.
  • GREEN: exact substring, Unicode grapheme boundary, deterministic conservative group assignment 및 lossless reconstruction 구현.
  • GREEN 확인: grouping 21개 + snapshot 14개 통과.
  • REFACTOR: ktlintCheck 통과, residual 구문 분할 finding을 RED/GREEN으로 보정하고 독립 재검토에서 ADDRESSED. 실제 대규모 scope 성능은 운영 검증 대상이다.

Phase 1 Gate — P1-GATE

완료 증거: 같은 CONTENT source에 대해 extractor/detail/fingerprint가 일치하고 모든 title template은 원문 전체를 정확히 재생성한다. no build/DB/provider behavior claimed beyond focused evidence.

Phase 2: field approval과 CONTENT writer 통합

Phase 결과: 승인 값이 원본이 그대로인 동안 자동 materializer로부터 보호되고, 원본 변경 시 해당 field만 무효화된다.

선행조건: P1-GATE 완료, ContentTranslationOverride persistence contract 및 MySQL schema approved.

Task 2.1 — Override 저장과 locked field writer

Goal 실행 P2-T1: administrator selection과 normal CONTENT materializer가 같은 부모 lock 아래 field-scoped override를 적용한다.

  • 시작 조건: approved 3-table schema; PRD TR-18~TR-20.
  • 완료 증거: approve, automatic materialize race, source validation 및 unchanged payload tests 통과.
  • 범위 밖: ContentTranslation JSON/schema 변경, non-CONTENT writers.

Files:

  • Create: src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/domain/ContentTranslationOverride.kt, src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/port/ContentTranslationOverrideStore.kt, src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/ContentTranslationOverrideEntity.kt, corresponding repository/store adapter, application/ContentTranslationWriteService.kt.
  • Modify: src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationReadModelMaterializer.kt, src/main/kotlin/kr/co/vividnext/sodalive/content/translation/ContentTranslationRepository.kt only if locked query needed.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/ContentTranslationOverrideIntegrationTest.kt.

Interfaces: consumes exact source snapshot, automatic translated field values or approved candidate+provenance; produces locked merged payload and field-scoped override update.

  • RED: shouldProtectCurrentApprovalFromAutomaticWrite, shouldMaterializeApprovedFieldsWithoutSharedMemory, shouldRejectAutomaticResultWithStaleSource, shouldKeepUnselectedFieldsByteForByte, shouldPersistApprovalProvenance tests를 작성한다.
  • RED 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationOverrideIntegrationTest'에서 오래된 managed source로 materialize가 true를 반환하는 assertion 실패 확인.
  • GREEN: CONTENT-only writer obtains parent lock before current source/override/payload reads and merges only touched fields; other resource materializers unchanged.
  • GREEN 확인: 위 신규 class 9개 + ContentTagTranslationIntegrationTest 11개 통과. lint 마무리는 P2-T2와 함께 기록한다.
  • REFACTOR: CONTENT의 기존 late-lock upsert를 공용 field writer로 대체하고 불필요한 생성자 의존성을 제거했다. 신규 코드와 테스트는 각각 200 pure LOC 이내이며 직접 회귀와 최종 ktlintCheck 통과. 아래 Progress 참조.

Task 2.2 — Source mutation invalidation 및 queue repair

Goal 실행 P2-T2: 모든 관련 source 변경이 changed-field approvals만 지우고 fallback/automatic refresh로 바꾼다.

  • 시작 조건: P2-T1 locked writer 사용 가능.
  • 완료 증거: content owner, ADMIN, creator-admin mutations, membership add/remove, missing-language event, detail shortcut, queue dedup 회귀 통과.
  • 범위 밖: global queue rewrite, 다른 도메인 번역 정책 변경. 공유 queue의 언어 포함 identity 전환은 기계적인 변경으로 제한하고 비-CONTENT 회귀를 검증한다.

Files:

  • Modify: content/AudioContentService.kt, admin/content/AdminContentService.kt, creator/admin/content/CreatorAdminContentService.kt, creator/admin/content/series/CreatorAdminContentSeriesService.kt, content/LanguageDetectEvent.kt, content/AudioContentDetailTranslationService.kt, i18n/translation/TranslationJob.kt, i18n/translation/TranslationJobRepository.kt, i18n/translation/TranslationJobScheduler.kt, i18n/translation/TranslationJobWorker.kt, i18n/translation/ResourceTranslationJobScheduler.kt.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/ContentTranslationSourceInvalidationIntegrationTest.kt; direct source service/controller existing affected tests to add after verifying exact class names.

Interfaces: mutation hooks consume before/after locked snapshots, enqueue standard refresh; worker consumes materialize(false) as incomplete rather than completed.

  • RED: 신규 SourceInvalidation 13개, Queue 6개, Membership 7개 테스트로 필드 fallback/다른 승인 보존/A→B→A/언어 변경/상세 shortcut/완료 작업 재개/언어 identity/혼합 flag 및 활성·membership 잠금을 검증한다.
  • RED 확인: 세 mutation entrypoint 모두 이전 승인 제목을 반환하는 assertion 실패를 먼저 확인했다. 감지 provider 호출 중 transaction 존재 assertion 실패 및 worker false/승인 우선순위 변이 RED도 별도로 확인했다.
  • GREEN: 세 mutation entrypoint와 감지·상세 경로에 같은 부모 잠금/필드 무효화/fallback/enqueue를 연결하고 queue identity와 호환 exists를 적용했다. materialize false는 재시도한다.
  • GREEN 확인: 신규 36개와 AudioContentDetail HTTP 22개, AudioContentService 16개, AdminContentService 6개, worker 13개, ContentTag 11개, scheduler 3개, retry 10개가 최종 focused 실행에서 통과했다. 추가 직접 회귀 140개도 별도 focused 실행에서 통과했다.
  • REFACTOR: 모든 변경 locale payload의 해당 필드만 같은 mutation transaction에서 fallback으로 바꾼다. 기존 broad translation event 대신 changed fields만 직접 enqueue하며 새 public HTTP/API/payload metadata는 추가하지 않았다. 최종 ktlintCheck 통과.

Phase 2 Gate — P2-GATE

검증해야 할 race: concurrent approval vs automatic writer, source update vs detail read, all three source mutation paths, AI admin delegation, materialize(false) and source language queue identity. H2 tests는 production MySQL locking 증거로 간주하지 않는다.

Phase 3: durable request lifecycle과 reviewed grouping API

Phase 결과: 관리자 scope request가 안전하게 준비되고 시리즈 grouping을 반드시 리뷰·확정하기 전에는 provider call이 시작되지 않는다.

선행조건: P1-GATE, schema DDL 승인, ADMIN/API envelope review.

Task 3.1 — Request persistence, preparation, idempotency

Goal 실행 P3-T1: request snapshot과 scope idempotency가 durable하게 저장되고 source language preparation race가 안전하다.

  • 시작 조건: P2-GATE; 세-table schema와 rollout design 검토 완료. 당시 OFF 호환 정책은 후속 DEC-11로 대체됐다.
  • 완료 증거: duplicate/mismatch idempotency, all-member snapshot, language detect/cancel, unsupported language tests.
  • 범위 밖: candidate provider network calls.

Files:

  • Create under src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/: request/domain state; application/TranslationSelectionRequestService.kt, application/ContentTranslationSourceService.kt; port/TranslationSelectionStore.kt; adapter/out/persistence/TranslationSelectionRequestEntity.kt, repository/store adapter.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionRequestIntegrationTest.kt.

Interfaces: consumes ADMIN id, scope union, client UUID; produces request ID/status/revision and frozen source/member snapshot or terminal preparation failure.

  • RED: shouldReplaySameCreationBody, shouldRejectReusedClientIdWithDifferentBody, shouldSnapshotOnlyActiveLinkedMembers, shouldUseValidSourceLanguageWithoutRedetection, shouldDetectMissingLanguageBeforeFinalSnapshot, shouldFailUnsupportedOrUndetectedLanguage, shouldRecoverPreparationOnceThenFail, shouldNotPublishPreparedSnapshotAfterCancelOrSourceChange tests.
  • RED 확인: focused class command에서 expectation failure 확인.
  • GREEN: snapshot, idempotency unique handling, final source recheck, existing cache-backed detector 재사용 구현.
  • GREEN 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestIntegrationTest' 통과.
  • REFACTOR: no retry layer/new detector cache. Record duplicate collision and preparation failure API mapping.

Task 3.2 — Grouping review and API read model

Goal 실행 P3-T2: series manager가 lossless proposed groups를 수정하고 완전한 전체 grouping을 확정한다.

  • 시작 조건: P3-T1, TitleGroupingAnalyzer approved model.
  • 완료 증거: ADMIN guard, member coverage/language/span validation, expectedRevision conflict tests.
  • 범위 밖: frontend code, post-generation edits.

Files:

  • Create: application/TranslationSelectionGroupingService.kt, adapter/in/web/AdminTranslationSelectionController.kt, dto/TranslationSelectionRequest.kt, dto/TranslationSelectionResponse.kt.

  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/in/web/AdminTranslationSelectionHttpIntegrationTest.kt.

  • RED: shouldRequireAdminRole, shouldRejectIncompleteOrDuplicateScopeCoverage, shouldRejectDifferentSharedTextOrSplitGrapheme, shouldAcceptAllIndividualReview, shouldRequireReviewBeforeGenerate tests를 작성한다.

  • RED 확인: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest'에서 assertion failure 확인.

  • GREEN: POST, GET, contents paging, grouping GET/PUT의 typed endpoint 제안 구현. 모든 신규 endpoint는 ADMIN role, ApiResponse/SodaException pattern 사용.

  • GREEN 확인: 같은 focused HTTP test, 기존 admin controller security tests 및 ./gradlew ktlintCheck 실행.

  • REFACTOR: request types/validation only in feature package, no general framework.

Phase 3 Gate — P3-GATE

검증: preparation 취소 이후 새 translation dispatch 승인이 없음, 활성 연결 콘텐츠 전체 포함 및 비활성 제외, invalid/deleted scope를 대체하지 않음, all-individual 결과에도 group review 필수.

Phase 4: per-provider candidate generation, leases, cancel gate

Phase 결과: 모든 provider가 fresh independent candidate를 남기며 failures visible, cancel gate 이후 dispatch/late publication 불가.

선행조건: P3-GATE, translation provider cancellation boundary review.

Task 4.1 — Candidate persistence, generation manifest, worker

Goal 실행 P4-T1: immutable generation manifest에서 unit×provider candidate rows가 durable하고 bounded recovery로 완료된다.

  • 시작 조건: Request API+schema ready.
  • 완료 증거: no memory reuse, every provider attempted, duplicate generate, partial provider error, lease/fence tests.
  • 범위 밖: apply and CONTENT overrides (Phase 5).

Files:

  • Create: domain/TranslationCandidate.kt, application/TranslationSelectionGenerationService.kt, application/TranslationSelectionWorkerService.kt, adapter/out/persistence/TranslationCandidateEntity.kt, adapter/scheduler/TranslationSelectionWorker.kt.
  • Modify only if necessary: i18n/translation/TranslationProvider.kt or a feature adapter interface, plus required settings registration.
  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionWorkerIntegrationTest.kt.

Interfaces: POST generate(expectedRevision) atomically freezes all fields/languages/providers/groups and creates provider candidate tasks; worker claims one task, runs exactly one selected provider and persists candidate if its fence remains valid.

  • RED: shouldAttemptEveryRegisteredProviderDespiteMemory, shouldIsolateProviderFailures, shouldGenerateAllFieldsAndNonSourceSupportedLanguages, shouldReplayGenerateWithoutCreatingJobs, shouldRecoverLeaseAtMostOnce, shouldRejectStaleFencePublish, shouldReachReadyAfterTerminalProviderFailures tests.
  • RED 확인: 실제 generate HTTP 404, worker 미처리 및 residual 중복 호출 assertion 실패를 확인했다. 실제 테스트 이름과 실행은 Progress에 기록했다.
  • GREEN: Direct provider calls without TranslationCoordinator/cache; typed terminal candidate results and durable bounded claim/fence.
  • GREEN 확인: worker 및 candidate lifecycle/lease/grouping focused 검증 통과. 아래 실행 기록 참조.
  • REFACTOR: worker-specific polling only; candidate claim query and Redisson scheduler lock lock:translation-selection match project lock rules.

Task 4.2 — Outbound cancellation gate and bounded provider calls

Goal 실행 P4-T2: 매 outbound chunk authorization이 cancel과 선형화되고 늦은 결과는 publish되지 않는다.

  • 시작 조건: P4-T1 provider candidate run contract.
  • 완료 증거: first chunk in-flight / later chunk denied race, bounded timeout, failure/cancel distinction tests.
  • 범위 밖: transport migration, broad AWS/Papago cleanup, external exactly-once guarantee.

Files:

  • Modify only targeted: i18n/translation/TranslateRequest.kt, AwsTranslationService.kt, PapagoTranslationService.kt, content/LanguageDetectionCacheService.kt / existing provider adapters, feature request store/worker.

  • Test additions after source inspection: existing AWS/Papago provider test files; new src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionCancelIntegrationTest.kt.

  • RED: shouldStopBeforeNextProviderChunkAfterCancel, shouldAllowAlreadyAuthorizedCallToFinish, shouldRejectLateCompletionAfterCancel, shouldDistinguishCancellationFromProviderFailure, shouldStopTranslationAfterCancelDuringDetection, shouldRespectOutboundCallBound tests.

  • RED 확인: 후보 미폐기, 실제 SDK retry 및 Papago 다음 HTTP chunk 미차단 assertion 실패를 확인했다.

  • GREEN: 각 outbound chunk/retry의 dispatch gate, Papago admin connect 3초/read 15초 및 AWS 요청별 API-call/attempt 예산 15초 구현. SDK가 지원하지 않는 요청별 socket 설정은 아래 기술 판정에 명시했다.

  • GREEN 확인: cancel/worker/실제 SDK·HTTP 전송 14개 최종 통과, 기존 AWS/Papago/provider 설정 직접 회귀 포함. 아래 명령과 결과 참조.

  • REFACTOR: network IO outside DB transaction; do not leak raw provider exception/body; document at-least-once billing risk.

Phase 4 Gate — P4-GATE

Gate checks: 현재 AWS tags unchanged-result 정책은 해당 후보 실패로 표시하되 Papago 독립 호출을 막지 않음; candidate는 translation memory 불변; 기존 감지 캐시 허용·번역은 fresh; 취소 commit 이후 새 dispatch 승인 및 stale publication 금지. 이미 승인된 호출의 전송/비용은 취소가 되돌리지 않음.

Phase 5: atomic subset apply and server contract

Phase 결과: source-current selections commit together once, title group applies all members atomically, receipt makes retries idempotent.

선행조건: P2-GATE, P4-GATE.

Task 5.1 — Selection validation, receipt, CONTENT override apply

Goal 실행 P5-T1: administrator can apply one valid nonempty subset once while omitted translations stay unchanged and excluded candidates discard.

  • 시작 조건: override-aware writer and complete candidate results.
  • 완료 증거: partial, stale field, unrelated source change, group membership, full transaction rollback, replay tests.
  • 범위 밖: multiple apply rounds, freeform values, applying selected fields from another request.

Files:

  • Create: application/TranslationSelectionApplyService.kt, domain/TranslationSelectionReceipt.kt (or keep types inline if single use).

  • Modify: request store/service, candidate repository, ContentTranslationWriteService.kt, ADMIN controller/DTO.

  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionApplyIntegrationTest.kt.

  • RED: 부분 적용·그룹 완전성·source/ownership·replay·rollback의 실제 DB/HTTP 테스트를 작성했다.

  • RED 확인: apply HTTP 404와 provider/source 검증 변이 assertion 실패를 확인했다. P5-R1 연결 회귀 RED도 별도 기록했다.

  • GREEN: request/Series/CONTENT 잠금 이후 선택을 검증하고 override/payload/receipt/discard를 원자 적용했다.

  • GREEN 확인: P5 및 직접 영향 집중 테스트 통과. 기본 시각 인자 proxy 결함은 overload로 수정하고 영향 42개를 재검증했다.

  • REFACTOR: concurrent approval·자동 writer·부분 승인 이후 자동 갱신까지 보정하고 최종 gate APPROVE를 받았다.

Task 5.2 — Complete proposed ADMIN API/error contract

Goal 실행 P5-T2: every proposed request/candidate/apply/cancel interaction maps to typed endpoint and existing auth/error response conventions.

  • 시작 조건: P3-T2, P4-T2, P5-T1 service boundaries stable.
  • 완료 증거: route, role, serialization, stable errors, idempotency, stale values and pagination integration tests.
  • 범위 밖: browser app, endpoint aliases, existing controller behavior changes.

Files:

  • Modify: adapter/in/web/AdminTranslationSelectionController.kt, dto/TranslationSelectionRequest.kt, dto/TranslationSelectionResponse.kt, i18n/SodaMessageSource.kt and existing message resource files verified before editing.

  • Test (new/proposed): src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/in/web/AdminTranslationSelectionHttpIntegrationTest.kt.

  • RED: ADMIN 권한·오류·paging·cancel·receipt HTTP 계약 테스트를 작성했다.

  • RED 확인: endpoint 미구현과 잘못된 언어 오류 코드 RED를 확인했다.

  • GREEN: 계약의 9개 endpoint와 typed DTO·안정 오류를 구현했다.

  • GREEN 확인: 최종 실제 HTTP 27개, ktlintCheck, bootJar 통과.

  • REFACTOR: 공통 exception handler를 바꾸지 않고 새 메시지와 feature 입력 오류를 처리했다.

Phase 5 Gate — P5-GATE

검증: subset apply writes exactly selected values, omitted candidate is not recoverable through same request, common bundle all-or-nothing, independent selected field unaffected by unrelated source update, stale selected candidate rejected, all validation occurs before any write.

Phase 6: schema and writer readiness gate

Phase 결과: 신규 writer가 작업을 생성하기 전에 schema와 구 writer 종료 조건을 충족하고 rollback 경로가 approval 보호를 보존한다. 별도 flag 활성화는 DEC-11로 폐기됐다.

선행조건: P1-GATE~P5-GATE, implementation owner가 실제 migration location, transport timeout semantics와 production DB claim strategy를 확인.

Task 6.1 — rollout readiness evidence

Goal 실행 P6-T1: 신규 writer가 승인 override를 덮어쓸 legacy writer와 구 unique index가 없는 준비된 환경에서 작업을 시작한다.

  • Files: schema.sql; CreatorAdminContentSeriesService.kt membership lock; deployment/operator-owned schema and rollout artifacts; plans/runbook evidence in this document or deployment-owned release record.

  • TDD 예외 사유: Deployment order, DDL application, blue/green instance inventory are operator/runtime procedures and cannot be proven by a code unit test alone.

  • 대체 검증 방법: schema review, 설정 없는 등록 테스트, rollout checklist, MySQL-focused locking/unique claim integration evidence, environment instance inventory.

  • 과거 기본 OFF controller/poller 동작을 구현·검증했다. 이 요구는 DEC-11/P7로 대체되며 당시 PASS 이력만 보존한다.

  • 세 신규 테이블과 queue 확장/축소 순서를 schema.sql artifact로 작성했다. 아래 운영 실행은 하지 않았다.

  • 최종 HTTP/회귀·lint·bootJar와 단일 전체 검토/차단 보정을 완료했다. 상세 증거는 Progress와 implementation-review.md에 있다.

  • Expand schema before new writers start work: three tables and source-language-aware queue unique index. 구 index는 구 writer/in-flight 작업 drain 전까지 유지한다. MySQL DDL every column/table COMMENT; timestamp seconds precision.

  • Drain all legacy web/worker instances, scheduled tasks, and in-flight materializers. 관리자 화면 미사용으로 일반 큐 작업을 막을 수 있다고 가정하지 않는다.

  • Remove old queue unique index after legacy drain and before any new writer creates jobs; retain the language-aware index. schema.sql의 주석 처리된 DROP은 별도 통제된 운영 statement로 남긴다.

  • Start the override-aware application only after schema/index/writer readiness is complete. Controller와 후보 worker는 기동 시 자동 등록되며 ADMIN·Redisson 잠금·기존 주기를 유지한다. 별도 기능 활성화 설정이나 미구현 worker 중지 기능은 없다.

  • After first approval rollback only to override-aware build. Record operator approval and evidence; never roll back to writer that ignores overrides.

  • Run MySQL integration evidence for candidate claim/fencing, Content lock freshness, group apply transaction, timestamp DB-response equality. H2 alone is insufficient.

승인된 execution order와 dependencies

다음 preflight 표는 같은 interface나 파일 경계를 공유하는 후속 작업을 묶어 충돌 지점을 드러낸다. 이는 task 순서를 바꾸거나 추가 구현 결정을 내리지 않는다.

선행 작업 의존 작업 공유 interface/file 경계
P1 snapshot (P1-T1) P2, P3 CONTENT source snapshot, fingerprint 및 source service
P1 grouping (P1-T2) P3, P4, P5 grouping/template 및 selection domain model
P2 writer (P2-T1/T2) P5, normal worker override-aware CONTENT writer, materializer 및 source invalidation
P3 request (P3-T1/T2) P4, P5 request lifecycle, store, controller/DTO contract
P4 candidate (P4-T1/T2) P5 candidate repository, generation manifest 및 cancellation boundary
P5 apply/API (P5-T1/T2) P6 apply transaction, controller/API contract 및 receipt

P6-T1의 운영 절차는 이번 승인 범위 밖이다. 로컬 구현 승인만으로 production DDL, 배포 또는 rollout 절차를 수행하지 않는다. P7의 플래그 제거 구현은 DEC-11로 이미 승인됐다.

순서 Goal 의존성 산출물
1 P1-T1 사용자 승인 Shared CONTENT source snapshot
2 P1-T2 P1-T1 Group analyzer/template
3 P1-GATE P1-T1, P1-T2 Source/group invariants
4 P2-T1 P1-GATE, schema approved Override-aware CONTENT writer
5 P2-T2 P2-T1 Source invalidation/queue correction
6 P2-GATE Phase 2 tasks Writer/mutation race evidence
7 P3-T1 P2-GATE Durable prepared request
8 P3-T2 P1-GATE, P3-T1 Review API
9 P3-GATE Phase 3 tasks No pre-review dispatch proof
10 P4-T1 P3-GATE Candidate worker/fresh results
11 P4-T2 P4-T1 Chunk dispatch cancellation gate
12 P4-GATE Phase 4 tasks Provider/cancel evidence
13 P5-T1 P2-GATE, P4-GATE Atomic one-shot subset apply
14 P5-T2 P3-T2, P5-T1 API contract implementation
15 P5-GATE Phase 5 tasks End-to-end server contract evidence
16 P6-T1 All gates, DEC-11 readiness Schema/index/writer readiness evidence

검증 명령 제안

구현 파일 경로 보완

Task에서 줄인 기존 경로의 root는 src/main/kotlin/kr/co/vividnext/sodalive/이고 신규 feature 경로의 root는 src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/다. corresponding repository/store adapter로 표기한 신규 파일은 아래 경로로 고정한다. 이 표는 새로 만들 파일의 제안이며 존재하는 파일이라는 뜻이 아니다.

  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/ContentTranslationOverrideRepository.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/JpaContentTranslationOverrideStore.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/TranslationSelectionRequestRepository.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/TranslationCandidateRepository.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/out/persistence/JpaTranslationSelectionStore.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/ContentTranslationWriteService.kt
  • src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationCallControl.kt
  • docs/20261117_관리자번역후보선택/schema.sql — 향후 구현에서 작성할 MySQL DDL. 현재 문서 작업에서는 생성·실행하지 않는다.

ContentTranslationSourceService.kt는 P1에서 생성하고 P3에서는 수정한다. Feature revision/selection 모델은 domain/TranslationSelection.kt, request/response 모델은 앞서 정한 DTO 두 파일에 둔다. 단일 사용 receipt 모델도 response DTO 파일 안에 두며 별도 TranslationSelectionReceipt.kt는 만들지 않는다. 공통 예외 파일은 기존 src/main/kotlin/kr/co/vividnext/sodalive/common/SodaException.kt와 src/main/kotlin/kr/co/vividnext/sodalive/common/SodaExceptionHandler.kt를 그대로 소비한다.

각 Phase Gate의 시작 조건은 같은 Phase Task 전체 GREEN 및 회귀 완료이며, 범위 밖은 다른 Phase 기능 추가와 테스트 완화다. 완료 증거는 아래 해당 focused 명령 통과·Task별 기록·Phase 문단의 수동 불변식 대조다. P6은 실제 운영 적용 승인 전 실행하지 않고 준비·검증 계획만 전달한다.

아래 commands는 미래 implementation checks이며 이번 문서 작업에서는 실행하지 않는다. Test class 경로와 names는 모두 proposed; implementation 시작 때 source tree와 actual Gradle test discovery에 맞춰 확정한다.

./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceSnapshotTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.domain.TitleGroupingAnalyzerTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationOverrideIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionWorkerIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionCancelIntegrationTest'
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionApplyIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest'
./gradlew ktlintCheck
./gradlew bootJar
  • Run a selector only after confirming the proposed test class exists. Do not claim these tests already exist.
  • Add exact affected source mutation and language detection test classes only after reading their actual test files; do not fabricate existing class names.
  • MySQL locking/index behavior requires integration against a suitable MySQL test database. H2 evidence alone cannot establish production behavior.
  • Entire test suite is user-owned: ./gradlew test. Do not run unfiltered test, check, build or clean build as the agent.
  • 제품 test, SQL, DB, build, provider 호출과 commit은 문서 작업에서 실행하지 않는다. 문서 변경 범위와 공백 검사는 별도로 수행해 아래 기록에 남긴다.

Change and commit strategy

This is a future implementation proposal, not permission to execute or commit. No commit is created by this plan. If the user separately authorizes implementation and commits, each atomic commit must contain one verified increment and its regression tests: shared snapshot/grouping; override-aware writer/invalidation; durable candidate generation/cancel; atomic apply/API; rollout/verification evidence. Do not commit intentionally failing RED work or split an invariant across commits. Use the repository's docs/agent-guides/커밋메시지.md and validate each proposed message using work/scripts/check-commit-message-rules.sh before an authorized commit.

승인된 기술 결정

제품 인터뷰와 승인된 설계 질문은 반복하지 않는다. 다음 설계는 기존 구현 기준이며 운영 실행은 이번 범위 밖이다.

  1. 세-table logical schema, JSON snapshot boundary, raw fingerprint definition and MySQL unique/index/lock strategy.
  2. Exact conservative title-span ranking and single ownership segmentation policy; code point API offset and grapheme boundary validation.
  3. 60초 lease와 복구 1회, connect/read/API-call별 timeout, dispatch 승인 기준의 취소 경계. Read timeout은 전체 처리 시간 보장이 아니다.
  4. All supported non-source languages × all registered provider fan-out, existing detection cache use when source language is missing, and its preparation failure behavior.
  5. DEC-11의 설정 없는 등록, 신규 작업 생성 전 schema 준비·legacy writer drain·구 queue index 제거, override-aware rollback condition.

기존 구현은 authentication handler, provider transport 재시도/timeout, series membership lock path를 기준으로 검증했다. 실제 운영 DB 검증은 별도 운영 증거이며 확정된 제품 요구사항을 약화하거나 구현 승인을 다시 요구하는 근거가 아니다.

Progress / 검증 기록

DEC-11/P7 이전의 기본 OFF, 혼합 flag 및 OFF→ON 운영 안내는 당시 검증·설계 이력으로 보존한다. 현행 정책은 설정 없는 기동 등록과 새 writer 작업 생성 전 schema/index/구 writer 종료 조건이다. 과거 PASS를 P7의 검증이나 외부 gate 승인으로 재사용하지 않는다.

Phase 7: 사용자 요청에 따른 자동 활성화

Goal 실행 P7-T1: 별도 enabled 설정 없이 관리자 번역 API와 후보 worker를 등록하고 일반 큐는 항상 원문 언어를 포함한 identity를 사용한다.

  • 시작 조건: PRD DEC-11 사용자 명시 승인. 기존 기능 전체를 다시 설계하지 않는다.
  • 완료 증거: 설정 없는 controller/worker 등록 및 ADMIN 경계, 언어별 독립 작업 생성·명시 refresh의 RED/GREEN, 직접 영향 회귀·lint, 현행 문서 일치.
  • 범위 밖: 운영 DB·배포·커밋, 일반 provider/후보/승인 정책 변경, 새 스위치나 default-true 호환 shim.
  • 변경 파일: AdminTranslationSelectionController.kt, TranslationSelectionWorker.kt, TranslationJobScheduler.kt, 고아 조회가 생기는 TranslationJobRepository.kt, src/main/resources/application.yml; 직접 생성자 호출 테스트와 activation/queue 테스트. 정확한 패키지는 기존 Phase의 file map을 유지한다.
  • 문서: 이 PRD/계획, api-contract.md, schema.sql, frontend-implementation-prompt.md 및 리뷰의 현행 정책을 수정한다. 과거 검증 기록은 삭제하지 않고 DEC-11/P7로 대체됐음을 명시한다.
  • RED: 설정 없는 실제 ADMIN endpoint/worker 등록과 서로 다른 원문 언어의 동일 source hash 작업 생성 실패를 확인했다.
  • GREEN: property·조건부 등록·legacy flag 분기를 제거하고 모든 호출자를 맞췄다. 사용이 사라진 repository 메서드/null-language 분기만 정리했다.
  • GREEN 확인: activation HTTP, polling, queue/refresh, 관련 scheduler/호출자 테스트를 --tests로 한정해 실행했다.
  • REFACTOR/자체 대조: ADMIN·Redisson·fixed-delay 계약 불변과 테스트 전용 격리를 확인하고 lint·문서 정합성 결과를 기록했다. 외부 검토 판정은 아래 별도 Gate다.

운영 전제 변경: OFF 상태 배포로 구 index와 공존하는 경로는 제거한다. 새 테이블·언어 포함 unique index를 먼저 준비하고, 구 writer를 drain한 뒤 구 unique index를 제거해야 한다. 그 이후 신규 코드의 실제 작업 생성을 허용한다. 관리자 화면을 사용하지 않는다는 사실만으로 일반 큐 생성이 중지된다고 가정하지 않는다. 이 작업에서 SQL이나 배포는 실행하지 않는다.

  • 착수 기록: 2026-11-18. 플래그 production 참조는 controller/worker 조건부 등록, scheduler 분기, application.yml이며 관련 테스트와 현행 문서도 함께 변경한다.

완료 Gate P7-GATE: 사용자가 하위 에이전트 없이 직접 마무리하도록 지시했다. 부모가 등록·권한·worker 잠금·queue identity와 테스트/문서 정합성을 직접 검토하고 bootJar 빌드 성공을 확인해 완료했다. P7 외부 리뷰 승인으로 표현하지 않는다.

P7-T1 로컬 완료 증거 — 2026-11-18

P7-GATE 부모 직접 완료 — 2026-11-18

  • 사용자의 직접 처리 지시 이후 하위 에이전트에 새 작업을 위임하지 않았다. 외부 검토의 결과를 기다리거나 승인 근거로 사용하지 않았다.
  • 직접 대조: application.yml의 활성화 설정 부재, controller/worker의 조건부 등록 제거, ADMIN 권한과 Redisson/1000ms 주기 유지, scheduler의 원문 언어별 조회 및 legacy 분기 제거, repository의 non-null exact-language locking query를 확인했다.
  • 검증 근거: P7 RED 4개 및 GREEN 18개 class 162개·ktlint 통과 기록과 테스트 assertions를 대조했다. 마지막 Contents HTTP XML 8개는 failures/errors/skipped 0이다. 통과한 테스트를 반복하지 않았다.
  • 직접 빌드: ./gradlew --offline --no-daemon bootJar — BUILD SUCCESSFUL in 19s, build/libs/sodalive-0.0.1-SNAPSHOT.jar 생성. 동일 명령을 불필요하게 한 번 더 호출한 결과는 16s/모든 task UP-TO-DATE였으며 추가 검증 증거로 계산하지 않는다.
  • 직접 공백 검사: GIT_MASTER=1 git diff --check 통과. 최종 문서 상태를 갱신한 뒤 변경 문서의 공백을 검사한다.
  • 운영 SQL·배포·커밋·전체 테스트는 실행하지 않았다. 운영 MySQL과 실제 provider는 미검증이다. 신규 작업 생성 전 schema/index와 구 writer 종료 조건은 유지한다.

아래는 구현 담당자의 당시 완료 기록이며, 이 기록에 남은 부모 검토 대기 상태는 위 P7-GATE 직접 완료로 종결됐다.

  • Task 7.1: 활성화 설정을 제거하고 설정 없는 API/worker 등록과 원문 언어별 독립 queue identity를 검증했다. P7-GATE는 미완료다.
  • 원인과 최소 수정: controller/worker의 조건부 등록과 scheduler의 기본 false 분기가 같은 설정에 묶여 있었다. 두 annotation/import, scheduler의 @Value·Boolean 인자·legacy 분기, application.yml의 해당 설정을 제거했다. true 기본값, matchIfMissing, 새 활성화 스위치는 없다.
  • 고아 API: TranslationJobRepository.existsByResourceTypeAndResourceIdAndFieldKeyAndTargetLanguageAndSourceHash를 삭제했다. findContentFieldJobsForUpdate는 exact force-refresh 호출이 필요하므로 유지하고 sourceLanguage를 non-null String으로 좁혀 null wildcard만 제거했다. P2의 locking current read·managed refresh와 worker의 재료화/완료 원자 transaction은 유지했다.
  • 계약 교체: TranslationSelectionDisabledHttpIntegrationTest의 비등록/404 기대는 DEC-11로 폐기하고 TranslationSelectionActivationHttpIntegrationTest의 실제 ADMIN 생성·조회, USER 거부 및 worker bean 등록 2개로 교체했다. environment에도 해당 property가 없는지 확인한다. Queue의 구 unique 공존/혼합 flag 요구는 동일 언어 중복 방지·exact 언어 재개로 교체했다. Refresh의 legacy skip 요구는 다른 언어 완료 행을 보존하면서 현재 언어 refresh를 생성하는 검증으로 교체했다. Retry/완료 태그도 이전 언어 행을 보존하며 새 identity를 생성하도록 기대를 맞췄다. stale managed RUNNING·빈 consistent read 이후 commit된 exact row·현재 상태별 예산·원자 완료 경쟁 회귀는 삭제하거나 약화하지 않았다.
  • 테스트 격리: 기존 선택 기능 @Import 설정과 local H2/fake provider, Redisson mock을 재사용했다. 이 전용 설정은 scheduling processor를 활성화하지 않으며 polling 테스트가 실제 worker를 명시 호출한다. production disable knob나 전역 isolation 변경, 실제 provider 호출은 없다.

RED 실행 명령 (production 변경 전):

./gradlew --offline --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.TranslationSelectionActivationHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest.shouldDistinguishJobsBySourceLanguage' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationRefreshIntegrationTest.shouldCreateIndependentLanguageRefreshAgainstCurrentRows'
  • RED 결과: 3개 class 4개 테스트가 모두 assertion 실패, errors/skip 0. 실제 생성 HTTP expected 200 / actual 404, worker bean expected 1 / actual 0, 일반 queue expected {ko, ja} / actual {ko}, 명시 refresh expected {ko, ja} / actual {ja}. 컴파일·fixture 실패가 아니다. BUILD FAILED in 50s.

GREEN 실행 명령:

./gradlew --offline --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.TranslationSelectionActivationHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.TranslationSelectionContentsHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionApplyHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionReceiptHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionPollingIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionWorkerIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationRefreshIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.CompletedContentTagRepairTest' \
  --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRefreshIntegrationTest' ktlintCheck
./gradlew --offline --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionContentsHttpIntegrationTest'
  • GREEN 결과: 첫 명령은 17개 class 154개 테스트와 ktlintCheck 통과, BUILD SUCCESSFUL in 1m 43s. TranslationSelectionContentsHttpIntegrationTest selector는 잘못된 이름이라 매칭되지 않았다. 통과한 154개를 재실행하지 않고 실제 AdminTranslationSelectionContentsHttpIntegrationTest만 두 번째 명령으로 실행해 8개 통과, BUILD SUCCESSFUL in 47s. 총 18개 class 162개가 failures/errors/skipped 0이다.
  • 첫 실행 직후 build/test-results/test/TEST-*.xml의 17개 suite와 개수를 대조했다: Activation 2, Admin HTTP 14, Apply HTTP 10, Receipt HTTP 3, Polling 2, Request 8, SelectionWorker 4, Queue 7, Refresh 7, SourceInvalidation 13, Scheduler 3, Retry 10, CompletedTags 27, CreatorCommunity 16, JobWorker 13, ContentTag 11, SelectionRefresh 4. 두 번째 실행의 Contents HTTP XML은 8개다. Gradle 후속 test 실행이 이전 XML을 덮어쓰므로 현재 result 디렉터리는 두 번째 실행 증거이며 첫 실행의 관찰 기록과 혼동하지 않는다.
  • 정적 대조: src/main 검색에서 활성화 property·selectionEnabled·삭제한 exists API·null-language wildcard 참조 0건. 테스트의 enabled=true/false 주입도 모두 제거했고 property 이름은 신규 activation 테스트의 실제 environment 부재 assertion에만 남는다. API ADMIN 경계, worker lock key/lease/fixed-delay, exact-language refresh는 원래 구현을 유지했다.
  • 문서: PRD/API/현재 계획/SQL 운영 주석/독립적으로 전달하는 frontend prompt와 현재 review 상태를 자동 등록 정책으로 맞췄다. 과거 검증/리뷰의 OFF 정책에는 DEC-11 supersession 안내를 붙이고 PASS 기록은 보존했다. SQL DROP은 여전히 주석 처리된 별도 운영 statement이며 실행하지 않았다.
  • 자체 구조 대조: 변경은 등록·enqueue identity·기존 회귀 계약에 한정했다. 신규 helper/type escape/방어층/로그/입력 경계는 추가하지 않았다. 신규 activation 테스트는 45 pure LOC, Queue는 185, Refresh는 140이다. 기존 CompletedContentTagRepairTest는 241로 다음 증설 때 분리를 검토한다. 기존 Retry 테스트는 287로 크지만 이번 요청의 좁은 계약 교체만 수행하고 무관한 구조 정리는 하지 않았다.
  • 미검증·미실행: 전체 테스트(./gradlew test는 사용자 실행), check/build/bootJar, 운영 MySQL RR·잠금·시각·DDL, cloud/실제 provider, 배포·커밋, 외부 reviewer. 사용자 지정 도구 범위에 따라 LSP는 호출하지 않았고 Kotlin/Java compilation과 ktlintCheck를 사용했다. Gradle 9 deprecation 안내는 남아 있다. H2 성공을 운영 MySQL 증거로 주장하지 않는다. 신규 writer의 작업 생성 전 세 테이블·언어 포함 unique index, 구 writer/in-flight 종료, 구 unique index 제거가 필요하며 P7-GATE는 부모 담당자에게 남긴다.

최종 로컬 완료 및 운영 인계 — 2026-11-17

  • P1~P5 및 P5-R1 완료. 단일 전체 gate의 TR-19 차단 한 건을 보정한 후 새 delta 검토가 APPROVE/HIGH를 반환했다. 다른 통과 범위는 재감사하지 않았다.
  • 부모가 최종 코드에서 실제 HTTP 세 클래스 27개와 bootJar를 실행했다. BUILD SUCCESSFUL in 2m 7s, 종료 코드 0. 최신 XML failures/errors/skipped 0과 jar 존재를 최종 reviewer가 확인했다.
  • P5-R1 신규4+직접118 회귀 및 ktlintCheck 통과. 이전 각 Phase의 RED/GREEN·실패 보정 기록은 보존하며 중복을 합산해 전체 테스트 수로 주장하지 않는다.
  • Feature 기본값은 false다. schema expand → 모든 구 writer/in-flight 작업 drain → 구 queue unique index 제거 → enabled=true의 순서를 운영 담당자가 별도 승인 후 수행한다. 운영 MySQL 검증과 DDL 실행·배포·커밋은 미실행이다.
  • Ruling 요약: residual 내부 구문을 하나의 입력으로 보존해 의미 손실을 막았다. AWS SDK admin retry는 request별 interceptor gate/timeout 안에서 제어하고 일반 retry 설정은 유지했다. 두 판단은 승인된 요구를 구현하는 방식이며 잘못되면 후보 품질/취소 시 비용 예측에 영향이 있으나 게시 값은 명시적 적용 전까지 보존한다.
  • 전체 테스트 사용자 명령: ./gradlew test. 실제 provider 품질·4500건 처리량·프론트엔드 화면은 이번 검증 범위 밖이다. 최종 상태·문서 공백 검사 후 종료한다.

P4-GATE 완료 — 2026-11-17

  • 독립 검토 PASS. Provider manifest/version, fresh fan-out, 필드 정책을 포함한 요청 내부 dedup, linked 후보 출처, lease/fence/cancel, all-failed/zero-unit READY, 실제 SDK retry 전송 gate, 일반 호출 비간섭을 확인했다.
  • 검증 증거는 최초 focused 180개 실행 중 실패 2건을 수정하고 해당 ADMIN API 13개와 실제 전송·취소·worker 14개를 통과한 이력이다. 최초 실패를 감추거나 180개 전체가 마지막 실행에서 통과했다고 표현하지 않는다. 마지막 14개 XML failures/errors/skipped 0 및 ktlint 오류 0을 검토자가 확인했다.
  • 기존 API 404 기대를 구현된 REVIEW_REQUIRED/호출0 검증으로 바꾸고 AWS SDK의 실제 CBOR 프로토콜에 맞춘 로컬 fixture 수정은 검증 완화가 아니라 계약 반영이다.
  • 실제 cloud·운영 DB·배포는 미실행. 다음 P5-T1/P5-T2.

P3-GATE 완료 — 2026-11-17

  • 독립 검토 PASS, 수정 필요 finding 없음. ADMIN/기본 비활성 gate, ACTIVE membership, UUID 충돌 rollback 후 replay, 준비 lease/fence/cancel, source/membership current read, 전체 grouping coverage/revision, snapshot/현재 값 분리와 출처를 확인했다.
  • 관련 11개 class 68개 tests의 XML failures/errors/skipped 0과 ktlint 보고서를 독립 검토자가 대조했다. 나노초 경계 DB 왕복·실제 HTTP 시각 일치 검증 포함. 재실행하지 않았다.
  • 준비 시 누락 언어만 감지하며 게시 payload·approval·기존 번역 memory·일반 job은 변경하지 않는 경로가 구현됐다.
  • 운영 MySQL·실제 provider·배포는 미검증/미실행이다. 다음 P4-T1/P4-T2.

P4 provider 경계 참고 — 2026-11-17

  • AWS SDK 공식 RequestOverrideConfiguration.Builder는 요청별 apiCallTimeout, apiCallAttemptTimeout, putExecutionAttribute를 제공한다. AwsRequestOverrideConfiguration.Builder 공개 메서드에는 요청별 retry strategy가 없다. 설치된 SDK에서 compile로 확인하고 존재하지 않는 builder API를 가정하지 않는다.
  • 공식 ExecutionInterceptor.beforeTransmission은 SDK retry마다 호출된다. 요청 execution attribute가 있을 때만 취소 gate를 실행하는 interceptor 방식은 기존 공유 client와 일반 호출 동작을 유지하면서 admin 요청의 실제 전송 재시도를 제어할 수 있다.
  • Ruling: 일반 client의 retry 설정을 전역 변경하거나 새 transport를 만들지 않는다. Admin 요청의 SDK 재시도도 실제 전송 전 gate와 전체 API timeout 안에 포함시킨다. 이미 승인된 전송의 과금은 되돌릴 수 없으며 요청/후보 작업의 exactly-once는 주장하지 않는다.
  • 근거: https://docs.aws.amazon.com/java/api/latest/software/amazon/awssdk/core/interceptor/ExecutionInterceptor.html 및 https://docs.aws.amazon.com/java/api/latest/software/amazon/awssdk/awscore/AwsRequestOverrideConfiguration.Builder.html . 문서 조회만 했고 실제 AWS 호출은 없다.

P3-T1 구현·집중 검증 — 2026-11-17

  • 생성은 외부 호출 전에 PREPARING과 활성 member IDs를 commit한다. 관리자+UUID unique 충돌은 별도 REQUIRES_NEW 삽입 transaction이 rollback된 후 승자 요청을 읽는다. canonical scope SHA-256이 다르면 IDEMPOTENCY_CONFLICT다. 빈 활성 시리즈는 FAILED/EMPTY_SCOPE로 저장한다.
  • 공유 source builder와 기존 감지 cache를 사용한다. 준비 전후 request → Series → 현재 CONTENT 오름차순 잠금 및 fresh refresh로 원문·언어·활성 membership을 검사한다. 누락 언어만 최종 게시 transaction에서 저장하며 payload/approval/일반 job을 변경하지 않는다. 초기 source baseline은 복구에도 고정한다.
  • 60초 lease, 단조 fence, 복구 1회 및 두 번째 만료 PREPARATION_INTERRUPTED를 구현했다. 취소는 request gate에서 즉시 commit하며 진행 중 감지 종료를 기다리지 않는다. 만료 fence는 갱신·게시할 수 없다. feature worker는 기존 Redisson의 lock:translation-selection을 사용하고 controller와 같은 enabled property로 보호한다.
  • RED: 최초 실제 HTTP 생성에서 endpoint 미구현 404 assertion 실패를 확인했다. 이후 준비 미구현 경계에서 17개 중 9개 assertion 실패를 확인했다. 테스트 설정의 중복 method-security와 JPA index column naming 오류는 RED 증거에서 제외하고 원인만 수정했다.
  • GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionPreparationIntegrationTest' — Request 8개, Preparation 12개, failures/errors/skipped 0. 동시 unique, timestamp 나노초 0/123456789/999999999의 실제 flush/clear 왕복, detector transaction 부재, latch 취소 및 stale fence를 포함한다.
  • 저장 보완: getter를 자동 직렬화하지 않는 typed JSON에 raw source·필드 fingerprint·검증된 lossless template를 명시적으로 저장한다. 이 보완 후 재검증과 최종 lint는 P3-T2와 함께 수행한다. 생성·잠금·JSON의 주석은 rollback-only transaction 재사용, 잠금 소유권, 파생 getter 오저장 방지를 설명하는 필수 경계 기록이다.
  • P3-T2에서는 summary/contents/grouping/cancel HTTP와 오류·권한을 완성한다. candidate/generate/apply endpoint는 아직 없다. parent가 P3 전체 외부 검토를 수행한다.

P3-T1 / P3-T2 완료 기록 — 2026-11-17

  • P3-T1: 실제 request persistence, 원자적 멱등 생성, 활성 membership 고정, 원본 언어 준비 및 취소·lease/fence·복구 검증 완료.
  • P3-T2: ADMIN create/summary/contents/grouping GET·PUT/cancel의 실제 HTTP, typed DTO, revision과 source range 검토 구현 및 집중 검증 완료.
  • P3 로컬 검증: 신규 45개와 직접 회귀 23개, 총 11개 class의 68개 테스트가 failures/errors/skipped 0. 같은 실행에서 ktlintCheck BUILD SUCCESSFUL, Kotlin/Java compilation 완료.
  • P3-GATE 외부 검토: 부모 담당자가 전체 Phase 검토를 수행한다. 이 완료 기록은 운영 활성화나 외부 review sign-off가 아니다. 상단 진행 표와 기존 체크박스는 요청된 append-only 경계에 따라 수정하지 않았다.

실제 endpoint는 /admin/audio-content/translation-requests의 POST, GET /{requestId}, GET /{requestId}/contents, GET·PUT /{requestId}/grouping, POST /{requestId}/cancel이다. Controller와 worker 모두 sodalive.translation-selection.enabled의 명시적 true에서만 등록되므로 기본값은 비활성이다. /generate, candidate 및 apply endpoint는 추가하지 않았다. 미래 상태와 DDL 예약 컬럼만 존재한다.

그룹 read model은 분석 시 확정한 raw shared text, code point exclusive-end range와 lossless template/valueIndex를 저장한 typed JSON을 그대로 반환한다. PUT은 기존 P1 validate를 사용하고 IllegalArgumentException을 INVALID_GROUPING으로 바꾼다. 전체 scope 누락·중복, 언어 혼합, 다른 raw shared text, grapheme 분할을 거부한다. 모두 individual인 series도 REVIEW_REQUIRED를 거쳐 확정하며 revision은 재검토마다 증가한다. GENERATING 이후 편집은 거부한다.

콘텐츠 페이지는 기본 50, 최대 100, Long ID cursor다. 동결 원문/fingerprint와 현재 fingerprint·활성·연결 자격을 구분한다. 삭제된 원문의 snapshot을 보존하고 현재 fingerprint는 null, eligible은 false다. 현재 source fingerprint에 일치하는 override만 ADMIN 출처와 실제 provenance를 반환하며 나머지는 UNKNOWN이다. 현재 locale payload가 없으면 현재 source fallback을 사용한다. 일부 필드의 원문 변경은 다른 필드의 approval provenance를 숨기지 않는다.

추가 RED/GREEN: 기존 cache detector는 첫 제공자 실행 중 취소돼도 다음 감지 제공자를 호출했다. TranslationSelectionDetectionDispatchIntegrationTest에서 fallback 호출 expected 0 / actual 1을 확인했다. 기존 detectWithCache(query) 계약을 유지하고 detectWithCache(query, authorizeDispatch) overload를 추가해 각 감지 제공자 직전 짧은 request/source/lease gate를 실행한다. 네트워크 중 transaction/부모 잠금은 없고 취소 전 승인된 호출만 in-flight로 취급한다. 이 경계는 후보 번역 호출 구현이 아니다. P3 HTTP 최초 RED는 미구현 GET/PUT/cancel 경로에서 12개 assertion 실패였다. 최초 lint의 새 파일 포맷/import 오류는 apply_patch로 수정했고 마지막 실행은 깨끗하다.

최종 실행 명령:

./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelection*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
  --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' \
  --tests 'kr.co.vividnext.sodalive.admin.content.AdminContentControllerSecurityTest' ktlintCheck

신규 class별 최종 결과는 Request 8, Preparation 12, DetectionDispatch 1, Polling 2, Admin HTTP 13, Contents HTTP 8, Disabled HTTP 1이다. 기존 회귀는 Cache 2, Metadata transaction 10, Provider cache E2E 5, Admin security 6이다. Timestamp 검증은 나노초 0/123456789/999999999의 23:59:59를 실제 H2 flush/clear·재조회와 HTTP 2026-11-17T23:59:59Z까지 정확히 비교한다. H2의 이 결과를 MySQL locking/timestamp 증거로 주장하지 않는다.

P4가 소비할 실제 경계:

  1. application/TranslationSelectionRequestService: create(adminId: Long, clientRequestId: UUID, scope: TranslationSelectionScope): TranslationSelectionRequest, get(requestId: Long), cancel(requestId: Long). 조회는 작업을 dispatch하지 않는다.
  2. port/TranslationSelectionStore: find(requestId), findCreation(adminId, clientRequestId), lock(requestId), nextPreparation(now), save(request). lock/claim/save의 transaction은 호출 application이 소유한다. lock은 PESSIMISTIC_WRITE와 refresh로 현재 managed 상태도 갱신한다.
  3. application/TranslationSelectionPreparationService: prepareNext(): Boolean, claimNext(): TranslationPreparationClaim?, processPrepare(claim: TranslationPreparationClaim). Claim은 requestId/fence/고정 sources다. 만료된 claim은 자신의 lease를 되살릴 수 없다. 복구 한도를 소진한 row를 FAILED로 닫은 경우 claimNext는 null이다.
  4. domain/SelectionRequestSnapshot: version, immutable memberContentIds, preparationSources, 확정 contents 및 sourceFingerprints, grouping의 groups/individualContentIds/templates, reviewed, providerManifest, targetLanguages. SelectionTitleTemplate.template()은 기존 P1 TitleTemplate/render 계약으로 복원한다. P4는 accepted generation revision과 후보 progress의 실제 처리를 추가해야 한다.
  5. application/ContentTranslationSourceService.lockScope(scope)는 호출자의 request transaction 안에서 Series → 현재 CONTENT 오름차순 잠금을 얻고 활성 콘텐츠만 반환한다. 새 source 조립 없이 기존 AudioContent.toContentSourceSnapshot()을 사용한다. adapter/scheduler/TranslationSelectionWorker는 기존 Redisson lock:translation-selection 안에서 현재 PREPARING만 처리하며 P4가 같은 poller를 확장한다.

자체 구조 대조: 새 production 파일 최대 169 pure LOC, 새 테스트 최대 181 pure LOC다. 파일별 책임은 요청 저장/준비/검토/조회/HTTP/polling으로 한정한다. 새 내부 Any map·type suppression·retry framework·일반 자동 번역 fallback을 추가하지 않았다. source와 JSON/API 입력의 경계에서 검증하고 기존 P1 분석 정책, P2 override writer와 detector cache를 재사용한다. 테스트 HTTP helper의 method/path/body/actor는 실제 wire 입력이라 네 인자를 유지하며 별도 가짜 config 객체를 만들지 않았다. 기존 대형 SodaMessageSource는 필요한 여섯 message key만 추가했다.

미실행: 전체 테스트/full check/build/bootJar, 운영 또는 실제 DB/DDL, 실제 provider/cloud, 배포·활성화, git/commit/delegation/worktree 및 외부 검토. LSP 도구가 없어 Kotlin/Java compilation과 lint로 검사했다. 기존 AudioContentServiceTest의 불필요한 !! 및 donation/presence 테스트의 unchecked cast 경고, Gradle 9 deprecation은 변경 범위 밖이라 그대로 남겼다. P1 domain 파일은 수정하지 않아 전용 재검증을 하지 않았다. 전체 테스트 사용자 실행 명령은 ./gradlew test다. 승인된 P3에서 중단한다.

P2-GATE 완료 — 2026-11-17

  • 최초 독립 검토의 materialize/complete 간 refresh 유실을 같은 transaction 완료 처리로 보정했다. 후속 RR snapshot 변형은 명시적 CONTENT refresh의 locking current read와 managed refresh로 보정했다.
  • 제한 재검토 최종 판정: ADDRESSED, 해당 P2 finding 잔여 없음. Content → job 잠금 순서와 provider transaction 분리는 유지한다.
  • 검증 이력: 초기 관련 focused 257개, 완료 경합 보정 관련 44개, RR 보정 신규 7개+관련 46개 통과. 각 수정 범위에 맞춰 실행했으며 마지막 ktlintCheck 통과. 이 수치를 서로 다른 고유 테스트 총합으로 주장하지 않는다.
  • 실제 MySQL RR은 실행하지 않았고 H2 가시성 모사는 별도 한계로 기록한다. P2-GATE는 코드·기능 검증 완료이며 운영 적용 승인이 아니다. 다음 P3-T1/P3-T2.

P1-T2 구현 검증 — 2026-11-17

  • 상태: 그룹 분석·검토 검증·템플릿 조립 구현 및 focused GREEN 완료, 작업 범위 독립 검토 중.
  • 구현: TitleGroupingAnalyzer.analyze, TitleGroupingReview.validate, TitleTemplate.render; 언어별 실제 반복 구간 탐색, 전체 scope 분할/범위 검증, 원문을 보존하는 Unicode code-point/grapheme template.
  • RED: 도메인 테스트 21개가 미구현 정책 때문에 assertion 실패했다.
  • GREEN: TitleGroupingAnalyzerTest 21개 + ContentSourceSnapshotTest 14개 통과, ktlintCheck 통과. 부모가 grouping XML의 failures/errors/skipped 0을 확인했다.
  • 검토 초점: multiword residual 입력이 의미 문맥을 유지하는지, 손실 없는 재구성과 provider 입력 경계가 함께 맞는지 확인한다.
  • 미실행: 전체 테스트, DB, 실제 provider, HTTP 회귀(이번 변경은 domain 3파일만).
  • Ruling: 의미 있는 residual gap은 내부 공백/구두점을 포함한 하나의 번역 입력으로 유지한다. 단어별 분해는 실제 문맥을 소실하므로 금지한다. 바깥 구분자만 literal로 보존한다. 잘못된 판단이면 제목 분석 후보 품질에 영향이 있지만 사용자 원문·게시 번역은 적용 전까지 바뀌지 않는다.

P1-T2 보정 및 P1-GATE 완료 — 2026-11-17

  • RED: 두 residual 구문을 기대했으나 다섯 단어 입력으로 나뉘는 assertion 실패를 확인했다.
  • 수정: 문자 있는 gap은 바깥 구분자만 literal로 두고 내부 공백·구두점·숫자·grapheme를 포함한 구문을 하나의 residual로 유지한다.
  • GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.domain.TitleGroupingAnalyzerTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceSnapshotTest' — 21+14개 통과. ./gradlew ktlintCheck 통과.
  • 독립 제한 재검토: 기존 fragmentation 지적 ADDRESSED, 잔여 지적 없음. Snapshot 14개/HTTP 22개 검증과 함께 P1-GATE 완료.
  • 다음: P2-T1 승인 저장과 CONTENT writer 연동. 제품 커밋·운영 DB·provider 호출 없음.

P1-T1 구현 검증 — 2026-11-17

  • 상태: 구현·집중 검증 완료, 작업 범위 독립 검토 진행 중.
  • 변경: ContentSourceSnapshot과 AudioContent.toContentSourceSnapshot()을 추가하고 CONTENT extractor/상세 서비스의 원문 조립을 공유했다. 활성 태그의 연관 ID 순서를 고정하고 정확한 원문·언어·태그 벡터의 length-framed fingerprint를 추가했다. 생성자 주입/API 계약은 유지했다.
  • RED: AudioContentDetailTranslationHttpIntegrationTest.shouldShareOrderedActiveSourceAcrossExtractorAndDetail가 기존 태그 순서 차이로 assertion 실패했다. 별도 tag-vector collision 변이에서도 도메인 테스트 2개가 assertion 실패했으며 변이는 복구했다. 새 타입 미구현 컴파일 실패는 RED 증거로 세지 않았다.
  • GREEN: ./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceSnapshotTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' ktlintCheck — BUILD SUCCESSFUL, 도메인 13개/HTTP 22개 모두 통과. 부모가 Gradle XML의 failures/errors/skipped 0을 확인했다.
  • 한계: H2·테스트 provider 기준이다. 전체 테스트/운영 DB/실제 provider/배포/커밋은 실행하지 않았다. LSP 도구가 없어 Kotlin compile과 lint로 검사했다.
  • 다음: P1-T1 독립 검토 종료 후 P1-T2 제목 분석을 구현한다. 같은 통과 테스트를 변경 없이 반복 실행하지 않는다.

P1-T1 검토 보정 및 완료 — 2026-11-17

  • 검토: nullable tag ID를 null-first로 정렬하면 영속화 전후 원문이 바뀌는 1건을 발견했다.
  • RED: ContentSourceSnapshotTest.shouldAppendPendingTagsAndKeepSnapshotStableAfterIdAssignment가 null-first 순서 때문에 assertion 실패.
  • 수정: 저장 ID는 오름차순, pending은 nullsLast 안정 정렬로 뒤에 두어 삽입 순서를 유지한다.
  • GREEN: snapshot 및 상세 HTTP 두 focused class 재실행 — BUILD SUCCESSFUL 38s, 14+22개 모두 통과. 이 보정 후 lint 재실행은 P1 grouping 검증에서 함께 수행한다.
  • 재검토: 같은 두 위치만 읽어 ADDRESSED, 추가 지적 없음. P1-T1 완료, 다음 P1-T2. 제품 커밋·운영 반영은 없다.

문서 제안 작성 — 2026-11-17

  • 상태: 기술 설계 초안, 사용자 검토 대기.
  • 무엇을: 기존 PRD를 인터뷰 결정에 맞게 보정하고 신규 API 및 구현 계획 제안 2개를 작성.
  • 어떻게: sample-prd.md, sample-plan-task.md, 작업/문서유지보수/코드/테스트/실행명령어 guides, 기존 CONTENT translation/provider/admin/mutation/read path sources를 읽어 문서에 반영했다.
  • 검증: 문서 간 정합성만 확인. tests, build, SQL, provider, API, DB 및 Git commands는 실행하지 않았다.
  • 남은 항목: architecture/API proposal 사용자 검토, 운영 DB/MySQL locking 및 provider timeout behavior unverified, 모든 implementation tasks 미착수.
  • 다음 행동: 사용자가 제안 설계를 검토하고 구현 기준을 승인한 뒤 P1-T1부터 시작.

설계 검토와 후속 인터뷰 반영 — 2026-11-17

  • 단일 독립 검토에서 제품 결정/제안 혼동, apply 검증 잠금 순서, queue index 호환, 취소 경계, preview DTO, PREPARING 복구, replay/provider-version 검증을 지적했다. 검토 기록에 근거와 보정을 남겼다.
  • 후속 인터뷰에서 활성 series member만 포함하고 한 번의 부분 적용 후 요청을 종료하기로 확정했다. 자유 번역문 입력 제외는 사용자 거부 결정이 아닌 이번 요청 범위 제한이다.
  • 검토 지적을 PRD/API/계획에 반영했다. MySQL·외부 provider·실제 UI는 실행하지 않았고 구현 체크박스는 모두 미완료다.

문서 검증 — 2026-11-17

  • 네 문서 각각 GIT_MASTER=1 git diff --no-index --check /dev/null "문서 경로"를 실행했다. 모두 종료 코드 0, 공백 오류 출력 없음. 대상은 prd.md, api-contract.md, plan-task.md, reviews/design-review.md다.
  • GIT_MASTER=1 git status --short --untracked-files=all 확인 결과 이 디렉터리의 위 Markdown 네 파일만 신규 파일로 표시됐다. 제품 source·설정·테스트 변경은 없다.
  • 이 기록 추가 후 계획 문서의 공백 검사만 다시 수행한다. 다른 문서의 통과한 검사는 반복하지 않는다.
  • 문서 전용 범위이므로 Gradle 테스트·빌드·운영 DB·provider 호출은 실행하지 않았다. 향후 구현의 테스트 명령은 제안이며 실행 성공을 주장하지 않는다.

P2-T1 / P2-T2 구현·검증 완료 — 2026-11-17

  • 상태: 두 구현 Goal 완료, 활성 구현 Goal 없음. Phase 2에서 중단한다. P2-GATE는 외부 최종 검토 전이므로 통과 판정하지 않는다. 상단 상태 표의 갱신은 부모 담당자의 범위로 남긴다.
  • 승인 저장: ContentTranslationOverride domain/port/JPA entity/repository/store와 ContentTranslationWriteService를 추가했다. 승인 문자열, 정확한 fingerprint, request/candidate/provider/admin 출처와 UTC 초 승인 시각을 override row 하나에 보관한다. 후보/request FK나 해당 테이블/API, ContentTranslation metadata column은 없다.
  • 쓰기 경계: lockContent(contentId: Long): AudioContent?, lockContent(content: AudioContent), approve(contentId: Long, locale: String, approvals: List<ContentFieldApproval>): List<ContentTranslationOverride>, materialize(contentId: Long, locale: String): Boolean, hasCurrentApproval(contentId: Long, locale: String, fieldKey: String): Boolean. approve는 REQUIRED transaction으로 외부 그룹 transaction에 참여하며 선택하지 않은 payload 문자열을 보존한다. CONTENT materializer는 부모 lock과 refresh 뒤 최신 source/override/payload를 읽고, 승인 없는 필드에만 기존 memory를 요구한다. 잠금 중 provider 호출은 없다.
  • 변경 경계: ContentTranslationSourceInvalidationService.lock(content), invalidateChanged(content, before: ContentSourceSnapshot), invalidateStale(content); ContentTranslationLanguageService.detectMissing(contentId, expectedQuery: String? = null). 호출자는 source 수정 전에 부모를 잠그고 before/after를 비교한다. 변경 필드만 전체 locale에서 승인 해제/fallback/enqueue하며 언어 변경은 세 필드 전부다. 이미 삭제한 승인은 A→B→A에서도 살아나지 않는다. 감지 뒤 잠금 안에서 원문을 다시 검사하며 기존 payload shortcut도 stale 승인을 제거한다.
  • 외부 호출: 기존 감지 cache의 hash/provider/winner 정책은 유지하고 DB 조회·publish만 짧은 transaction으로 분리했다. 세 수정 서비스의 표지 업로드는 부모 lock 이전에 transaction을 suspend하여 수행한다. 실제 테스트 provider/uploader callback에서 active transaction 부재를 확인했다. 기존 활성 변경(delete/uploadComplete/scheduled publish/admin/creator)과 Series add/remove에도 같은 부모 잠금과 refresh를 적용했다.
  • Queue: sourceLanguage 포함 unique/단건 lookup/active lookup/claim grouping을 적용했다. enabled=false에서는 exact lookup 실패 후 legacy key EXISTS로 구 index 충돌을 피한다. 다중 언어 row와 혼합 flag, 두 unique index 공존을 H2에서 검증했다. 완료된 일반 CONTENT 필드는 명시적 source invalidation signal일 때만 재개하며 기존 태그 repair와 비-CONTENT 완료 정책은 유지한다. 승인된 재실행 필드는 worker가 paid call을 생략한다.
  • RED: 첫 override 테스트에서 stale managed source로 materialize가 true를 반환하는 assertion 실패 1개; 세 source 수정 진입점에서 기존 승인 제목이 남는 assertion 실패 3개; 감지 provider의 active transaction assertion 실패를 확인했다. 승인 우선순위와 worker false 처리를 각각 제거한 변이에서도 2개 assertion 실패를 확인하고 원래 구현을 복구했다. 타입/테스트 fixture 오류와 JPA column naming 오류는 RED 증거에 포함하지 않았다.
  • 수정 중 실패: H2 fixture의 HashTag가 BaseEntity가 아닌 점과 명시적 column naming을 보정했다. 감지 테스트의 query는 shared snapshot과 동일한 전체 query로 고쳤다. HTTP 감지 후 enqueue 기대와 legacy event assertion은 새 계약에 따라 실제 DB의 정확한 필드/언어/행 수 assertion으로 교체했다. 테스트 삭제/skip/비교 완화는 없다. 초기 compile 포함 120초, 최종 compile/test/lint 결합 240초 제한 실행은 완료 판정하지 않았으며, 후자는 종료 후 실행 중 JVM이 없음을 확인하고 focused test와 lint를 분리해 완료했다.
  • 최종 GREEN: 아래 최종 명령에서 11개 class, 117개 테스트 전부 failures/errors/skipped 0. 신규 Override 10개(나노초 0/123456789/999999999의 23:59:59 flush/clear 왕복 포함), SourceInvalidation 13개, Membership 7개, Queue 6개. parent lock을 보유한 상태의 approval/automatic 경쟁과 실제 override read 경계의 PESSIMISTIC_WRITE도 확인했다.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' \
  --tests 'kr.co.vividnext.sodalive.admin.content.AdminContentServiceTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest'
./gradlew ktlintCheck
  • 추가 직접 회귀 GREEN: ./gradlew --no-daemon test에 각 아래 class를 --tests로 명시하여 실행했다. 같은 통과 검사를 변경 없이 반복하지 않았다.
    • i18n.translation.CompletedContentTagRepairTest 27개.
    • content.LanguageDetectionCacheServiceTest 2개, i18n.translation.LanguageDetectionProviderTest 7개, content.MetadataLanguageDetectTransactionTest 10개, i18n.translation.MetadataTranslationHttpIntegrationTest 4개.
    • i18n.translation.AudioContentReadRetryTest 1개, i18n.translation.LanguageProviderCacheEndToEndTest 5개.
    • v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest 13개, AiCharacterAdminAudioContentUpdateTest 19개, v2.api.admin.aicharacter.series.LegacyCreatorAdminSeriesCharacterizationTest 7개. Legacy producer 테스트는 관련 없는 scheduled consumer를 mock하여 외부 provider 실행을 격리하고 실제 queue 쓰기를 검증했다.
    • content.CreatorCommunityLanguageDetectTest 12개, CreatorCommunityLanguageDetectionCacheConcurrencyTest 2개, v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest 16개, content.ContentSeriesDetailTranslationHttpIntegrationTest 15개.
  • 최종 lint: ./gradlew ktlintCheck BUILD SUCCESSFUL. LSP diagnostics 도구는 제공되지 않아 focused 실행의 Kotlin/Java compilation과 ktlint를 근거로 사용했다. 기존 Kotlin 경고 및 Gradle 9 deprecation, embedded Redis 종료 시 reconnect warning은 숨기지 않았다. 신규 파일은 production 최대 112 pure LOC, 테스트 최대 168 pure LOC이며 기존 대형 서비스는 요청된 경계만 수정했다.
  • 운영 artifact: schema.sql은 override table만 생성하고 모든 컬럼/테이블 COMMENT를 포함한다. provenance는 plain ID/list metadata의 TEXT JSON으로 저장한다. 별도 expand SQL은 source-language unique를 추가하면서 구 index를 유지한다. 구 writer/in-flight 작업 drain 후 별도 승인으로 구 index를 삭제하고 그 뒤 enabled=true로 바꾸는 순서 및 override-aware rollback 제한을 주석으로 남겼다. 이 주석은 SQL 실행 순서를 잘못 적용하지 않기 위한 필수 운영 조건이다. 운영 SQL은 실행하지 않았다.
  • 미실행: 전체 테스트 및 full check/build, production/MySQL locking·timestamp·DDL, 실제 provider/cloud 호출, 배포, git/commit/worktree, 외부 reviewer. H2 증거를 production MySQL 검증으로 간주하지 않는다. P1 builder는 변경하지 않아 P1 전용 테스트는 재실행하지 않았다. 전체 테스트는 사용자가 ./gradlew test로 실행한다. Phase 3~5 기능은 추가하지 않았다.

P2 Gate finding 보정 — 재료화와 작업 완료의 원자적 commit — 2026-11-17

  • 범위: 외부 검토에서 확인한 단일 경쟁 조건만 수정했다. Phase를 추가하지 않았으며 P2-GATE 판정은 부모 담당자에게 남긴다.
  • 원인: worker의 materializer transaction이 CONTENT 잠금을 해제한 다음 completeJob의 별도 transaction이 실행됐다. 그 사이 raw title에 공백을 추가하면 정확한 fingerprint는 달라지지만 normalized job hash는 같다. 무효화는 payload를 source fallback으로 바꾼 후 RUNNING job을 유지하고, 이전 worker가 뒤늦게 COMPLETED로 바꾸어 refresh를 잃었다.
  • RED: ContentTranslationQueueIntegrationTest.shouldKeepRefreshWhenRawSourceChangesDuringWorkerCompletion을 먼저 추가했다. 실제 Spring materializer proxy가 반환한 직후 latch로 worker를 멈추고, 실제 repository와 invalidation service로 원문 제목 → 원문 제목 변경을 commit시켰다. 기존 worker에서 expected PENDING but was COMPLETED assertion 실패 1개를 확인했다. 서비스 결과나 repository 쓰기를 가짜로 대체하지 않았고 sleep은 사용하지 않았다.
  • 수정: TranslationJobWorker.processNextGroup의 materialize + 성공 작업 completeJob 호출을 기존 transactionTemplate의 한 executeWithoutResult로 감쌌다. materializer의 REQUIRED와 completeJob의 기존 REQUIRED template이 같은 transaction에 참여하므로 CONTENT 부모 잠금은 payload와 COMPLETED 상태가 함께 commit될 때까지 유지된다. provider/ensureMemory loop는 이 transaction 밖에 그대로 둔다. 동일한 최소 wrapper를 모든 resource의 성공 경로에 적용하되 resource별 재료화 로직, 완료 조건, 부분 실패 경로와 재시도 정의는 바꾸지 않았다.
  • 잠금 순서: claim transaction은 job lock을 해제한 뒤 종료된다. 이후 materialization/completion은 CONTENT 부모 → payload/override → job 순서이며, source invalidation의 CONTENT 부모 → job 순서와 일치한다. job lock을 보유한 채 CONTENT를 다시 잠그는 경로를 추가하지 않았다. 실패하거나 materialize가 false이면 이 transaction이 rollback된 후 기존 failJob transaction으로 재시도 상태를 저장한다.
  • GREEN: 같은 latch 테스트는 worker transaction이 열려 있으면 원문 수정 시작까지만 기다려 잠금 획득을 경쟁시킨다. 수정 commit 후 동일 en job ID/hash가 PENDING으로 남고 payload는 정확한 공백 포함 source fallback이다. 다음 실제 worker 실행에서 English title로 복구되고 해당 job이 COMPLETED가 되는 것까지 검증했다. 실제 테스트 provider callback의 active transaction 부재와 총 호출 1회도 확인했다.
  • focused 검증: 아래 명령의 Queue 7개, SourceInvalidation 13개, Worker 13개, ContentTag 11개, 총 44개 테스트가 failures/errors/skipped 0이다. 첫 결합 실행에서 테스트는 모두 통과했으나 신규 테스트의 미사용 import 1개로 lint가 실패했다. 해당 import만 제거하고 ./gradlew ktlintCheck를 실행해 BUILD SUCCESSFUL을 확인했다. 통과한 테스트는 반복 실행하지 않았다.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' ktlintCheck
./gradlew ktlintCheck
  • 변경 파일: i18n/translation/TranslationJobWorker.kt, v2/contenttranslation/application/ContentTranslationQueueIntegrationTest.kt 및 이 Progress 기록뿐이다. 테스트 조율은 기존 materializer 호출 경계에서 실제 Spring proxy에 위임하며 production 전용 test seam은 추가하지 않았다.
  • 미실행: 이전 257개 전체 회귀의 재실행, 전체 테스트/full check/build, 운영 DB/MySQL·cloud/provider, git 및 외부 검토. 검증은 H2 기준이며 전체 테스트 사용자 명령은 ./gradlew test다. 새 API, provider 코드, DDL 및 승인·무효화 정책 변경은 없다.

P2 Gate 동일 finding 보정 — 강제 refresh의 current read — 2026-11-17

  • 범위: 같은 lost-refresh finding의 REPEATABLE READ 변형만 보정했다. 앞선 worker의 materialize/COMPLETED 원자적 transaction은 그대로 유지했다. 새 Phase나 Gate 통과 판정은 추가하지 않는다.
  • 원인: source mutation의 잠금 전 비잠금 조회가 만든 consistent-read snapshot 때문에 worker 완료 commit 이후에도 scheduler의 plain lookup은 이전 RUNNING 또는 빈 결과를 볼 수 있었다. 잠금 조회로 row를 다시 찾아도 같은 persistence context의 managed 상태는 별도로 오래될 수 있다. 비활성 호환 모드의 legacy EXISTS 역시 이전 빈 snapshot을 사용하면 다른 언어 row를 놓칠 수 있다.
  • 수정: 명시적 CONTENT invalidation 경로에만 TranslationJobRepository.findContentFieldJobsForUpdate의 PESSIMISTIC_WRITE 조회를 사용한다. exact sourceLanguage로 현재 row를 찾은 뒤 EntityManager.refresh(job, PESSIMISTIC_WRITE)로 managed 상태도 다시 읽는다. 그 잠금 아래 현재 FAILED/COMPLETED만 PENDING으로 전환하고 retry/error/nextRetryAt을 초기화한다. managed entity를 직접 갱신하므로 같은 persistence context에도 PENDING이 남는다. 현재 PENDING/RUNNING의 상태와 예산은 보존한다.
  • 뒤늦게 나타난 row: locking query 자체가 이전 plain snapshot에 없던 row의 존재 여부를 판단한다. exact row가 없고 enabled=false이면 같은 current locking query에만 sourceLanguage=null을 전달해 legacy key의 모든 언어 row 존재를 확인한다. 리스트의 존재만 판단하므로 다중 언어 row에도 안전하며 잘못된 insert를 생략한다. exact 언어 row가 있으면 다른 언어 row는 변경하지 않는다. 일반 enqueue와 비-CONTENT의 기존 plain lookup/조건부 UPDATE 정책은 유지했다.
  • 잠금/외부 호출: 기존 source invalidation의 Content 부모 → job 순서를 유지하며 job lock은 source mutation transaction 끝까지 보유한다. provider 코드나 network 경계는 바꾸지 않았고 새 경로는 DB 조회/갱신만 한다. 전역 isolation 변경, context 전체 clear, 재시도 계층 또는 오류 suppression은 없다.
  • RED: 신규 ContentTranslationRefreshIntegrationTest 7개 중 3개 assertion 실패를 구현 전에 확인했다. 실제 별도 transaction에서 완료를 commit한 뒤에도 stale managed RUNNING이 재개되지 않는 경우, 이전 plain 조회가 빈 결과인 exact job이 뒤늦게 commit된 경우는 expected PENDING / actual COMPLETED였다. legacy plain EXISTS가 이전 false를 반환하는 경우에는 다른 언어 job이 있는데도 추가 insert가 발생했다. 나머지 현재 상태별 4개는 기존 동작 확인이었다.
  • 검증 경계: managed RUNNING 회귀는 실제 H2/JPA의 stale persistence context와 별도 transaction commit을 사용한다. 뒤늦은 exact/legacy row 두 회귀는 H2를 MySQL RR로 가장하지 않고, 기존 plain-read 메서드에만 이전 null/false를 유지시켜 그 visibility 경계를 모사한다. locking query, refresh, source invalidation 및 모든 repository 쓰기는 실제 Spring/JPA/H2를 사용하고 DB 상태를 assert한다. sourceLanguage가 다른 완료 row가 그대로 남는 것과 같은 managed 객체가 PENDING으로 바뀌는 것도 검증했다. production 전용 test seam, sleep 또는 mock write는 없다.
  • GREEN: 아래 한 번의 focused 실행에서 Refresh 7개, Queue 7개, SourceInvalidation 13개, Scheduler 3개, Retry 10개, Worker 13개, 총 53개가 failures/errors/skipped 0이며 ktlintCheck도 BUILD SUCCESSFUL이다. 기존 latch 기반 완료 경쟁/후속 refresh, materialize false 재시도와 provider transaction 부재 회귀도 포함한다.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationRefreshIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' ktlintCheck
  • 변경 파일: production은 TranslationJobScheduler/TranslationJobRepository 두 파일, 신규 회귀는 ContentTranslationRefreshIntegrationTest 한 파일이다. EntityManager 생성자 주입에 따라 기존 직접 생성 테스트 6파일의 호출 인자만 맞췄다. 이 Progress 외 기존 문서/체크리스트/Gate는 변경하지 않았다.
  • 한계: 실제 MySQL REPEATABLE READ 실행, 운영 isolation 설정 확인, 운영 DB/DDL·cloud/provider, 전체 테스트/full check/build 및 이전 전체 focused 회귀 재실행은 하지 않았다. H2 통과를 MySQL RR production proof로 주장하지 않는다. 전체 테스트 사용자 명령은 ./gradlew test이며 최종 P2 Gate는 부모 검토 대상이다.

P4-T1 / P4-T2 구현 및 로컬 검증 완료 — 2026-11-17

  • 실제 API: POST /admin/audio-content/translation-requests/{requestId}/generate의 {expectedRevision}와 GET /{requestId}/candidates?afterCandidateId=&size=50을 기존 ADMIN controller에 추가했다. 최대 page size는 100이며 조회는 dispatch하지 않는다. 요약 progress는 실제 candidate 상태 집계다. acceptedGenerateRevision replay는 terminal/current revision 거부보다 먼저 판정한다. 모든 individual인 series도 기존 grouping review가 필수다.
  • Request 잠금 아래 source snapshot/grouping은 보존하고 generationUnits/provider ID·version/대상별 후보를 같은 transaction에 동결한다. FIELD는 nonblank title/detail/tags 전체 문자열, GROUP_COMMON은 sharedParts 순서 배열, TITLE_RESIDUAL은 member template의 residual 순서 배열이다. literal-only residual과 빈 필드는 paid 작업이 없다. 세 source 언어별 non-source target 전체를 검증했다.
  • TranslationCandidate/TranslationCandidateStore/JPA candidate entity가 작업과 결과를 영속화한다. 고정 unit/provider/language unique, 60초 lease, claim attempt 최대 2, 만료/stale fence의 renew/publish 거부 및 EXECUTION_INTERRUPTED 종결을 구현했다. 모든 후보 terminal이면 전부 실패해도 READY이며 zero-work도 즉시 READY다. 일반 job retry나 전역 cache/framework는 추가하지 않았다.
  • 모든 등록 provider를 직접 호출한다. 기존 memory가 있어도 fresh 호출하며 동일 번역 결과의 제공자 출처는 별도 candidate로 남는다. provider 변경/소실은 PROVIDER_CHANGED, count/blank/unchanged AWS tags는 INVALID_PROVIDER_RESULT, provider 예외는 PROVIDER_FAILED다. 외부 예외 원문은 저장·반환하지 않고 current payload/override/translation memory는 변경하지 않는다.
  • Ruling: 정확히 같은 입력 배열은 같은 request/provider/version/source/target/kind/field 정책 안에서 선행 candidate ID로 연결한다. 각 member의 unit/input/source 소유권은 독립 row로 보존하고 선행 성공·실패를 같은 transaction에 종결 복사한다. 기존 memory나 다른 요청을 읽지 않는다. 잘못된 판단이면 중복 비용이나 candidate provenance에 영향을 주므로 group 공통 순서, residual 중복 호출 8→6, member 소유권을 실제 H2·fake provider로 확인했다.
  • Lock 순서는 request gate → candidate ID 오름차순이다. 선행 candidate보다 나중에 생성한 linked rows만 함께 잠근다. Worker의 짧은 REQUIRES_NEW transaction은 READ_COMMITTED로 제한해 잠금 대기 전의 RR 집계 snapshot이 마지막 READY 전이를 누락하지 않게 했다. 전역 isolation은 바꾸지 않았다. Cancel은 같은 request gate에서 모든 후보를 DISCARDED로 만들고 결과/lease를 폐기하며 fence를 증가시킨다. 취소 commit 이후 새 전송 승인 및 늦은 게시를 거부한다. Network 동안 DB transaction을 유지하지 않는다.
  • 같은 Redisson lock:translation-selection poller가 candidate 한 건과 preparation 한 건을 처리한다. Preparation은 finally에서 수행하므로 만료 candidate의 복구 소진이 다른 요청 준비를 막지 않는다. 실제 scheduler 검증을 추가했다. DB claim이 실행 소유권의 기준이며 분산 lock만으로 소유권을 추정하지 않는다.
  • TranslateRequest.callControl: TranslationCallControl?는 기본 null이다. 실제 AWS Translate/Comprehend 공유 client에 요청 execution attribute가 있을 때만 동작하는 AwsTranslationCallInterceptor.beforeTransmission을 등록했다. 매 SDK retry를 gate로 검사하며 일반 호출 retry는 유지한다. 실제 SDK + localhost HTTP에서 첫 500 응답 중 cancel DB commit 후 network count 1, 일반 호출은 500→200으로 count 2를 확인했다. Papago translation 각 chunk와 detection도 전송 직전에 gate를 확인한다. 기존 detector callback/cache와 일반 fallback 정책은 유지한다.
  • Ruling: 설치된 SDK 2.57.11은 요청별 apiCallTimeout/apiCallAttemptTimeout/putExecutionAttribute를 지원하며 공개 요청별 retryStrategy 및 Apache5 connect/read override를 제공하지 않는다. 따라서 AWS는 기존 공유 transport의 socket 설정을 유지하고 요청별 남은 15초 API/attempt budget으로 제한한다. Papago만 기존 RestTemplate 방식의 admin 전용 transport에 configurable connect 3000ms/read 15000ms를 적용한다. 정상 일반 transport/retry는 바꾸지 않고 새 dependency/client-per-call은 도입하지 않는다. 이 판단이 틀리면 AWS socket 수치 보장에 영향이 있으며 해당 수치를 보장했다고 주장하지 않는다. Papago read timeout도 절대 total wall-clock 15초 보장이 아니다.
  • 실제 HTTP timeout 테스트는 Papago 100ms read, AWS 150ms API budget의 짧은 설정으로 응답 보류를 종결하는 것을 확인한다. SDK timeout의 절대 중단 정밀도나 이미 승인된 전송의 과금 취소는 보장하지 않는다. Crash 복구는 이미 청구된 호출을 한 번 더 보낼 수 있다.

TDD/검증 기록:

  1. 최초 WorkerIntegrationTest에서 미구현 generate HTTP expected 200 / actual 404를 확인했다. 생성 구현 후 worker 미처리의 READY / GENERATING 실패를 확인했고, 취소 미폐기 2개와 residual 중복 호출 expected 6 / actual 8도 RED 후 수정했다. 실제 SDK retry/Papago chunk 제어 테스트는 기대한 제어 예외가 발생하지 않는 RED를 먼저 확인했다. 중간 테스트 Kotlin 문법 오류와 120초 compile timeout은 RED 증거로 세지 않는다.
  2. 관련 focused 180개 실행에서 178개가 통과하고 2개가 실패했다. 실패는 P3의 Phase4 이전 404 기대와 AWS local fake의 JSON 응답이었다. 첫 테스트는 실제 REVIEW_REQUIRED 오류·호출 0 검증으로 갱신했다. 두 번째는 실제 SDK가 Accept: application/cbor를 사용하는 것을 확인하고 이미 설치된 shaded CBORFactory로 wire 응답을 고쳤다. 제품 SDK/transport는 바꾸지 않았다.
  3. 수정한 ADMIN HTTP class 13개가 통과했다. 마지막 직접 회귀는 ControlledProvider 5개, ControlledDetection 2개, Cancel 3개, Worker 4개로 총 14개 failures/errors/skipped 0이다. 마지막 Worker에는 새 복구 소진/preparation 진행 검증 1개가 포함된다. 초기 180개와 이를 합친 고유 범위는 181개이나, 181개 단일 일괄 GREEN 실행으로 표현하지 않는다. 이미 통과한 기능은 반복 실행하지 않았다.
  4. 최종 ./gradlew --no-daemon ktlintCheck BUILD SUCCESSFUL. Kotlin/Java 및 테스트 compilation 완료. 신규 핵심 파일은 WorkerService 158 pure LOC, GenerationService 124, 실제 provider HTTP test 182이며 추가 범용 framework/Any escape/type suppression은 없다. DTO·source 정책·영속 adapter·worker의 책임을 분리하고 P1/P2/P3 경계를 재사용했다. 기존 테스트의 !!/unchecked cast 경고와 Gradle 9 deprecation은 변경 범위 밖으로 남겼다.

실행 명령:

./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelection*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.Controlled*HttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsTranslationServiceTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' \
  --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
  --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' \
  --tests 'kr.co.vividnext.sodalive.admin.content.AdminContentControllerSecurityTest'
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.ControlledProviderHttpIntegrationTest.shouldPreserveOrdinarySdkRetries' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest'
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.Controlled*HttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionCancelIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionWorkerIntegrationTest'
./gradlew --no-daemon ktlintCheck

P5 인계 계약:

  • TranslationSelectionGenerationService.generate(requestId, expectedRevision): TranslationSelectionRequest, TranslationSelectionCandidateQueryService.page(requestId, afterCandidateId, size): TranslationCandidatesResponse.
  • TranslationSelectionRequest.acceptedGenerateRevision, snapshot.generationUnits, 기존 raw snapshot.contents/fingerprints/grouping/templates/providerManifest/targetLanguages를 소비한다. Worker progress는 admin revision을 올리지 않는다.
  • TranslationCandidate: candidateId/requestId/unit/provider/targetLanguage/status/translatedValues/failureCode/attempt/leaseUntil/fence/terminalAt/linkedCandidateId. Unit은 FIELD/GROUP_COMMON/TITLE_RESIDUAL 및 실제 field/content/group/inputValues/sourceLanguage를 보존한다. P5는 성공 후보의 자기 unit/provenance를 검증하고 기존 P2 writer에 전달할 수 있다.
  • TranslationCandidateStore의 find/page/lock/progress/save/discard와 request gate를 재사용한다. TranslationSelectionWorkerService는 claimNext/runNext/process/authorize/publish를 제공한다. schema.sql에 COMMENT와 FK RESTRICT를 포함한 candidate DDL만 작성했으며 실행하지 않았다.

미실행/지시 이탈: P5 apply/approval endpoint, 전체 test/check/build/bootJar, 운영 MySQL/DDL·실제 AWS/Papago·배포·git/commit 및 reviewer는 실행하지 않았다. H2를 MySQL locking 증거로 주장하지 않는다. LSP 도구가 없어 compilation/lint를 사용했다. 사용자용 전체 테스트 명령은 ./gradlew test다. SDK 서명 확인에 읽기 전용 explore 하위 에이전트를 1회 사용한 것은 이번 요청의 위임 금지 위반이며 세션 중 고지했다. 해당 agent는 SDK만 읽었고 source/test를 수정하지 않았다. 이후 구현·검증은 직접 수행했다. 승인된 Phase4에서 중단한다.

P5-T1 / P5-T2 로컬 구현 및 검증 완료 — 2026-11-17

  • P5-T1 RED: 실제 HTTP /apply 미구현 404를 확인했다. Provider manifest와 exact raw fingerprint 검증을 각각 제거한 변이에서는 provider version, raw 공백 변경, 원본 언어 변경의 3개 assertion 실패를 확인하고 원래 구현을 복구했다.
  • P5-T1 GREEN: FIELD 및 TITLE_GROUP의 one-shot subset을 request → Series → CONTENT 오름차순 잠금 안에서 검증하고 payload·override·receipt·미선택 후보 폐기를 한 transaction으로 저장했다. 불완전 그룹, 후보 소유권·성공 상태·frozen manifest/input/언어 불일치, 선택 원문 또는 활성 membership 변경은 쓰기 없이 거부한다.
  • P5-T1 직접 회귀: 콘텐츠·언어 bundle별 approve 1회로 합쳐 미선택 문자열을 보존하며 없는 locale은 현재 원문 fallback으로 초기화한다. Group은 기존 reviewed template.render로 선언된 shared 배열 순서와 원문 배치를 보존한다. Literal-only member에는 common ID만 기록한다. 선택 alias는 복사된 결과와 자기 ID를 유지하며 미선택 leader의 폐기와 독립적이다.
  • P5-T2 RED/GREEN: HTTP CONTENT 전체 흐름, 여러 그룹·개별 제목이 섞인 SERIES 전체 흐름, cancel, 불완전 그룹의 무쓰기 거부, stable typed errors, ADMIN guard, 원문 변경 후에도 불변인 receipt GET/replay를 확인했다. 지원하지 않는 fr의 INVALID_REQUEST 기대가 CANDIDATE_NOT_SELECTABLE로 실패한 뒤 입력 경계에서 보정했다.
  • P5-T2 검증: 관련 고유 170개 케이스를 검증했다. 최초 170개 실행에서 20개 실패가 있었으며 아래 원인을 수정한 뒤 해당 5개 class 42개가 failures/errors/skipped 0으로 통과했다. 나머지 128개는 앞 실행의 통과 증거를 유지하고 반복하지 않았다. 단일 실행의 170개 GREEN으로 표현하지 않는다. 마지막 ktlintCheck는 BUILD SUCCESSFUL이다.
  • P5-GATE 부모 최종 검토: 사용자의 지시에 따라 외부 reviewer를 호출하지 않았다. 전체 QA/build 및 최종 review 판정은 부모 담당자에게 인계한다. 기존 상단 표·체크박스와 이전 완료 기록은 변경하지 않았다.

실제 경계:

  1. TranslationSelectionApplyService.apply(requestId: Long, adminId: Long, body: ApplyTranslationSelectionRequest): TranslationSelectionApplyReceipt는 REQUIRED transaction을 소유한다. Body는 operationId, expectedRevision, sealed TranslationSelectionChoice.Field/TitleGroup이며 residual choice는 contentId, nullable candidateId다. 번역문 입력이나 Any payload는 없다.
  2. Request 잠금 안에서 operation/body SHA-256 replay를 상태·revision보다 먼저 판정한다. FIELD/group/residual의 의미상 집합 순서만 canonical 정렬하며 중복 자체는 제거하지 않는다. 다른 operation은 terminal에서 REQUEST_CLOSED, 같은 operation의 다른 body는 IDEMPOTENCY_CONFLICT다. 요청 생성자 소유권을 추가하지 않고 ADMIN acting member ID를 provenance에 저장한다.
  3. 최종 판정은 기존 ContentTranslationSourceService.lockScope(scope) 이후의 새 source/활성 연결 목록으로 한다. FIELD는 자기 필드와 현재 자격만 검사하여 다른 필드 수정·다른 member 추가를 허용한다. 선택 TITLE_GROUP은 전체 frozen ACTIVE series membership과 모든 member의 title/language를 검사한다. 잠금 전 managed source/tag 연관이 남은 경우와 원문 수정 commit을 기다린 경우도 실제 H2 transaction으로 검증했다.
  4. ContentTranslationWriteService.approve(contentId, locale, approvals)를 유지하고 명시적 approvedAt: LocalDateTime을 받는 overload를 추가했다. Apply는 한 번 초 정밀도로 정규화한 시각을 모든 bundle 및 receipt에 전달한다. TranslationCandidateStore.discardUnselected(requestId, selectedIds: Set<Long>, now): Int는 선택 ID를 보존하고 논리 폐기 개수를 반환하며 기존 discard-all은 cancel만 사용한다.
  5. 기존 예약 컬럼 apply_operation_id/apply_body_hash/apply_receipt/applied_at을 domain/JPA/typed JSON converter/response에 연결했다. 새 DDL·중복 컬럼은 없다. Snapshot provider version은 apply에서 변경하지 않는다. Receipt는 최종 필드 값·실제 candidate IDs/providers·초 정밀도 시각·폐기 수를 같은 transaction에 저장하고 원본 변경 뒤에도 그대로 반환한다.

회귀 수정 기록:

  • 최초 넓힌 focused 실행의 20개 실패 원인은 새 시각 인자의 Kotlin default expression nowProvider()였다. 생성된 static approve$default가 Spring CGLIB proxy의 미초기화 backing field를 읽어 NPE가 발생했다. 실패 stack은 ContentTranslationWriteService.approve$default와 기존 3인자 호출을 직접 가리켰다. Timestamp 자체나 기존 테스트를 완화하지 않았다.
  • 기본 인자 expression을 제거하고 기존 3인자 transactional 메서드 안에서 clock을 읽어 4인자 overload로 전달했다. 시각을 명시한 apply 경로와 기존 호출의 transaction 참여를 유지한다. 직접 영향 42개에는 Override 10, SourceInvalidation 13, Queue 7, 기존 feature Worker 4, Contents HTTP 8이 포함된다.
  • 초기 compile/test 결합 240초 timeout은 성공이나 RED 증거로 세지 않았고 실행 프로세스 종료 후 더 긴 한도의 focused 명령으로 완료했다. 중간 lint의 새 코드 포맷·미사용 import를 apply_patch로 수정했다. 마지막 잔여 if branch brace도 수정하고 최종 lint가 통과했다.

집중 검증 명령과 증거:

# 최초 관련 170개: 150 통과, 20 실패. 아래 42개 보정 재검증과 함께 해석한다.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelection*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.*IntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationOverrideIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' ktlintCheck
# 보정 후 42개 및 ktlintCheck: BUILD SUCCESSFUL, failures/errors/skipped 0.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationOverrideIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionWorkerIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionContentsHttpIntegrationTest' ktlintCheck
  • 신규 P5 케이스는 56개: Apply 20, Group 15, Concurrency 7, Apply HTTP 10, Receipt HTTP 3, 기존 Admin HTTP에 추가한 CONTENT 전체 흐름 1이다. 기존 ADMIN guard의 세 역할은 apply도 검사하도록 확장했다. Group HTTP는 공통 Papago+member별 AWS/Papago 출처, 여러 그룹·언어·개별 제목, 일부 언어 미선택, 불완전 요청 실패 후 같은 operation의 정상 적용을 확인한다.
  • CountDownLatch로 두 관리자 요청의 later-commit-wins와 일반 materializer 경쟁, apply/cancel 양쪽 commit 순서, source mutation 대기를 제어했다. 실제 DB payload·override·candidate 상태·receipt를 확인하며 mock 반환값을 assertion하지 않는다. 외부 transaction rollback은 네 저장 결과를 모두 되돌린다.
  • 나노초 0/123456789/999999999의 23:59:59 입력을 실제 flush/clear·재조회에 통과시켰고 override/applied_at/receipt와 HTTP GET·POST replay가 정확히 2026-11-17T23:59:59Z에 일치했다. 현재 source를 이후 바꿔도 영수증은 불변이다.
  • 구조 대조: 새 production 최대 197 pure LOC, 새 테스트 최대 197 pure LOC다. 기존 Admin HTTP는 231 pure LOC로 경고 구간이며 다음 증설 시 동작별 HTTP class로 분리한다. 기존 대형 SodaMessageSource는 네 필수 message key만 수정했다. 책임은 적용 orchestration/typed 입력/영속화/HTTP로 나누고 P1 render·P2 writer·P3 lockScope를 재사용했다. 불필요한 fallback/retry/helper/type suppression/새 로그는 추가하지 않았다. 승인 시각의 네 번째 인자는 여러 bundle과 receipt의 같은 확정 시각을 보장하기 위한 실제 호출 입력이다.

변경 파일: production root는 src/main/kotlin/kr/co/vividnext/sodalive/, test root는 src/test/kotlin/kr/co/vividnext/sodalive/다.

production (11)
v2/contenttranslation/application/TranslationSelectionApplyService.kt (new)
v2/contenttranslation/application/ContentTranslationWriteService.kt
v2/contenttranslation/dto/ApplyTranslationSelectionRequest.kt (new)
v2/contenttranslation/dto/TranslationSelectionResponse.kt
v2/contenttranslation/domain/TranslationSelectionRequest.kt
v2/contenttranslation/port/TranslationCandidateStore.kt
v2/contenttranslation/adapter/in/web/AdminTranslationSelectionController.kt
v2/contenttranslation/adapter/out/persistence/JpaTranslationCandidateStore.kt
v2/contenttranslation/adapter/out/persistence/JpaTranslationSelectionStore.kt
v2/contenttranslation/adapter/out/persistence/TranslationSelectionRequestEntity.kt
i18n/SodaMessageSource.kt
tests (9)
v2/contenttranslation/application/TranslationSelectionApplyIntegrationTest.kt (new)
v2/contenttranslation/application/TranslationSelectionApplyGroupIntegrationTest.kt (new)
v2/contenttranslation/application/TranslationSelectionApplyConcurrencyIntegrationTest.kt (new)
v2/contenttranslation/application/TranslationSelectionApplyTestSupport.kt (new)
v2/contenttranslation/application/TranslationSelectionTestConfiguration.kt
v2/contenttranslation/adapter/in/web/AdminTranslationSelectionHttpIntegrationTest.kt
v2/contenttranslation/adapter/in/web/AdminTranslationSelectionApplyHttpIntegrationTest.kt (new)
v2/contenttranslation/adapter/in/web/AdminTranslationSelectionReceiptHttpIntegrationTest.kt (new)
v2/contenttranslation/adapter/in/web/TranslationSelectionApplyHttpTestSupport.kt (new)
docs (2)
docs/20261117_관리자번역후보선택/api-contract.md
docs/20261117_관리자번역후보선택/plan-task.md

미실행: 전체 test/check/build/bootJar, 변경하지 않은 provider transport tests의 재실행, 실제 cloud/provider, production/MySQL/DDL, 배포·활성화, git/commit/delegation, 외부 최종 검토. LSP diagnostics 도구가 없어 Kotlin/Java compilation 및 lint를 사용했다. 기존 다른 테스트의 !!/unchecked cast와 Gradle 9 deprecation은 범위 밖이다. H2 결과는 MySQL isolation/잠금 증거가 아니며 부모 P6 QA/build/final review와 운영 검증으로 인계한다. 전체 테스트 사용자 명령은 ./gradlew test다.

P5-R1 최종 Gate 회귀 보정 — 부분 적용 뒤 변경 필드 자동 재료화 — 2026-11-18

목표: P5 subset apply가 만든 기존 locale payload에서 일반 원문 수정으로 예약된 필드만 게시하고 실제 게시된 job만 완료한다. P2의 엄격한 전체 재료화, 새 payload 완성 조건, 부모 잠금 및 재료화/작업 완료의 같은 transaction을 유지한다.

  • RED: TranslationSelectionRefreshIntegrationTest를 실제 apply → AudioContentService.modifyAudioContent → 일반 TranslationJobWorker로 실행해 3개 assertion 실패를 확인했다. title/detail만 승인한 뒤 tags memory가 없는 경우 제목은 Edited title 대신 수정 제목에 머물렀다. title/tags 변경 중 tags provider가 실패한 경우도 제목이 게시되지 않았고, locale payload가 없는 경우에는 게시 없이 title job이 COMPLETED가 됐다.
  • GREEN: 기존 writer에 materialize(contentId, locale, fields: Set<ContentSourceFieldKey>) overload를 추가했다. 기존 locale의 명시 필드만 현재 승인/메모리로 계산하고 기존 merge로 저장한다. Locale row가 없으면 모든 필드를 요구한다. 기존 2인자 materialize 및 기존 resource materialize는 전체 필드 조건을 유지한다.
  • Worker 연결: TranslationReadModelMaterializer.materializeContentFields(resourceId, targetLanguage, fieldKeys)로 CONTENT 성공 job의 필드 집합을 전달한다. 일부 provider 실패에도 성공 필드를 먼저 실제 게시한 뒤 같은 transaction에서 그 job만 완료한다. 게시 불가 시 성공 job도 재시도하며 provider 실패 job은 기존 실패 정책을 따른다. CONTENT 이외 분기와 provider I/O 경계는 변경하지 않았다.
  • 직접 회귀: 신규 4개, 기존 Queue 7개, Worker 13개가 통과했다. 추가 영향 범위 Apply 20, Override 10, SourceInvalidation 13, 기존 Refresh 7, CONTENT 상세 HTTP 22, ContentTag 11, SERIES 상세 HTTP 15개가 통과했다. 서로 다른 두 focused 실행의 합계 122개이며 전체 suite 성공을 뜻하지 않는다.
  • 최종 lint: ktlintCheck BUILD SUCCESSFUL. 첫 GREEN 실행은 테스트 24개가 통과했으나 새 테스트의 assert 줄바꿈으로 lint만 실패했다. 해당 포맷을 수정하고 나머지 98개 실행과 함께 최종 lint를 통과했다. 이미 통과한 24개는 반복 실행하지 않았다.
  • 부모의 delta 최종 검토: 이 수정의 외부 재검토와 관리 HTTP 27개/bootJar 새 검증은 부모 담당자 범위다. 이 단위에서 수행하지 않았다.

수정 경계와 불변식:

  • Production은 v2/contenttranslation/application/ContentTranslationWriteService.kt, i18n/translation/TranslationReadModelMaterializer.kt, i18n/translation/TranslationJobWorker.kt 세 파일만 변경했다. SourceInvalidation의 changed-field-only enqueue, 상세 shortcut, provider, queue identity, DTO/DDL은 변경하지 않았다. 새 framework/flag/cache 채움은 없다.
  • Writer는 CONTENT 부모 잠금과 refresh 이후 source와 locale 존재를 current locking read로 확인한다. 현재 source와 정확히 일치하는 field approval만 사용한다. 선택하지 않은 payload는 다른 메모리가 없거나 있어도 byte-for-byte 유지한다. 두 인자 전체 재료화는 기존 payload에서도 미준비 tags memory를 허용하지 않는다.
  • 신규 테스트 v2/contenttranslation/application/TranslationSelectionRefreshIntegrationTest.kt의 4개는 missing tags memory와 현재 detail 승인 보존, cached-but-unselected tags의 정확한 문자열 보존, provider 부분 실패 시 기존 payload의 성공 필드 게시, 새 payload 미완성 시 job 미완료를 확인한다. Fake provider callback에서 일반 번역 I/O 중 transaction 부재를 검사하고 DB payload/override/jobs/memory를 assert한다. H2의 claim syntax만 기존 test 관례대로 skip locked 없이 실행하며 claim 결과와 모든 DB 쓰기는 실제 구현이다.
  • 기존 ContentTranslationQueueIntegrationTest의 latch를 새 CONTENT 재료화 호출 경계에 연결하여 source mutation과 materialize/complete의 같은 transaction 회귀를 유지했다. TranslationJobWorkerTest는 기존 mock/verify의 CONTENT 호출 signature만 5곳 변경했으며 assertion을 삭제하거나 약화하지 않았다.
  • 구조 대조: writer 128, worker 118, materializer 216, 신규 테스트 126 pure LOC다. Materializer 216과 기존 Queue test 209는 경고 구간이며 다음 증설 시 책임별 분리를 검토한다. 기존 WorkerTest 285는 줄 수를 늘리지 않고 호출 signature만 맞췄다. 단일 차단 수정 범위 밖의 파일 분리는 하지 않았다. 새 약한 타입/Any/예외 suppression/로그/중복 writer는 없고, job의 기존 문자열 field key는 materializer 경계에서 enum set으로 변환한다.

실행 명령:

# RED: 3개 assertion 실패, production 변경 전.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRefreshIntegrationTest'
# GREEN: 신규 4 + Queue 7 + Worker 13 = 24개 통과. 이 실행의 lint 포맷 오류는 아래 최종 실행에서 보정했다.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRefreshIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationQueueIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' ktlintCheck
# 직접 영향 98개, failures/errors/skipped 0 및 최종 ktlintCheck 통과.
./gradlew --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionApplyIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationOverrideIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationRefreshIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' \
  --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' ktlintCheck

미실행: 전체 test/check/build/bootJar, 부모 소유 관리 HTTP 27개 재실행, 실제 provider/cloud/production DB, Git/commit/delegation 및 외부 재검토. LSP diagnostics 도구가 없어 실제 Kotlin/Java compilation과 lint로 검사했다. 운영 MySQL 잠금/isolation은 H2 결과로 보증하지 않는다. 기존 Gradle 9 deprecation은 그대로다. 전체 테스트 사용자 명령은 ./gradlew test다.

사용자 요청에 따른 커밋 전 검증 — 2026-11-18

  • /Users/klaus/.agent-commands/commit-with-validation.md와 저장소 커밋 규칙에 따라 기존 변경을 확인했다. 구현 코드는 추가로 수정하지 않았다.
  • 아래 명령으로 관리자 번역 선택 기능과 실제 로컬 provider HTTP 전송 제어를 검증했다.
./gradlew --offline --no-daemon test \
  --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.*' \
  --tests 'kr.co.vividnext.sodalive.i18n.translation.Controlled*HttpIntegrationTest' \
  ktlintCheck
  • 결과: BUILD SUCCESSFUL in 2m 4s. HTML 테스트 보고서 기준 218개, 실패 0, ignored 0. ktlintCheck는 UP-TO-DATE이며 git diff --check도 통과했다.
  • 구현 커밋: a3c76a1b 제공자 호출 제어, 9d8bc914 관리자 후보 선택·필드 승인 보호. 두 커밋 모두 ktlint hook 및 커밋 전·후 메시지 검증 PASS. 문서와 DDL은 별도 문서 커밋으로 기록한다.
  • 전체 테스트와 운영 MySQL·실제 cloud 호출·DDL·배포는 실행하지 않았다. 기존 직접 영향 회귀와 bootJar 증거는 위 실행 이력을 유지한다. 전체 테스트 사용자 실행 명령은 ./gradlew test다.