| name | core-design |
| description | システム全体のコア設計原則とパフォーマンス基準 |
コア設計原則
- 単一責任の原則 (SRP): クラスや関数には明確なひとつの責任のみを与える。複数の責務を持つ構造を避け、肥大化を防ぐ。
- 関心の分離 (SoC): プレゼンテーション層、ビジネスロジック層、データアクセス層などを明確に分離する。
- DRY 原則: 繰り返しを避け、重複コードを共通化して再利用可能な関数やクラスにまとめる。
- 設定の分離: 設定とロジックを分離し、API キーや認証情報は専用設定ファイルで安全に管理する。
- 整合性維持: 変更時にはすべての関連箇所の整合性を確保し、コード・スキーマ・API 定義・テストを一貫して更新する。
パフォーマンスとスケーラビリティ
- キャッシュ管理: キャッシュは TTL（有効期限）と無効化契機を明確に設計し、整合性を保つ。