Files
ar-inspection/.claude/commands/new-module.md
2025-12-01 23:57:09 +08:00

1.1 KiB

description
description
创建新的业务模块(Controller, Service, Mapper, Domain)

创建新的业务模块

根据提供的模块名称和功能描述,创建完整的业务模块结构:

  1. 确定模块位置: ruoyi-modules/ 下的对应业务模块

  2. 创建实体类 (Domain):

    • 位置: src/main/java/**/domain/
    • 使用 Lombok 注解
    • 继承 BaseEntity
    • 添加字段注释和验证注解
  3. 创建 Mapper 接口:

    • 位置: src/main/java/**/mapper/
    • 继承 BaseMapperPlus
    • 添加自定义查询方法
  4. 创建 Service 接口和实现:

    • 位置: src/main/java/**/service/ 和 service/impl/
    • 实现 CRUD 基础方法
    • 添加业务逻辑方法
  5. 创建 Controller:

    • 位置: src/main/java/**/controller/
    • 使用 @RestController 和 @RequestMapping
    • 实现 RESTful API
    • 添加 Swagger 文档注解
  6. 创建对应的 Mapper XML:

    • 位置: src/main/resources/mapper/**/

示例:

  • 实体类使用 @Data, @EqualsAndHashCode(callSuper = true)
  • Service 使用 @RequiredArgsConstructor
  • Controller 返回 R<> 统一响应格式
  • 使用 @SaCheckPermission 进行权限控制