9.4 KiB
企微优先开发路线图
文档状态：当前开发路线图事实源。
分类：开发治理 / 路线图。
适用时间：WDRG / WCP1 之后。
关联 Issue：WDRG,WCP1。
最近审计：2026-05-18。
不得误读：本文只控制后续开发节奏、阶段顺序和门禁，不代表企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 已完成运行时实现。
1. 路线图原则
- 采用“路线图门禁 + 单功能 Issue CSV”的工程流程；路线图管顺序和边界，具体实现仍以每个功能的 Issue CSV 为准。
- 当前路线只覆盖企微优先 HR/考勤域改造：人事助手、通讯录、打卡、HR/考勤审批、OA 镜像、OA 应急接管、恢复回写和 RuleOps。
- 采购、费用、合同、项目、报销、付款批次、AP、代账交接、审计和高敏附件继续 OA 主办；企业微信只做脱敏消息、deeplink、入口和成熟能力参考。
- 阶段未满足退出条件前不得跳阶段。线上缺陷、安全风险、正式使用阻断或真实反馈可以另开独立 Issue CSV，但不得混入企微 HR/考勤主路线。
- ERP 未来不接入 OA；真实支付、图片 OCR、银行流水导入、复杂 BPM、审批设计器和重预算继续不进入当前路线。
2. 当前阶段
| 阶段 | 状态 | 结论 |
|---|---|---|
DBWFOC |
已完成 | 固定数据边界：HR/考勤员工日常审批企微优先，OA 主办高敏业务不进企微原生审批或企微附件。 |
WFDG |
已完成 | 固定设计门禁：先判定主办方、数据边界、入口交互、隐私消息、同步审计、应急接管、恢复回写和 RuleOps 边界。 |
WDRG |
已完成 | 固定开发路线图和节奏，下一步只允许进入 WECOM-CAPABILITY-POC-V1。 |
WCP1 |
当前暂停配置 | 已完成只读 POC runner 和远端只读探测，结论 PAUSE_FOR_CONFIG；不得进入 wecom_hr_master_sync_v1，需先补企微配置/权限后复跑 POC。 |
WCPC |
当前等待外部配置 | 已建立配置收口合同并完成未补配置前基线复跑；等待已有在职测试号 userid、审批模板 ID、审批单号和企微后台权限后复跑完整 POC。 |
3. 阶段路线
| 顺序 | 阶段 | 目标 | 进入条件 | 退出条件 |
|---|---|---|---|---|
| 1 | WECOM-CAPABILITY-POC-V1 |
只读或低风险探测企微 API 能力，输出能力矩阵。 | WDRG 完成；企微后台权限、Secret、可信 IP、模板和可见范围按现状记录。 | 人事助手、通讯录、打卡、审批、假期余额、回调和权限配置均有 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY 或 NOT_SUPPORTED_BY_API 结论。 |
| 2 | wecom_hr_master_sync_v1 |
企微/人事助手员工、部门、主管、职位、联系方式和在职状态镜像到 OA。 | POC 证明人事助手/通讯录读取和回调能力可用，或明确缺口处理方式。 | OA 可自动创建/更新员工档案、账号、角色、企微绑定和审计；缺配置时记录 SKIP/BLOCKED_BY_EXTERNAL_CONFIG。 |
| 3 | wecom_attendance_approval_mirror_v1 |
企微打卡、请假、补卡、外出、加班、假期余额和审批历史镜像到 OA。 | HR 主数据镜像稳定；审批模板、打卡规则和回调能力已完成 POC 或有可解释替代方案。 | OA 可查询企微 HR/考勤镜像、附件摘要、审批历史、考勤解释和审计；不把 OA 主办高敏审批迁到企微。 |
| 4 | oa_hr_emergency_mode_v1 |
企业微信不可用时，由管理员人工开启 OA HR/考勤应急接管。 | 企微镜像数据可支撑对账；OA 应急入口、权限和审计方案明确。 | 管理员可填写原因、范围、预计结束时间和责任人后开启/关闭；应急单据带 EMERGENCY 标记。 |
| 5 | wecom_recovery_writeback_v1 |
企微恢复后，OA 应急数据先 dry-run，再回写企微。 | 应急接管模式完成；企微写回接口、冲突规则和回滚策略已单独批准。 | 系统生成成功、失败、跳过和冲突清单；无冲突项可自动回写，冲突进入人工确认。 |
| 6 | wecom_ruleops_v1 |
AI 草拟企微规则、生成差异报告和 dry-run，人工确认后写入企微。 | 前述同步/回写链路稳定；企微规则 API 能力和权限已验证。 | 每次写入保存前后快照、确认人、API errcode、失败原因、回滚建议和审计记录。 |
4. 每阶段固定门禁
每个正式阶段必须单独建立 Issue CSV，并至少包含：
- 需求边界：本阶段做什么、不做什么、涉及哪些角色和业务流程。
- 接口边界：新增或复用的企微 API、OA API、schema、feature flag、配置和权限。
- 数据边界：主事实源、镜像方向、附件归属、脱敏字段和审计责任。
- 失败处理：缺 Secret、权限、模板、可信 IP、回调、外部配置时必须记录
SKIP/BLOCKED_BY_EXTERNAL_CONFIG，不得伪造成成功。 - 测试门禁：本地静态检查、focused 单测、必要 Playwright、权限负例、文档审计和公网复检。
- 部署规则：本地全测通过后才能部署；生产写接口、企微规则写入、应急模式开启或恢复回写必须单独批准。
5. 并行工作规则
- 可以并行：线上缺陷修复、首周运营保障、真实反馈扫尾、QA-only 脚本维护、文档审计修正。
- 必须另开合同：OA 主办域的采购、合同、报销、付款、AP、代账、审计和高敏附件功能变更。
- 不允许混入：在 POC 未完成前开发 HR 主数据镜像；在 HR 主数据未稳定前开发恢复回写；在应急接管未完成前开发 RuleOps 正式写入。
- 不允许把企业微信原生审批用于报销、采购、合同、项目、财务付款或高敏附件审批。
6. 下一轮 POC 验收口径
WECOM-CAPABILITY-POC-V1 必须输出能力矩阵：
| 状态 | 含义 |
|---|---|
CAN_REUSE_NOW |
当前配置和 API 能力足以进入正式实现设计。 |
NEEDS_CONFIG |
需要企微后台配置、授权、可信 IP、模板、可见范围或 Secret 后再测。 |
NEEDS_API_POC |
文档显示可能支持，但需 QA-only 探测脚本确认。 |
KEEP_OA_PRIMARY |
该能力继续由 OA 主办，企微只做入口、消息或参考。 |
NOT_SUPPORTED_BY_API |
企业微信 API 不支持或风险过高，不进入自动化实现。 |
POC 默认只读或低风险探测。任何生产写操作、企微规则写入、真实员工批量变更、恢复回写或应急切换都必须另建合同并获得明确批准。
7. WCP1 POC 结果
2026-05-18 已执行 WECOM-CAPABILITY-POC-V1，本轮新增 QA-only runner scripts/qa/check-wecom-capability-poc.mjs。本地不开启 live read 时报告为可解释 PAUSE_FOR_API_POC，本地开启 live read 但无真实企微 env 时报告为可解释 PAUSE_FOR_CONFIG；部署服务器容器内使用现有远端 env 执行 live 只读探测，报告目录为远端 /tmp/wecom-capability-poc-wcp1/summary.json，结论同为 PAUSE_FOR_CONFIG。
当前可复用能力：
- 工作台应用 access token 可获取，核心 CorpID/Agent/Secret/OAuth 配置存在。
- HCLT 已作为历史证据纳入：
HRWDTEST-20260517214548已完成企微通讯录 create/update/disable，errcode=0。 - 通讯录部门读取通过工作台应用 token fallback 可用。
- 人事助手字段配置读取可用。
- 审批 access token 可获取，但模板、实例、假期余额和回调配置尚未满足镜像开发准入。
当前阻断：
contact.member_read：测试成员读取返回wecom_errcode_48009，需要核对通讯录读取权限、应用可见范围或测试成员状态。hr.staff_read：测试成员花名册读取返回wecom_errcode_60021，需要把可用于 POC 的测试成员纳入应用/人事助手权限范围，或改用在职测试成员复跑。checkin.records_read/checkin.rules_read：远端WECOM_CHECKIN_SYNC_ENABLED未开启，打卡短窗口和规则读取按NEEDS_CONFIG记录。approval.template_detail/approval.instance_detail：缺审批模板 ID 和测试审批单号。approval.vacation_quota：假期余额读取返回wecom_errcode_301062，缺假期权限。callback.config：回调 URL、Token、AESKey 未作为可读配置注入，本轮不能证明回调链路。
因此，当前下一步不是 wecom_hr_master_sync_v1 开发，而是补齐或确认上述配置后复跑 WECOM-CAPABILITY-POC-V1。只有 contact.member_read 与 hr.staff_read 至少对一个已有在职测试号通过，并且能力矩阵给出 GO_TO_HR_MASTER_SYNC，才允许进入 HR 主数据镜像合同。
8. WCPC 配置收口状态
2026-05-18 已建立 WCP1-CONFIG-CLOSEOUT-V1 合同，目标是用已有在职测试号和一条新建企业微信测试审批单复跑完整 POC。本轮不开发业务功能、不部署、不持久修改服务器 .env，服务器复跑只使用临时环境变量。
当前已完成：
- 建立 WCPC Issue CSV。
- 使用现有远端配置和历史
HRWDTEST-20260517214548做基线复跑，报告目录为远端/tmp/wecom-capability-poc-wcpc-baseline。 - 基线结论仍为
PAUSE_FOR_CONFIG，contact.member_read=wecom_errcode_48009，hr.staff_read=wecom_errcode_60021。
等待外部配置：
- 已有在职测试号 userid。
- 测试审批模板 ID。
- 测试审批单号
sp_no。 - 打卡 API、审批、假期余额和回调配置权限确认。
在这些配置完成并复跑前，wecom_hr_master_sync_v1 仍不得启动。