ai-engineering-init 1.1.0

package/.claude/docs//346/226/260/345/212/237/350/203/275/345/274/200/345/217/221/346/265/201/347/250/213/350/247/204/350/214/203.md

@@ -0,0 +1,688 @@
+# 新功能开发流程规范
+
+> **重要提示**: 本文档规定了从零开发新功能的完整流程。
+> **注意**: 本项目是 RuoYi-Vue-Plus **纯后端项目**，采用**三层架构**（无 DAO 层）。
+
+最后更新: 2026-02-09
+
+---
+
+## 📋 开发流程总览
+
+```
+第一步: 需求分析与设计
+    ↓
+第二步: 设计数据库表结构
+    ↓
+第三步: 生成菜单 SQL
+    ↓
+第四步: 生成后端代码（三层架构）
+    ↓
+第五步: 开发业务逻辑
+    ↓
+第六步: 测试与验证
+```
+
+---
+
+## 🏗️ 核心架构（必须牢记）
+
+| 项目 | 规范 |
+|------|------|
+| **包名** | `org.dromara.*`（禁止 `com.ruoyi.*`、`plus.ruoyi.*`） |
+| **架构** | 三层：Controller → Service → Mapper（**无 DAO 层**） |
+| **查询构建** | Service 层 `buildQueryWrapper()` |
+| **Mapper 继承** | `BaseMapperPlus<Entity, VO>` |
+| **对象转换** | `MapstructUtils.convert()` |
+| **Entity 基类** | `TenantEntity`（多租户） |
+| **BO 映射** | `@AutoMapper` 注解（单数，不是 `@AutoMappers`） |
+| **主键策略** | 雪花 ID（不用 AUTO_INCREMENT） |
+| **API 路径** | 标准 RESTful：`/list`、`/{id}` |
+
+---
+
+## 📐 第一步: 需求分析与设计
+
+### 1.1 明确功能需求
+
+在开始开发前，明确以下内容：
+- 功能名称和用途
+- 需要哪些字段
+- 业务规则和校验
+- 权限控制要求
+
+### 1.2 确定模块位置
+
+| 业务领域 | 模块目录 | 包路径 | 表前缀 |
+|---------|---------|--------|--------|
+| 系统管理 | `ruoyi-modules/ruoyi-system/` | `org.dromara.system` | `sys_` |
+| 演示模块 | `ruoyi-modules/ruoyi-demo/` | `org.dromara.demo` | `test_` |
+| 工作流 | `ruoyi-modules/ruoyi-workflow/` | `org.dromara.workflow` | `flow_` |
+| 商城业务 | `ruoyi-modules/ruoyi-mall/` | `org.dromara.mall` | `m_` |
+| 自定义 | `ruoyi-modules/ruoyi-xxx/` | `org.dromara.xxx` | `xxx_` |
+
+---
+
+## 📐 第二步: 设计数据库表结构
+
+### 2.1 表设计规范
+
+#### ✅ 命名规范
+
+| 项目 | 规范 | 示例 |
+|------|------|------|
+| **表名** | 前缀 + 业务名称 | `m_goods`（商城商品） |
+| **主键** | `id`（雪花 ID） | `id BIGINT(20) NOT NULL` |
+| **外键** | `关联表_id` | `user_id`, `goods_id` |
+| **状态字段** | `status` | `status CHAR(1) DEFAULT '1'` |
+| **删除标记** | `del_flag` | `del_flag CHAR(1) DEFAULT '0'` |
+
+#### ✅ 建表模板（必须包含的字段）
+
+```sql
+CREATE TABLE xxx_table (
+    -- 主键（雪花 ID，不用 AUTO_INCREMENT）
+    id              BIGINT(20)    NOT NULL COMMENT '主键ID',
+
+    -- 多租户字段（必须）
+    tenant_id       VARCHAR(20)   DEFAULT '000000' COMMENT '租户ID',
+
+    -- 业务字段
+    xxx_name        VARCHAR(100)  NOT NULL COMMENT '名称',
+    status          CHAR(1)       DEFAULT '1' COMMENT '状态(0停用 1正常)',
+    remark          VARCHAR(500)  DEFAULT NULL COMMENT '备注',
+
+    -- 审计字段（必须，继承自 TenantEntity）
+    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 '更新时间',
+
+    -- 逻辑删除（必须）
+    del_flag        CHAR(1)       DEFAULT '0' COMMENT '删除标志(0正常 1已删除)',
+
+    PRIMARY KEY (id),
+    INDEX idx_tenant_id (tenant_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='xxx表';
+```
+
+### 2.2 SQL 文件存放位置
+
+| 类型 | 位置 |
+|------|------|
+| 系统表 | `script/sql/ry_vue_5.X.sql` |
+| 业务表 | `script/sql/` 目录下新建文件 |
+
+---
+
+## 🎯 第三步: 生成菜单 SQL
+
+### 3.1 菜单表结构
+
+```sql
+INSERT INTO sys_menu VALUES (
+    menu_id,        -- 菜单ID（唯一，从已有最大ID+10开始）
+    'menu_name',    -- 菜单名称（中文）
+    parent_id,      -- 父菜单ID（一级目录为0）
+    order_num,      -- 排序值
+    'path',         -- 路由地址
+    'component',    -- 组件路径
+    NULL,           -- 路由参数
+    '0',            -- 是否外链
+    '1',            -- 菜单状态
+    'menu_type',    -- 菜单类型（M目录 C菜单 F按钮）
+    '1',            -- 显示状态
+    '1',            -- 状态
+    'permission',   -- 权限标识符
+    'icon',         -- 菜单图标
+    103,            -- 创建部门
+    1,              -- 创建人
+    sysdate(),      -- 创建时间
+    NULL,           -- 更新人
+    NULL,           -- 更新时间
+    'remark'        -- 备注
+);
+```
+
+### 3.2 权限标识符命名规范
+
+| 操作 | 权限标识符 | 说明 |
+|------|-----------|------|
+| **列表** | `模块:功能:list` | `demo:xxx:list` |
+| **查询** | `模块:功能:query` | `demo:xxx:query` |
+| **新增** | `模块:功能:add` | `demo:xxx:add` |
+| **修改** | `模块:功能:edit` | `demo:xxx:edit` |
+| **删除** | `模块:功能:remove` | `demo:xxx:remove` |
+| **导出** | `模块:功能:export` | `demo:xxx:export` |
+
+### 3.3 完整菜单 SQL 示例
+
+```sql
+-- 功能菜单（二级菜单）
+INSERT INTO sys_menu VALUES (
+    3010, 'XXX管理', 2000, 10, 'xxx', 'demo/xxx/index',
+    NULL, '0', '1', 'C', '1', '1', 'demo:xxx:list', 'list',
+    103, 1, sysdate(), NULL, NULL, 'XXX管理菜单'
+);
+
+-- 按钮权限
+INSERT INTO sys_menu VALUES (3011, 'XXX查询', 3010, 1, '#', '', NULL, '0', '1', 'F', '1', '1', 'demo:xxx:query', '#', 103, 1, sysdate(), NULL, NULL, '');
+INSERT INTO sys_menu VALUES (3012, 'XXX新增', 3010, 2, '#', '', NULL, '0', '1', 'F', '1', '1', 'demo:xxx:add', '#', 103, 1, sysdate(), NULL, NULL, '');
+INSERT INTO sys_menu VALUES (3013, 'XXX修改', 3010, 3, '#', '', NULL, '0', '1', 'F', '1', '1', 'demo:xxx:edit', '#', 103, 1, sysdate(), NULL, NULL, '');
+INSERT INTO sys_menu VALUES (3014, 'XXX删除', 3010, 4, '#', '', NULL, '0', '1', 'F', '1', '1', 'demo:xxx:remove', '#', 103, 1, sysdate(), NULL, NULL, '');
+INSERT INTO sys_menu VALUES (3015, 'XXX导出', 3010, 5, '#', '', NULL, '0', '1', 'F', '1', '1', 'demo:xxx:export', '#', 103, 1, sysdate(), NULL, NULL, '');
+```
+
+---
+
+## 🔧 第四步: 生成后端代码（三层架构）
+
+### 4.1 代码生成顺序
+
+```
+1. Entity (实体类) → extends TenantEntity
+   ↓
+2. BO (业务对象) → @AutoMapper(target = Entity.class)
+   ↓
+3. VO (视图对象) → @AutoMapper(target = Entity.class)
+   ↓
+4. Mapper (接口) → extends BaseMapperPlus<Entity, Vo>
+   ↓
+5. Service 接口 → IXxxService
+   ↓
+6. Service 实现 → 包含 buildQueryWrapper()
+   ↓
+7. Controller → extends BaseController
+```
+
+### 4.2 后端包结构
+
+```
+ruoyi-modules/ruoyi-xxx/src/main/java/org/dromara/xxx/
+├── controller/
+│   └── XxxController.java          # @RestController
+├── service/
+│   ├── IXxxService.java            # 服务接口
+│   └── impl/
+│       └── XxxServiceImpl.java     # 服务实现（包含 buildQueryWrapper）
+├── mapper/
+│   └── XxxMapper.java              # extends BaseMapperPlus<Xxx, XxxVo>
+└── domain/
+    ├── Xxx.java                    # Entity（extends TenantEntity）
+    ├── bo/
+    │   └── XxxBo.java              # 业务对象（@AutoMapper）
+    └── vo/
+        └── XxxVo.java              # 视图对象
+```
+
+### 4.3 代码模板
+
+#### Entity（实体类）
+
+```java
+package org.dromara.xxx.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.common.tenant.core.TenantEntity;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("xxx_table")
+public class Xxx extends TenantEntity {
+
+    @TableId(value = "id")
+    private Long id;
+
+    private String xxxName;
+    private String status;
+}
+```
+
+#### BO（业务对象）
+
+```java
+package org.dromara.xxx.domain.bo;
+
+import io.github.linpeilie.annotations.AutoMapper;
+import jakarta.validation.constraints.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.xxx.domain.Xxx;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = Xxx.class, reverseConvertGenerate = false)  // ✅ 单数
+public class XxxBo extends BaseEntity {
+
+    @NotNull(message = "ID不能为空", groups = {EditGroup.class})
+    private Long id;
+
+    @NotBlank(message = "名称不能为空", groups = {AddGroup.class, EditGroup.class})
+    private String xxxName;
+
+    private String status;
+}
+```
+
+#### VO（视图对象）
+
+```java
+package org.dromara.xxx.domain.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import org.dromara.xxx.domain.Xxx;
+import java.io.Serializable;
+import java.util.Date;
+
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = Xxx.class)
+public class XxxVo implements Serializable {
+
+    @ExcelProperty(value = "ID")
+    private Long id;
+
+    @ExcelProperty(value = "名称")
+    private String xxxName;
+
+    @ExcelProperty(value = "状态")
+    private String status;
+
+    @ExcelProperty(value = "创建时间")
+    private Date createTime;
+}
+```
+
+#### Mapper（接口）
+
+```java
+package org.dromara.xxx.mapper;
+
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+import org.dromara.xxx.domain.Xxx;
+import org.dromara.xxx.domain.vo.XxxVo;
+
+public interface XxxMapper extends BaseMapperPlus<Xxx, XxxVo> {
+    // 继承 BaseMapperPlus，已提供 selectVoById、selectVoPage 等方法
+}
+```
+
+#### Service 接口
+
+```java
+package org.dromara.xxx.service;
+
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.xxx.domain.bo.XxxBo;
+import org.dromara.xxx.domain.vo.XxxVo;
+import java.util.Collection;
+import java.util.List;
+
+public interface IXxxService {
+
+    XxxVo queryById(Long id);
+
+    TableDataInfo<XxxVo> queryPageList(XxxBo bo, PageQuery pageQuery);
+
+    List<XxxVo> queryList(XxxBo bo);
+
+    Boolean insertByBo(XxxBo bo);
+
+    Boolean updateByBo(XxxBo bo);
+
+    Boolean deleteByIds(Collection<Long> ids);
+}
+```
+
+#### Service 实现（⭐ 核心：无 DAO 层）
+
+```java
+package org.dromara.xxx.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 lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+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.xxx.domain.Xxx;
+import org.dromara.xxx.domain.bo.XxxBo;
+import org.dromara.xxx.domain.vo.XxxVo;
+import org.dromara.xxx.mapper.XxxMapper;
+import org.dromara.xxx.service.IXxxService;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+@Service
+@RequiredArgsConstructor
+public class XxxServiceImpl implements IXxxService {
+
+    private final XxxMapper baseMapper;  // ✅ 直接注入 Mapper（无 DAO 层）
+
+    @Override
+    public XxxVo queryById(Long id) {
+        return baseMapper.selectVoById(id);
+    }
+
+    @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 List<XxxVo> queryList(XxxBo bo) {
+        return baseMapper.selectVoList(buildQueryWrapper(bo));
+    }
+
+    @Override
+    public Boolean insertByBo(XxxBo bo) {
+        Xxx add = MapstructUtils.convert(bo, Xxx.class);  // ✅ MapstructUtils 转换
+        return baseMapper.insert(add) > 0;
+    }
+
+    @Override
+    public Boolean updateByBo(XxxBo bo) {
+        Xxx update = MapstructUtils.convert(bo, Xxx.class);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    @Override
+    public Boolean deleteByIds(Collection<Long> ids) {
+        return baseMapper.deleteByIds(ids) > 0;
+    }
+
+    /**
+     * 构建查询条件（在 Service 层）
+     */
+    private LambdaQueryWrapper<Xxx> buildQueryWrapper(XxxBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<Xxx> lqw = Wrappers.lambdaQuery();
+        lqw.like(StringUtils.isNotBlank(bo.getXxxName()), Xxx::getXxxName, bo.getXxxName());
+        lqw.eq(StringUtils.isNotBlank(bo.getStatus()), Xxx::getStatus, bo.getStatus());
+        lqw.between(params.get("beginCreateTime") != null && params.get("endCreateTime") != null,
+            Xxx::getCreateTime, params.get("beginCreateTime"), params.get("endCreateTime"));
+        return lqw;
+    }
+}
+```
+
+#### Controller
+
+```java
+package org.dromara.xxx.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.RequiredArgsConstructor;
+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.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.xxx.domain.bo.XxxBo;
+import org.dromara.xxx.domain.vo.XxxVo;
+import org.dromara.xxx.service.IXxxService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import java.util.List;
+
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/xxx/xxx")
+public class XxxController extends BaseController {
+
+    private final IXxxService xxxService;
+
+    /**
+     * 查询列表
+     */
+    @SaCheckPermission("xxx:xxx:list")
+    @GetMapping("/list")
+    public TableDataInfo<XxxVo> list(XxxBo bo, PageQuery pageQuery) {
+        return xxxService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 获取详情
+     */
+    @SaCheckPermission("xxx:xxx:query")
+    @GetMapping("/{id}")
+    public R<XxxVo> getInfo(@NotNull(message = "ID不能为空") @PathVariable Long id) {
+        return R.ok(xxxService.queryById(id));
+    }
+
+    /**
+     * 新增
+     */
+    @SaCheckPermission("xxx:xxx:add")
+    @Log(title = "XXX管理", businessType = BusinessType.INSERT)
+    @PostMapping
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody XxxBo bo) {
+        return toAjax(xxxService.insertByBo(bo));
+    }
+
+    /**
+     * 修改
+     */
+    @SaCheckPermission("xxx:xxx:edit")
+    @Log(title = "XXX管理", businessType = BusinessType.UPDATE)
+    @PutMapping
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody XxxBo bo) {
+        return toAjax(xxxService.updateByBo(bo));
+    }
+
+    /**
+     * 删除
+     */
+    @SaCheckPermission("xxx:xxx:remove")
+    @Log(title = "XXX管理", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "ID不能为空") @PathVariable Long[] ids) {
+        return toAjax(xxxService.deleteByIds(List.of(ids)));
+    }
+
+    /**
+     * 导出
+     */
+    @SaCheckPermission("xxx:xxx:export")
+    @Log(title = "XXX管理", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(XxxBo bo, HttpServletResponse response) {
+        List<XxxVo> list = xxxService.queryList(bo);
+        ExcelUtil.exportExcel(list, "XXX数据", XxxVo.class, response);
+    }
+}
+```
+
+---
+
+## 🎯 第五步: 开发业务逻辑
+
+### 5.1 添加业务校验
+
+```java
+@Override
+public Boolean insertByBo(XxxBo bo) {
+    // 业务校验
+    if (isNameExists(bo.getXxxName())) {
+        throw new ServiceException("名称已存在");
+    }
+
+    Xxx add = MapstructUtils.convert(bo, Xxx.class);
+    return baseMapper.insert(add) > 0;
+}
+
+private boolean isNameExists(String name) {
+    return baseMapper.exists(Wrappers.<Xxx>lambdaQuery()
+        .eq(Xxx::getXxxName, name));
+}
+```
+
+### 5.2 添加事务管理
+
+```java
+@Transactional(rollbackFor = Exception.class)
+@Override
+public Boolean insertByBo(XxxBo bo) {
+    // 多表操作使用事务
+    Xxx add = MapstructUtils.convert(bo, Xxx.class);
+    boolean result = baseMapper.insert(add) > 0;
+
+    // 其他关联操作...
+
+    return result;
+}
+```
+
+---
+
+## 📋 开发流程检查清单
+
+### ✅ 表设计检查
+
+- [ ] 表前缀与模块对应
+- [ ] 主键使用雪花 ID（不用 AUTO_INCREMENT）
+- [ ] 包含 `tenant_id` 字段
+- [ ] 包含审计字段（create_dept、create_by、create_time、update_by、update_time）
+- [ ] 包含逻辑删除字段（del_flag）
+- [ ] 添加必要的索引
+
+### ✅ 后端代码检查
+
+- [ ] 包名是 `org.dromara.*`
+- [ ] Entity 继承 `TenantEntity`
+- [ ] BO 使用 `@AutoMapper`（单数）
+- [ ] Service 不继承任何基类
+- [ ] Service 直接注入 Mapper（无 DAO 层）
+- [ ] `buildQueryWrapper()` 在 Service 实现类中
+- [ ] 使用 `MapstructUtils.convert()` 转换对象
+- [ ] Mapper 继承 `BaseMapperPlus<Entity, VO>`
+- [ ] Controller 使用标准 RESTful 路径（/list、/{id}）
+- [ ] 使用 `@SaCheckPermission` 权限注解
+
+### ✅ 菜单 SQL 检查
+
+- [ ] 菜单 ID 不冲突
+- [ ] 权限标识符符合规范
+- [ ] 包含完整的权限按钮（list、query、add、edit、remove、export）
+
+---
+
+## ❌ 常见错误
+
+### 禁止的写法
+
+```java
+// ❌ 错误1: 注入 DAO（本项目没有 DAO 层）
+private final IXxxDao xxxDao;
+
+// ❌ 错误2: 使用 BeanUtils
+BeanUtil.copyProperties(bo, entity);
+
+// ❌ 错误3: Service 继承基类
+public class XxxServiceImpl extends ServiceImpl<XxxMapper, Xxx> { }
+
+// ❌ 错误4: 使用 @AutoMappers（复数）
+@AutoMappers({@AutoMapper(target = Xxx.class)})
+
+// ❌ 错误5: 错误的包名
+package com.ruoyi.xxx;
+package plus.ruoyi.xxx;
+
+// ❌ 错误6: 使用 AUTO_INCREMENT
+id BIGINT(20) AUTO_INCREMENT
+
+// ❌ 错误7: 错误的 API 路径
+@GetMapping("/pageXxxs")
+@GetMapping("/getXxx/{id}")
+```
+
+### 正确的写法
+
+```java
+// ✅ 正确1: 直接注入 Mapper
+private final XxxMapper baseMapper;
+
+// ✅ 正确2: 使用 MapstructUtils
+MapstructUtils.convert(bo, Xxx.class);
+
+// ✅ 正确3: Service 只实现接口
+public class XxxServiceImpl implements IXxxService { }
+
+// ✅ 正确4: 使用 @AutoMapper（单数）
+@AutoMapper(target = Xxx.class)
+
+// ✅ 正确5: 正确的包名
+package org.dromara.xxx;
+
+// ✅ 正确6: 使用雪花 ID
+id BIGINT(20) NOT NULL
+
+// ✅ 正确7: 标准 RESTful 路径
+@GetMapping("/list")
+@GetMapping("/{id}")
+```
+
+---
+
+## 📚 参考实现
+
+查看已有的完整实现：
+
+| 类型 | 参考文件 |
+|------|---------|
+| 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` |
+
+---
+
+## 🎯 总结
+
+**开发流程**：
+
+```
+1️⃣ 需求分析 → 明确功能、确定模块位置
+2️⃣ 表设计 → 雪花ID、租户ID、审计字段、逻辑删除
+3️⃣ 菜单SQL → 权限标识符规范
+4️⃣ 后端代码 → 三层架构（Controller → Service → Mapper）
+5️⃣ 业务逻辑 → 校验、事务、异常处理
+6️⃣ 测试验证 → 接口测试、功能测试
+```
+
+**核心原则**：
+
+- ✅ **包名是 `org.dromara.*`**
+- ✅ **三层架构，无 DAO 层**
+- ✅ **Service 直接注入 Mapper**
+- ✅ **buildQueryWrapper() 在 Service 层**
+- ✅ **使用 MapstructUtils.convert() 转换对象**
+- ✅ **主键使用雪花 ID**
+- ✅ **RESTful API 路径规范**