辞書フォールバック戦略の決定
コンポーネント表示名のフォールバック方針を決定。テキスト表示は最小限とし、辞書設定を本命とする。イニシャル衝突は連番で対応。
辞書フォールバック戦略の決定
多言語辞書の一元管理アーキテクチャ設計 の補足。
1. 解決したい問題
- UI に変数名(
worker_red、draw_cards)を露出させたくない - 辞書に表示名がない場合のフォールバックが必要
- テキスト表示モードでイニシャルが必要な場合がある
2. 決定事項
2-1. 表示の優先順位
1. 辞書に表示名がある → その名前を使う2. 辞書にない → 警告 + フォールバック表示変数名は一切表示しない。
2-2. イニシャル取得
- 英語(pivot language)から取る
- 日本語・中国語等からは取らない(業界標準)
function getInitial(entry: DictEntry): string { const en = entry.en || 'Piece'; return en[0].toUpperCase();}2-3. イニシャル衝突時の対応
1文字 + 連番方式:
function assignInitials(names: string[]): string[] { const count: Record<string, number> = {};
return names.map(name => { const initial = name[0].toUpperCase(); count[initial] = (count[initial] || 0) + 1;
if (count[initial] === 1) { return initial; } return `${initial}(${count[initial]})`; });}| 表示名 | イニシャル |
|---|---|
| Piece A | P |
| Piece B | P(2) |
| Gold | G |
| Grain | G(2) |
| Worker | W |
2-4. テキスト表示モード
最小限とする(または廃止検討)。
理由:
- テキスト表示を頑張っても辞書設定をサボる言い訳になる
- フォールバックが出た時点で「辞書に追加しろ」のサイン
- 本命は辞書を充実させること
3. 警告の実装
function tComponent( key: string, lang: Lang = 'ja', gameDict?: Record<string, DictEntry>): string { // 1. ゲーム固有辞書 if (gameDict?.[key]?.[lang]) { return gameDict[key][lang]; }
// 2. 共通辞書 if (components[key]?.[lang]) { return components[key][lang]; }
// 3. フォールバック(警告付き) console.warn(`[dict] Missing component: ${key}`); return formatFallback(key);}
function formatFallback(key: string): string { // 変数名を整形(最低限の可読性) return key .replace(/_/g, ' ') .replace(/\b\w/g, c => c.toUpperCase());}4. 運用方針
| フェーズ | 対応 |
|---|---|
| 開発中 | 警告を見て辞書に追加 |
| 本番 | 辞書が揃っている前提 |
| 緊急時 | フォールバックで最低限表示 |
5. 実装優先度
| # | タスク | 優先度 |
|---|---|---|
| 1 | 辞書から表示名を取る仕組み | 高 |
| 2 | 辞書にない場合の警告 | 高 |
| 3 | フォールバック表示 | 中 |
| 4 | イニシャル連番対応 | 低(必要になったら) |
| 5 | テキスト表示モード | 低(廃止検討) |