Domain-Driven Design 戦術パターン

エンティティ、値オブジェクト、境界付けられたコンテキストで複雑なビジネスドメインをモデル化します。

概要

• 複雑なビジネスロジックのモデリング
• ドメインとインフラストラクチャの分離
• サブドメイン間の明確な境界の確立
• ビジネスロジックを含むリッチドメインモデルの構築
• ユビキタス言語をコードに実装

ビルディングブロック概要

┌─────────────────────────────────────────────────────────────┐
│                    DDD Building Blocks                       │
├─────────────────────────────────────────────────────────────┤
│  ENTITIES           VALUE OBJECTS        AGGREGATES         │
│  Order (has ID)     Money (no ID)        [Order]→Items      │
│                                                              │
│  DOMAIN SERVICES    REPOSITORIES         DOMAIN EVENTS      │
│  PricingService     IOrderRepository     OrderSubmitted     │
│                                                              │
│  FACTORIES          SPECIFICATIONS       MODULES            │
│  OrderFactory       OverdueOrderSpec     orders/, payments/ │
└─────────────────────────────────────────────────────────────┘

クイックリファレンス

エンティティ（アイデンティティを持つ）

from dataclasses import dataclass, field
from uuid import UUID
from uuid_utils import uuid7

@dataclass
class Order:
    """Entity: アイデンティティを持つ、可変状態、ライフサイクル。"""
    id: UUID = field(default_factory=uuid7)
    customer_id: UUID = field(default=None)
    status: str = "draft"

    def __eq__(self, other: object) -> bool:
        if not isinstance(other, Order):
            return NotImplemented
        return self.id == other.id  # アイデンティティによる等値性

    def __hash__(self) -> int:
        return hash(self.id)

完全なパターンについては Read("${CLAUDE_SKILL_DIR}/references/entities-value-objects.md") を参照してください。

値オブジェクト（イミュータブル）

from dataclasses import dataclass
from decimal import Decimal

@dataclass(frozen=True)  # 必ずfrozen=True!
class Money:
    """Value Object: 属性によって定義され、アイデンティティではない。"""
    amount: Decimal
    currency: str

    def __add__(self, other: "Money") -> "Money":
        if self.currency != other.currency:
            raise ValueError("Cannot add different currencies")
        return Money(self.amount + other.amount, self.currency)

Address、DateRangeの例については Read("${CLAUDE_SKILL_DIR}/references/entities-value-objects.md") を参照してください。

重要な判断

判断	推奨事項
エンティティ vs 値オブジェクト	一意なID + ライフサイクルがある？ エンティティ。それ以外は値オブジェクト
エンティティの等値性	IDで比較、属性では比較しない
値オブジェクトの可変性	常にイミュータブル（frozen=True）
リポジトリのスコープ	アグリゲートルートごとに1つ
ドメインイベント	エンティティで収集、永続化後に発行
コンテキスト境界	技術的ではなく、ビジネス機能によって分ける

ルールクイックリファレンス

ルール	影響	カバー範囲
aggregate-boundaries (${CLAUDE_SKILL_DIR}/rules/aggregate-boundaries.md を参照)	高	アグリゲートルート設計、IDによる参照、トランザクションごとに1つ
aggregate-invariants (${CLAUDE_SKILL_DIR}/rules/aggregate-invariants.md を参照)	高	ビジネスルール強制、スペシフィケーションパターン
aggregate-sizing (${CLAUDE_SKILL_DIR}/rules/aggregate-sizing.md を参照)	高	適切なサイズ設定、分割のタイミング、最終的一貫性

使用してはいけない場合

エンティティが5個未満？ DDDは全く使わないでください。儀式のコストが利益より大きいです。

パターン	インタビュー	ハッカソン	MVP	成長期	エンタープライズ	よりシンプルな代替案
アグリゲート	オーバーキル	オーバーキル	オーバーキル	選択的	適切	検証付きの普通のdataclass
境界付けられたコンテキスト	オーバーキル	オーバーキル	オーバーキル	境界線上	適切	明確なインポートを持つPythonパッケージ
CQRS	オーバーキル	オーバーキル	オーバーキル	オーバーキル	正当化されたとき	読み取り/書き込みの単一モデル
値オブジェクト	オーバーキル	オーバーキル	境界線上	適切	必須	エンティティの型付きフィールド
ドメインイベント	オーバーキル	オーバーキル	オーバーキル	選択的	適切	サービス間の直接メソッド呼び出し
リポジトリパターン	オーバーキル	オーバーキル	境界線上	適切	必須	サービスレイヤーの直接ORM クエリ

経験則: DDDはコード量が約40%増加します。ドメイン複雑性が本当に要求する場合のみ価値があります（複数オブジェクト間で広がる不変条件を持つ5個以上のエンティティ）。CRUDアプリでDDDを使用することは赤信号です。

アンチパターン（禁止）

# 決してドメインモデルを貧血化させてはいけません（データのみのクラス）
@dataclass
class Order:
    id: UUID
    items: list  # 間違い - ビジネスロジックがない!

# インフラストラクチャをドメインに漏らしてはいけません
class Order:
    def save(self, session: Session):  # 間違い - DBのことを知っている!

# イミュータブルでない値オブジェクトを使用してはいけません
@dataclass  # 間違い - frozen=True がない
class Money:
    amount: Decimal

# リポジトリがORMモデルを返してはいけません
async def get(self, id: UUID) -> OrderModel:  # 間違い - ドメイン型を返す!

関連スキル

• aggregate-patterns - アグリゲート設計の詳細な掘り下げ
• ork:distributed-systems - アグリゲート間の調整
• ork:database-patterns - DDDのためのスキーマ設計

参考資料

Read("${CLAUDE_SKILL_DIR}/references/<file>") で必要に応じて読み込んでください：

ファイル	内容
entities-value-objects.md	エンティティと値オブジェクトの完全なパターン
repositories.md	リポジトリパターンの実装
domain-events.md	イベント収集と発行
bounded-contexts.md	コンテキストマッピングとACL

機能の詳細

entities

キーワード: entity、identity、lifecycle、mutable、domain object 解決内容: Pythonでのエンティティのモデル化、アイデンティティ等値性、ビジネスロジックの追加

value-objects

キーワード: value object、immutable、frozen、dataclass、structural equality 解決内容: イミュータブルな値オブジェクトの作成、VOとエンティティの使い分け

domain-services

キーワード: domain service、business logic、cross-aggregate、stateless 解決内容: ドメインサービスの使用時期、複数アグリゲート間のロジック

repositories

キーワード: repository、persistence、collection、IRepository、protocol 解決内容: リポジトリパターンの実装、DB アクセスの抽象化、ORM マッピング

bounded-contexts

キーワード: bounded context、context map、ACL、subdomain、ubiquitous language 解決内容: 境界付けられたコンテキストの定義、ACLとの統合、コンテキスト関係