SuperAPI AI 工具集

clean-architecture

编程与开发

查看项目

更新于 10-15 19:51

技能介绍

用途:为 .NET 应用提供整洁架构(Clean Architecture)的落地规范,指导如何按分层组织代码、约束依赖方向,并把业务规则放在领域层。

主要能力:

  1. 四项目布局:Domain、Application、Infrastructure、Api。依赖全部指向内层,Domain 不引用任何项目,Application 只引用 Domain,Infrastructure 引用 Application 与 Domain,Api 引用全部但依赖抽象,由项目引用在编译期强制约束。
  2. 领域层承载规则:业务逻辑以实体方法、领域服务或规约形式存在于 Domain,仅使用纯 C# 与 .NET 原语,不感知数据库、HTTP 或框架。
  3. 用例为工作单元:每个命令或查询在 Application 层是单个类,负责编排领域对象、通过抽象持久化并返回结果,避免包含大量方法的“服务”类。
  4. 基础设施作为插件:EF Core、外部 API、邮件发送、文件存储等放在 Infrastructure,实现 Application 或 Domain 定义的接口,可替换实现而不影响业务逻辑。
  5. API 层保持薄:端点只做 HTTP 与用例之间的映射,不含业务逻辑。

使用方式:资料给出目录结构示例,如 Domain 下的 Entities、Enums、Exceptions、Interfaces、Common;Application 下的 Common/Behaviors、Common/Interfaces 与按功能划分的 Commands、Queries;Infrastructure 下的 Persistence、Services、DependencyInjection;Api 下的 Endpoints 与 Program.cs。推荐在 Application 定义 IAppDbContext 最小接口,在 Infrastructure 用 AppDbContext 实现,并说明 EF Core 的 DbSet 本身已是仓储,额外抽象多数情况下只增加间接层。命令与查询通过 Mediator 的 IRequestHandler 处理,配合 AbstractValidator 做校验;领域实体通过静态工厂方法创建并封装状态变更;端点实现 IEndpointGroup 并由 app.MapEndpoints() 自动发现,新增端点无需改动 Program.cs;基础设施通过 AddInfrastructure 扩展方法注册 DbContext 与接口映射。

适用场景:领域复杂度中等以上、系统生命周期较长、团队熟悉分层架构的 .NET 项目;当业务规则涉及跨实体组的不变量时引入 Domain 层;需要校验、日志等管道行为时使用 Mediator;副作用(通知、审计)需要与主流程解耦时引入领域事件。

限制与注意:资料列出反模式,包括贫血领域模型、在 Domain 层引用 DbContext、端点内写业务逻辑、为每个实体创建仓储。是否从 VSA 演进到 CA、何时添加仓储或领域事件,需结合具体复杂度判断。资料未提供安装命令、收费、价格、平台或效果信息。