领域建模

在任何领域驱动的应用程序的核心，是表示系统核心知识和业务规则的模型。良好的领域建模意味着将现实世界的概念转化为具有表现力、内聚性和一致性的软件结构。

实体

实体是一个主要由其身份定义的对象，而不仅仅是其属性。即使属性随时间变化，实体的身份保持不变。

主要特征：

具有唯一身份（通常是一个Id）。
重要的是实体的是谁，而不仅仅是它包含的什么。
其属性可以随着时间变化。

使用 Lino 创建实体

要使用 Lino 创建新实体，请执行：

lino entity new

命令行助手将询问：

服务 – 实体将被创建的服务。
模块 – 实体将被创建的模块（仅限模块化服务）。
实体名称 – 域和数据库表中使用的名称。

然后，您将定义构成实体的字段，并配置每个字段。

可用字段类型

类型	描述	范围 / 备注
`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 管理迁移，保持数据库同步。该过程将在持久层章节中详细说明。

值对象

一个 值对象 表示一个仅由其属性定义的领域概念 — 它没有自身的身份标识。如果两个值对象的所有属性值都相同，则认为它们相等。

主要特征：

创建后不可变。
没有 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 和 Name。
允许添加验证、辅助方法和行为。

使用 Lino 创建枚举

执行：

lino enum new

助手会询问：

服务。
模块（如果适用）。
位置 — 域或聚合的根。
枚举名称。
类型 — 传统的 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，确保数据库反映领域模型。详细内容见持久层章节。