WDRG 收口企微优先开发路线图

docs/开发交付与变更管理规约.md

@@ -3,10 +3,10 @@
 **文档状态**：当前开发交付事实源。
 **分类**：开发治理。
 **适用范围**：hyb-oa 所有非微小代码、文档、测试、脚本和部署准备变更。
-**关联 Issue**：`GOV8`。
-**最近审计**：2026-05-13。
+**关联 Issue**：`GOV8,WDRG`。
+**最近审计**：2026-05-18。
 **不得误读**：本文定义开发和变更流程，不替代具体业务 PRD、模块规约或测试规约。
-**路线口径**：开发必须围绕最新 Issue CSV 执行；hyb-oa 是唯一业务主系统，企业微信只做基础设施，飞书路线已废弃。
+**路线口径**：开发必须围绕最新 Issue CSV 执行；WDRG 后企微优先 HR/考勤改造必须先读 [企微优先开发路线图](./企微优先开发路线图.md)，再按单功能 Issue CSV 实施。采购、合同、报销、财务、AP、代账和高敏附件继续 OA 主办，ERP 未来不接入 OA。
 
 本文回答“一个变更怎么开始、怎么审查、什么时候提交、怎么交付”。测试细节以 [测试规约与回归门禁](./测试规约与回归门禁.md) 为准。
 
@@ -18,6 +18,12 @@
 
 不得跳过 Issue CSV 直接开发非微小变更。需求、方案或验收口径不清时，先澄清或补文档。
 
+WDRG 后，企微优先 HR/考勤改造增加一层路线图门禁：
+
+`需求事实源 -> 设计门禁 -> 路线图门禁 -> 企微能力 POC -> 单功能 Issue CSV -> 方案批准 -> 开发实现 -> review -> QA 回归 -> 部署 / 公网验证`
+
+路线图只控制顺序、边界、准入和退出条件；具体接口、schema、页面、权限、审计和测试仍必须在单功能 Issue CSV 中声明。阶段未退出前不得跳阶段：`WECOM-CAPABILITY-POC-V1` 未完成时，不得直接开发 `wecom_hr_master_sync_v1`、`wecom_attendance_approval_mirror_v1`、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1` 或 `wecom_ruleops_v1`。
+
 ## 2. Issue 生命周期
 
 | 状态 | 含义 | 可进入条件 |
@@ -79,12 +85,28 @@
 | 测试影响 | 原测试是否仍有效，是否新增权限/视觉/公网/真机验证 |
 | 回滚路径 | 如何撤销或延后 |
 
+### 2.3 路线图门禁和单功能合同
+
+WDRG 后，企微优先 HR/考勤路线采用“路线图门禁 + 单功能 Issue CSV”：
+
+| 层级 | 作用 | 不承担 |
+| --- | --- | --- |
+| 路线图 | 固定阶段顺序、准入/退出门禁、并行规则和禁止跳过项 | 不写详细接口、schema、页面或迁移 |
+| POC 合同 | 只读或低风险探测企微 API、配置、回调、模板和权限能力 | 不迁移运行时主流程 |
+| 单功能合同 | 明确一个功能的接口、数据、权限、页面、审计、失败处理、测试和回滚 | 不顺手开发下一个阶段 |
+
+当前企微优先路线顺序固定为：
+
+`WECOM-CAPABILITY-POC-V1 -> wecom_hr_master_sync_v1 -> wecom_attendance_approval_mirror_v1 -> oa_hr_emergency_mode_v1 -> wecom_recovery_writeback_v1 -> wecom_ruleops_v1`
+
+允许并行处理线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护；但采购、合同、报销、付款、AP、代账和高敏附件等 OA 主办域必须另开合同，不得混入企微 HR/考勤路线。
+
 ## 3. 开发边界
 
 - 每次只做当前 Issue 范围内的事，不顺手重构无关模块。
 - 跨后端和前端的任务，先稳定后端 API / 数据契约，再接前端。
 - 涉及权限、状态机、审批规则、财务状态、Prisma migration 的改动，必须写明回滚策略。
-- 不在当前 MVP 首批范围内扩展预算、ERP、AI 自动处理、飞书、复杂 BPM 或重型项目管理；企业微信原生审批只按 WFOC/DBWFOC/WFDG 口径用于 HR/考勤员工日常审批优先复用，不迁移报销、财务、采购、合同、项目或高敏附件等 OA 主办流程。后续企微/OA 运行时迁移先做 `WECOM-CAPABILITY-POC-V1`，再按单功能 Issue CSV 开发。
+- 不在当前 MVP 首批范围内扩展预算、ERP、AI 自动处理、飞书、复杂 BPM 或重型项目管理；ERP 未来不接入 OA。企业微信原生审批只按 WFOC/DBWFOC/WFDG/WDRG 口径用于 HR/考勤员工日常审批优先复用，不迁移报销、财务、采购、合同、项目或高敏附件等 OA 主办流程。后续企微/OA 运行时迁移先做 `WECOM-CAPABILITY-POC-V1`，再按 [企微优先开发路线图](./企微优先开发路线图.md) 拆单功能 Issue CSV 开发。
 - 未经确认不得重置数据库、编辑迁移历史、修改生产配置、暴露真实密钥或处理真实敏感数据。
 
 ## 3.1 只读审计和排障边界