ddd-tactical-patterns

DDD の戦術的パターン

このスキルを使用する場合

• ドメインルールをコード構造に変換するとき。
• 集約の境界と不変条件を設計するとき。
• 貧血モデルを振る舞い豊かなドメインオブジェクトにリファクタリングするとき。
• リポジトリの契約とドメインイベントの境界を定義するとき。

このスキルを使用しない場合

• まだ戦略的境界を定義している段階である。
• タスクが API ドキュメントや UI レイアウトのみである。
• 完全な DDD の複雑さが正当化されない。

手順

1. まず不変条件を特定し、それを中心に集約を設計します。
2. 検証済みの概念に対して不変の値オブジェクトをモデル化します。
3. ドメインの振る舞いはコントローラーではなくドメインオブジェクトに保持します。
4. 意味のある状態遷移に対してドメインイベントを発行します。
5. リポジトリは集約ルートの境界に保ちます。

詳細なチェックリストが必要な場合は、references/tactical-checklist.md を開いてください。

例

class Order {
  private status: "draft" | "submitted" = "draft";

  submit(itemsCount: number): void {
    if (!Number.isInteger(itemsCount) || itemsCount <= 0) throw new Error("Order cannot be submitted empty");
    if (this.status !== "draft") throw new Error("Order already submitted");
    this.status = "submitted";
  }
}

制限事項

• このスキルはデプロイアーキテクチャを定義しません。
• データベースやトランスポートプロトコルを選択しません。
• 不変条件のカバレッジのためにテストパターンと組み合わせる必要があります。