feat(slidev): update 3 4

2026-07-03 00:26:47 +08:00
parent 2fd8fc1f66
commit 6baa4cd10e
47 changed files with 1185 additions and 382 deletions
@@ -0,0 +1,59 @@
+# 业务交付验收清单
+
+本清单用于判断复杂业务模块是否达到可验收状态，适用于后台管理、审批流、运营系统、CRM、低代码二开和数据看板等项目。
+
+## 项目理解
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 能说明模块边界 | 说明模块负责什么、不负责什么 |  |
+| 能定位关键目录 | 能指出前端页面、API 层、后端入口、服务层和数据层位置 |  |
+| 能区分事实和推断 | 对没有源码依据的业务规则标注为推断或待确认 |  |
+| 能记录不确定点 | 不确定内容没有被包装成确定事实 |  |
+
+## 需求与接口
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 用户故事完整 | 覆盖主要角色、关键动作和限制条件 |  |
+| 非目标范围明确 | 明确本次不做的能力、数据迁移、生产部署或外部集成 |  |
+| 接口契约完整 | 覆盖列表、详情、新增、编辑、分配、状态、审计和看板 |  |
+| 失败场景明确 | 每个关键接口至少有权限、参数、状态或数据不存在失败场景 |  |
+| 验收方式明确 | 每个关键需求都有可执行检查方法 |  |
+
+## 权限与状态
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 权限矩阵完整 | 覆盖页面级、按钮级、接口级和数据范围 |  |
+| 权限字符合理 | 命名统一，并标注为建议或源码事实 |  |
+| 后端权限未缺失 | 没有用前端按钮隐藏替代后端接口控制 |  |
+| 状态流转表完整 | 覆盖初始态、处理中、确认/审核态、终态和驳回态 |  |
+| 非法流转明确 | 列出关键非法流转、拒绝原因和验收方式 |  |
+
+## 审计、异常态与看板
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 审计操作覆盖关键动作 | 创建、编辑、分配、状态流转、关闭/归档等关键动作被覆盖 |  |
+| 审计字段可追溯 | 包含 actor、action、targetId、oldValue、newValue、source |  |
+| 敏感信息处理 | oldValue/newValue 有脱敏说明 |  |
+| 异常态可测试 | 权限不足、重复提交、非法状态、数据不存在、并发修改均覆盖 |  |
+| 看板指标可计算 | 每个指标有口径、维度、过滤条件和数据来源建议 |  |
+
+## Review 与交付
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| Review 有证据 | 问题能回到路径、表格、接口、角色或业务规则 |  |
+| 风险按严重程度排序 | 高风险问题优先展示 |  |
+| 建议可行动 | 每条建议有修复方向和验收方式 |  |
+| 交付物齐全 | 设计表、Review 报告、验证记录和未闭环事项完整 |  |
+| 能沉淀资产 | 高频问题能转成规则、检查清单、Prompt、反例或 Skill |  |
+
+## 判定原则
+
+- 优先看证据，不优先看文字是否漂亮。
+- 优先看权限、状态、审计、异常态，不只看 CRUD。
+- 优先看不确定点是否被诚实标出。
+- 优先看结论能否被角色账号、接口请求、样例数据或浏览器操作验证。
@@ -2,12 +2,11 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 创建记录 | 创建工单后能查询审计记录 |  |
+| 创建记录 | 创建业务记录后能查询审计记录 |  |
 | 字段变更 | 编辑关键字段记录 oldValue/newValue |  |
-| 指派记录 | 指派负责人记录原负责人和新负责人 |  |
+| 分配记录 | 分配或转交记录原处理人和新处理人 |  |
 | 状态记录 | 状态流转记录原状态和新状态 |  |
 | 操作人 | actor_id 和 actor_name 可追溯 |  |
 | 来源 | source 或 request_id 可追溯 |  |
 | 脱敏 | 敏感字段不明文进入审计 |  |
 | 失败处理 | 操作失败不写成功审计 |  |
-
@@ -3,11 +3,10 @@
 | 异常态 | 必须验证 | 结果 |
 | --- | --- | --- |
 | 空列表 | 页面显示空状态，不报错 |  |
