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