java-architecture-guide
SKILL.md
Java 业务项目架构指南
分层架构
四层单向调用，禁止反向或跨层依赖：
Controller → Facade → Service → Repository (Mapper)
各层职责
| 层 | 职责 | 注入 | 禁止 |
|---|---|---|---|
| Controller | HTTP 入口、参数校验、响应封装 | Facade | 注入 Service；包含业务逻辑；添加事务 |
| Facade | 跨服务编排、事务边界、DTO 组装 | 多个 Service、Converter | 直接操作 Mapper |
| Service | 单一领域业务逻辑、数据操作 | 本域 Mapper、Converter | 注入其他 Service 或其他域的 Mapper |
| Repository | 数据访问（继承 BaseMapper） | — | 添加自定义方法（查询在 Service 中构建） |