-| 详情不存在 | 提示工单不存在，页面不崩溃 |  |
+| 详情不存在 | 提示记录不存在，页面不崩溃 |  |
 | 权限不足 | 前端提示或隐藏，后端拒绝 |  |
 | 非法状态 | 返回非法流转，状态不变 |  |
 | 重复提交 | 只成功一次，只写一条有效审计 |  |
 | 参数缺失 | 返回参数错误，业务数据不变 |  |
 | 并发修改 | 拒绝覆盖或提示刷新 |  |
 | 看板无数据 | 图表显示空态，不显示假数据 |  |
-
@@ -2,11 +2,10 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 菜单权限 | 工单菜单只对授权角色可见 |  |
-| 按钮权限 | 新增、编辑、删除、指派、状态按钮按权限显示 |  |
+| 菜单权限 | 目标模块菜单只对授权角色可见 |  |
+| 按钮权限 | 新增、编辑、删除、分配、状态按钮按权限显示 |  |
 | 接口权限 | 无权限账号直接请求敏感接口失败 |  |
-| 数据权限 | 普通用户只能看到授权范围内工单 |  |
+| 数据权限 | 普通用户只能看到授权范围内数据 |  |
 | 权限字符 | 前端按钮、菜单配置、后端接口命名一致 |  |
 | 审计 | 权限敏感操作成功后有审计记录 |  |
-| 反例验证 | 无权限账号不能绕过前端执行删除/指派 |  |
-
+| 反例验证 | 无权限账号不能绕过前端执行删除/分配 |  |
@@ -6,7 +6,6 @@
 | 合法流转 | 状态流转表中的合法路径可执行 |  |
 | 非法流转 | 非法路径被拒绝且状态不变 |  |
 | 角色限制 | 不同角色只能执行被授权动作 |  |
-| 前置条件 | 驳回原因、关闭条件、负责人等校验完整 |  |
+| 前置条件 | 驳回原因、关闭条件、处理人、审批意见等校验完整 |  |
 | 审计日志 | 每次成功流转写审计 |  |
 | 重复提交 | 重复点击不会产生重复有效流转 |  |
-
@@ -2,11 +2,10 @@

 | 验收项 | 请求条件 | 通过标准 | 结果 |
 | --- | --- | --- | --- |
-| 默认查询 | 管理员默认条件 | 返回完整指标 |  |
+| 默认查询 | 管理员或授权角色默认条件 | 返回完整指标 |  |
 | 时间过滤 | 指定 start/end | 只统计时间范围内数据 |  |
-| 类型过滤 | 指定工单类型 | 只统计对应类型 |  |
+| 类型过滤 | 指定业务类型 | 只统计对应类型 |  |
 | 空数据 | 无匹配条件 | 返回 0 或空集合 |  |
 | 无权限 | 未授权账号 | 返回 403 或业务拒绝 |  |
 | 数据范围 | 普通角色 | 只返回授权范围 |  |
 | 指标一致性 | 固定样例数据 | 与手工计算一致 |  |
-
@@ -1,9 +1,11 @@
 # 阶段 Review Prompt

 ```text
-请对 JeecgBoot 工单模块阶段交付物做 Review。
+请对目标业务模块阶段交付物做 Review。

 输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
 - RBAC 权限矩阵
 - 权限控制方案
 - 状态流转表
@@ -26,5 +28,5 @@
 约束：
 - 不要只说整体不错。
 - 不要直接改代码。
+- 不要把示例模块、示例角色或示例接口当成目标项目事实。
 ```
-
@@ -15,7 +15,7 @@

 | 等级 | 模块 | 问题 | 触发规则 | 风险 | 修复建议 | 验收 |
 | --- | --- | --- | --- | --- | --- | --- |
-| P1 | 权限 | 删除接口只隐藏按钮，后端缺少权限校验 | 前端按钮不是安全边界 | 可绕过前端删除工单 | 后端补权限校验 | 无权限账号请求返回 403 |
+| P1 | 权限 | 敏感操作只做前端按钮隐藏，后端缺少权限校验 | 前端按钮不是安全边界 | 可绕过前端直接调用接口完成高风险操作 | 后端补权限校验和数据范围校验 | 无权限账号直接请求返回 403 或业务拒绝 |

 ## 不确定点

@@ -25,4 +25,3 @@
 ## 结论

 通过 / 有条件通过 / 不通过
-
@@ -1,71 +0,0 @@
-# 验收清单
-
-本清单用于判断学员是否真正掌握 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。
- 优先看不确定点是否被诚实标出。
- 优先看能否复用到团队资产库。
- 对没有依据的自信结论扣分。
-