Yabanin — i18n 用語集
機械翻訳される 7 つのロケール(ja、ko、hi、id、pt-BR、es、ar)向けの翻訳方針です。ダッシュボードのすべての文字列(web/dashboard/src/i18n/en.json)とサイトの文字列(web/site/)は機械翻訳されたあと、needs-review のフラグが付きます(下記のフラグ付けの規約を参照)。人間によるレビューは別の QA 工程です(ブラウザで実施する確認はすべてのロケールを対象とします。フラグは、ネイティブ話者による確認がまだ必要なものを示します)。
フラグ付けの規約
- 各ロケールの JSON(
en.jsonの兄弟。例:ja.json)は、キー集合全体の機械翻訳です。キーは同じ、構造は同じ、キーの欠落はありません。 - 機械翻訳ロケールは、
docs/plans/work-records/I18N-0<3..9>.mdとコミットメッセージ(needs-review)の中で needs-review と宣言されます。 - 個々の文字列には印を付けないでください。ネイティブによる確認が完了するまで、ロケール全体が needs-review です。
中核用語(lineage / 監査 / 主権)
これらの用語は、Yabanin のドキュメントと UI にお いて法的・技術的な重みを持ちます。すべてのロケールと画面で一貫して翻訳する必要があります。英語のままにする用語はその旨が表に書かれており、翻訳側で別の言い換えを作ってはいけません。
| 英語 | 英語のままにするか | 指針 |
|---|---|---|
| lineage | いいえ | リクエストの法域上の来歴記録です(リージョンの主張 + 証拠ティア + 署名)。CJK / アラビア文字では、下記の確立された用語で訳します。ラテン文字のロケール(pt-BR、es、id)では、借用した "lineage" / "linhagem" ではなく直接の訳語を優先します。祖先や系譜を表す用語(家族の血統という含意)は避けてください。ここでの用語は出自ではなく、リクエストの検証可能な来歴を指します。 |
| attestation | いいえ | 推論がどこで行われたか(またはそのティア)についての、署名され検証可能な主張です。動詞の系統としては "attest" を維持してください。 |
| audit | いいえ | ログに対して実行する、オフラインの支出 / 品質の分析です。"security audit" とは別です。これはコスト / 品質の監査です。 |
| sovereign / sovereignty | いいえ | データ / ゲートウェイの主権です。リクエストとデータがどこで処理されるかを顧客が制御することを指します。「国家の」だけに狭めないでください。 |
| residency pack | いい え | 法域を経路の振る舞いに対応付ける、選定済みの方針ルールの集合です。 |
| evidence tier | いいえ | リージョン主張の種類です。provider_attested、endpoint_pinned、header_observed、provider_declared。ティアの名前(snake_case の識別子)は API の値なので、決して翻訳しません。翻訳するのは表示ラベルだけです。 |
| signature / signature valid | いいえ | attestation の暗号学的な検証です。 |
| counterfactual | いいえ | 最適化がなかった場合に支払われていたはずのコストです。 |
| tier(モデルティア) | いいえ | モデルの経路ティアです(例: baseline / candidate のティア)。 |
| scope(適用スコープ) | いいえ | レポートに適用される、組織 / プロバイダ / 期間のフィルタ集合です。 |
| credits | いいえ | 前払いの残高です。金融上の意味を保ち、"credit score" の意味にはしないでください。 |
| gateway | いいえ | 自社運用の AI ゲートウェイのプロセスです。 |
| air-gap | いいえ | 完全に隔離されたインストールです。 |
| shadow mode | いいえ | 評価のためにトラフィックをミラーするモードです。 |
| kill criterion | いいえ | モデルの変更を正当化する、節約率 ≥45% のしきい値です。 |
| privacy mode | いいえ | エラー文言と生の JSON をマスク するダッシュボードのモードです。 |
| provider | いいえ | 上流のモデルプロバイダです。 |
| org / organization | いいえ | テナントの組織です。 |
| request | いいえ | 単一の API リクエストの記録です。 |
| model | いいえ | レジストリ内の LLM です。 |
| token / tokens | いいえ | LLM のトークンです。 |
| cost | いいえ | 金銭上のコストです。 |
| savings | いいえ | 最適化によって節約された金額です。 |
| cache / cache hit | いいえ | 完全一致 / セマンティックのキャッシュです。 |
| UTC | 維持 | タイムゾーンのラベルです。決して翻訳しません。 |
| USD | 維持 | 通貨コードです。決して翻訳しません。 |
| API key / agent key | いいえ | 資格情報の成果物です。 |
| Yabanin | 維持 | ブランド名です。翻訳も翻字もしません。 |
| Astra | 維持 | デザインシステムの名前です。決して翻訳しません。 |
| OpenAI-compatible | 維持 | プロトコルの説明です。"OpenAI" は維持します。 |
CJK / アラビア文字固有
- ja(日本語): lineage → リネージ(カタカナ)はプロダクト UI で許容されますが、漢字の用語が欲しい場合に一貫して使う推奨用語は 請求系統 (せいきゅう けいとう) です。UI ラベルでは リーネージ を一貫して使います。attestation → アテスト (証明/証言)。1 つの画面の中で、漢字だけの形とカタカナの形を混ぜないでください。
- ko(韓国語): lineage → 리네이지 または 요구사항 계보。一貫して 요구 계보 を優先します。attestation → 인증/증언。ハングルを一貫して使い、snake_case のティア名はラテン文字のままにします。
- hi(ヒンディー語): lineage → अव्यवच्छेद्यता は重すぎます。निरीक्षण-रेखा(inspection line)を使うか、लाइनेज(翻字)を一貫して維持してください。attestation → प्रमाणपत्र/गवाही。全体をデーヴァナーガリーで書きます。
- ar(アラビア語、RTL): lineage → نسب الطلبات(request lineage)。attestation → إثبات。sovereignty → السيادة。RTL は専用の工程で扱います。この文書が提供するのは翻訳だけです。数字は、ID、金額、タイムスタンプについて西洋数字(0-9)を使い、en のデータと一致させてください。
数値、単位、デー タトークン
- 数値、通貨コード(USD)、日付、タイムスタンプ、ID(
req_…、org uuid)、モデル名(gpt-4o-mini)、フィールド / 演算子のトークン(starts_with、org_id)は決して翻訳しません。これらはデータです。翻訳では{{interpolation}}プレースホルダを含め、そのまま残します(トークンはまったく同じもの。文法上可能なら順序も同じ。語順の都合で動かす場合でも、プレースホルダのトークン自体は壊さず残します)。 - 補間値(
{{from}}、{{total}}、{{pct}})は、翻訳後の文字列に en とまったく同じ形で現れなければなりません。
翻訳しないもの
- コード断片と CLI コマンド(
<pre>ブロックの中ではそのまま保持)。 snake_caseの識別子と API のフィールド名。- メールアドレス、URL、ブランド名。
- データの例であるプレースホルダ値(
prod-backend、nightly-etl、acme、gpt-4o)。これらはサンプルデータであり、UI の文言ではありません。