log

辞書フォールバック戦略の決定

コンポーネント表示名のフォールバック方針を決定。テキスト表示は最小限とし、辞書設定を本命とする。イニシャル衝突は連番で対応。

辞書フォールバック戦略の決定

多言語辞書の一元管理アーキテクチャ設計 の補足。

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 AP
Piece BP(2)
GoldG
GrainG(2)
WorkerW

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テキスト表示モード低(廃止検討)