# 验收清单

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