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

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와 독립';