WCP1 收口企业微信能力POC

docs/企微优先开发路线图.md

@@ -2,8 +2,8 @@
 
 **文档状态**：当前开发路线图事实源。  
 **分类**：开发治理 / 路线图。  
-**适用时间**：WDRG 之后。  
-**关联 Issue**：`WDRG`。  
+**适用时间**：WDRG / WCP1 之后。
+**关联 Issue**：`WDRG,WCP1`。
 **最近审计**：2026-05-18。  
 **不得误读**：本文只控制后续开发节奏、阶段顺序和门禁，不代表企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 已完成运行时实现。
 
@@ -21,7 +21,8 @@
 | --- | --- | --- |
 | `DBWFOC` | 已完成 | 固定数据边界：HR/考勤员工日常审批企微优先，OA 主办高敏业务不进企微原生审批或企微附件。 |
 | `WFDG` | 已完成 | 固定设计门禁：先判定主办方、数据边界、入口交互、隐私消息、同步审计、应急接管、恢复回写和 RuleOps 边界。 |
-| `WDRG` | 当前 | 固定开发路线图和节奏，下一步只允许进入 `WECOM-CAPABILITY-POC-V1`。 |
+| `WDRG` | 已完成 | 固定开发路线图和节奏，下一步只允许进入 `WECOM-CAPABILITY-POC-V1`。 |
+| `WCP1` | 当前暂停配置 | 已完成只读 POC runner 和远端只读探测，结论 `PAUSE_FOR_CONFIG`；不得进入 `wecom_hr_master_sync_v1`，需先补企微配置/权限后复跑 POC。 |
 
 ## 3. 阶段路线
 
@@ -65,3 +66,26 @@
 | `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 主数据镜像合同。