ai-engineering-init 1.6.0 → 1.8.0

package/src/skills/crud-development/SKILL.md

@@ -1,409 +1,328 @@
 ---
 name: crud-development
 description: |
-  后端 CRUD 开发规范。基于 RuoYi-Vue-Plus 三层架构（Controller -> Service -> Mapper），无独立 DAO 层。
+  通用 CRUD 开发指南。基于 Spring Boot 三层架构（Controller -> Service -> Mapper），
+  提供 Entity、DTO、VO、Service、Controller 的标准模板。
+  触发场景：新增业务模块、增删改查开发、快速生成 CRUD 代码。
+  触发词：CRUD、增删改查、新增模块、生成代码。
+  注意：如果项目有专属技能（如 `leniu-crud`），优先使用专属版本。
+---
 
-  触发场景：
-  - 新建业务模块的 CRUD 功能
-  - 创建 Entity、BO、VO、Service、Mapper、Controller
-  - 分页查询、新增、修改、删除、导出
-  - 查询条件构建（buildQueryWrapper）
+# CRUD 开发指南
 
-  触发词：CRUD、增删改查、新建模块、Entity、BO、VO、Service、Mapper、Controller、分页查询、buildQueryWrapper、@AutoMapper、BaseMapperPlus、TenantEntity
+> 通用模板。如果项目有专属技能（如 `leniu-crud`），优先使用。
 
-  注意：
-  - 三层架构，Service 直接注入 Mapper，无 DAO 层。
-  - 查询条件在 Service 层构建（buildQueryWrapper）。
-  - 使用 @AutoMapper（单数）而非 @AutoMappers。
-  - API 路径使用标准 RESTful 格式（/list、/{id}）。
----
+## 核心规范
 
-# CRUD 开发规范（RuoYi-Vue-Plus 三层架构）
+### 三层架构
 
-## 核心架构特征
+| 层 | 职责 | 命名示例 |
+|----|------|---------|
+| Controller | 接收请求、参数校验、路由分发 | `OrderController` |
+| Service | 业务逻辑、事务管理 | `OrderService` / `OrderServiceImpl` |
+| Mapper | 数据访问（ORM 映射） | `OrderMapper` |
 
-| 项 | 规范 |
-|----|------|
-| **包名前缀** | `org.dromara.*` |
-| **架构** | Controller -> Service -> Mapper（无 DAO 层） |
-| **查询构建** | Service 层 `buildQueryWrapper()` |
-| **Mapper** | 继承 `BaseMapperPlus<Entity, VO>` |
-| **对象转换** | `MapstructUtils.convert()` |
-| **Entity 基类** | `TenantEntity`（多租户） |
-| **BO 映射** | `@AutoMapper`（单数） |
-| **API 路径** | RESTful：`/list`、`/{id}` |
+### 标准包结构
 
----
+```
+[你的包名]/
+├── controller/        # 控制器
+├── service/
+│   └── impl/          # 服务实现
+├── mapper/            # 数据访问层
+├── entity/            # 实体类
+├── dto/               # 请求参数对象
+├── vo/                # 响应视图对象
+├── enums/             # 枚举常量
+└── config/            # 模块配置
+```
+
+## 代码示例
 
-## 1. Entity
+### 1. Entity（实体类）
 
 ```java
-package org.dromara.demo.domain;
+package [你的包名].entity;
 
-import org.dromara.common.tenant.core.TenantEntity;
 import com.baomidou.mybatisplus.annotation.*;
 import lombok.Data;
-import lombok.EqualsAndHashCode;
-import java.io.Serial;
+import java.time.LocalDateTime;
 
 @Data
-@EqualsAndHashCode(callSuper = true)
-@TableName("test_xxx")
-public class Xxx extends TenantEntity {
+@TableName("t_order")
+public class Order {
 
-    @Serial
-    private static final long serialVersionUID = 1L;
-
-    @TableId(value = "id")
+    @TableId(type = IdType.ASSIGN_ID)
     private Long id;
 
-    private String xxxName;
+    private String orderNo;
+
+    private Integer status;
+
+    private Long amount;
+
+    @TableField(fill = FieldFill.INSERT)
+    private String createBy;
+
+    @TableField(fill = FieldFill.INSERT)
+    private LocalDateTime createTime;
 
-    private String status;
+    @TableField(fill = FieldFill.INSERT_UPDATE)
+    private String updateBy;
 
-    @TableLogic
-    private Long delFlag;
+    @TableField(fill = FieldFill.INSERT_UPDATE)
+    private LocalDateTime updateTime;
+
+    @TableLogic(value = "0", delval = "1")
+    private Integer deleted;
 }
 ```
 
