value-objects-and-dtos

値オブジェクトと DTO（Symfony）

使用する場面

• 独自のルールを持つドメイン概念（お金、メールアドレス、住所など）が、生のスカラー値として渡されている場合。
• データが境界を越える場合：リクエスト入力、API 出力、メッセージのペイロード。
• Doctrine エンティティ内に値オブジェクトを保存する場合。

デフォルトのワークフロー

1. 不変条件を持つドメイン概念には値オブジェクトを、境界を越えるデータには DTO を使うかを決めます。
2. readonly にし、コンストラクターで検証して、すばやくエラーを返します。
3. 値オブジェクトには値に基づく等価性を持たせ、新しいインスタンスを返す操作を実装します。
4. 値オブジェクトは Doctrine の埋め込み可能オブジェクトとして永続化します。
5. 入力 DTO（検証制約）と出力 DTO（シリアライザー属性）は分けておきます。

ガードレール

• セッターや変更処理は使いません。変更する場合は新しいインスタンスを返します。
• DTO は振る舞いを持たず、データのみを保持します。
• エンティティを API の入力や出力として直接公開しないでください。
• 金額は浮動小数点数ではなく、最小通貨単位の整数として保存します。

段階的な情報開示

• 実行時の指針とリスク管理には、このファイルを使用します。
• 詳細な実装情報が必要な場合は、参照資料を開きます。

出力要件

• 不変条件と等価性を備えた値オブジェクト。
• 入力 DTO と出力 DTO、およびそれらとエンティティとのマッピング。
• 各不変条件の単体テスト。

参照資料

• reference.md