feat：update 3 4

2026-07-02 10:04:32 +08:00
parent 604e7e68d7
commit 2fd8fc1f66
224 changed files with 12369 additions and 9 deletions
@@ -0,0 +1,27 @@
+# 后端规则
+
+## 适用范围
+
+Spring Boot、Controller、Service、Mapper、权限注解、事务、审计、状态流转。
+
+## JeecgBoot 后端约束
+
+1. 后端二开必须遵守 `update-begin` / `update-end` 修改痕迹规则。
+2. Controller 返回统一使用项目已有 `Result<T>` 风格。
+3. 查询优先复用项目已有 QueryWrapper/QueryGenerator 约定。
+4. 权限敏感接口必须有后端权限校验，不能只依赖前端按钮隐藏。
+5. 状态流转必须在 Service 层集中校验，不能只在前端限制。
+6. 删除、关闭、指派、状态变更必须考虑审计日志。
+7. 参数校验失败、数据不存在、非法状态、权限不足必须有明确响应。
+8. 涉及多步写入时必须说明事务边界。
+
+## 输出验收
+
+| 检查项 | 通过标准 |
+| --- | --- |
+| 修改痕迹 | 新增/修改代码块有 update 注释 |
+| 权限 | 无权限账号请求接口被拒绝 |
+| 状态 | 非法流转被 Service 拒绝 |
+| 审计 | 关键操作有日志记录方案 |
+| 事务 | 多表或多步骤写入说明事务 |
+