-## 2. BO
+### 2. DTO（请求参数）
 
 ```java
-package org.dromara.demo.domain.bo;
+package [你的包名].dto;
 
-import io.github.linpeilie.annotations.AutoMapper;
-import org.dromara.demo.domain.Xxx;
-import org.dromara.common.core.validate.AddGroup;
-import org.dromara.common.core.validate.EditGroup;
-import org.dromara.common.mybatis.core.domain.BaseEntity;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
 import jakarta.validation.constraints.*;
+import lombok.Data;
 
 @Data
-@EqualsAndHashCode(callSuper = true)
-@AutoMapper(target = Xxx.class, reverseConvertGenerate = false)
-public class XxxBo extends BaseEntity {
+public class OrderCreateDTO {
 
-    @NotNull(message = "主键不能为空", groups = {EditGroup.class})
-    private Long id;
+    @NotBlank(message = "订单号不能为空")
+    private String orderNo;
 
-    @NotBlank(message = "名称不能为空", groups = {AddGroup.class, EditGroup.class})
-    private String xxxName;
+    @NotNull(message = "金额不能为空")
+    @Min(value = 1, message = "金额必须大于0")
+    private Long amount;
+}
+```
 
-    private String status;
+```java
+package [你的包名].dto;
+
+import lombok.Data;
+
+@Data
+public class OrderQueryDTO {
+
+    private String orderNo;
+
+    private Integer status;
+
+    private Integer pageNum = 1;
+
+    private Integer pageSize = 10;
 }
 ```
 
-## 3. VO
+### 3. VO（响应对象）
 
 ```java
-package org.dromara.demo.domain.vo;
+package [你的包名].vo;
 
-import io.github.linpeilie.annotations.AutoMapper;
-import org.dromara.demo.domain.Xxx;
-import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
-import cn.idev.excel.annotation.ExcelProperty;
 import lombok.Data;
-import java.io.Serial;
-import java.io.Serializable;
-import java.util.Date;
+import java.time.LocalDateTime;
 
 @Data
-@ExcelIgnoreUnannotated
-@AutoMapper(target = Xxx.class)
-public class XxxVo implements Serializable {
-
-    @Serial
-    private static final long serialVersionUID = 1L;
+public class OrderVO {
 
-    @ExcelProperty(value = "主键")
     private Long id;
 
-    @ExcelProperty(value = "名称")
-    private String xxxName;
+    private String orderNo;
+
+    private Integer status;
 
-    @ExcelProperty(value = "状态")
-    private String status;
+    private Long amount;
 
-    @ExcelProperty(value = "创建时间")
-    private Date createTime;
+    private LocalDateTime createTime;
 }
 ```
 
-## 4. Service 接口
+### 4. Mapper
 
 ```java
-package org.dromara.demo.service;
-
-import org.dromara.demo.domain.bo.XxxBo;
-import org.dromara.demo.domain.vo.XxxVo;
-import org.dromara.common.mybatis.core.page.PageQuery;
-import org.dromara.common.mybatis.core.page.TableDataInfo;
-import java.util.Collection;
-import java.util.List;
-
-public interface IXxxService {
-    XxxVo queryById(Long id);
-    List<XxxVo> queryList(XxxBo bo);
-    TableDataInfo<XxxVo> queryPageList(XxxBo bo, PageQuery pageQuery);
-    Boolean insertByBo(XxxBo bo);
-    Boolean updateByBo(XxxBo bo);
-    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+package [你的包名].mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import [你的包名].entity.Order;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface OrderMapper extends BaseMapper<Order> {
 }
 ```
 
