docs: 更新TRA编程培训课程材料、课件与AI技能交付包

- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
2026-08-08 11:00:36 +08:00
parent e7d6db93c3
commit 67837df8d0
169 changed files with 6618 additions and 2887 deletions
@@ -2,7 +2,7 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 创建记录 | 创建工单后能查询审计记录 |  |
+| 创建记录 | 创建业务对象后能查询审计记录 |  |
 | 字段变更 | 编辑关键字段记录 oldValue/newValue |  |
 | 指派记录 | 指派负责人记录原负责人和新负责人 |  |
 | 状态记录 | 状态流转记录原状态和新状态 |  |
@@ -3,7 +3,7 @@
 | 异常态 | 必须验证 | 结果 |
 | --- | --- | --- |
 | 空列表 | 页面显示空状态，不报错 |  |
-| 详情不存在 | 提示工单不存在，页面不崩溃 |  |
+| 详情不存在 | 提示业务对象不存在，页面不崩溃 |  |
 | 权限不足 | 前端提示或隐藏，后端拒绝 |  |
 | 非法状态 | 返回非法流转，状态不变 |  |
 | 重复提交 | 只成功一次，只写一条有效审计 |  |
@@ -2,10 +2,10 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 菜单权限 | 工单菜单只对授权角色可见 |  |
+| 菜单权限 | 业务对象菜单只对授权角色可见 |  |
 | 按钮权限 | 新增、编辑、删除、指派、状态按钮按权限显示 |  |
 | 接口权限 | 无权限账号直接请求敏感接口失败 |  |
-| 数据权限 | 普通用户只能看到授权范围内工单 |  |
+| 数据权限 | 普通用户只能看到授权范围内业务对象 |  |
 | 权限字符 | 前端按钮、菜单配置、后端接口命名一致 |  |
 | 审计 | 权限敏感操作成功后有审计记录 |  |
 | 反例验证 | 无权限账号不能绕过前端执行删除/指派 |  |
@@ -4,7 +4,7 @@
 | --- | --- | --- | --- |
 | 默认查询 | 管理员默认条件 | 返回完整指标 |  |
 | 时间过滤 | 指定 start/end | 只统计时间范围内数据 |  |
-| 类型过滤 | 指定工单类型 | 只统计对应类型 |  |
+| 类型过滤 | 指定业务对象类型 | 只统计对应类型 |  |
 | 空数据 | 无匹配条件 | 返回 0 或空集合 |  |
 | 无权限 | 未授权账号 | 返回 403 或业务拒绝 |  |
 | 数据范围 | 普通角色 | 只返回授权范围 |  |
@@ -1,7 +1,7 @@
-# 阶段 Review Prompt
+# 阶段 Review 任务上下文契约

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

 输入材料：
 - RBAC 权限矩阵
@@ -15,7 +15,7 @@

 | 等级 | 模块 | 问题 | 触发规则 | 风险 | 修复建议 | 验收 |
 | --- | --- | --- | --- | --- | --- | --- |
-| P1 | 权限 | 删除接口只隐藏按钮，后端缺少权限校验 | 前端按钮不是安全边界 | 可绕过前端删除工单 | 后端补权限校验 | 无权限账号请求返回 403 |
+| P1 | 权限 | 删除接口只隐藏按钮，后端缺少权限校验 | 前端按钮不是安全边界 | 可绕过前端删除业务对象 | 后端补权限校验 | 无权限账号请求返回 403 |

 ## 不确定点

@@ -1,71 +1,35 @@
-# 验收清单
+# 业务交付验收清单

-本清单用于判断学员是否真正掌握 JeecgBoot 工单案例，而不是只复制了 TRAE 输出。建议讲师在小组展示时逐项打分。
+本清单用于审查一个业务模块的设计、代码或 PR 是否具备可交付证据。它不替代目标项目的实际规则、接口规范或测试要求。

 ## 项目理解

 | 检查项 | 通过标准 | 结果 |
-| --- | --- | --- |
-| 能说明 JeecgBoot 前后端目录 | 至少指出 `jeecg-boot`、`jeecgboot-vue3`、`docs/project-knowledge` 的用途 |  |
-| 能定位后端入口 | 能指出 `JeecgSystemApplication.java` 和后端启动模块 |  |
-| 能定位前端入口 | 能指出 `src/main.ts`、路由、Pinia 和 API 请求层 |  |
-| 能区分事实和推断 | 对没有源码依据的业务规则标注为推断或待确认 |  |
-| 能记录不确定点 | 不确定内容没有被包装成确定事实 |  |
+|---|---|---|
+| 模块边界明确 | 已定位前后端入口、接口、数据模型和必要配置 |  |
+| 事实与推断分开 | 每个非显然结论能够回到源码、日志、配置或规范 |  |
+| 待确认项明确 | 无证据内容没有被包装成确定事实 |  |

-## 需求与接口
+## 改动边界

 | 检查项 | 通过标准 | 结果 |
-| --- | --- | --- |
-| 用户故事完整 | 覆盖管理员、负责人、研发、测试、只读用户 |  |
-| 非目标范围明确 | 明确课堂不做完整编码、生产部署、真实数据迁移 |  |
-| 接口契约完整 | 覆盖列表、详情、新增、编辑、指派、状态、审计、看板 |  |
-| 失败场景明确 | 每个关键接口至少有权限、参数、状态或数据不存在失败场景 |  |
-| 验收方式明确 | 每个关键需求都有可执行检查方法 |  |
+|---|---|---|
+| 目标与非目标明确 | 说明本次解决的问题及明确不修改的相邻范围 |  |
+| 关键风险已识别 | 权限、状态、审计、异常、数据范围和兼容性按需核对 |  |
+| 最小改动可解释 | 关键规则有权威入口，未引入无关重构 |  |

-## 权限与状态
+## 验证与交付

 | 检查项 | 通过标准 | 结果 |
-| --- | --- | --- |
-| 权限矩阵完整 | 覆盖页面级、按钮级、接口级和数据范围 |  |
-| 权限字符合理 | 命名统一，并标注为建议而非源码事实 |  |
-| 后端权限未缺失 | 没有用前端按钮隐藏替代后端接口控制 |  |
-| 状态流转表完整 | 覆盖新建、处理中、待验证、已关闭、已驳回 |  |
-| 非法流转明确 | 至少列出 5 条非法流转和拒绝原因 |  |
+|---|---|---|
+| 验证覆盖匹配风险 | 正常、异常、权限、状态与边界场景按实际风险设计 |  |
+| 执行结果如实记录 | 已执行命令、CI、日志或人工观察可复核；未执行项明确列出 |  |
+| PR 或变更说明完整 | 包含目标、实现范围、验证证据和已知边界 |  |
+| 资产沉淀有依据 | 仅将可复用且已验证的判断沉淀为 Rule、任务上下文契约、检查单、Skill 或 MCP 契约 |  |

-## 审计、异常态与看板
-
-| 检查项 | 通过标准 | 结果 |
-| --- | --- | --- |
-| 审计操作覆盖关键动作 | 创建、编辑、指派、状态流转、关闭、评论至少覆盖 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。
- 优先看不确定点是否被诚实标出。
- 优先看能否复用到团队资产库。
- 对没有依据的自信结论扣分。
+## 判定原则

+- 优先审查证据与边界，不以篇幅或术语数量判断质量。
+- 前端隐藏或必填不能替代后端权限和业务状态保护。
+- 局部测试、CI 通过和源码阅读分别只支撑相应范围的结论。
+- 发生资产变更时，补充行为、引用、兼容性和夹具验证证据。