# 模块 7：阶段代码审查与修复

<div class="mt-6 text-sm">

工单模块改动涉及权限、状态、审计、异常和看板，必须做阶段 Review。

</div>

<div class="grid grid-cols-2 gap-4 mt-8 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">权限是否闭环</div>
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">状态流转是否完整</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">审计日志是否可查</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">异常态是否覆盖</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">看板口径是否清楚</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">测试是否覆盖关键路径</div>
</div>

<!--
Review 的重点不是格式，也不是变量名。
第四天 Review 要检查业务闭环：权限、状态、审计、异常、看板和测试。
-->

---

# AI Review 输入

<div class="mt-5 text-sm">

| 输入材料 | 用途 |
|---|---|
| 当天 diff | 看实际修改 |
| RBAC 权限矩阵 | 判断权限是否正确 |
| 状态流转表 | 判断合法和非法路径 |
| 审计日志 SOP | 判断是否可追溯 |
| 异常态清单 | 判断防御性逻辑 |
| 看板指标字典 | 判断统计口径 |
| 测试结果 | 判断是否可验收 |

</div>

<!--
AI Review 不能只给 diff。
如果不给业务产物，AI 很难判断代码是否符合业务规则。
-->

---

# 复杂业务控制面的三个 Skill

<div class="mt-5 text-xs">

| Skill | 什么时候用 | 输入材料 | 输出产物 |
|---|---|---|---|
| design-complex-business-module | 开始写代码前 | 需求、项目规则、现有角色/API/表结构 | RBAC、权限方案、状态表、审计 SOP、异常清单、指标字典 |
| review-business-delivery | 阶段 Review 时 | diff、业务产物、测试结果、验收记录 | 问题清单、证据缺口、待确认项 |
| track-review-fix-loop | 修 Review 后 | Review 报告、修改文件、验证证据 | 修复记录、未闭环事项、资产更新建议 |

</div>

<div class="mt-4 p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">
Skill 负责流程和质量门禁；rule 负责长期约束；template/checklist 负责稳定输出。
</div>

<!--
这里把 Skill 放在阶段 Review 前后承接处。
前三天讲过 Skill 的概念，第四天要让学员看到具体怎么用。
design-complex-business-module 用在开工前，review-business-delivery 用在阶段审查，track-review-fix-loop 用在修复闭环。
这三个 Skill 串起来，正好覆盖复杂业务从设计、审查到沉淀资产的全过程。
-->

---

# design-complex-business-module 怎么用

<div class="mt-5 text-xs">

```md
请使用 design-complex-business-module，基于 JeecgBoot 工单模块设计复杂业务控制面。

输入材料：
1. 需求范围：工单权限、状态流转、审计、异常态、看板。
2. 项目规则：security-permission、state-audit、testing、delivery。
3. 现有证据：角色、菜单权限、接口、数据表、相似模块。

输出必须包含：
RBAC 权限矩阵、权限控制方案、状态流转表、非法流转清单、
审计日志 SOP、异常态清单、看板指标字典、看板接口验收记录。

要求：
没有源码或配置证据的内容标记为“建议”或“待确认”。
```

</div>

<!--
这个 Skill 的重点是“先设计控制面，再设计代码”。
它不是让 AI 直接写实现，而是先把权限、状态、审计、异常态、看板和验收资产凑齐。
课堂里可以让学员用它生成第一版产物，再由主讲人结合已读源码补业务确认。
-->

---

# 阶段 Review 报告

<div class="mt-5 text-xs">

| 等级 | 模块 | 问题 | 风险 | 修复建议 | 验收 |
|---|---|---|---|---|---|
| P1 | 权限 | 删除接口只隐藏按钮，后端缺少校验 | 可绕过前端删除工单 | 补后端权限校验 | 无权限请求返回 403 |
| P1 | 状态 | closed 工单仍可重新处理 | 关闭状态失效 | 禁止 closed -> processing | 接口返回非法状态 |
| P2 | 审计 | 指派未记录前后值 | 难以追踪责任 | 记录 old/new assignee | 详情页日志可查 |
| P2 | 看板 | 平均关闭周期口径不清 | 管理判断失真 | 明确 create_time 到 close_time | 指标字典更新 |

</div>

<!--
Review 输出必须结构化。
每个问题要有等级、模块、风险、修复建议和验收方式。
-->

---

# review-business-delivery 怎么用

<div class="mt-5 text-xs">

