---
generated_at: 2026-03-01 10:30:00
metrics:
  claims_total: 28
  claims_with_evidence: 26
  claims_without_evidence: 2
confidence_derived: 0.93
---

# 根拠レポート：51-翻訳システム

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：26 / 28、根拠なし：2
- 優先レビュー（高）
  1. **パフォーマンス要件の具体値**：レスポンス時間等の定量的指標が不明
  2. **XSS対策の実装状況**：呼び出し側での対応要否の確認が必要

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `packages/translations/src/types.ts` - 型定義ファイル
- E-02: `packages/translations/src/exports/index.ts` - エクスポート定義
- E-03: `packages/translations/src/utilities/init.ts` - i18n初期化ロジック
- E-04: `packages/translations/src/utilities/getTranslation.ts` - ラベル翻訳ヘルパー
- E-05: `packages/translations/src/utilities/getTranslationsByContext.ts` - コンテキスト別翻訳抽出
- E-06: `packages/translations/src/utilities/languages.ts` - 言語設定ユーティリティ
- E-07: `packages/translations/src/clientKeys.ts` - クライアント用翻訳キー
- E-08: `packages/translations/src/importDateFNSLocale.ts` - date-fnsロケール読み込み
- E-09: `packages/translations/src/languages/en.ts` - 英語翻訳ファイル
- E-10: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv` - 画面機能マッピング

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | 40以上の言語をサポート | E-06（acceptedLanguages配列に45言語定義） | ○ |
| C-02 | initI18nで言語設定に基づくi18nインスタンス生成 | E-03（188-218行目） | ○ |
| C-03 | t関数でキーに基づく翻訳テキスト取得と変数置換 | E-03（114-144行目） | ○ |
| C-04 | 複数形対応（one/few/many/other）の選択 | E-03（42-54行目） | ○ |
| C-05 | getTranslationでフィールドラベルの動的翻訳 | E-04（12-48行目） | ○ |
| C-06 | date-fnsロケールの動的インポート | E-08（3-187行目） | ○ |
| C-07 | コンテキスト別翻訳抽出（client/api） | E-05（57-63行目） | ○ |
| C-08 | Language型はdateFNSKeyとtranslationsを持つ | E-01（52-55行目） | ○ |
| C-09 | TFunctionは翻訳キーとオプションを受け取り文字列を返す | E-01（134-137行目） | ○ |
| C-10 | I18nインターフェースがi18nインスタンスの全体構造を定義 | E-01（139-153行目） | ○ |
| C-11 | 言語がサポートされていない場合はエラー | E-03（191行目） | ○ |
| C-12 | 翻訳キーが見つからない場合はconsole.logで警告 | E-03（68-69行目） | ○ |
| C-13 | RTL言語（ar/fa/he）の識別 | E-06（3行目） | ○ |
| C-14 | Accept-Languageヘッダーからの言語抽出 | E-06（138-166行目） | ○ |
| C-15 | メモ化による同一言語・コンテキストのキャッシュ | E-03（168-186行目、188行目） | ○ |
| C-16 | {{variable}}形式のプレースホルダ置換 | E-03（91-103行目） | ○ |
| C-17 | 翻訳キーはnamespace:key形式 | E-03（33行目） | ○ |
| C-18 | クライアント用翻訳キーはclientTranslationKeysで定義 | E-07（7-540行目） | ○ |
| C-19 | enTranslationsがネームスペース別に翻訳を定義 | E-09（3-643行目） | ○ |
| C-20 | 画面No.15バージョン詳細画面との関連 | E-10（49行目） | ○ |
| C-21 | 画面No.16アカウント設定画面との関連 | E-10（52行目） | ○ |
| C-22 | filterKeys関数で再帰的にキーをフィルタ | E-05（5-41行目） | ○ |
| C-23 | deepMergeSimpleでカスタム翻訳をマージ | E-03（150-153行目） | ○ |
| C-24 | count=0で_zeroサフィックス | E-03（42-43行目） | ○ |
| C-25 | count>5で_manyサフィックス | E-03（48-49行目） | ○ |
| C-26 | データベース操作なし | E-01〜E-09（DBアクセスコードなし） | ○ |
| C-27 | パフォーマンス要件の具体値 | **根拠なし** | △ |
| C-28 | XSS対策は呼び出し側で対応 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- パフォーマンス要件の具体値
  - レスポンス時間やメモリ使用量等の定量的な性能指標がコードやドキュメントから確認できない
  - 候補：ベンチマークテスト / パフォーマンステストコード / 性能要件ドキュメント
- XSS対策の実装状況
  - 変数置換時のエスケープ処理の有無がコード上で明確でない
  - 候補：セキュリティ設計書 / UIコンポーネントでのサニタイズ処理

## 5) リスクフラグ（レビュー観点）
- 0（低リスク）：型定義、関数シグネチャ、処理フロー
- 1（中リスク）：パフォーマンス要件 - 定量値未確認だが機能動作に影響なし
- 1（中リスク）：XSS対策 - 直接的な脆弱性ではないが設計確認推奨

## 6) レビュアーチェックリスト（最小）
- [ ] 複数形対応ロジック（count値による分岐）が正確か確認
- [ ] クライアント用翻訳キーの選定基準が適切か確認
- [ ] date-fnsロケールの動的インポートがすべての言語をカバーしているか確認
- [ ] 翻訳キーが見つからない場合のフォールバック動作が期待通りか確認
