在 C#/.NET 中为复杂业务领域建模时，用 DDD…

当需要在 C# 领域层封装业务规则、设计聚合根与值对象、派发领域事件并避免贫血模型时使用。

适用场景

解决思路

1. 在领域层定义 Entity<TId> 基类统一实体身份与相等性：Id 用 protected set 且默认 default!，提供 ORM 水合用的 protected 无参构造和接收 TId 的 protected 构造；重写 Equals/GetHashCode，并实现 ==/!=，比较时要求 GetType() 相同且 Id 用 EqualityComparer<TId>.Default 相等。
2. 定义 AggregateRoot<TId> : Entity<TId> 基类收集领域事件：私有 List<IDomainEvent> _domainEvents；公开 IReadOnlyList<IDomainEvent> DomainEvents 并返回 AsReadOnly()；提供 protected RaiseDomainEvent(IDomainEvent) 添加事件；提供 ClearDomainEvents() 清空。
3. 具体聚合根如 Order 继承 AggregateRoot<Guid>：属性用 private set；集合用私有 List<T> 并暴露 IReadOnlyList<T>；提供 ORM 用 private 无参构造；用静态工厂 Create 创建并 RaiseDomainEvent(new OrderCreated(...))；业务方法 AddLine 先检查 Status 必须 Draft、quantity > 0，创建 OrderLine 加入 _lines，再 RecalculateTotal；Submit 检查 Status 和 _lines.Count 非空，设置 Status 并 RaiseDomainEvent(new OrderSubmitted(Id, Total))；RecalculateTotal 用 _lines.Aggregate(Money.Zero(Total.Currency), (sum, line) => sum.Add(line.LineTotal))。
4. 遵循聚合设计规则：所有修改通过聚合根；只用 ID 值对象引用其他聚合根（如 CustomerId 而不是 Customer 导航）；保持聚合小；一个事务只改一个聚合；集合暴露为 IReadOnlyList<T> 防止外部绕过根方法修改子项。
5. 值对象用 record 或 record struct 实现值语义：无身份，按属性值相等。简单值对象如 CustomerId 在构造函数中校验 string.IsNullOrWhiteSpace(value) 并抛 DomainException，包裹基元并提供 ToString；复合值对象如 Address 在构造函数中校验 street、city、postalCode 非空。
6. 实现带行为的值对象 Money：构造函数校验 currency 非空，Amount 赋值，Currency = currency.ToUpperInvariant()；提供 static Zero(currency)；Add/Subtract 先 EnsureSameCurrency 再返回新 Money；Multiply(int) 和 Multiply(decimal) 返回新 Money；EnsureSameCurrency 在货币不同时抛 DomainException；ToString 格式化为金额和货币。
7. 映射值对象到 EF Core：多属性值对象如 Money 用 builder.OwnsOne 映射到父表列（如 TotalAmount、TotalCurrency，Currency 设 HasMaxLength(3)）；单属性值对象如 CustomerId 用 HasConversion(id => id.Value, value => new CustomerId(value)) 并设 HasMaxLength(50)。实现细节见 dotnet-efcore-architecture。
8. 选择值对象还是基元：领域概念有约束（email、money、quantity）、多属性组成一个单元（address、date range）、需要防止基元执念时用值对象；基础设施 ID 无领域规则（correlation ID、trace ID）、单值无需校验、API 边界简单 DTO 字段时用基元。
9. 定义领域事件契约：IDomainEvent 标记接口含 Guid EventId 和 DateTimeOffset OccurredAt；用抽象 record DomainEventBase 提供默认 EventId = Guid.NewGuid()、OccurredAt = DateTimeOffset.UtcNow；具体事件用 sealed record 继承 DomainEventBase，如 OrderCreated(Guid OrderId, CustomerId CustomerId)、OrderSubmitted(Guid OrderId, Money Total)、OrderCancelled(Guid OrderId, string Reason)。
10. 领域事件在 SaveChangesAsync 成功后再派发，确保聚合状态先持久化再执行副作用。实现 DomainEventDispatcher：遍历事件，用 typeof(IDomainEventHandler<>).MakeGenericType(domainEvent.GetType()) 得到 handlerType，用 serviceProvider.GetServices(handlerType) 取处理器，用 ((dynamic)handler).HandleAsync((dynamic)domainEvent, ct) 调用。注意 dynamic 派发不兼容 Native AOT；Native AOT 用源生成或字典派发。
11. 定义 IDomainEventHandler<in TEvent> where TEvent : IDomainEvent，包含 Task HandleAsync(TEvent domainEvent, CancellationToken ct)。
12. 用 EF Core SaveChangesInterceptor 或包装器在保存后派发事件：重写 SavedChangesAsync；若 eventData.Context 非空，从 ChangeTracker.Entries<AggregateRoot<Guid>>() 筛选 DomainEvents.Count > 0 的聚合，收集所有事件，对每个聚合 ClearDomainEvents()，再 await dispatcher.DispatchAsync(events, ct)，最后返回 result。
13. 区分领域事件与集成事件：领域事件在限界上下文内，进程内 dispatcher 传输，引用领域类型，同一事务范围，例如 OrderSubmitted 触发邮件处理器；集成事件跨限界上下文/服务，经消息代理（Service Bus、RabbitMQ）传输，只用基元/DTO，至少一次且消费者幂等，例如 OrderSubmittedIntegration 通知 shipping 服务。领域事件处理器可发布集成事件。
14. 在领域事件处理器中发布集成事件：如 OrderSubmittedHandler 依赖 IPublishEndpoint，在 HandleAsync 中 Publish(new OrderSubmittedIntegration(domainEvent.OrderId, domainEvent.Total.Amount, domainEvent.Total.Currency), ct)，不传领域类型。
15. 优先富领域模型：业务逻辑放在领域实体内部，方法强制不变量并返回有意义结果；如 ShoppingCart 聚合根提供 AddItem（查找已有项则 IncreaseQuantity，否则加入 new CartItem）、RemoveItem（找不到则抛 DomainException）、GetTotal（用 Aggregate 汇总每个 item 的 LineTotal），内部 _items 暴露为 IReadOnlyList。
16. 避免贫血领域模型反模式：不要让实体变成带 public setter 和 public List<T> 的数据袋，也不要把业务逻辑放在外部 service；贫血模型只适合领域逻辑极少的简单 CRUD 实体（参考数据、配置记录）。对复杂业务规则的聚合根建议从富模型开始。
17. 用领域服务封装不属于单个实体/值对象的业务逻辑，并跨聚合执行规则：领域服务操作领域类型，保持纯 C#，无基础设施依赖。例如 PricingService.CalculateDiscount(Order order, CustomerTier tier, IReadOnlyList<PromotionRule> activePromotions) 先 discount = Money.Zero(order.Total.Currency)，按 tier 加 Gold 10% 或 Platinum 15%，再遍历 activePromotions，若 promo.AppliesTo(order) 则 discount.Add(promo.Calculate(order))，返回 discount。
18. 使用领域服务的场景：逻辑需要多个不应互相引用的聚合的数据；业务规则不属于任何单一实体（如跨产品和客户等级的定价）；外部策略或配置驱动逻辑（如税务计算规则）。如果逻辑需要数据库或外部 API，放到应用服务，由应用服务预加载数据后调用纯领域服务。
19. 在领域层定义仓储契约：IOrderRepository 提供 Task<Order?> FindByIdAsync(Guid id, CancellationToken ct)、Task AddAsync(Order order, CancellationToken ct)、Task SaveChangesAsync(CancellationToken ct)；可选 IUnitOfWork 提供 Task<int> SaveChangesAsync(CancellationToken ct)。实现放基础设施层。
20. 遵循仓储设计规则：每个聚合根一个仓储；不返回 IQueryable<T>；不使用泛型 IRepository<T>；返回领域类型而非 DTO；所有异步方法包含 CancellationToken。
21. 用领域特定异常信号不变量违反：定义 DomainException : Exception，含 message 和 inner 构造；为不同不变量定义具体异常，如 InsufficientStockException(ProductId productId, int requested, int available) 并暴露 ProductId、Requested、Available 字段。在 API 边界把 DomainException 映射为 HTTP 响应（如 422 Unprocessable Entity），不让 HTTP 状态码等基础设施关注点泄漏到领域层。
22. 避免在聚合属性上暴露 public setter：所有状态变更通过聚合根方法，属性用 private set 或 init。
23. 避免在聚合根之间创建导航属性：用 ID 值对象引用其他聚合根（如 CustomerId），跨聚合导航破坏限界上下文隔离。
24. 避免在事务内派发领域事件：应在 SaveChangesAsync 成功后派发；保存前派发会在保存失败时仍触发副作用。
25. 避免在集成事件中使用领域类型：集成事件跨限界上下文，必须用基元或 DTO；领域类型变更会破坏其他服务。
26. 避免只把校验逻辑放在 API 层：领域不变量属于领域模型；API 校验捕获畸形输入，领域校验强制业务规则。
27. 避免创建带 public List<T> 属性的贫血实体：集合暴露为 IReadOnlyList<T>，并在聚合根提供强制业务规则的变更方法。
28. 避免把基础设施服务注入领域实体：实体应是纯 C# 对象；需要外部数据的逻辑用领域服务，基础设施编排用应用服务。

适用边界 · 注意事项

• 当任务是 EF Core 配置、聚合持久化映射、DbContext 生命周期、迁移、拦截器等持久化细节时，不用本技能，改用 dotnet-efcore-architecture 或 dotnet-efcore-patterns。
• 当任务是 API 边界输入校验、EF Core/Dapper/ADO.NET 选型、垂直切片架构/请求管道、消息基础设施/saga 编排时，不用本技能，改用 dotnet-validation-patterns、dotnet-data-access-strategy、dotnet-architecture-patterns 或 dotnet-messaging-patterns。
• 对于领域逻辑极少的简单 CRUD 实体（如参考数据、配置记录），不必强制使用富领域模型和完整 DDD 战术模式。