```md
请使用 review-business-delivery 对本次工单模块改动做阶段 Review。

输入材料：
- 当天 diff 或修改文件清单
- RBAC 权限矩阵和权限控制方案
- 状态流转表和非法流转清单
- 审计日志 SOP 和异常态清单
- 看板指标字典和接口验收记录
- 测试命令、接口响应、浏览器验证或手工验收记录

输出格式：
先列问题清单，按 P0/P1/P2/P3 排序；
每个问题必须有证据、风险、修复建议和验收方式；
缺少证据时单独列“证据缺口”，不要猜测。
```

</div>

<!--
Review Skill 的作用是防止 AI 只做代码风格点评。
第四天 Review 必须把业务产物和代码 diff 一起看，否则无法判断权限是否闭环、状态是否非法、审计是否可查、指标口径是否正确。
-->

---

# 修复记录

<div class="mt-5 text-xs">

| Review 编号 | 问题 | 是否成立 | 修改说明 | 验证结果 | 资产沉淀 |
|---|---|---|---|---|---|
| R01 | 删除接口缺少权限校验 | 是 | 增加后端权限校验 | 无权限请求被拒绝 | 权限检查清单 |
| R02 | closed 可重新处理 | 是 | 补非法流转校验 | 状态不变 | 状态流转检查清单 |
| R03 | 看板关闭周期口径不清 | 是 | 明确指标口径 | 指标说明已更新 | 看板口径清单 |

</div>

<!--
Review 不是结束。
每个问题都要判断是否成立、记录修改说明、验证结果和是否沉淀资产。
-->

---

# track-review-fix-loop 怎么用

<div class="mt-5 text-xs">

```md
请使用 track-review-fix-loop，把阶段 Review 问题转成修复闭环记录。

输入材料：
- 带编号的 Review 报告
- 修改文件或产物
- 测试输出、接口响应、浏览器截图或手工验收步骤
- 现有 rules、checklists、prompts、examples、skills 目录

每个问题状态只能是：
成立-已修复 / 成立-暂不修复 / 不成立 / 需确认 / 未闭环

输出必须包含：
修复记录、未闭环事项、资产更新建议。
资产类型从 rule、checklist、prompt、command、skill、example 中选择。
```

</div>

<!--
修复闭环 Skill 对应第四天最后的资产沉淀。
它要求每个问题不能只写“已修复”，必须有证据和状态。
如果问题反复出现，例如权限绕过、非法状态流转、审计缺失，就要判断是否沉淀为 rule、checklist、prompt、example 或新的 Skill。
-->

---

# 复杂业务模块资产

<div class="grid grid-cols-2 gap-3 mt-6 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">01 工单 RBAC 权限矩阵</div>
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">02 工单权限控制方案</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">03 工单状态流转表</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">04 非法流转清单</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">05 工单审计日志 SOP</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">06 异常态与防御性逻辑清单</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">07 研发效能看板指标字典</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">08 看板接口验收记录</div>
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">09 阶段 Review 报告</div>
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">10 修复记录</div>
</div>

<!--
第四天最终交付十个产物。
这些产物共同说明：工单模块不只是能运行，还具备权限、状态、审计、异常和指标的工程闭环。
-->

---

# 复杂业务资产包目录

<div class="mt-5 text-xs">

```text
ai-dev-assets/
├── rules/
│   ├── security-permission.md
│   ├── state-audit.md
│   ├── testing.md
│   └── delivery.md
├── skills/
│   ├── design-complex-business-module/
│   ├── review-business-delivery/
│   └── track-review-fix-loop/
├── templates/jeecgboot/
├── checklists/jeecgboot/
├── prompts/jeecgboot/
└── examples/jeecgboot/
```

</div>

<div class="mt-4 p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">
交付给团队的不是聊天记录，而是可安装、可复用、可审查的工程资产包。
</div>

<!--
这一页把第四天的 rule 和 Skill 落到目录结构。
rules 是长期约束，skills 是可触发流程，templates/checklists/prompts/examples 是 Skill 会调用的材料。
这样学员能把课堂产物带回团队，而不是停留在一次性演示。
-->

---
layout: center
class: text-center
---

# 复杂业务模块的控制面

<div class="mt-8 text-lg">
让工单模块从“能跑通”升级到“可控制、可审计、可验证、可 Review”。
</div>

<div class="grid grid-cols-5 gap-3 mt-8 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">权限矩阵</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">状态机</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">审计 SOP</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">异常清单</div>
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">Review 闭环</div>
</div>

<!--
第四天的核心不是让 AI 多写代码。
核心是让 AI 按规则、证据和验收标准协作，把复杂业务的风险变成可检查、可修复、可沉淀的工程资产。
-->