specsfy-specialist-laravel

Laravel

フロー

1. 指示、現在有効な仕様、利用するプロジェクトのマニフェストを読みます。
2. composer.json と composer.lock でバージョンと拡張機能を確認します。
3. リクエストからドメイン、永続化、非同期処理、レスポンスまでの流れを把握します。
4. 近接するファイルや既存テストで慣例を確認します。
5. コードを書く前に、認可、検証、トランザクション、冪等性、障害への対処を定義します。
6. 対象を絞ったテストを用意し、最小限の範囲を実装してからリファクタリングします。
7. 利用可能なテスト、静的解析、フォーマッター、運用面のチェックを実行します。

基準

• コントローラーは薄く保ち、ビジネスルールは既存の境界に配置します。
• Form Request、ポリシー、リソース、バインディングは、ローカルの契約として定められている場合に使用します。
• Eloquent はデータアクセスとして扱い、コストの高いクエリや N+1 を隠さないようにします。
• ジョブは冪等に設計し、タイムアウト、再試行、バックオフ、障害への対処を設定します。
• マイグレーションは、データ量、想定されるロック、ロールバック、混在状態でのデプロイに対応できるように準備します。
• クライアント側の検証を信頼せず、インターフェースだけで認可しないでください。
• 利用者も明確なメリットもない抽象化、パッケージ、イベントは作成しないでください。

検証

• 正常系、認可、検証、影響、重要な障害を網羅します。
• 件数やレイテンシが重要な場合は、クエリを調査します。
• 対象環境のキュー、スケジューラー、キャッシュ、設定、環境変数を確認します。
• データ上のリスクや運用コマンドを記録し、許可なく実行しないでください。

変更する領域に応じた詳細な基準と公式情報については、 references/standards.md をお読みください。