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: 模块优化必须分析现有业务流并说明促进作用 **任何模块新增/优化前，必须先分析现有业务流程全貌。**