GitHub Translation Sync：ローカライゼーションワークフローを自動化する

# パターン1：ロケールディレクトリ
locales/
  en/
    common.json
    dashboard.json
  es/
    common.json
    dashboard.json

# パターン2：ロケールファイルサフィックス
locales/
  common.en.json
  common.es.json
  dashboard.en.json
  dashboard.es.json

# パターン3：単一ディレクトリにロケールプレフィックス
i18n/
  en.json
  es.json
  fr.json

# パターン4：フレームワーク固有（例：Flutter ARB）
lib/l10n/
  app_en.arb
  app_es.arb

# better-i18n.yml
sync:
  # ソース言語 — このロケールのファイルからキーが抽出されます
  sourceLanguage: en

  # ターゲット言語 — これらの翻訳が生成されます
  targetLanguages:
    - es
    - fr
    - de
    - ja
    - ko
    - "zh-CN"

  # 翻訳ファイルのパスパターン
  # {locale}と{namespace}プレースホルダーを使用したGlobパターンをサポート
  paths:
    - "locales/{locale}/{namespace}.json"

  # 代替：ロケールごとに1ファイル
  # paths:
  #   - "locales/{locale}.json"

  # 変更を監視するブランチ（デフォルト：main）
  baseBranch: main

  # 翻訳の配信方法
  delivery:
    # "pr"はPull Requestを作成、"commit"は直接プッシュ（非推奨）
    method: pr

    # PRブランチの命名パターン
    branchPattern: "i18n/sync-{timestamp}"

    # すべてのチェックが通過したときにPRを自動マージ（ブランチ保護が必要）
    autoMerge: false

    # 翻訳PRに割り当てるレビュアー
    reviewers:
      - "@i18n-team"

    # 翻訳PRに追加するラベル
    labels:
      - "i18n"
      - "automated"

  # AI翻訳設定
  ai:
    # 新しいキーをAIで自動翻訳
    autoTranslate: true

    # PR作成前に人間の承認を要求
    requireApproval: false

    # AI翻訳者へのカスタム指示
    instructions: |
      - Use formal register for German (Sie, not du)
      - Keep brand name "Better i18n" untranslated in all languages
      - Use Oxford comma in English translations

開発者                   GitHub                Better i18n              GitHub
    |                        |                       |                      |
    |-- コミットプッシュ ---->|                       |                      |
    |   (en/common.jsonに    |-- Webhook ----------->|                      |
    |    新しいキーを追加)    |                       |                      |
    |                        |                       |-- AIが翻訳 -------->|
    |                        |                       |   全ターゲット言語   |
    |                        |                       |   向けに新キーを翻訳 |
    |                        |                       |                      |
    |                        |<---------- 翻訳付きPRを作成 ---------------|
    |                        |                       |                      |
    |<-- PR通知 ------------|                       |                      |
    |                        |                       |                      |
    |-- レビュー＆マージ ---->|                       |                      |

# .github/workflows/i18n-validate.yml
name: Validate Translations

on:
  pull_request:
    paths:
      - "locales/**"
    types: [opened, synchronize]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Bun
        uses: oven-sh/setup-bun@v2

      - name: Install dependencies
        run: bun install

      - name: Validate translation coverage
        run: |
          bunx @better-i18n/cli coverage \
            --min 95 \
            --format github-actions

      - name: Validate ICU syntax
        run: |
          bunx @better-i18n/cli validate \
            --format github-actions

      - name: Check for unused keys
        run: |
          bunx @better-i18n/cli lint \
            --unused \
            --format github-actions

      - name: Comment coverage report on PR
        if: github.event_name == 'pull_request'
        uses: actions/github-script@v7
        with:
          script: |
            const { execSync } = require('child_process');
            const report = execSync('bunx @better-i18n/cli coverage --format markdown').toString();
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `## Translation Coverage Report\n\n${report}`
            });

main ------------------------------------------------
  \                                 |
   \-- i18n/sync-20260315 ---------/
       (新しいキーの翻訳)

# better-i18n.yml
sync:
  baseBranch: main
  featureBranchSync:
    enabled: true
    # これらのブランチをターゲットにするPRの翻訳を同期
    targetBranches:
      - "main"
      - "develop"
    # フィーチャーPRと同じブランチをターゲットにする翻訳PRを作成
    followBranch: true

main ------------------------------------------------
  \
   \-- feature/new-checkout -------------------------
        \                           |
         \-- i18n/new-checkout -----/
             (このフィーチャーの翻訳)

sync:
  delivery:
    # 複数のプッシュを1つのPRにまとめるために30分待機
    batchWindow: 30

sync:
  paths:
    - "locales/{locale}/common.json"
    - "locales/{locale}/marketing.json"
  # 内部ネームスペースを明示的に除外
  exclude:
    - "locales/{locale}/internal.json"
    - "locales/{locale}/test-fixtures.json"

sync:
  delivery:
    commitMessage: "chore(i18n): sync translations for {languages}"
    prTitle: "chore(i18n): translations update ({date})"
    prBody: |
      ## Automated Translation Update

      This PR contains translations synced from Better i18n.

      **Languages updated:** {languages}
      **Keys added:** {keysAdded}
      **Keys updated:** {keysUpdated}
      **Keys removed:** {keysRemoved}

      ---
      _Generated by Better i18n GitHub Sync_

sync:
  webhooks:
    - url: "https://your-server.com/api/i18n-webhook"
      events:
        - sync.completed
        - sync.failed
        - pr.created
        - pr.merged
      secret: "${WEBHOOK_SECRET}"  # Better i18nダッシュボードで設定

# better-i18n.yml
sync:
  sourceLanguage: en
  targetLanguages:
    - es
    - fr
    - de
    - ja
    - "pt-BR"
    - "zh-CN"

  paths:
    - "messages/{locale}/{namespace}.json"

  baseBranch: main

  delivery:
    method: pr
    branchPattern: "i18n/translations-{date}"
    autoMerge: true  # CIが通過したら自動マージ
    reviewers:
      - "@frontend-team"
    labels:
      - "i18n"
      - "auto-merge"
    batchWindow: 15  # 15分以内の変更をまとめる

  ai:
    autoTranslate: true
    requireApproval: false
    instructions: |
      E-commerce context:
      - "Cart" should use shopping cart terminology (not vehicle)
      - Currency amounts should not be translated (they are formatted by code)
      - Product names in {curly braces} are variables — do not translate
      - Use formal register for German and Japanese
      - Use informal register for Spanish and Portuguese
      - Keep "Better i18n" as-is in all languages

  featureBranchSync:
    enabled: true
    targetBranches: ["main", "staging"]
    followBranch: true