ドメインモデリング

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

エンティティ

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

主な特徴：

一意の識別子を持つ（通常は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`	不変の値オブジェクト	例：住所、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によって生成された構造:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.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を管理し、データベースを同期させます。このプロセスは「永続化レイヤー」セクションで詳しく説明します。

値オブジェクト

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

主な特徴：

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

Linoで値オブジェクトを作成する

次を実行してください：

lino value-object 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`
`decimal`	正確な小数	金銭的な値
`float`	浮動小数点数 (32ビット)	約6～9桁
`double`	浮動小数点数 (64ビット)	約15～17桁
`DateTime`	日付/時刻	タイムゾーン含む
`DateOnly`	日付のみ	C# 10以上
`TimeOnly`	時刻のみ	C# 10以上

例

値オブジェクト 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）：

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.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によって管理され、データモデルの同期を維持できます。

列挙型

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

動機：

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

主な特徴：

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

Linoで列挙型を作成する

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

lino enum new

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

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

例

PersonStatus列挙型：

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

生成された構造：

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.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を生成・適用し、データベースがドメインモデルを反映するようにしてください。詳細は永続化層のセクションで説明します。