メインコンテンツまでスキップ

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 の文言ではありません。