Translation Service

存在理由

プラットフォームは、基盤となるコンテンツモデルを複製したりフォークしたりすることなく、多言語でコンテンツを配信する必要があります。翻訳サポートにより、元のスキーマとコンテンツ構造を保ったまま、ソースドキュメントに紐づくドキュメントレベルの言語バリアントが作成されます。

使用するタイミング

• 1 つ以上のコンポーネントを複数の言語に翻訳するとき
• 一括翻訳ジョブの進捗を追跡するとき
• 失敗した翻訳を再試行するとき
• 機械翻訳の結果を手動で修正するとき
• ドキュメントまたはウェブサイトアプリで翻訳済みコンテンツを閲覧するとき
• CMS で言語別のドキュメントビューを構築するとき

含まれる機能

• CMS におけるコンポーネントと対象言語の一括選択
• 進捗追跡が可能な非同期翻訳ジョブ
• TensorZero を用いたドキュメント翻訳
• 最新状態の翻訳を自動的にスキップ
• 同一のアクティブ翻訳ジョブの重複排除
• CMS 内のナビゲーション後もアクティブジョブの進捗を復元
• 失敗した翻訳に対する再試行コントロール
• 永続的な対象言語の設定
• PATCH エンドポイントを通じた手動翻訳修正
• 言語対応のドキュメント取得
• 古い翻訳を検出するためのソースハッシュ
• 翻訳対応のデータベース列およびインデックス

コアワークフロー

1. コンポーネントページを開き、翻訳に送信 を選択します。
2. 1 つ以上のコンポーネントと対象言語を選択します。
3. 見積もりの翻訳数を確認し、バッチをキューに入れます。
4. 翻訳マネージャーが公開済みソースドキュメントを読み込み、ソースハッシュがすでに最新である翻訳をスキップします。
5. 残りの翻訳は TensorZero を通じて非同期で処理されます。
6. CMS から、キュー中・完了・スキップ・失敗の各翻訳を監視します。
7. 必要に応じて失敗した翻訳を再試行します。
8. 機械生成された結果に調整が必要な場合は、翻訳済みコンテンツを手動で修正します。
9. 言語対応スキーマおよびドキュメント API を通じて翻訳バリアントを読み込みます。

翻訳ジョブ

バッチを送信すると、翻訳ジョブが作成されます。ジョブには次の内容が記録されます:

• 選択されたコンポーネントと言語
• 処理されたソースドキュメント
• スケジュールされた翻訳
• 最新のためスキップされた翻訳
• 完了した翻訳
• 失敗した翻訳
• 現在のジョブステータス

同じ選択内容を、同等のジョブがアクティブな状態で送信すると、重複作業を避け既存のジョブに再接続します。

CMS はアクティブなジョブ識別子をローカルに保存し、ナビゲーション後に進捗を復元できるようにします。翻訳ジョブの状態は現在、翻訳マネージャーがメモリ内で保持しており、サービスが再起動するとクリアされます。サービスは単一インスタンスでデプロイするか、ジョブの送信とステータス要求が同一プロセスに到達するようスティッキー ルーティングを使用してください。

古い翻訳の検出

各翻訳ドキュメントは、翻訳時点のソースドキュメント公開コンテンツのハッシュを保存します。

別の翻訳バッチが送信されると次のように動作します:

• ハッシュが一致する場合、翻訳は最新でありスキップできます
• ハッシュが異なる場合、ソースが変化しているため翻訳を再生成する必要があります

これにより、変更されていないコンテンツを再翻訳することなく、一括翻訳を繰り返し安全に実行できます。

API エンドポイント

• POST /translation — 1 つ以上のコンポーネントの翻訳をキューに登録します
• GET /translation-jobs/{job_id} — 翻訳ジョブのステータスと進捗を取得します
• PATCH /translations — 翻訳済みコンテンツを手動で修正します

システムの提供面

• CMS の一括翻訳ダイアログ
• CMS の翻訳ジョブステータスと復元コントロール
• 翻訳マネージャーの API とバックグラウンドワーカー
• TensorZero 翻訳統合
• CMS の言語別ドキュメントビュー
• ドキュメントアプリの言語対応コンテンツ読み込み
• 翻訳の永続化とソースハッシュ追跡