WRULE1 实现企微审批链校验器 POC
这个提交包含在：
+16
-3
@@ -477,10 +477,11 @@ Go 结论边界：
|
||||
| WROAD2-CLOSEOUT 三天验收 | 待 Day 1/2/3 自动采集 | Day 0 报告 `/app/artifacts/qa-flow/wroad2-ops-20260520-041941/summary.json` 为 `PASS_WITH_FINDINGS`。已知 observation 为 live smoke 凭据、pending OCR 子检查和历史 callback gap，不阻断受控试用；企微 runtime、审批补偿归档、OA 离线读取、打卡摘要 offline 可读和隐私扫描仍是主链路。三天内正常或已知 finding 不打扰，仅新增异常、状态恶化、阻断或脚本失败时通知。 |
|
||||
| WROAD2-BIZ1 三天业务冒烟 | 已建档，待人工执行 | 三天内补充真实业务动作：`SMOKE002` 每天按企微规则尝试上/下班打卡，提交低风险请假和补卡；`SMOKE101` 每条审批必须先打开详情再审批；`HYD000006` 每天查看 OA 企微审批归档历史和打卡摘要。人工业务冒烟不替代 WARCH3 自动巡检；无法打卡、无法审批或仍需手选审批人时，真实记录为 finding。 |
|
||||
| WAPPR1 审批规则规范化 | 已建档，作为真实试用前门禁 | 用户发现补卡申请需要申请人手动选择审批人，该现象作为 blocking finding 治理。测试模板固定 `SMOKE002 -> SMOKE101`；正式请假、补卡、外出、加班模板必须按直属主管、部门负责人或指定审批角色自动带出审批人；申请人不得任意选择审批人，审批人缺失、停用、未绑定、不可见或自审时阻断。 |
|
||||
| WREAL1-PREP 真实试用准备 | 仅规划，不启用真实员工 | 固化候选员工 active/已绑定/可见、审批人非本人、回滚联系人、允许流程、暂停条件和验收标准。当前继续测试账号；真实试用必须等请假、补卡、外出、加班四类测试号证据和 WAPPR1 审批规则门禁通过后再问答确认，默认仍从 1 名真实员工 + 1 名审批人/管理员观察开始。 |
|
||||
| WRULE1 审批链校验器 | 已建档并进入本地 POC | 固定“单一组织规则，两个执行域”：OA 维护主管链、业务审批角色和管理员兜底，企微执行 HR/考勤审批，OA 只读已归档审批详情并校验理论审批人是否匹配实际审批链。WRULE1 不读取企微后台规则、不写企微、不替代 WAPPR1 人工门禁。 |
|
||||
| WREAL1-PREP 真实试用准备 | 仅规划，不启用真实员工 | 固化候选员工 active/已绑定/可见、审批人非本人、回滚联系人、允许流程、暂停条件和验收标准。当前继续测试账号；真实试用必须等请假、补卡、外出、加班四类测试号证据和 WAPPR1/WRULE1 审批规则门禁通过后再问答确认，默认仍从 1 名真实员工 + 1 名审批人/管理员观察开始。 |
|
||||
| 外出/加班 | live POC 待三天验收后另建合同 | WEXT1 dry-run 证据保留；当前不创建企微外出/加班模板或审批单。已锁定 WEXT1-LIVE 方向：外出+加班两类一起创建 OA-POC 测试模板和低风险审批单，固定 `SMOKE002 -> SMOKE101`、`WECOM_AGENT_SECRET` 和双开关，样件保留审计，由 `SMOKE101` 真机确认。 |
|
||||
|
||||
三天验收结束后的人工问答选项固定为：进入 WEXT1-LIVE、先处理指定 finding、或暂停。外出/加班 live 写入前必须再次说明当前状态、改了什么、测了什么、结果是什么和会留下什么企微记录；四类测试号证据和 WAPPR1 审批规则门禁通过后，再问是否进入真实小范围试用。
|
||||
三天验收结束后的人工问答选项固定为：进入 WEXT1-LIVE、先处理指定 finding、或暂停。外出/加班 live 写入前必须再次说明当前状态、改了什么、测了什么、结果是什么和会留下什么企微记录；四类测试号证据和 WAPPR1/WRULE1 审批规则门禁通过后，再问是否进入真实小范围试用。
|
||||
|
||||
## WAUTO1 / WEXT1LD 自动证据汇总与 live 前 dry-run
|
||||
|
||||
@@ -512,7 +513,7 @@ Go 结论边界：
|
||||
| 项 | 当前结果 | 证据和边界 |
|
||||
| --- | --- | --- |
|
||||
| 路线合同 | 已建档 | 新增 `issues/2026-05-20_20-15-29-wecom-test-account-closeout-to-minimal-mirror-route-v1.csv`，作为 WFULLSMOKE1 后的路线锁定合同。 |
|
||||
| 测试号收口 | 已锁定 | 当前优先完成 WROAD2-CLOSEOUT、WROAD2-BIZ1、WAPPR1、WAUTO1、WEXT1LD 和 WFULLSMOKE1；WAPPR1 四类模板必须为 A，否则不进入 WEXT1-LIVE 或 WREAL1。 |
|
||||
| 测试号收口 | 已锁定 | 当前优先完成 WROAD2-CLOSEOUT、WROAD2-BIZ1、WAPPR1、WRULE1、WAUTO1、WEXT1LD 和 WFULLSMOKE1；WAPPR1 四类模板必须为 A，WRULE1 必须为 `PASS_RULE_MATCH` 或可解释 `PASS_WITH_ADMIN_FALLBACK`，否则不进入 WEXT1-LIVE 或 WREAL1。 |
|
||||
| 外出/加班 live | 待后续问答 | 只有三天验收、全域主路径、业务冒烟、规则门禁和 dry-run 均可解释通过后，才另建 WEXT1-LIVE 合同并再次问答是否一次性 live 创建外出+加班测试号样件。 |
|
||||
| 真实试用与镜像 | 后置 | WREAL1 首批固定为 1 名真实员工 + 1 名审批人/管理员观察；WREAL1 通过后优先规划 `wecom_attendance_approval_mirror_v1` 最小完整镜像，应急接管、恢复回写和 RuleOps 均后置。 |
|
||||
|
||||
@@ -531,6 +532,18 @@ Go 结论边界：
|
||||
| 外出/加班 live 前 dry-run | `PASS_FIXTURE_DRY_RUN_READY` | 公网报告 `/app/artifacts/qa-flow/wecom-approval-fixtures-20260520T125941Z/summary.json`；`secretMatrix=OK`、`actors=OK`、`liveWrite=DRY_RUN_READY`、`autoRerun=DRY_RUN_SKIPPED`。本轮没有设置 `WECOM_APPROVAL_FIXTURE_WRITE=1`，没有带 `--live --create-templates --submit-test-approvals`，没有创建企微模板或审批单。 |
|
||||
| 后续问答 | 待人工门禁 | dry-run 已具备进入问答的自动证据，但必须先由 `HYD000006` 确认请假、补卡、外出、加班四类模板均为 A；若出现 B/C/D，先修审批规则。WAPPR1 四类为 A 且三天业务动作可解释通过后，才问是否进入 WEXT1-LIVE；真实员工试用仍固定后置为 1 名真实员工 + 1 名审批人/管理员观察。 |
|
||||
|
||||
## WRULE1 企微 HR/考勤审批链校验器 POC
|
||||
|
||||
执行时间：2026-05-20。本轮只做本地只读 POC，不部署、不写 OA 业务数据、不写企业微信、不启用真实员工。
|
||||
|
||||
| 项目 | 状态 | 证据与边界 |
|
||||
| --- | --- | --- |
|
||||
| 执行合同 | 已建档 | 新增 `issues/2026-05-20_23-56-15-wecom-hr-approval-rule-validator-v1.csv`，ID 为 `WRULE1-0..WRULE1-7`。 |
|
||||
| 校验器 | 已实现 | 新增 `server/src/services/integrations/wecomApprovalRuleValidator.js` 和 `server/src/scripts/check-wecom-approval-rule-validator.js`；按 OA 直属主管、业务审批角色和管理员兜底计算理论审批人，再与 OA 已归档企微审批参与人/动作对比。 |
|
||||
| 结论分类 | 已固定 | `PASS_RULE_MATCH`、`PASS_WITH_ADMIN_FALLBACK`、`FAIL_APPLICANT_CAN_CHOOSE`、`FAIL_SELF_APPROVAL`、`FAIL_APPROVER_MISMATCH`、`PAUSED_MANUAL_CONFIRMATION`、`SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。 |
|
||||
| 人工门禁关系 | 不替代 WAPPR1 | `--manual-gate=<template>:A/B/C/D` 只登记管理员后台和真机提交页结论；缺门禁时输出 `PAUSED_MANUAL_CONFIRMATION`。WRULE1 只能证明已提交审批链是否匹配 OA 理论规则，不能证明申请页是否允许改审批人。 |
|
||||
| 隐私边界 | 已固化 | 报告只输出脱敏 `sp_no`、template、employee 前缀、计数和 finding 类型；不输出完整 userid、完整 template_id、完整审批单号、手机号、邮箱、token、Secret、表单值、附件、评论或原始 payload。 |
|
||||
|
||||
## 历史恢复
|
||||
|
||||
需要追溯 R70-R91 的详细流水时，使用：
|
||||
|
||||
在新工单中引用
屏蔽一个用户