name: crud-by-controller-gas

description: 基于 tofly-gas 项目现有 Controller 风格快速生成标准 CRUD 代码（Controller/Service/Mapper/Mapper.xml），并强制约束 SQL 只能写在 *Mapper.xml 中。用户提到生成 CRUD、仿照控制器写接口、补全增删改查、统一接口风格或规范 MyBatis SQL 放置位置时使用。

CRUD 生成 Skill（tofly-gas 场景）

适用场景

当用户要求“参考某个 Controller 生成 CRUD”时，按此 Skill 执行。
默认参考 tofly-gas 的 Java 微服务风格，保持原有接口与分层模式一致。

公共 Skill 引用

POM 工作流：language/java/pom-factory-skill.md；Maven 治理条文：rules/java-pom-governance.mdc。
Java CRUD 通用规范：rules/java-crud-common.mdc。
当任务涉及 pom.xml、多模块依赖版本治理、dependencyManagement/pluginManagement、systemPath 清理时，必须同时应用 pom-factory-skill 与 java-pom-governance。
当 CRUD 生成与 POM 治理同时出现时，Controller/Service/Mapper 代码规范遵循本文件，Maven 构建与依赖规范遵循 pom-factory-skill + java-pom-governance。
当本文件与 java-crud-common 有冲突时：本文件的项目差异规则优先。

tofly-gas 专项约束

分层、SQL 仅 XML、Mapper 签名与 namespace、禁止 select *、动态 SQL 标签：一律遵循 rules/java-crud-common.mdc。
接口契约：返回体统一使用项目既有响应对象（通常为 ResultRespone 或项目统一结果类型）。
CRUD 路径与方法：GET /page、GET /{id}、POST /、PUT /、DELETE /{id}、DELETE /deleteByIds；查询 @ModelAttribute 承接查询对象，写接口 @RequestBody；主键参数命名与同模块保持一致。

生成步骤

识别实体信息
确认实体名、主键字段、主键类型、表名。
确认是否已有 Mapper/Service，避免重复创建。
生成 Controller
路由、方法命名、参数风格与同模块既有 Controller 保持一致。
接口最小集合：分页、详情、新增、修改、单删、批删。
禁止在 Controller 编写业务处理逻辑，复杂处理下沉到 Service。
生成 Service 层
Service 接口继承 MyBatis-Plus IService<Entity>（若项目已有该模式）。
ServiceImpl 继承 ServiceImpl<Mapper, Entity> 并实现接口。
不写任何 SQL。
生成 Mapper 层
Mapper 接口继承 BaseMapper<Entity>。
如需自定义查询，仅声明方法签名。
生成 *Mapper.xml
创建或补充对应 XML 文件。
所有自定义 SQL 都写在 XML 中。
自检
按 rules/java-crud-common.mdc 自检。
检查是否出现注解 SQL。
检查 Controller 是否包含业务逻辑代码（若有则迁移到 Service）。
检查 XML namespace 与方法 id 是否一一对应。