{
  "schema_version": "1.0.0",
  "description": "デジタル庁デザインアセット非公式ミラーの検索用メタデータ定義。",
  "use_case_taxonomy": {
    "navigation": "メニュー、検索、戻る、外部リンク、ダウンロードなどの操作導線",
    "form_action": "申請、入力、添付、送信、コピーなどフォーム内操作",
    "status_feedback": "完了、注意、通知、更新、履歴など状態や結果の表示",
    "identity_auth": "本人確認、認証、パスワード、証明書、印鑑など",
    "administrative_service": "行政手続き、自治体、法律、税、年金など",
    "finance_payment": "収入、支出、銀行口座、お金、請求など",
    "health_welfare": "健康、医療、予防接種、母子、子どもなど",
    "travel_mobility": "出発、到着、旅程、荷物、ファストトラックなど",
    "device_channel": "スマートフォン、PC、プリンター、郵送など利用環境や連絡手段",
    "people_scene": "人物、家族、専門家、利用者などを含む説明イラスト",
    "document_communication": "書類、通知、情報提供、案内、郵送など",
    "generic_illustration": "特定用途に限定しない補助ビジュアル"
  },
  "top_level_fields": {
    "schema_version": "メタデータ形式のバージョン。",
    "generated_at": "metadata.json を生成したUTC日時。",
    "base_url": "配信先のベースURL。",
    "source": "元アセットとライセンスに関する情報。",
    "rate_limit_policy": "Gemini API生成時の制限とキャッシュ方針。",
    "asset_count": "assets 配列の件数。",
    "assets": "検索対象アセットの配列。"
  },
  "asset_fields": {
    "asset_id": "安定ID。URLやファイル名が変わっても同一素材を追跡するためのキー。",
    "asset_type": "icon / illustration / image。",
    "collection": "配信コレクション名。",
    "status": "active / deprecated / removed。",
    "files": {
      "path": "pages 配下からの相対パス。",
      "filename": "ファイル名。",
      "format": "svg / png など。",
      "width": "画像幅。取得できない場合は null。",
      "height": "画像高。取得できない場合は null。",
      "content_hash": "差分更新とキャッシュ判定に使うフィンガープリント。通常は sha256、--fast 実行時は fast。",
      "hash_method": "content_hash の方式。sha256 / fast。"
    },
    "urls": {
      "canonical_url": "AIやアプリが利用すべき配信URL。",
      "metadata_url": "このアセットを含む metadata.json のURL。",
      "raw_url": "実ファイルの直接URL。",
      "source_url": "公式配布元URL。"
    },
    "license": "利用規約・出典情報。",
    "semantic": {
      "title_ja": "日本語の短い名称。",
      "title_en": "英語の短い名称。",
      "description_ja": "検索用の短い説明。",
      "alt_ja": "アクセシビリティ向け代替テキスト。",
      "tags_ja": "日本語検索タグ。",
      "tags_en": "英語検索タグ。",
      "category": "検索カテゴリ。",
      "style": "line / fill / white / warmgray / small などの見た目属性。",
      "use_case_ids": "用途分類ID。use_case_taxonomy のキーから複数選択。",
      "suitable_uses": "用途分類を自然文にした説明。AI検索や人間向け表示に使う。"
    },
    "ai_generation": {
      "provider": "Geminiで生成した場合は gemini。ファイル名由来のみなら null。",
      "model": "使用モデル名。",
      "prompt_version": "プロンプト仕様のバージョン。",
      "input_hash": "画像ハッシュとプロンプトから作るAI入力ハッシュ。",
      "generated_at": "生成日時。",
      "review_status": "filename-derived / auto / reviewed。"
    }
  }
}