core-design

---

name: core-design description: システム全体のコア設計原則とパフォーマンス基準

コア設計原則

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

パフォーマンスとスケーラビリティ

• キャッシュ管理: キャッシュは TTL（有効期限）と無効化契機を明確に設計し、整合性を保つ。