# 模块 9：若依坏规则示例

<div class="mt-6 p-4 rounded-xl bg-red-500/10 border border-red-500/30 text-sm">

- 注意权限安全
- 代码要规范
- 日志要完整
- 数据权限要合理
- 生成代码要检查

方向没错，但不可执行。
</div>

<!--
这些话方向没错，但不可执行。
“注意权限安全”太泛。
“日志要完整”没有说明哪些操作必须记录。
“数据权限要合理”没有判断标准。
“生成代码要检查”没有检查项。
所以要改成明确规则。
-->

---

# 规则可执行性四问

<div class="grid grid-cols-2 gap-4 mt-6 text-sm">
<div class="p-4 rounded-xl bg-blue-500/10 border border-blue-500/30">
<div class="font-bold mb-1">什么时候触发？</div>
<div class="text-xs text-gray-400">文件、功能、接口、操作类型</div>
</div>
<div class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30">
<div class="font-bold mb-1">必须做什么？</div>
<div class="text-xs text-gray-400">检查、修改、输出、标注</div>
</div>
<div class="p-4 rounded-xl bg-amber-500/10 border border-amber-500/30">
<div class="font-bold mb-1">不能做什么？</div>
<div class="text-xs text-gray-400">禁止猜测、绕过、硬编码、直接上线</div>
</div>
<div class="p-4 rounded-xl bg-purple-500/10 border border-purple-500/30">
<div class="font-bold mb-1">怎么验收？</div>
<div class="text-xs text-gray-400">证据、测试、报告、人工确认</div>
</div>
</div>

<!--
判断 rules 是否可执行，就问这四个问题。
如果回答不出来，这条规则就是口号。
让学员用四问去改写坏规则，会比直接给标准答案更有效。
-->

---

# 若依好规则示例

<div class="mt-6 p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">

- 涉及用户、角色、菜单、部门、岗位的新增、修改、删除、导出接口时，必须检查后端权限控制和操作日志记录
- 涉及列表查询时，必须确认是否需要数据权限过滤
- 代码生成结果上线前，必须检查权限、日志、表单校验、异常处理和测试
</div>

<!--
这就是更好的规则。
它有触发场景：用户、角色、菜单、部门、岗位相关接口。
它有必须动作：检查后端权限控制和操作日志。
它能被检查：看 Controller、注解、Service 和日志配置。
这类规则才适合写进 .trae/rules.md。
-->

---

# 好规则拆解

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

| 原文片段 | 它解决了什么 |
|---|---|
| 涉及用户、角色、菜单、部门、岗位 | 明确触发范围 |
| 新增、修改、删除、导出接口 | 明确敏感动作 |
| 必须检查后端权限控制和操作日志 | 明确 AI 必须动作 |
| 上线前检查权限、日志、校验、异常和测试 | 明确验收项 |

</div>

<!--
这页用来拆解为什么好规则好。
它不是句子更长，而是触发范围、敏感动作、必须动作和验收项都更明确。
-->

---

# 若依 rules 检查 Prompt

<div class="mt-4 p-4 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">

```
@workspace 请检查当前 .trae/rules.md 是否适合若依项目。
重点检查：权限规则 · 操作日志规则 · 数据权限规则 · 
前端按钮权限规则 · 代码生成规则 · 敏感配置规则
```

</div>

<!--
这是让 TRAE 检查若依 rules 的 Prompt。
重点检查权限规则、操作日志规则、数据权限规则、前端按钮权限规则、代码生成规则和敏感配置规则。
要求 AI 先给审查报告，不要直接改文件。
-->

---

# rules 审查报告模板

<div class="mt-4 p-4 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">

```md
| 规则编号 | 当前规则 | 问题 | 改写建议 | 验收方式 |
|---|---|---|---|---|
| R-001 | 注意权限安全 | 太泛，无法触发 | 涉及敏感接口时必须检查... | 标注 Controller 权限注解 |
```

</div>

<div class="mt-4 text-sm">
要求 TRAE 输出审查报告后，再由人决定是否写入 <code>.trae/rules.md</code>。
</div>

<!--
rules 审查也要结构化。
不要让 AI 直接把 rules 改掉，要先列当前规则、问题、改写建议和验收方式。
讲师可以用这个模板让学员逐条自查 rules，并结合课堂样例说明取舍。
-->

---

# 若依版 rules.md 结构

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

0.基础原则 · 1.安全规则 · 2.权限规则 · 3.操作日志规则 · 4.编码规则 · 5.前端规则 · 6.测试规则 · 7.代码生成规则 · 8.不确定性处理规则

</div>

<!--
今天最终产出是若依版 .trae/rules.md v0.1。
它比通用 rules 多了几个若依特色部分：权限规则、操作日志规则、代码生成规则。
这份 rules 后续可以作为团队后台管理系统 AI 协作规范的基础。
-->