PART 01 — メッセージ定義書
バリデーション・エラー・通知メッセージの体系化と多言語対応

"""
YAMLで管理したメッセージ定義をDjangoの.poファイルとJSONに変換するスクリプト。
pip install pyyaml

messages.yaml の例:
  VAL-001:
    ja: "{field}は必須項目です"
    context: "バリデーションエラー: 必須チェック"
  ERR-001:
    ja: "システムエラーが発生しました。しばらく経ってから再度お試しください。（ERR-001）"
    context: "サーバー内部エラー"
"""
import yaml
import json
from pathlib import Path
from datetime import datetime


def load_messages(yaml_path: str) -> dict:
    """YAMLメッセージ定義を読み込む"""
    with open(yaml_path, encoding="utf-8") as f:
        return yaml.safe_load(f)


def generate_django_po(messages: dict, lang: str, output_path: str) -> None:
    """Django .poファイルを生成する"""
    now = datetime.now().strftime("%Y-%m-%d %H:%M+0900")
    lines = [
        '# Django messages file',
        f'# Generated: {now}',
        '# charset=UTF-8',
        'msgid ""',
        'msgstr ""',
        '"Content-Type: text/plain; charset=UTF-8\\n"',
        '"Content-Transfer-Encoding: 8bit\\n"',
        '',
    ]
    for code, data in messages.items():
        text = data.get(lang, "")
        context = data.get("context", "")
        if context:
            lines.append(f'# {context}')
        lines.append(f'#: message_code:{code}')
        lines.append(f'msgid "{code}"')
        # テキスト内のダブルクォートをエスケープ
        escaped = text.replace('\\', '\\\\').replace('"', '\\"')
        lines.append(f'msgstr "{escaped}"')
        lines.append('')

    Path(output_path).parent.mkdir(parents=True, exist_ok=True)
    Path(output_path).write_text('\n'.join(lines), encoding='utf-8')
    print(f"✅ .poファイル生成: {output_path} ({len(messages)}件)")


def generate_json(messages: dict, lang: str, output_path: str) -> None:
    """フロントエンド用JSONメッセージファイルを生成する"""
    result = {code: data.get(lang, "") for code, data in messages.items()}
    Path(output_path).parent.mkdir(parents=True, exist_ok=True)
    with open(output_path, 'w', encoding='utf-8') as f:
        json.dump(result, f, ensure_ascii=False, indent=2)
    print(f"✅ JSONファイル生成: {output_path} ({len(result)}件)")


def validate_placeholders(messages: dict) -> list[str]:
    """プレースホルダーの書式検証（{field}形式の抜け漏れを確認）"""
    import re
    errors = []
    for code, data in messages.items():
        for lang, text in data.items():
            if lang in ("context",):
                continue
            # {xxx}形式のプレースホルダーを検出
            placeholders = re.findall(r'\{([^}]+)\}', text)
            if placeholders:
                # Pythonのstr.formatが成功するか検証
                try:
                    dummy = {p: f"[{p}]" for p in placeholders}
                    text.format(**dummy)
                except (KeyError, ValueError) as e:
                    errors.append(f"{code}[{lang}]: プレースホルダーエラー: {e}")
    return errors


if __name__ == "__main__":
    YAML_PATH = "messages.yaml"
    messages = load_messages(YAML_PATH)

    # バリデーション
    errors = validate_placeholders(messages)
    if errors:
        print("❌ プレースホルダーエラーが見つかりました:")
        for e in errors:
            print(f"  - {e}")
    else:
        print("✅ プレースホルダーバリデーション: OK")

    # Django .po ファイル生成
    generate_django_po(messages, lang="ja", output_path="locale/ja/LC_MESSAGES/messages.po")
    # フロントエンド用 JSON 生成
    generate_json(messages, lang="ja", output_path="frontend/src/locales/ja/messages.json")