WRA1 修正企微运行验收门禁

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

@@ -2,8 +2,8 @@
 
 **文档状态**：当前开发路线图事实源。  
 **分类**：开发治理 / 路线图。  
-**适用时间**：WDRG / WCP1 / WHMSLIVE / WOUA / WAPI / WRRA / WOUA-FIX / WRV1 之后。
-**关联 Issue**：`WDRG,WCP1,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1`。
+**适用时间**：WDRG / WCP1 / WHMSLIVE / WOUA / WAPI / WRRA / WOUA-FIX / WRV1 / WRA1 之后。
+**关联 Issue**：`WDRG,WCP1,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1,WRA1`。
 **最近审计**：2026-05-19。
 **不得误读**：本文只控制后续开发节奏、阶段顺序和门禁。WHMSLIVE 后只代表企微 HR 主数据镜像已部署并受控验证；WAPI 后进一步固定企微 API/Secret 口径并转为运行优先；WRRA 后明确 `PASS_WITH_FINDINGS` 只代表只读对账成功且存在差异，不代表企微考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps 已完成运行时实现。
 
@@ -31,6 +31,7 @@
 | `WRRA` | 已固化路线修正 | 收紧运行优先退出门禁：`PASS_WITH_FINDINGS` 不能直接放行深度镜像；下一步默认先做 `WOUA-FIX / WECOM-RUNTIME-READY-V1`，收口用户一致性差异或明确 WHMS 同步窗口后再判断是否进入考勤/审批镜像准备。 |
 | `WOUA-FIX` | 已受控执行并公网复检 | 按用户确认将 7 个 OA active 缺企微测试账号软归档，修正 `T0000` seed 复活问题，并转交 `SMOKE201` 归档后遗留的测试主管/待办副作用；复检 OA active 5、企微 active 5、匹配 5、OA active 缺企微 0。剩余 5 个企微缺字段先接受不补，1 个归档绑定保留审计，不写企微资料、不执行真实员工 WHMS 批量 apply。 |
 | `WRV1` | 已部署并公网只读验证 | 新增 QA-only runner `server/src/scripts/check-wecom-runtime-ready.js` 和 `npm run check:wecom-runtime-ready`。公网 live 报告 `/app/artifacts/qa-flow/wecom-runtime-ready-20260518T173402Z/summary.json` 为 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`：入口/OAuth、Secret 矩阵、OA active 绑定、通讯录 `user/list_id`、人事助手 `get_staff_info` 和消息 dry-run 均通过；打卡读取因 `WECOM_CHECKIN_SYNC_ENABLED=true` 未启用而阻断；审批模板、测试 `sp_no`、真实回调配置仍为 `NEEDS_CONFIG`。不补企微资料、不发默认真实消息、不写 OA/企微用户资料。 |
+| `WRA1` | 已部署并公网复跑 | 修正 WRV1 门禁误判：`WECOM_CHECKIN_SYNC_ENABLED` 保留为正式考勤同步开关，但 QA-only 运行验收打卡只读探测显式使用 `requireSyncEnabled=false`。公网报告 `/app/artifacts/qa-flow/wecom-runtime-ready-20260518T180506Z/summary.json` 为 `PASS_WITH_CONFIG_GAPS`：打卡 API 只读可读且记录 `readable_sync_disabled`，审批模板、测试 `sp_no` 和真实回调仍为 `NEEDS_CONFIG`。 |
 
 ## 3. 阶段路线
 
@@ -156,6 +157,7 @@ WRRA 将 WAPI/WOUA 后的路线门禁修正为“运行优先 + 差异收口先
 
 - 工作台入口、OAuth/免登绑定、脱敏应用消息、OA deeplink、通讯录 userid 清单、人事助手花名册读取和打卡短窗口读取先做运行就绪门禁；本轮不配置审批模板、测试 `sp_no` 或真实回调。
 - runner 为 `server/src/scripts/check-wecom-runtime-ready.js` / `npm run check:wecom-runtime-ready`；默认只构建脱敏消息 payload，真实低风险消息必须同时指定 `--send-test-message` 和 `WECOM_RUNTIME_TEST_SEND=1`。
+- WRA1 后，`WECOM_CHECKIN_SYNC_ENABLED` 只作为正式考勤同步开关；QA-only 打卡短窗口读取可以显式绕过该开关做只读探测，报告记录 `readable_sync_disabled`，但不得启动正式同步批次。
 - 报告输出到 `artifacts/qa-flow/wecom-runtime-ready-<timestamp>/summary.json`，结论限定为 `PASS_RUNTIME_READY`、`PASS_WITH_CONFIG_GAPS` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
 - 对剩余企微缺字段保持 accepted finding，不补企微资料；如后续要补字段或 WHMS 真实员工批量 apply，必须另建写入合同。
 - `wecom_attendance_approval_mirror_v1` 继续暂缓，直到审批模板 ID、测试 `sp_no`、真实回调配置、回调验签/解密/幂等和打卡细项 POC 明确。