Translation Service

존재 이유

플랫폼은 기본 콘텐츠 모델을 복제하거나 분기하지 않고도 다국어 콘텐츠를 제공할 수 있어야 합니다. 번역 지원 기능은 원본 스키마와 콘텐츠 구조를 유지하면서 소스 문서와 연결된 문서 수준의 언어 변형을 생성합니다.

다음과 같은 경우 사용

• 하나 이상의 구성 요소를 여러 언어로 번역할 때
• 대량 번역 작업의 진행 상황을 추적할 때
• 실패한 번역을 다시 시도할 때
• 기계가 생성한 번역을 수동으로 교정할 때
• 문서나 웹사이트 앱에서 번역된 콘텐츠를 읽어야 할 때
• CMS에서 언어별 문서 보기를 구축할 때

포함 내용

• CMS에서 일괄 구성 요소 및 언어 선택
• 진행 상황 추적이 가능한 비동기 번역 작업
• TensorZero 기반 문서 번역
• 이미 최신 상태인 번역 자동 건너뛰기
• 동일한 활성 번역 작업의 중복 제거
• CMS 내 이동 이후에도 활성 작업 진행 상황 복원
• 실패한 번역을 위한 재시도 제어
• 지속적인 대상 언어 기본 설정
• 패치 엔드포인트를 통한 수동 번역 교정
• 언어 인식 문서 검색
• 오래된 번역을 감지하기 위한 소스 해시
• 번역 인식 데이터베이스 열 및 인덱스

핵심 워크플로

1. 구성 요소 페이지를 열고 번역으로 보내기를 선택합니다.
2. 하나 이상의 구성 요소와 대상 언어를 선택합니다.
3. 예상 번역 수를 검토하고 배치를 대기열에 추가합니다.
4. 번역 관리자는 게시된 소스 문서를 불러오고 소스 해시가 이미 최신인 번역을 건너뜁니다.
5. 나머지 번역은 TensorZero를 통해 비동기적으로 처리됩니다.
6. CMS에서 대기, 완료, 건너뜀, 실패 상태의 번역을 모니터링합니다.
7. 필요할 때 실패한 번역을 다시 시도합니다.
8. 기계가 생성한 출력에 조정이 필요하면 번역된 콘텐츠를 수동으로 교정합니다.
9. 언어 인식 스키마 및 문서 API를 통해 번역된 변형을 읽습니다.

번역 작업

배치를 제출하면 번역 작업이 생성됩니다. 작업에는 다음이 기록됩니다:

• 선택한 구성 요소와 언어
• 처리된 소스 문서
• 예약된 번역
• 이미 최신이라 건너뛴 번역
• 완료된 번역
• 실패한 번역
• 현재 작업 상태

동일한 선택 항목을 해당 작업이 활성 상태일 때 제출하면 중복 작업을 생성하는 대신 기존 작업에 다시 연결합니다.

CMS는 탐색 이후에도 진행 상황을 복원할 수 있도록 활성 작업 식별자를 로컬에 저장합니다. 번역 작업 상태는 현재 번역 관리자가 메모리에 보관하며 서비스가 다시 시작되면 초기화됩니다. 서비스를 단일 인스턴스로 배포하거나 스티키 라우팅을 사용해 작업 제출과 상태 요청이 동일한 프로세스에 도달하도록 하십시오.

오래된 번역 감지

각 번역 문서는 번역 당시 소스 문서의 게시된 콘텐츠 해시를 저장합니다.

다른 번역 배치를 제출하면:

• 해시가 일치하면 번역이 최신이므로 건너뛸 수 있습니다
• 해시가 다르면 소스가 변경되었으므로 번역을 다시 생성해야 합니다

이를 통해 변경되지 않은 콘텐츠를 다시 번역하지 않고도 대량 번역을 반복 실행할 수 있습니다.

API 엔드포인트

• POST /translation — 하나 이상의 구성 요소에 대한 번역을 대기열에 추가
• GET /translation-jobs/{job_id} — 번역 작업 상태와 진행 상황 확인
• PATCH /translations — 번역된 콘텐츠를 수동으로 교정

시스템 화면

• CMS 대량 번역 대화 상자
• CMS 번역 작업 상태 및 복구 제어
• 번역 관리자 API 및 백그라운드 워커
• TensorZero 번역 통합
• CMS 언어별 문서 보기
• 문서 앱의 언어 인식 콘텐츠 로딩
• 번역 지속성 및 소스 해시 추적