smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
150 lines
4.7 KiB
Markdown
150 lines
4.7 KiB
Markdown
# 模块 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 协作规范的基础。
|
|
-->
|