用途:该技能围绕 Robert C. Martin 提出的 Clean Architecture,协助按分层方式组织代码,核心是依赖规则——源码依赖只能指向内层。适用于需长期演进的企业应用、希望解耦框架与数据库(如更换 ORM 或 REST 改 gRPC 时不动领域层)、以及需要对核心业务用例做快速隔离单元测试的场景。
主要能力:讲解并示范实体(企业业务规则)、用例交互器(应用业务规则)、接口适配器与框架驱动层;演示依赖倒置,将仓储接口声明在领域层、实现放在基础设施层;提供 Subscription 实体、RenewSubscriptionUseCase、UserRepositoryPort 等示例;给出常见模式与最佳实践。
使用方式:资料以概念说明与 TypeScript 代码示例为主,未提供安装命令或调用步骤,暂未提供。
最佳实践:领域实体不引入框架导入;端口以接口形式定义在领域层;用内存 mock 测试用例;跨边界使用 DTO 与校验模式。避免把 ORM 实体返回给控制器、避免贫血领域模型、避免对简单 CRUD 过度设计。
限制:会带来认知与样板代码开销,不适合简单原型;出现循环依赖时应以接口打破;样板过多时可考虑垂直切片架构或模块化单体。