.NET 领域驱动设计模板使用教程

1. 项目介绍

本项目是基于 Clean Architecture 的 .NET 领域驱动设计（Domain-Driven Design, DDD）模板。它旨在帮助开发者构建高度解耦的单一应用程序，并具有在业务需求演变时过渡到微服务的灵活性。模板通过垂直切片架构实现了 DDD 的核心原则，将每个边界上下文（Bounded Context）隔离在独立的项目中，从而最小化领域耦合的风险。

2. 项目快速启动

环境准备

确保你的开发环境已经安装了以下工具：

• .NET Core 8 或更高版本
• ASP.NET Core 8 或更高版本
• Entity Framework Core 8 或更高版本

克隆项目

使用 Git 克隆项目到本地：

git clone https://github.com/evgenirusev/.NET-Domain-Driven-Design-Template.git

配置数据库连接字符串

在项目配置文件中（通常是 appsettings.json 或 appsettings.Production.json），设置数据库连接字符串。

{
  "ConnectionStrings": {
    "DefaultConnection": "Your Database Connection String Here"
  }
}

迁移数据库

运行以下脚本以创建项目迁移：

./run_migrations.sh

运行项目

使用以下命令运行项目：

dotnet run

项目将启动并可在默认的网络服务器端口上访问。

3. 应用案例和最佳实践

边界上下文分离

在 DDD 中，边界上下文定义了模型的边界。本模板通过将每个边界上下文隔离在独立的项目中来实现这一点，从而允许独立领域的发展。

CQRS 与仓库模式

命令查询责任分离（CQRS）和仓库模式在项目中得到了应用，以实现读写分离和从 Entity Framework 解耦。

领域事件

领域事件用于在不同边界上下文之间进行通信。在实体中触发事件，并通过事件处理器进行响应和处理。

public class Order : Entity, IAggregateRoot
{
    public Order(Guid customerId, DateTime orderDate)
    {
        // ...
        RaiseEvent(new OrderAddedEvent());
    }
}

领域模型与验证

领域模型通过工厂和仓库作为防腐蚀层，并在所有层中实现验证，确保核心领域的状态有效且无错误。

4. 典型生态项目

本模板基于以下技术和工具构建：

• .NET Core 8
• ASP.NET Core 8
• Entity Framework Core 8
• MediatR（中介者模式实现）
• FluentValidation（验证库）
• AutoMapper（对象映射）
• Scrutor（依赖注入扩展）
• xUnit（单元测试框架）
• FluentAssertions（断言库）

通过以上介绍，您应该能够开始使用这个 .NET 领域驱动设计模板，并根据实际需求进行定制和扩展。