-## 5. Service 实现（核心）
+### 5. Service
 
 ```java
-package org.dromara.demo.service.impl;
+package [你的包名].service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import [你的包名].entity.Order;
+import [你的包名].dto.OrderCreateDTO;
+import [你的包名].dto.OrderQueryDTO;
+import [你的包名].vo.OrderVO;
+
+public interface IOrderService extends IService<Order> {
+
+    Long createOrder(OrderCreateDTO dto);
+
+    void updateOrder(Long id, OrderCreateDTO dto);
+
+    OrderVO getOrderDetail(Long id);
+
+    Page<OrderVO> pageQuery(OrderQueryDTO query);
+}
+```
+
+```java
+package [你的包名].service.impl;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
-import com.baomidou.mybatisplus.core.toolkit.Wrappers;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import [你的包名].dto.OrderCreateDTO;
+import [你的包名].dto.OrderQueryDTO;
+import [你的包名].entity.Order;
+import [你的包名].mapper.OrderMapper;
+import [你的包名].service.IOrderService;
+import [你的包名].vo.OrderVO;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
-import org.dromara.common.core.exception.ServiceException;
-import org.dromara.common.core.utils.MapstructUtils;
-import org.dromara.common.core.utils.StringUtils;
-import org.dromara.common.mybatis.core.page.PageQuery;
-import org.dromara.common.mybatis.core.page.TableDataInfo;
-import org.dromara.demo.domain.Xxx;
-import org.dromara.demo.domain.bo.XxxBo;
-import org.dromara.demo.domain.vo.XxxVo;
-import org.dromara.demo.mapper.XxxMapper;
-import org.dromara.demo.service.IXxxService;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
 
 @Service
 @RequiredArgsConstructor
-public class XxxServiceImpl implements IXxxService {
-
-    private final XxxMapper baseMapper;  // 直接注入 Mapper（无 DAO 层）
+public class OrderServiceImpl extends ServiceImpl<OrderMapper, Order> implements IOrderService {
 
     @Override
-    public XxxVo queryById(Long id) {
-        return baseMapper.selectVoById(id);
+    @Transactional(rollbackFor = Exception.class)
+    public Long createOrder(OrderCreateDTO dto) {
+        Order order = new Order();
+        // 使用 [你的对象转换工具] 或手动赋值
+        order.setOrderNo(dto.getOrderNo());
+        order.setAmount(dto.getAmount());
+        order.setStatus(0);
+        this.save(order);
+        return order.getId();
     }
 
     @Override
-    public List<XxxVo> queryList(XxxBo bo) {
-        return baseMapper.selectVoList(buildQueryWrapper(bo));
-    }
-
-    @Override
-    public TableDataInfo<XxxVo> queryPageList(XxxBo bo, PageQuery pageQuery) {
-        LambdaQueryWrapper<Xxx> lqw = buildQueryWrapper(bo);
-        Page<XxxVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
-        return TableDataInfo.build(result);
-    }
-
-    @Override
-    public Boolean insertByBo(XxxBo bo) {
-        Xxx add = MapstructUtils.convert(bo, Xxx.class);
-        validEntityBeforeSave(add);
-        return baseMapper.insert(add) > 0;
-    }
-
-    @Override
-    public Boolean updateByBo(XxxBo bo) {
-        Xxx update = MapstructUtils.convert(bo, Xxx.class);
-        validEntityBeforeSave(update);
-        return baseMapper.updateById(update) > 0;
+    @Transactional(rollbackFor = Exception.class)
+    public void updateOrder(Long id, OrderCreateDTO dto) {
+        Order order = this.getById(id);
+        if (order == null) {
+            throw new [你的业务异常类]("订单不存在");
+        }
+        order.setOrderNo(dto.getOrderNo());
+        order.setAmount(dto.getAmount());
+        this.updateById(order);
     }
 
     @Override
-    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
-        if (isValid) {
-            List<Xxx> list = baseMapper.selectByIds(ids);
-            if (list.size() != ids.size()) {
-                throw new ServiceException("您没有删除权限!");
-            }
+    public OrderVO getOrderDetail(Long id) {
+        Order order = this.getById(id);
+        if (order == null) {
+            throw new [你的业务异常类]("订单不存在");
         }
-        return baseMapper.deleteByIds(ids) > 0;
-    }
-
-    private LambdaQueryWrapper<Xxx> buildQueryWrapper(XxxBo bo) {
-        Map<String, Object> params = bo.getParams();
-        LambdaQueryWrapper<Xxx> lqw = Wrappers.lambdaQuery();
-        lqw.eq(bo.getId() != null, Xxx::getId, bo.getId());
-        lqw.eq(StringUtils.isNotBlank(bo.getStatus()), Xxx::getStatus, bo.getStatus());
-        lqw.like(StringUtils.isNotBlank(bo.getXxxName()), Xxx::getXxxName, bo.getXxxName());
-        lqw.between(params.get("beginCreateTime") != null && params.get("endCreateTime") != null,
-            Xxx::getCreateTime, params.get("beginCreateTime"), params.get("endCreateTime"));
-        lqw.orderByAsc(Xxx::getId);
-        return lqw;
+        OrderVO vo = new OrderVO();
+        // 使用 [你的对象转换工具] 或手动赋值
+        vo.setId(order.getId());
+        vo.setOrderNo(order.getOrderNo());
+        vo.setStatus(order.getStatus());
+        vo.setAmount(order.getAmount());
+        vo.setCreateTime(order.getCreateTime());
+        return vo;
     }
 
-    private void validEntityBeforeSave(Xxx entity) {
-        // TODO 做一些数据校验，如唯一约束
+    @Override
+    public Page<OrderVO> pageQuery(OrderQueryDTO query) {
+        Page<Order> page = new Page<>(query.getPageNum(), query.getPageSize());
+        LambdaQueryWrapper<Order> wrapper = new LambdaQueryWrapper<Order>()
+                .like(StringUtils.hasText(query.getOrderNo()), Order::getOrderNo, query.getOrderNo())
+                .eq(query.getStatus() != null, Order::getStatus, query.getStatus())
+                .orderByDesc(Order::getCreateTime);
+        Page<Order> result = this.page(page, wrapper);
+
+        // 转换为 VO
+        Page<OrderVO> voPage = new Page<>(result.getCurrent(), result.getSize(), result.getTotal());
+        voPage.setRecords(result.getRecords().stream().map(order -> {
+            OrderVO vo = new OrderVO();
+            vo.setId(order.getId());
+            vo.setOrderNo(order.getOrderNo());
+            vo.setStatus(order.getStatus());
+            vo.setAmount(order.getAmount());
+            vo.setCreateTime(order.getCreateTime());
+            return vo;
+        }).toList());
+        return voPage;
     }
 }
 ```
 
