ドメインモデリング

ドメイン駆動設計アプリケーションの中心には、システムの中核的な知識とビジネスルールを表すモデルがあります。ドメインを適切にモデリングすることは、現実世界の概念を表現力豊かで、一貫性があり、まとまりのあるソフトウェア構造に変換することを意味します。

エンティティ

エンティティとは、主にその識別性によって定義されるオブジェクトであり、単に属性だけで定義されるものではありません。属性が時間の経過とともに変わっても、エンティティの識別性は変わりません。

主な特徴：

一意の識別子を持つ（通常はId）。
重要なのはエンティティが何を含んでいるかではなく、誰であるかです。
属性は時間とともに変化することがあります。

Linoでエンティティを作成する

Linoを使って新しいエンティティを作成するには、以下を実行します：

lino entity new

CLIウィザードが以下を尋ねます：

サービス – エンティティを作成するサービス。
モジュール – エンティティを作成するモジュール（モジュラーサービスの場合）。
エンティティ名 – ドメインおよびデータベーステーブルで使用される名前。

その後、各フィールドを設定してエンティティを構成します。

利用可能なフィールドタイプ

タイプ	説明	範囲／備考
`short`	16ビット整数	-32,768 ～ 32,767
`int`	32ビット整数	-2,147,483,648 ～ 2,147,483,647
`long`	64ビット整数	-9,223,372,036,854,775,808 ～ 9,223,372,036,854,775,807
`string`	テキスト	約20億文字まで
`bool`	真偽値	`true` または `false`
`Guid`	グローバル一意識別子	分散一意性
`decimal`	高精度小数	金融値に最適
`float`	浮動小数点数（32ビット）	約6～9桁の精度
`double`	浮動小数点数（64ビット）	約15～17桁の精度
`DateTime`	日時	タイムゾーン含む
`DateOnly`	日付のみ (C# 10+)	–
`TimeOnly`	時間のみ (C# 10+)	–
`Entity`	別のエンティティへの参照	1：1 または 1：N
`Value Object`	不変の Value Object	例：住所、CPF
`Enum`	列挙型	固定された値の集合
`List<Entity>`	エンティティのリスト	1：N
`ManyToMany`	多対多	結合テーブルが必要

例

Person エンティティを作成する例：

┌────┬────┬───────────────┬────────┬────────┬───────────┬────────────────┐
│ PK │ FK │ Property name │ Type   │ Length │ Required  │ Auto-increment │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│ x  │    │ Id            │ int    │        │     x     │       x        │
├────┼────┼───────────────┼────────┼────────┼───────────┼────────────────┤
│    │    │ Name          │ string │  100   │     x     │                │
└────┴────┴───────────────┴────────┴────────┴───────────┴────────────────┘

Linoによって生成された構造:

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Errors/
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

エンティティを定義した後、Linoを使ってMigrationsを管理し、データベースを同期させます。このプロセスは「永続化レイヤー」セクションで詳しく説明します。

現在の進化ワークフロー

lino entity new の対話型フローに加えて、サービス、モジュール、名前がすでに分かっている場合は、CLI のコマンド上で意図を明示できます：

lino entity new --name <EntityName> --service <ServiceName> --module <ModuleName>
lino entity edit --service <ServiceName> --module <ModuleName> --entity <EntityName>
lino entity list --service <ServiceName> --module <ModuleName>

大きなモジュールで新しい概念を作成する前に、entity list を使用してください。編集時には、識別子、プロパティ、必須性、長さ、リレーション、インデックス、ownership、tenant、migrations への影響を確認します。

Strongly Typed IDs、ownership、invariants

Strongly Typed IDs が有効な場合、識別子は ProductId のような専用型になり、異なるエンティティの IDs を誤って取り違える可能性を減らします。リレーションはドメイン上の実際の ownership を反映するべきです。すべての参照を直接ナビゲーションにする必要はなく、多くの場合、識別子、shadow entity、integration event、または明示的なクエリの方がモジュール境界をよりよく保護します。

invariants は UI、データベース、validators だけでなく、ドメインに置いてください。エンティティを変更した後は、build を実行し、diff を確認して、migrations を生成または更新します。

Value Object

Value Objectは、その属性のみで定義されるドメインの概念を表し、固有の識別子を持ちません。すべての値が同じ場合、二つのValue Objectは等しいと見なされます。

主な特徴：

作成後は不変です。
Idを持ちません。

Linoで Value Object を作成する

次を実行してください：

lino value-object new

CLIは以下を尋ねます：

サービス – オブジェクトを作成するサービス。
モジュール – オブジェクトを作成するモジュール（モジュールサービスのみ）。
場所 – ドメインルートまたは特定のアグリゲート。
Value Object の名前。

次に、オブジェクトを構成するフィールドを定義します。

利用可能なフィールドタイプ

タイプ	説明	備考
`short`	16ビット整数	-32,768 → 32,767
`int`	32ビット整数	-2,147,483,648 → 2,147,483,647
`long`	64ビット整数	-9,223,372,036,854,775,808 → 9,223,372,036,854,775,807
`string`	テキスト	約20億文字まで
`bool`	ブール値	`true`/`false`
`decimal`	正確な小数	金銭的な値
`float`	浮動小数点数 (32ビット)	約6～9桁
`double`	浮動小数点数 (64ビット)	約15～17桁
`DateTime`	日付/時刻	タイムゾーン含む
`DateOnly`	日付のみ	C# 10以上
`TimeOnly`	時刻のみ	C# 10以上

例

Value Object Address:

┌───────────────┬────────┬────────┬───────────┐
│ Property name │ Type   │ Length │ Required  │
├───────────────┼────────┼────────┼───────────┤
│ Street        │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Number        │ string │   10   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Neighborhood  │ string │   50   │           │
├───────────────┼────────┼────────┼───────────┤
│ City          │ string │  100   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ State         │ string │   2    │     x     │
├───────────────┼────────┼────────┼───────────┤
│ PostalCode    │ string │   20   │     x     │
├───────────────┼────────┼────────┼───────────┤
│ Country       │ string │  100   │     x     │
└───────────────┴────────┴────────┴───────────┘

生成されたファイル構造（アグリゲート Person）：

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            └── Person/
                                ├── PersonResources.resx
                                ├── PersonResources.en.resx
                                └── PersonResources.pt-BR.resx

エンティティと同様に、MigrationsはLinoによって管理され、データモデルの同期を維持できます。

現在の進化ワークフロー

対話型コマンドに加えて、その概念をどこに作成すべきか分かっている場合はパラメーターを使用します：

lino value-object new --name <ValueObjectName> --service <ServiceName> --module <ModuleName>
lino value-object edit --service <ServiceName> --module <ModuleName> --value-object <ValueObjectName>
lino value-object list --service <ServiceName> --module <ModuleName>

エンティティのプロパティが ValueObject として宣言されている場合、Lino は既存の Value Object を再利用するか、エンティティモデリング中に新しいものを作成できます。フィールド群がお金、住所、寸法、期間、ドキュメントのような単一の概念を表す場合は、この選択肢を優先してください。

永続化、UI、ローカライゼーション

Lino はモジュールの永続化レイヤーを通じて Value Objects のプロパティをマッピングし、表示メタデータを resources に渡します。これにより、ネストされた値に対してローカライズされた labels とメッセージを提供できます。Value Object は生成されたモジュールに属し、明示的な integration がない限り、モジュール間の共有契約にはなりません。

invariants は型そのもので保護してください。負の値、無効な通貨、逆転した期間、不正な形式のドキュメントが有効なものとして生成されてはいけません。

列挙型

DDDにおける列挙型は、C#の従来のenumを超えることができます。状態を表すリッチなオブジェクトであり、バリデーションや補助メソッド、さらには振る舞いを含むことが可能です。

動機：

C#のenumは整数または文字列の値に限定されています。
クラスとして列挙型をモデル化することで、より柔軟で表現力豊かな設計が可能になります。

主な特徴：

共通の基底クラスを継承し、Idと名前をカプセル化したクラスです。
バリデーションや補助メソッド、振る舞いを追加できます。

Linoで列挙型を作成する

以下のコマンドを実行してください：

lino enumeration new

ウィザードでは以下を尋ねられます：

サービス。
モジュール（該当する場合）。
場所 — ドメインのルートまたはアグリゲート。
列挙型の名前。
タイプ — 従来のenumかスマート Enum（class）。
データベースでの保存方法 — intまたはstring。

例

PersonStatus列挙型：

┌───────┬───────────┬──────────────┐
│ Value │ Name      │ Display Name │
├───────┼───────────┼──────────────┤
│ 1     │ Active    │ Active       │
├───────┼───────────┼──────────────┤
│ 2     │ Inactive  │ Inactive     │
├───────┼───────────┼──────────────┤
│ 3     │ Suspended │ Suspended    │
├───────┼───────────┼──────────────┤
│ 4     │ Deleted   │ Deleted      │
└───────┴───────────┴──────────────┘

生成された構造：

<ProjectName>/
└── src/
    └── Services/
        └── <ServiceName>/
            └── Domain/
                ├── <ProjectName>.<ServiceName>.Domain.csproj
                └── Aggregates/
                    └── People/
                        ├── Person.cs
                        ├── Enums/
                        │   └── PersonStatus.cs
                        ├── ValueObjects/
                        │   └── Address.cs
                        ├── Errors/
                        │   ├── AddressErrors.cs
                        │   └── PersonErrors.cs
                        ├── Repositories/
                        │   └── IPersonRepository.cs
                        └── Resources/
                            ├── Address/
                            │   ├── AddressResources.resx
                            │   ├── AddressResources.en.resx
                            │   └── AddressResources.pt-BR.resx
                            ├── Person/
                            │   ├── PersonResources.resx
                            │   ├── PersonResources.en.resx
                            │   └── PersonResources.pt-BR.resx
                            └── PersonStatus/
                                ├── PersonStatusResources.resx
                                ├── PersonStatusResources.en.resx
                                └── PersonStatusResources.pt-BR.resx

列挙型の値をstringとして保存することも可能で、可読性が向上しますが、パフォーマンスやストレージ効率では劣ることがあります。そのため、intとして保存し、整合性の維持や保守性向上のために、列挙型の値を主キーとする補助的なエンティティ（テーブル）を作成することを推奨します。

列挙型を定義した後は、Linoを使ってMigrationsを生成・適用し、データベースがドメインモデルを反映するようにしてください。詳細は永続化層のセクションで説明します。

現在の進化ワークフロー

対話型コマンドに加えて、場所と名前がすでに定義されている場合はパラメーターを使用します：

lino enumeration new --name <EnumerationName> --service <ServiceName> --module <ModuleName>
lino enumeration edit --service <ServiceName> --module <ModuleName> --enumeration <EnumerationName>
lino enumeration list --service <ServiceName> --module <ModuleName>

Enumeration、エンティティ、または設定

Enumeration を使う	エンティティまたは設定を使う
注文ステータス、公開状態、技術的な連携タイプ	ユーザーが管理するカテゴリ、tenant ごとに設定できる理由、backoffice で管理されるサプライヤー
コードとともにバージョン管理される値	runtime で変更される値、または権限で制御される値
値ごとの単純なルールまたは小さな振る舞い	ライフサイクル、監査、動的翻訳、または独自のリレーション

Enumeration が表示名を公開する場合、Lino はローカライズされた labels 用の resources を生成できます。永続化される場合や seed data として使われる場合は、値の追加、削除、名前変更の後に migrations を確認してください。コード、データベース、UI の整合性もドメイン変更の一部です。