smart
28 lines
1.0 KiB
Markdown
28 lines
1.0 KiB
Markdown
# 后端规则
|
|
|
|
## 适用范围
|
|
|
|
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 拒绝 |
|
|
| 审计 | 关键操作有日志记录方案 |
|
|
| 事务 | 多表或多步骤写入说明事务 |
|
|
|