-## 6. Mapper
-
-```java
-package org.dromara.demo.mapper;
-
-import org.dromara.demo.domain.Xxx;
-import org.dromara.demo.domain.vo.XxxVo;
-import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
-
-public interface XxxMapper extends BaseMapperPlus<Xxx, XxxVo> {
-    // 已提供 selectVoById、selectVoPage、selectVoList 等方法
-}
-```
-
-## 7. Controller
+### 6. Controller
 
 ```java
-package org.dromara.demo.controller;
+package [你的包名].controller;
 
-import java.util.Arrays;
-import java.util.List;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import [你的包名].dto.OrderCreateDTO;
+import [你的包名].dto.OrderQueryDTO;
+import [你的包名].service.IOrderService;
+import [你的包名].vo.OrderVO;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
-import jakarta.servlet.http.HttpServletResponse;
-import jakarta.validation.constraints.*;
-import cn.dev33.satoken.annotation.SaCheckPermission;
+import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
-import org.springframework.validation.annotation.Validated;
-import org.dromara.common.idempotent.annotation.RepeatSubmit;
-import org.dromara.common.log.annotation.Log;
-import org.dromara.common.log.enums.BusinessType;
-import org.dromara.common.mybatis.core.page.PageQuery;
-import org.dromara.common.mybatis.core.page.TableDataInfo;
-import org.dromara.common.web.core.BaseController;
-import org.dromara.common.core.domain.R;
-import org.dromara.common.core.validate.AddGroup;
-import org.dromara.common.core.validate.EditGroup;
-import org.dromara.common.excel.utils.ExcelUtil;
-import org.dromara.demo.domain.vo.XxxVo;
-import org.dromara.demo.domain.bo.XxxBo;
-import org.dromara.demo.service.IXxxService;
-
-@Validated
-@RequiredArgsConstructor
-@RestController
-@RequestMapping("/demo/xxx")
-public class XxxController extends BaseController {
 
-    private final IXxxService xxxService;
+@RestController
+@RequestMapping("/api/v1/orders")
+@RequiredArgsConstructor
+public class OrderController {
 
-    @SaCheckPermission("demo:xxx:list")
-    @GetMapping("/list")
-    public TableDataInfo<XxxVo> list(XxxBo bo, PageQuery pageQuery) {
-        return xxxService.queryPageList(bo, pageQuery);
-    }
+    private final IOrderService orderService;
 
-    @SaCheckPermission("demo:xxx:query")
-    @GetMapping("/{id}")
-    public R<XxxVo> getInfo(@NotNull(message = "主键不能为空") @PathVariable Long id) {
-        return R.ok(xxxService.queryById(id));
+    @PostMapping
+    public ResponseEntity<Long> create(@Valid @RequestBody OrderCreateDTO dto) {
+        return ResponseEntity.ok(orderService.createOrder(dto));
     }
 
-    @SaCheckPermission("demo:xxx:add")
-    @Log(title = "XXX管理", businessType = BusinessType.INSERT)
-    @RepeatSubmit()
-    @PostMapping()
-    public R<Void> add(@Validated(AddGroup.class) @RequestBody XxxBo bo) {
-        return toAjax(xxxService.insertByBo(bo));
+    @PutMapping("/{id}")
+    public ResponseEntity<Void> update(@PathVariable Long id,
+                                       @Valid @RequestBody OrderCreateDTO dto) {
+        orderService.updateOrder(id, dto);
+        return ResponseEntity.ok().build();
     }
 
-    @SaCheckPermission("demo:xxx:edit")
-    @Log(title = "XXX管理", businessType = BusinessType.UPDATE)
-    @RepeatSubmit()
-    @PutMapping()
-    public R<Void> edit(@Validated(EditGroup.class) @RequestBody XxxBo bo) {
-        return toAjax(xxxService.updateByBo(bo));
+    @GetMapping("/{id}")
+    public ResponseEntity<OrderVO> detail(@PathVariable Long id) {
+        return ResponseEntity.ok(orderService.getOrderDetail(id));
     }
 
-    @SaCheckPermission("demo:xxx:remove")
-    @Log(title = "XXX管理", businessType = BusinessType.DELETE)
-    @DeleteMapping("/{ids}")
-    public R<Void> remove(@NotEmpty(message = "主键不能为空") @PathVariable Long[] ids) {
-        return toAjax(xxxService.deleteWithValidByIds(Arrays.asList(ids), true));
+    @GetMapping
+    public ResponseEntity<Page<OrderVO>> page(OrderQueryDTO query) {
+        return ResponseEntity.ok(orderService.pageQuery(query));
     }
 
-    @SaCheckPermission("demo:xxx:export")
-    @Log(title = "XXX管理", businessType = BusinessType.EXPORT)
-    @PostMapping("/export")
-    public void export(@Validated XxxBo bo, HttpServletResponse response) {
-        List<XxxVo> list = xxxService.queryList(bo);
-        ExcelUtil.exportExcel(list, "XXX数据", XxxVo.class, response);
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete(@PathVariable Long id) {
+        orderService.removeById(id);
+        return ResponseEntity.ok().build();
     }
 }
 ```
 
