WPROC1 固化企微路线与开发流程门禁

2026-05-19 11:05:31 +08:00
@@ -3,8 +3,8 @@
 **文档状态**：当前开发交付事实源。
 **分类**：开发治理。
 **适用范围**：hyb-oa 所有非微小代码、文档、测试、脚本和部署准备变更。
-**关联 Issue**：`GOV8,WDRG`。
-**最近审计**：2026-05-18。
+**关联 Issue**：`GOV8,WDRG,WPROC1`。
+**最近审计**：2026-05-19。
 **不得误读**：本文定义开发和变更流程，不替代具体业务 PRD、模块规约或测试规约。
 **路线口径**：开发必须围绕最新 Issue CSV 执行；WDRG 后企微优先 HR/考勤改造必须先读 [企微优先开发路线图](./企微优先开发路线图.md)，再按单功能 Issue CSV 实施。采购、合同、报销、财务、AP、代账和高敏附件继续 OA 主办，ERP 未来不接入 OA。

@@ -22,7 +22,7 @@ WDRG 后，企微优先 HR/考勤改造增加一层路线图门禁；WAPI/WRRA

 `需求事实源 -> 设计门禁 -> 路线图门禁 -> 企微能力 POC -> 单功能 Issue CSV -> 方案批准 -> 开发实现 -> review -> QA 回归 -> 部署 / 公网验证`

-路线图只控制顺序、边界、准入和退出条件；具体接口、schema、页面、权限、审计和测试仍必须在单功能 Issue CSV 中声明。阶段未退出前不得跳阶段：WOUA-FIX 已完成测试账号差异收口，但 `PASS_WITH_FINDINGS` 的剩余缺字段/归档绑定不直接放行深度镜像；WRA1 已完成 `WECOM-RUNTIME-READY-V1` 的运行入口、OAuth/绑定、脱敏消息、通讯录、人事助手和打卡只读门禁修正；WMSG1 已完成真实应用消息和 Deeplink 确认。当前 `PASS_WITH_CONFIG_GAPS` 只表示运行优先主链路可用，WAPC1 只表示审批配置准备清单已固化；审批模板、低风险测试 `sp_no` 和真实回调配置仍必须在进入 `wecom_attendance_approval_mirror_v1` 前补齐并验证。
+路线图只控制顺序、边界、准入和退出条件；具体接口、schema、页面、权限、审计和测试仍必须在单功能 Issue CSV 中声明。阶段未退出前不得跳阶段：WOUA-FIX 已完成测试账号差异收口，但 `PASS_WITH_FINDINGS` 的剩余缺字段/归档绑定不直接放行深度镜像；WRA1 已完成 `WECOM-RUNTIME-READY-V1` 的运行入口、OAuth/绑定、脱敏消息、通讯录、人事助手和打卡只读门禁修正；WMSG1 已完成真实应用消息和 Deeplink 确认。当前 `PASS_WITH_CONFIG_GAPS` 只表示运行优先主链路可用，WAPC1 只表示审批配置准备清单已固化；WAPC2 只证明请假/补卡模板详情和审批详情只读 runner 已具备。WPROC1 后，审批镜像前必须先完成 WAPC2F 自动样件、WAPC2 自动复跑、WCBK1 回调只读 POC、WACP3 补偿拉取 POC 和 WADM1 镜像数据模型设计。

 ## 2. Issue 生命周期

@@ -97,10 +97,49 @@ WDRG 后，企微优先 HR/考勤路线采用“路线图门禁 + 单功能 Issu

 当前企微优先路线顺序固定为：

-`WECOM-CAPABILITY-POC-V1 -> wecom_hr_master_sync_v1 -> runtime_first_wecom_enablement -> WOUA-FIX / WECOM-RUNTIME-READY-V1 -> WAPC1 审批配置准备 -> wecom_attendance_approval_mirror_v1 -> oa_hr_emergency_mode_v1 -> wecom_recovery_writeback_v1 -> wecom_ruleops_v1`
+`WECOM-CAPABILITY-POC-V1 -> wecom_hr_master_sync_v1 -> runtime_first_wecom_enablement -> WOUA-FIX / WECOM-RUNTIME-READY-V1 -> WAPC1 审批配置准备 -> WAPC2 请假/补卡只读 POC -> WAPC2F 自动生成 POC 样件 -> WAPC2 自动复跑 -> WCBK1 回调只读 POC -> WACP3 补偿拉取 POC -> WADM1 镜像数据模型设计 -> wecom_attendance_approval_mirror_v1 -> oa_hr_emergency_mode_v1 -> wecom_recovery_writeback_v1 -> wecom_ruleops_v1`

 允许并行处理线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护；但采购、合同、报销、付款、AP、代账和高敏附件等 OA 主办域必须另开合同，不得混入企微 HR/考勤路线。

+### 2.4 三层门禁
+
+企微后续开发默认采用三层门禁：
+
+| 门禁 | 作用 | 退出口径 |
+| --- | --- | --- |
+| 路线门禁 | 决定阶段顺序、禁止跳过项和是否允许并行 | 最新路线图、PRD 和 Issue CSV 不冲突 |
+| 能力门禁 | 证明官方 API、Secret、权限、可信 IP、模板、回调和测试数据可用 | POC runner 返回 `PASS`、`NEEDS_CONFIG` 或真实 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` |
+| 实现门禁 | 控制代码、单测、回归、公网验证、状态回填和提交 | `Test_Method` 通过或真实 SKIP，事实源和 Issue 状态已回写 |
+
+Definition of Ready：
+
+- 已有 Issue CSV，且依赖项满足。
+- 已读对应事实源、[企微优先开发路线图](./企微优先开发路线图.md) 和 [企微 API 能力目录](./企微API能力目录.md)。
+- 明确做什么、不做什么、读写边界、Secret 来源和失败分类，不允许运行时猜 Secret。
+- 明确测试账号、申请人、审批人和自审校验；审批类 POC 默认不得自己申请自己审批。
+- 明确 live 写入开关、回滚或清理方式、脱敏报告边界和人工确认点。
+
+Definition of Done：
+
+- `Test_Method` 全部执行并真实通过，或按缺配置规则记录 `NEEDS_CONFIG` / `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
+- Issue 状态和 Notes 反映实际结果，不用口头判断代替证据。
+- 文档事实源、索引、矩阵和必要 skill 已同步。
+- 本地门禁通过；面向公网或企微可测的能力已部署并通过 `/ready`、runtime smoke、public bundle scan 或对应 live runner。
+- 已完成中文 commit，并在最终说明中区分“已部署”和“仅本地验证”。
+
+自动化优先规则：
+
+- 能用 runner 自动生成、自动检查、自动复跑的，不要求人工手动操作。
+- 人工只处理写入批准、Secret/Token/EncodingAESKey 配置、企微后台无法 API 化的配置、真机确认和风险拍板。
+- 缺配置必须输出 `NEEDS_CONFIG` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，不得伪造成 PASS。
+
+高风险能力进入实现前必须先有 POC：
+
+- 真实回调先证明 URL 验证、验签、解密、幂等和重复投递。
+- 补偿拉取先证明按时间窗口拿到审批单号并可拉取审批详情。
+- 镜像表先设计字段、状态机、幂等键、索引和隐私保留边界。
+- 应急接管和恢复回写必须等镜像稳定后再做。
+
 ## 3. 开发边界

 - 每次只做当前 Issue 范围内的事，不顺手重构无关模块。