-- Schema artifact for the implemented admin translation selection feature. -- Do not execute against production without operator approval; no automatic DDL is performed by the application. -- DEC-11: API and candidate worker register at startup without an activation flag. -- Before new writers create any jobs, prepare all three tables and the language-aware unique index, -- drain every legacy writer and in-flight job, then complete the separate old-index removal below. CREATE TABLE content_translation_override ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '승인 override 식별자', content_id BIGINT NOT NULL COMMENT '기존 콘텐츠 식별자, 삭제 cascade 없음', locale VARCHAR(10) NOT NULL COMMENT '승인 대상 언어', field_key VARCHAR(10) NOT NULL COMMENT 'TITLE, DETAIL, TAGS 중 승인 필드', source_fingerprint VARCHAR(67) NOT NULL COMMENT '원본 언어와 정확한 필드 원문의 버전 포함 fingerprint', approved_text TEXT NOT NULL COMMENT '관리자가 선택한 번역 문자열', provenance TEXT NOT NULL COMMENT 'JSON 출처: requestId, candidateIds 목록, providers id/version 목록, approvedBy; 후보 FK 없음', approved_at TIMESTAMP NOT NULL COMMENT 'UTC 초 정밀도로 한 번 정규화한 승인 시각', created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각', updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각', PRIMARY KEY (id), UNIQUE KEY uk_content_translation_override_field (content_id, locale, field_key) ) COMMENT='콘텐츠 언어별 필드 승인과 출처, 전역 번역 메모리와 독립'; -- Expand: keep uk_translation_job_resource_field_target_hash until every old writer and in-flight job is drained. ALTER TABLE translation_job ADD UNIQUE KEY uk_translation_job_resource_field_target_hash_language (resource_type, resource_id, field_key, target_language, source_hash, source_language); -- Contract (separate operator-approved step after legacy drain, required before new writers start work): -- ALTER TABLE translation_job DROP INDEX uk_translation_job_resource_field_target_hash; -- New writers always use exact source-language identity; there is no legacy-index compatibility mode. -- After the first approval, rollback only to an override-aware application version. No DDL in this file was executed. -- Request state, reviewed source/group snapshots, and the atomic apply receipt. CREATE TABLE translation_selection_request ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '관리자 번역 선택 요청 식별자', created_by BIGINT NOT NULL COMMENT '생성한 관리자 식별자', client_request_id VARCHAR(36) NOT NULL COMMENT '관리자 범위 생성 멱등 UUID', body_hash VARCHAR(64) NOT NULL COMMENT '버전 포함 canonical scope 본문 SHA-256', scope TEXT NOT NULL COMMENT 'CONTENT 또는 SERIES 및 Long 식별자의 typed JSON', status VARCHAR(24) NOT NULL COMMENT 'PREPARING REVIEW_REQUIRED READY_TO_GENERATE GENERATING READY APPLIED CANCELLED FAILED', revision BIGINT NOT NULL COMMENT '관리자 의미 변경 revision, 최초 1', snapshot LONGTEXT NOT NULL COMMENT '버전 JSON: 고정 활성 member IDs, 준비 원문, 확정 원문, reviewed 원문 그룹, provider ID/version manifest, 대상 언어, generation units', preparation_attempt INT NOT NULL COMMENT '준비 실행 횟수, 최초 실행과 복구 1회까지', preparation_lease_until TIMESTAMP NULL COMMENT '준비 소유권 UTC 초 만료 시각, lease 60초', preparation_fence BIGINT NOT NULL COMMENT '오래된 실행의 게시와 갱신을 거부하는 단조 fence', error_code VARCHAR(40) NULL COMMENT '준비 실패 안정 코드, 외부 예외 본문 없음', accepted_generate_revision BIGINT NULL COMMENT '후속 후보 생성에서 수락한 revision', apply_operation_id VARCHAR(36) NULL COMMENT '후속 one-shot 적용 멱등 UUID', apply_body_hash VARCHAR(64) NULL COMMENT '후속 적용 canonical 본문 SHA-256', apply_receipt LONGTEXT NULL COMMENT '후속 적용과 동일 transaction에 저장할 버전 JSON 영수증', applied_at TIMESTAMP NULL COMMENT '후속 적용 UTC 초 확정 시각', created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각', updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각', PRIMARY KEY (id), UNIQUE KEY uk_translation_selection_creation (created_by, client_request_id), KEY ix_translation_selection_prepare (status, preparation_lease_until, id) ) COMMENT='관리자 번역 선택 요청과 고정 원문 및 그룹 검토, 일반 번역 작업과 독립'; CREATE TABLE translation_candidate ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT '제공자별 후보 식별자', request_id BIGINT NOT NULL COMMENT '동결 manifest를 소유한 관리자 번역 요청', unit_key VARCHAR(160) NOT NULL COMMENT '요청 안의 결정적 FIELD GROUP_COMMON TITLE_RESIDUAL 단위 키', unit LONGTEXT NOT NULL COMMENT 'JSON: kind, sourceLanguage, 정확한 inputValues 순서, field/content/group 소유권', provider_id VARCHAR(20) NOT NULL COMMENT '동결된 제공자 ID, fallback 대체 없음', provider_version VARCHAR(80) NOT NULL COMMENT '동결된 제공자 버전, dispatch 시 일치 검사', target_language VARCHAR(10) NOT NULL COMMENT 'source를 제외한 ko en ja 대상 언어', status VARCHAR(16) NOT NULL COMMENT 'PENDING RUNNING SUCCEEDED FAILED DISCARDED', translated_values LONGTEXT NULL COMMENT '입력 인덱스와 일치하는 JSON 번역 문자열 배열, 실패/폐기는 NULL', failure_code VARCHAR(40) NULL COMMENT '안정 실패 코드, 외부 응답/예외 원문은 저장하지 않음', attempt INT NOT NULL COMMENT '실제 provider 작업 claim 횟수, 최대 2, linked 결과는 별도 전송 없음', lease_until TIMESTAMP NULL COMMENT '소유권 UTC 초 만료, 60초 lease, 만료 fence의 연장 금지', fence BIGINT NOT NULL COMMENT 'claim/취소의 단조 fencing token', linked_candidate_id BIGINT NULL COMMENT '같은 요청 제공자 언어 원문 배열의 선행 후보, 단위 소유권은 이 row에 보존', terminal_at TIMESTAMP NULL COMMENT '성공 실패 폐기의 UTC 초 확정 시각', created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각', updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각', PRIMARY KEY (id), UNIQUE KEY uk_translation_candidate_unit (request_id, unit_key, provider_id, target_language), KEY ix_translation_candidate_claim (request_id, status, lease_until, id), CONSTRAINT fk_translation_candidate_request FOREIGN KEY (request_id) REFERENCES translation_selection_request (id) ON DELETE RESTRICT ) COMMENT='관리자 요청별 fresh provider 후보와 durable 실행 결과, 게시 번역 및 전역 memory와 독립';