-## 8. 建表 SQL
-
-```sql
-CREATE TABLE demo_xxx (
-    id           BIGINT(20)   NOT NULL COMMENT '主键（雪花ID，不用AUTO_INCREMENT）',
-    tenant_id    VARCHAR(20)  DEFAULT '000000' COMMENT '租户ID',
-    xxx_name     VARCHAR(100) NOT NULL COMMENT '名称',
-    status       CHAR(1)      DEFAULT '0' COMMENT '状态(0正常 1停用)',
-    create_dept  BIGINT(20)   DEFAULT NULL COMMENT '创建部门',
-    create_by    BIGINT(20)   DEFAULT NULL COMMENT '创建人',
-    create_time  DATETIME     DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    update_by    BIGINT(20)   DEFAULT NULL COMMENT '更新人',
-    update_time  DATETIME     DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    remark       VARCHAR(255) DEFAULT NULL COMMENT '备注',
-    del_flag     BIGINT(20)   DEFAULT 0 COMMENT '删除标志(0正常 1已删除)',
-    PRIMARY KEY (id)
-) ENGINE=InnoDB COMMENT='XXX表';
-```
-
----
-
-## 常见错误速查
-
-```java
-// ---- 错误写法 ----
-private final IXxxDao xxxDao;                    // 本项目没有 DAO 层
-BeanUtil.copyProperties(bo, entity);             // 必须用 MapstructUtils.convert()
-class XxxServiceImpl extends ServiceImpl<...> {} // Service 不继承基类
-@AutoMappers({@AutoMapper(...)})                 // 用单数 @AutoMapper
-@GetMapping("/pageXxxs")                         // 应该是 /list
-@GetMapping("/getXxx/{id}")                      // 应该是 /{id}
-
-// ---- 正确写法 ----
-private final XxxMapper baseMapper;              // 直接注入 Mapper
-MapstructUtils.convert(bo, Xxx.class);           // MapstructUtils 转换
-class XxxServiceImpl implements IXxxService {}   // 只实现接口
-@AutoMapper(target = Xxx.class)                  // 单数注解
-@GetMapping("/list")                             // RESTful 路径
-@GetMapping("/{id}")                             // RESTful 路径
-```
-
----
-
-## 检查清单
-
-- [ ] 包名是 `org.dromara.*`？
-- [ ] Service 只实现接口，不继承基类？
-- [ ] Service 直接注入 Mapper（无 DAO）？
-- [ ] `buildQueryWrapper()` 在 Service 层？
-- [ ] Entity 继承 `TenantEntity`？
-- [ ] BO 使用 `@AutoMapper`（单数）？
-- [ ] 使用 `MapstructUtils.convert()` 转换？
-- [ ] Mapper 继承 `BaseMapperPlus<Entity, VO>`？
-- [ ] Controller 使用 RESTful 路径？
-- [ ] SQL 使用 `del_flag`（0正常 1删除）？
-- [ ] 主键使用雪花 ID（无 AUTO_INCREMENT）？
-- [ ] 代码注释和 SQL COMMENT 使用中文？
-
----
-
-## 参考实现
-
-| 类型 | 类名 |
-|------|------|
-| Entity | `org.dromara.demo.domain.TestDemo` |
-| BO | `org.dromara.demo.domain.bo.TestDemoBo` |
-| VO | `org.dromara.demo.domain.vo.TestDemoVo` |
-| Service | `org.dromara.demo.service.impl.TestDemoServiceImpl` |
-| Mapper | `org.dromara.demo.mapper.TestDemoMapper` |
-| Controller | `org.dromara.demo.controller.TestDemoController` |
+## 常见错误
+
+| 错误 | 正确做法 |
+|------|---------|
+| Controller 里写业务逻辑 | 业务逻辑放 Service 层 |
+| 直接返回 Entity 给前端 | 使用 VO 封装响应数据 |
+| 用 Map 传递业务数据 | 使用 DTO/VO 强类型对象 |
+| 忘记加 `@Transactional` | 写操作方法加事务注解 |
+| 逻辑删除字段值搞反 | 确认项目约定（通用：0=正常, 1=删除） |
+| 分页参数未设默认值 | DTO 中给 pageNum/pageSize 默认值 |
+| Service 之间循环依赖 | 提取公共 Service 或使用事件机制解耦 |