docs(iron-rules): 新增铁律17 — 禁止浅层糊弄,必须深度分析+深度设计

核心要求:如果一个模块不能在真实医院环境中使用,就不算完成

禁止行为:
- 写空壳页面就宣称功能完成
- 只做CRUD就宣称模块开发完毕
- 设计文档只有标题没有内容
- 接口只返回200不验证业务逻辑
- 前端只有表格没有交互
- 后端没有参数校验

每个模块必须达到的标准:
- 前端:搜索/筛选/分页/弹窗/反馈/空状态/加载态
- 后端:参数校验/业务规则/异常处理/日志
- 数据:完整字段/关联/索引/Flyway
- 业务:正常+异常+边界+状态机
- 设计:背景/流程图/规则/时序图/测试用例
- 测试:接口+业务逻辑+异常

质量自检:能否在真实医院环境直接使用?
同步7个AI工具配置
This commit is contained in:
2026-06-06 15:09:51 +08:00
parent 84caa7e25a
commit 22712547bc
7 changed files with 67 additions and 6 deletions

View File

@@ -496,4 +496,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -496,4 +496,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -496,4 +496,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -496,4 +496,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -496,4 +496,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -497,4 +497,4 @@ git status && git add -A && git commit -m "feat(module): desc" && git push origi
---
> 📅 最后同步: 2026-06-06 14:02 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`
> 📅 最后同步: 2026-06-06 15:09 | 源文件: RULES.md | 重新同步: `bash scripts/sync-ai-rules.sh`

View File

@@ -24,6 +24,7 @@
| #10 | 设计文档必须包含UI设计和调用流程 | P0 | 设计文档/前端开发 |
| #11 | 模块设计必须分析业务逻辑不能只做CRUD | P0 | 全量模块设计 |
| #12 | 模块优化必须分析现有业务流并说明促进作用 | P0 | 全量模块优化 |
| #13 | 开发必须深度分析+深度设计,禁止浅层糊弄 | P0 | 全量开发 |
---
@@ -315,6 +316,66 @@ npm run lint
---
---
### 铁律 #13: 开发必须深度分析+深度设计,禁止浅层糊弄
**如果一个模块不能在真实医院环境中使用,就不算完成。**
#### 禁止行为(红线)
| ❌ 禁止 | 说明 |
|---------|------|
| 写空壳页面就宣称"功能完成" | 页面有内容但没有实际业务逻辑 |
| 只做CRUD就宣称"模块开发完毕" | 缺少业务规则/状态流转/异常处理 |
| 设计文档只有标题没有内容 | 设计文档是"施工图纸",必须有实质内容 |
| 接口只返回200不验证业务逻辑 | 测试必须验证业务正确性不只是HTTP状态码 |
| 前端只有表格没有交互 | 缺少搜索/筛选/分页/操作反馈/空状态 |
| 后端没有参数校验 | 缺少必填校验/格式校验/业务规则校验 |
#### 每个模块必须达到的标准
| 维度 | 必须具备 | 自检方法 |
|------|---------|---------|
| **前端** | 搜索/筛选/分页/新增编辑弹窗/操作反馈/空状态/加载态 | 能否正常操作每个功能 |
| **后端** | 参数校验/业务规则校验/异常处理/日志记录 | 能否处理正常+异常场景 |
| **数据** | 完整字段/关联关系/索引/Flyway迁移 | 数据库能否支撑业务 |
| **业务** | 正常流程/异常流程/边界场景/状态机 | 能否覆盖真实业务场景 |
| **设计** | 业务背景/流程图/规则清单/时序图/测试用例 | 设计文档是否可执行 |
| **测试** | 接口测试/业务逻辑测试/异常测试 | 能否在真实环境使用 |
#### 质量自检清单
开发完成后必须回答以下问题:
```
□ 这个模块放到医院里,医生/护士/收费员能直接用吗?
□ 搜索条件是否覆盖了真实使用场景?
□ 表单校验是否覆盖了所有必填项和格式要求?
□ 操作反馈是否清晰(成功/失败/加载中/空数据)?
□ 后端是否有完整的参数校验和业务规则校验?
□ 异常场景(网络断开/数据不存在/权限不足)是否处理?
□ 状态流转是否完整(每个状态都能正确转换)?
□ 设计文档是否足够详细,其他人能据此开发?
□ 测试用例是否覆盖了正常流程和异常流程?
□ 接口返回的数据结构是否前后端对齐?
```
#### 深度设计文档标准
| 文档部分 | 最低要求 | 优秀标准 |
|---------|---------|---------|
| 业务背景 | 说明做什么 | 说明为什么做+参考什么标准 |
| 业务流程 | 正常流程文字描述 | 正常+异常+边界+流程图 |
| 状态流转 | 状态列表 | 状态机图+转换条件+权限 |
| 业务规则 | 规则名称 | 规则编号+描述+触发时机+处理方式 |
| 数据模型 | 表名+字段 | ER图+字段说明+索引+关联 |
| 接口设计 | API路径 | 请求/响应示例+错误码+版本 |
| 前端设计 | 页面列表 | UI线框+交互时序+组件选型 |
| 测试用例 | 功能清单 | 正常/异常/边界/性能测试用例 |
---
### 铁律 #12: 模块优化必须分析现有业务流并说明促进作用
**任何模块新增/优化前,必须先分析现有业务流程全貌。**