feat：update 3 4
This commit is contained in:
smart
@@ -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 拒绝 |
|
||||
| 审计 | 关键操作有日志记录方案 |
|
||||
| 事务 | 多表或多步骤写入说明事务 |
|
||||
|
||||
@@ -0,0 +1,33 @@
|
||||
# 交付规则
|
||||
|
||||
## 交付前必须准备
|
||||
|
||||
1. 需求拆解表。
|
||||
2. 接口契约表。
|
||||
3. 权限矩阵。
|
||||
4. 状态流转表和非法流转清单。
|
||||
5. 审计日志 SOP。
|
||||
6. 异常态清单。
|
||||
7. 看板指标字典。
|
||||
8. Review 报告。
|
||||
9. 修复记录。
|
||||
|
||||
## PR 或阶段交付说明必须包含
|
||||
|
||||
- 背景和目标。
|
||||
- 修改范围。
|
||||
- 不做什么。
|
||||
- 关键设计。
|
||||
- 测试和验收结果。
|
||||
- 风险和回滚建议。
|
||||
- AI 辅助使用记录。
|
||||
|
||||
## 输出验收
|
||||
|
||||
| 检查项 | 通过标准 |
|
||||
| --- | --- |
|
||||
| 范围 | 修改范围和非目标范围明确 |
|
||||
| 证据 | 关键结论有源码或表格依据 |
|
||||
| 验收 | 每个风险点有验证动作 |
|
||||
| 资产 | 可复用内容已归档到资产库 |
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
# 前端规则
|
||||
|
||||
## 适用范围
|
||||
|
||||
Vue3、Vite、Pinia、路由、API 请求、页面状态、按钮权限、看板和表单。
|
||||
|
||||
## JeecgBoot 前端约束
|
||||
|
||||
1. 路径别名优先使用 `/@/`，不要随意引入新的 alias。
|
||||
2. API 请求必须复用项目请求层 `defHttp`，不要在页面中直接创建独立 axios 实例。
|
||||
3. 用户、权限、动态路由相关状态优先查 Pinia store。
|
||||
4. 新增页面必须考虑 loading、empty、error、forbidden 状态。
|
||||
5. 按钮权限不能作为安全边界，必须同步检查后端接口权限。
|
||||
6. 字典字段优先复用项目已有字典组件或工具，不在页面硬编码中文枚举。
|
||||
7. 表单提交必须考虑防重复提交、接口失败和参数校验反馈。
|
||||
|
||||
## 输出验收
|
||||
|
||||
| 检查项 | 通过标准 |
|
||||
| --- | --- |
|
||||
| API 层 | 页面没有绕过 `defHttp` |
|
||||
| 权限 | 页面按钮和后端接口都被检查 |
|
||||
| 状态 | loading、empty、error、forbidden 齐全 |
|
||||
| 字典 | 状态、优先级、类型不硬编码 |
|
||||
| 验证 | 给出浏览器或接口验收动作 |
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
# 全局 AI 协作规则
|
||||
|
||||
## 适用范围
|
||||
|
||||
所有 TRAE 辅助分析、设计、编码、测试、Review 和文档任务。
|
||||
|
||||
## 必须遵守
|
||||
|
||||
1. 输出必须区分“事实依据、推断、建议、不确定点、下一步验证”。
|
||||
2. 项目事实必须标注文件、函数、接口、配置、日志或数据来源。
|
||||
3. 修改代码前必须先说明目标、范围、不做什么、影响文件、风险和验收方式。
|
||||
4. 复杂任务必须先生成 Plan，经人工确认后再进入修改。
|
||||
5. 不允许凭框架印象替代当前项目源码依据。
|
||||
6. 不允许删除历史逻辑，除非先说明影响范围和回滚方案。
|
||||
7. 不确定内容必须显式写入“不确定点”，不得包装成确定结论。
|
||||
|
||||
## 输出验收
|
||||
|
||||
| 检查项 | 通过标准 |
|
||||
| --- | --- |
|
||||
| 事实依据 | 每个关键结论能回到路径或代码 |
|
||||
| 推断 | 标注为什么是推断 |
|
||||
| 建议 | 有可执行下一步 |
|
||||
| 不确定点 | 明确需要谁确认或怎么验证 |
|
||||
| 验收方式 | 能由人或命令复核 |
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
# 安全规则
|
||||
|
||||
## 必须禁止
|
||||
|
||||
1. 不允许提交密钥、Token、账号、密码、内网地址和真实租户 ID。
|
||||
2. 不允许在代码中硬编码生产环境地址。
|
||||
3. 不允许把前端按钮隐藏当作接口安全。
|
||||
4. 不允许在审计日志中明文记录敏感字段。
|
||||
5. 不允许让 AI 自行决定真实角色权限边界。
|
||||
|
||||
## 权限任务要求
|
||||
|
||||
权限相关输出必须覆盖：
|
||||
|
||||
- 页面是否可见。
|
||||
- 按钮是否可操作。
|
||||
- 接口是否可访问。
|
||||
- 数据范围是否受限。
|
||||
- 无权限访问如何验收。
|
||||
|
||||
## 输出验收
|
||||
|
||||
| 检查项 | 通过标准 |
|
||||
| --- | --- |
|
||||
| 敏感信息 | 输出未包含真实密钥或账号 |
|
||||
| 接口安全 | 后端权限校验被明确设计 |
|
||||
| 审计脱敏 | oldValue/newValue 有脱敏规则 |
|
||||
| 权限决策 | 标注待业务方确认 |
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# 测试规则
|
||||
|
||||
## 测试覆盖要求
|
||||
|
||||
每个功能至少覆盖：
|
||||
|
||||
1. 正常流。
|
||||
2. 异常流。
|
||||
3. 权限流。
|
||||
4. 状态流。
|
||||
5. 边界值。
|
||||
|
||||
## JeecgBoot 工单重点测试
|
||||
|
||||
| 类型 | 必测场景 |
|
||||
| --- | --- |
|
||||
| 权限 | 无权限账号直接请求删除/指派/关闭接口 |
|
||||
| 状态 | closed -> processing 等非法流转 |
|
||||
| 审计 | 编辑、指派、状态流转是否写审计 |
|
||||
| 异常态 | 工单不存在、重复提交、参数缺失 |
|
||||
| 看板 | 空数据、无权限、过滤条件、指标口径 |
|
||||
|
||||
## 输出验收
|
||||
|
||||
测试建议必须包含：
|
||||
|
||||
- 输入条件。
|
||||
- 操作步骤。
|
||||
- 预期结果。
|
||||
- 验证证据。
|
||||
- 不确定点。
|
||||
|
||||
Reference in New Issue
Block a user