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,28 @@
+# AI Review 报告模板
+
+## Review 输入
+
+- PR diff：
+- 需求说明：
+- rules：
+- 测试结果：
+- 历史问题：
+
+## 结论
+
+通过 / 有条件通过 / 不通过
+
+## 问题清单
+
+| 等级 | 文件/模块 | 问题 | 触发规则 | 风险 | 建议 | 测试/验收 |
+| --- | --- | --- | --- | --- | --- | --- |
+
+## 不确定点
+
+| 不确定点 | 需要谁确认 | 验证方式 |
+| --- | --- | --- |
+
+## 是否建议合入
+
+说明理由。
+
@@ -0,0 +1,13 @@
+# 审计日志检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 创建记录 | 创建工单后能查询审计记录 |  |
+| 字段变更 | 编辑关键字段记录 oldValue/newValue |  |
+| 指派记录 | 指派负责人记录原负责人和新负责人 |  |
+| 状态记录 | 状态流转记录原状态和新状态 |  |
+| 操作人 | actor_id 和 actor_name 可追溯 |  |
+| 来源 | source 或 request_id 可追溯 |  |
+| 脱敏 | 敏感字段不明文进入审计 |  |
+| 失败处理 | 操作失败不写成功审计 |  |
+
@@ -0,0 +1,13 @@
+# 异常态检查清单
+
+| 异常态 | 必须验证 | 结果 |
+| --- | --- | --- |
+| 空列表 | 页面显示空状态，不报错 |  |
+| 详情不存在 | 提示工单不存在，页面不崩溃 |  |
+| 权限不足 | 前端提示或隐藏，后端拒绝 |  |
+| 非法状态 | 返回非法流转，状态不变 |  |
+| 重复提交 | 只成功一次，只写一条有效审计 |  |
+| 参数缺失 | 返回参数错误，业务数据不变 |  |
+| 并发修改 | 拒绝覆盖或提示刷新 |  |
+| 看板无数据 | 图表显示空态，不显示假数据 |  |
+
@@ -0,0 +1,12 @@
+# 权限上线前检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 菜单权限 | 工单菜单只对授权角色可见 |  |
+| 按钮权限 | 新增、编辑、删除、指派、状态按钮按权限显示 |  |
+| 接口权限 | 无权限账号直接请求敏感接口失败 |  |
+| 数据权限 | 普通用户只能看到授权范围内工单 |  |
+| 权限字符 | 前端按钮、菜单配置、后端接口命名一致 |  |
+| 审计 | 权限敏感操作成功后有审计记录 |  |
+| 反例验证 | 无权限账号不能绕过前端执行删除/指派 |  |
+
@@ -0,0 +1,12 @@
+# 状态流转检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 状态枚举 | 所有状态有统一枚举或字典 |  |
+| 合法流转 | 状态流转表中的合法路径可执行 |  |
+| 非法流转 | 非法路径被拒绝且状态不变 |  |
+| 角色限制 | 不同角色只能执行被授权动作 |  |
+| 前置条件 | 驳回原因、关闭条件、负责人等校验完整 |  |
+| 审计日志 | 每次成功流转写审计 |  |
+| 重复提交 | 重复点击不会产生重复有效流转 |  |
+
@@ -0,0 +1,13 @@
+# 看板指标口径检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 指标含义 | 每个指标有业务解释 |  |
+| 计算口径 | 每个指标有公式或筛选条件 |  |
+| 时间范围 | 明确按创建时间、关闭时间还是更新时间统计 |  |
+| 数据范围 | 不同角色的数据范围清楚 |  |
+| 空数据 | 空数据展示为 0 或空态，不误导 |  |
+| 分组一致性 | 分组总和能和总数对齐 |  |
+| 权限 | 无看板权限不能访问接口 |  |
+| 验收证据 | 至少有一组样例数据手工校验 |  |
+
@@ -0,0 +1,12 @@
+# 看板接口验收清单
+
+| 验收项 | 请求条件 | 通过标准 | 结果 |
+| --- | --- | --- | --- |
+| 默认查询 | 管理员默认条件 | 返回完整指标 |  |
+| 时间过滤 | 指定 start/end | 只统计时间范围内数据 |  |
+| 类型过滤 | 指定工单类型 | 只统计对应类型 |  |
+| 空数据 | 无匹配条件 | 返回 0 或空集合 |  |
+| 无权限 | 未授权账号 | 返回 403 或业务拒绝 |  |
+| 数据范围 | 普通角色 | 只返回授权范围 |  |
+| 指标一致性 | 固定样例数据 | 与手工计算一致 |  |
+
@@ -0,0 +1,30 @@
+# 阶段 Review Prompt
+
+```text
+请对 JeecgBoot 工单模块阶段交付物做 Review。
+
+输入材料：
+- RBAC 权限矩阵
+- 权限控制方案
+- 状态流转表
+- 非法流转清单
+- 审计日志 SOP
+- 异常态清单
+- 看板指标字典
+- 看板接口验收记录
+- 测试结果或验证记录
+
+输出表格：
+等级 | 模块 | 问题 | 触发规则 | 风险 | 修复建议 | 验收
+
+要求：
+1. 问题按 P0/P1/P2/P3 分级。
+2. 每个问题必须说明触发了哪条规则。
+3. 每条建议必须有验收方式。
+4. 输出不确定点和需要人工确认的内容。
+
+约束：
+- 不要只说整体不错。
+- 不要直接改代码。
+```
+
@@ -0,0 +1,28 @@
+# 阶段 Review 报告
+
+## Review 输入
+
+- RBAC 权限矩阵：
+- 权限控制方案：
+- 状态流转表：
+- 非法流转清单：
+- 审计日志 SOP：
+- 异常态清单：
+- 看板指标字典：
+- 看板接口验收记录：
+
+## 问题清单
+
+| 等级 | 模块 | 问题 | 触发规则 | 风险 | 修复建议 | 验收 |
+| --- | --- | --- | --- | --- | --- | --- |
+| P1 | 权限 | 删除接口只隐藏按钮，后端缺少权限校验 | 前端按钮不是安全边界 | 可绕过前端删除工单 | 后端补权限校验 | 无权限账号请求返回 403 |
+
+## 不确定点
+
+| 不确定点 | 影响 | 需要谁确认 |
+| --- | --- | --- |
+
+## 结论
+
+通过 / 有条件通过 / 不通过
+
@@ -0,0 +1,71 @@
+# 验收清单
+
+本清单用于判断学员是否真正掌握 JeecgBoot 工单案例，而不是只复制了 TRAE 输出。建议讲师在小组展示时逐项打分。
+
+## 项目理解
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 能说明 JeecgBoot 前后端目录 | 至少指出 `jeecg-boot`、`jeecgboot-vue3`、`docs/project-knowledge` 的用途 |  |
+| 能定位后端入口 | 能指出 `JeecgSystemApplication.java` 和后端启动模块 |  |
+| 能定位前端入口 | 能指出 `src/main.ts`、路由、Pinia 和 API 请求层 |  |
+| 能区分事实和推断 | 对没有源码依据的业务规则标注为推断或待确认 |  |
+| 能记录不确定点 | 不确定内容没有被包装成确定事实 |  |
+
+## 需求与接口
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 用户故事完整 | 覆盖管理员、负责人、研发、测试、只读用户 |  |
+| 非目标范围明确 | 明确课堂不做完整编码、生产部署、真实数据迁移 |  |
+| 接口契约完整 | 覆盖列表、详情、新增、编辑、指派、状态、审计、看板 |  |
+| 失败场景明确 | 每个关键接口至少有权限、参数、状态或数据不存在失败场景 |  |
+| 验收方式明确 | 每个关键需求都有可执行检查方法 |  |
+
+## 权限与状态
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 权限矩阵完整 | 覆盖页面级、按钮级、接口级和数据范围 |  |
+| 权限字符合理 | 命名统一，并标注为建议而非源码事实 |  |
+| 后端权限未缺失 | 没有用前端按钮隐藏替代后端接口控制 |  |
+| 状态流转表完整 | 覆盖新建、处理中、待验证、已关闭、已驳回 |  |
+| 非法流转明确 | 至少列出 5 条非法流转和拒绝原因 |  |
+
+## 审计、异常态与看板
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 审计操作覆盖关键动作 | 创建、编辑、指派、状态流转、关闭、评论至少覆盖 5 类 |  |
+| 审计字段可追溯 | 包含 actor、action、targetId、oldValue、newValue、source |  |
+| 敏感信息处理 | oldValue/newValue 有脱敏说明 |  |
+| 异常态可测试 | 权限不足、重复提交、非法状态、数据不存在、并发修改均覆盖 |  |
+| 看板指标可计算 | 每个指标有口径、维度、过滤条件和数据来源建议 |  |
+
+## Review 与交付
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| Review 有证据 | 问题能回到路径、表格或业务规则 |  |
+| 风险按严重程度排序 | 高风险问题优先展示 |  |
+| 建议可行动 | 每条建议有修复方向和验收方式 |  |
+| 交付物齐全 | [worksheets.md](./worksheets.md) 中最终交付记录完整 |  |
+| 能沉淀资产 | 能说明哪些内容进入 [assets-index.md](./assets-index.md) 的资产库 |  |
+
+## 评分建议
+
+| 等级 | 分数 | 描述 |
+| --- | ---: | --- |
+| A | 90-100 | 依据充分，设计完整，风险清楚，验收可执行 |
+| B | 75-89 | 主链路完整，少量不确定点或验收细节不足 |
+| C | 60-74 | 有基本产出，但权限、状态、审计或异常态明显薄弱 |
+| D | 0-59 | 泛泛总结项目，缺少源码依据或无法验收 |
+
+## 讲师判定原则
+
+- 优先看证据，不优先看文字是否漂亮。
+- 优先看权限、状态、审计、异常态，不只看 CRUD。
+- 优先看不确定点是否被诚实标出。
+- 优先看能否复用到团队资产库。
+- 对没有依据的自信结论扣分。
+