81 lines
6.9 KiB
SQL
81 lines
6.9 KiB
SQL
-- 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와 독립';
|