ディレクトリ構成の基本原則 | sreake.com | 株式会社スリーシェイク

責務分離 ディレクトリ構成を考える際、各フォルダ・ファイルが明確な役割を持ち、それぞれの責務が適切に分離されていることが重要です。 ❌ 責務が曖昧な場合 1つのファイルに複数の役割が混在し、修正が難しくなる変更の影響が予測しづらくなり、バグを生みやすいどこに何のコードがあるのか分かりにくくなる ✅ 責務が分離されている場合 役割ごとに整理されているため、コードの見通しがよくなる変更の影響範囲が限定され、保守しやすくなる再利用しやすいモジュール設計が可能になる Bad 例 1つのファイルに複数の責務が混在 src/ ├── app.ts // 全ての処理をここに詰め込んでいる ├── user.ts // UI・API・データ処理が混在 表示・ロジック・データアクセスが1つの場所にあり、保守が困難役割が不明瞭で、他の人が見たときに理解しづらい Good 例 役割ごとに整理 src/ ├──