Master Data Patterns

概要

マスターデータはSQLiteから読み込む読み取り専用データ。

SQLite → SQLiteMasterDataManager → MasterDataLoader → MasterDataCache
                                                            ↓
                                                    各サービスで使用

Definition型

Domain/MasterData/ に配置。

ルール:

• struct + Identifiable + Sendable + Hashable
• let で不変
• ネストした構造体で関連データをグループ化

SQLiteクエリ

Application/MasterData/SQLite/SQLiteMasterDataQueries.*.swift に配置。

ルール:

• SQLiteMasterDataManager のextensionとして実装
• ファイル名は SQLiteMasterDataQueries.{Entity}.swift
• 複雑な結合はBuilderパターンを使用

新規マスターデータ追加時のチェックリスト

1. Domain/MasterData/ に *MasterModels.swift 作成
   • *Definition 構造体を定義
2. Application/MasterData/SQLite/SQLiteMasterDataQueries.*.swift 作成
   • fetchAll*() メソッドを実装
3. MasterDataCache.swift にプロパティ追加
4. MasterDataLoader.swift でロード処理追加
5. 必要に応じてゲーム用語定義を更新