laravel-architecture

Laravel のアーキテクチャ

Laravel アプリケーションのための、アーキテクチャに関する概要レベルの指針です。

コアコンセプト

philosophy.md - 基本原則：

• 何よりも宣言的なコードを優先する
• 関心事を厳密に分離する
• 型安全性を最優先する
• すべてのコアアーキテクチャ原則

patterns.md - パターンの概要：

• ドメインロジックにはアクションを使用する
• データ転送には DTO を使用する
• 複雑な状態にはステートマシンを使用する
• 外部連携にはサービスを使用する
• 複数ステップのプロセスにはワークフローを使用する
• ドメイン値には値オブジェクトを使用する

decisions.md - パターンの選択：

• 各パターンを使う場面
• 判断フローチャート
• アーキテクチャ上のトレードオフ
• よくあるシナリオ

structure.md - ディレクトリ構成：

• プロジェクト全体の構成
• ファイルの配置ルール
• 名前空間の規約
• Web と API の違い

examples.md - 参照実装：

• 完全に動作するサンプル
• エンドツーエンドのワークフロー
• 実際のプロジェクトで使われるパターン

checklist.md - 実装チェックリスト：

• セットアップタスク
• 機能開発ワークフロー
• 本番環境へのデプロイ手順

コア原則

1. アクションにドメインロジックを含める - ビジネスロジックは呼び出し可能なアクションクラスに置きます
2. プリミティブを渡さない - データ転送には常に DTO を使用します
3. HTTP 層を薄く保つ - コントローラーは HTTP に関する処理のみを扱います
4. カスタムクエリビルダー - スコープより型安全なクエリを優先します
5. 厳密な型付け - すべてのファイルで declare(strict_types=1) を指定します

クイック判断ツリー

次の処理が必要な場合……

• ドメインロジックを扱う？ → アクション
• データを転送する？ → DTO
• ユーザー入力を検証する？ → フォームリクエスト
• 単純な状態フィールド？ → Enum
• 複雑な状態遷移？ → ステートマシン
• 外部 API？ → Saloon を使用したサービス
• バックグラウンド処理？ → ジョブ（アクションに委譲）

詳細な指針については、decisions.md の判断フローチャートを参照してください。