From 22712547bc7750944e8525486050ca180281591f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8D=8E=E4=BD=97?= Date: Sat, 6 Jun 2026 15:09:51 +0800 Subject: [PATCH] =?UTF-8?q?docs(iron-rules):=20=E6=96=B0=E5=A2=9E=E9=93=81?= =?UTF-8?q?=E5=BE=8B17=20=E2=80=94=20=E7=A6=81=E6=AD=A2=E6=B5=85=E5=B1=82?= =?UTF-8?q?=E7=B3=8A=E5=BC=84=EF=BC=8C=E5=BF=85=E9=A1=BB=E6=B7=B1=E5=BA=A6?= =?UTF-8?q?=E5=88=86=E6=9E=90+=E6=B7=B1=E5=BA=A6=E8=AE=BE=E8=AE=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 核心要求：如果一个模块不能在真实医院环境中使用，就不算完成 禁止行为： - 写空壳页面就宣称功能完成 - 只做CRUD就宣称模块开发完毕 - 设计文档只有标题没有内容 - 接口只返回200不验证业务逻辑 - 前端只有表格没有交互 - 后端没有参数校验 每个模块必须达到的标准： - 前端：搜索/筛选/分页/弹窗/反馈/空状态/加载态 - 后端：参数校验/业务规则/异常处理/日志 - 数据：完整字段/关联/索引/Flyway - 业务：正常+异常+边界+状态机 - 设计：背景/流程图/规则/时序图/测试用例 - 测试：接口+业务逻辑+异常 质量自检：能否在真实医院环境直接使用？ 同步7个AI工具配置 --- .clinerules | 2 +- .cursorrules | 2 +- .github/copilot-instructions.md | 2 +- .qwenrules | 2 +- .windsurfrules | 2 +- AGENTS.md | 2 +- MD/specs/IRON_RULES.md | 61 +++++++++++++++++++++++++++++++++ 7 files changed, 67 insertions(+), 6 deletions(-) diff --git a/.clinerules b/.clinerules index 232b1affb..9ac79d89b 100644 --- a/.clinerules +++ b/.clinerules @@ -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` diff --git a/.cursorrules b/.cursorrules index 92d0aa0b5..7d9b84b6f 100644 --- a/.cursorrules +++ b/.cursorrules @@ -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` diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index d47e2a35d..ce201f84d 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -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` diff --git a/.qwenrules b/.qwenrules index 8456b5dfb..55088f570 100644 --- a/.qwenrules +++ b/.qwenrules @@ -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` diff --git a/.windsurfrules b/.windsurfrules index 98a7c27e2..082b420f3 100644 --- a/.windsurfrules +++ b/.windsurfrules @@ -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` diff --git a/AGENTS.md b/AGENTS.md index c75ea09ae..07f51179b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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` diff --git a/MD/specs/IRON_RULES.md b/MD/specs/IRON_RULES.md index 1e4e560b8..cd9b97484 100644 --- a/MD/specs/IRON_RULES.md +++ b/MD/specs/IRON_RULES.md @@ -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: 模块优化必须分析现有业务流并说明促进作用 **任何模块新增/优化前，必须先分析现有业务流程全貌。**