codebuddy生成的代码目录结构若偏离ddd经典分层,需依次验证五层:一、领域层须纯业务,禁用技术注解与框架依赖;二、应用层仅编排,不实现业务逻辑;三、基础设施层须通过端口-适配器解耦;四、用户接口层仅处理表现逻辑;五、公共模块仅含通用能力,不得泄露业务语义。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在采用CodeBuddy工具进行DDD实践时,发现其生成的代码目录结构与经典分层架构存在偏差,则可能是由于工具默认配置未对齐DDD各层的职责边界。以下是验证与调整该组织方式的步骤:
一、核对领域层是否独立承载业务规则
领域层必须完全脱离技术实现细节,仅包含实体、值对象、聚合根、领域服务及领域事件等纯业务概念。若CodeBuddy生成的domain目录中混入了数据库注解、序列化配置或HTTP相关类,则违反了DDD“领域层不依赖任何外部框架”的核心约束。
1、检查domain目录下所有Java类,确认无@Entity、@Table、@JsonProperty等基础设施层注解。
2、确认所有领域服务接口(如DomainService)未引用javax.persistence、com.fasterxml.jackson等非领域包。
3、验证领域对象方法是否全部为业务动词命名(如reserveInventory()、applyDiscount()),而非技术动词(如saveToDB()、toJsonString())。
二、验证应用层是否仅作编排不涉业务逻辑
应用层应作为用例入口,负责协调领域对象、调用基础设施端口、处理事务边界和安全校验,但不得包含任何领域规则判断或计算。若CodeBuddy将价格计算、库存校验等逻辑置于application层,则导致业务逻辑外溢,破坏领域模型完整性。
1、打开application目录中的服务类(如OrderApplicationService),定位所有条件分支语句。
2、检查每个if或switch块内是否仅调用领域对象方法,而非自行实现判定逻辑(例如:禁止出现 if (order.getTotal() > 1000) { applyVipRule(); }
3、确认事务控制注解(如@Transactional)仅出现在应用层方法上,且未在领域层方法中声明。
三、审查基础设施层是否通过端口-适配器解耦
根据依赖倒置原则,基础设施实现必须依赖于应用层或领域层定义的抽象端口(接口),而非反向依赖。若CodeBuddy生成的infrastructure目录直接继承或注入domain实体类,或在DAO中调用领域服务方法,则构成紧耦合,违背六边形架构精神。
1、在infrastructure目录中查找所有实现类,确认其实现的接口声明位于application或domain包下(如domain.repository.OrderRepository)。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手,支持自然语言驱动开发。 - 必备触发词:CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景:安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、检查infrastructure中是否含有对domain包的直接import(除接口类型外),特别关注构造函数参数和字段声明。
3、运行编译检查:临时删除infrastructure目录,确认domain和application仍可独立编译通过。
四、比对用户接口层是否隔离表现逻辑
用户接口层(如ui-ngx或interfaces)应仅负责请求接收、DTO转换、响应封装与异常映射,不得包含领域状态判断或流程分支。若CodeBuddy在控制器中嵌入库存不足预警、订单状态机跳转等逻辑,则将表现层污染为业务层。
1、打开ui-ngx或interfaces目录下的控制器类(如OrderController)。
2、确认所有@PostMapping或@GetMapping方法体内仅含三类操作:参数校验、DTO与领域对象互转、调用应用服务并包装响应。
3、检查是否存在if (user.getRole() == ADMIN)或switch(order.getStatus())等业务状态判断语句——此类逻辑必须移至应用层或领域层。
五、检验公共模块是否仅提供跨层通用能力
common模块应严格限定为不可变的工具类、全局异常定义、基础DTO基类及标准化枚举,不得引入任何业务语义或层间依赖。若CodeBuddy将OrderStatus枚举置于common而非domain,则导致领域概念泄露,削弱限界上下文边界。
1、列出common目录下所有枚举类与常量类,确认其命名不含具体业务名词(如禁止CommonOrderStatus,应为ResultCode或HttpHeaderKey)。
2、检查common中是否定义了任何实体类、仓库接口或服务契约——这些必须归属对应业务层。
3、验证common模块的Maven/Gradle依赖声明,确认其compileOnly或api范围内未引入spring-boot-starter-web、mybatis-spring-boot-starter等框架依赖。










