wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

WAPPR1 固化企微审批规则API边界

浏览代码
这个提交包含在：
wangsli
2026-05-20 22:25:50 +08:00
父节点 1567ff10ac
当前提交 1440cfe9a2
共修改 9 个文件，包含 32 行新增和 22 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
docs/trialrun/人工试运行报告.md
+1
查看文件
@@ -524,6 +524,7 @@ Go 结论边界：
| --- | --- | --- |
| 执行合同 | 已建档 | 新增 `issues/2026-05-20_21-10-00-wecom-test-account-closeout-auto-dryrun-v1.csv`，ID 为 `WTCLOSE1-0..WTCLOSE1-8`。 |
| 审批规则 | 执行目标 A | 小团队 HR/考勤审批采用一层直属主管或指定审批角色自动带出审批人；申请人不能任意改人；主管链缺失、审批人不可见/停用/未绑定或命中自审时，由管理员兜底或阻断。请假、补卡、外出、加班四类模板若为 B/C/D，均为阻断 finding。 |
| WAPPR1 API 边界调研 | 已确认需人工门禁 | 企业微信 `gettemplatedetail` 只返回模板控件，`getapprovaldetail` 只返回已提交审批单的实际审批节点和审批人，均不能只读读取“申请人是否可手选审批人/审批规则配置”。`applyevent` 的 `use_template_approver=1` 可使用后台流程，但属于写入型验证且存在模板限制，不能作为通用只读门禁。因此 WAPPR1 必须由后台人工确认、真机提交页确认和 API 提交后实际审批链校验共同组成。 |
| 自动范围 | 只到汇总和 dry-run | 复跑 WAUTO1、WFULLSMOKE1 和外出/加班 dry-run；公网 OA 测试业务数据必须带 `TEST/SMOKE/WFULL` 标记并保留审计；不设置企微写入开关，不执行 live 创建。 |
| WAUTO1 公网汇总 | `PAUSED_MANUAL_CONFIRMATION` | 公网报告 `/app/artifacts/qa-flow/wecom-controlled-trial-evidence-20260520-130010/summary.json`；`/ready`、审批补偿只读、审批归档离线、打卡摘要 offline、外出/加班 dry-run 和隐私扫描完成；finding 为 WARCH3 历史 summary 缺口、审批补偿和归档离线既有 `PASS_WITH_FINDINGS`。人工门禁仍待 WROAD2-BIZ1 三天业务动作和 WAPPR1 四类模板确认。 |
| WFULLSMOKE1 公网全域 smoke | `PASS_WITH_FINDINGS` | 公网报告 `/app/artifacts/qa-flow/three-day-full-goal-smoke-20260520-125909/summary.json`；主控脚本完成三天全域目标聚合。finding 为 live feature flag/OA 公网写流程需凭据或人工确认、运行镜像缺部分浏览器 spec、既有 WARCH3/WROAD2/WAUTO1 观察项；未写企业微信，未创建外出/加班样件，未启用真实员工。 |
docs/企微API能力目录.md
+7 -4
查看文件
@@ -16,6 +16,7 @@
- WPROC1 后默认自动化优先：能用 runner 自动生成、自动检查、自动复跑的，不要求人工手动操作；人工只处理写入批准、Secret/Token/EncodingAESKey 配置、企微后台无法 API 化配置、真机确认和风险拍板。
- WPROC2 后，企微高风险合同必须先通过 `node scripts/qa/check-process-contract.mjs --baseline` 和对应 profile 的 process gate；WAPC2F 使用 `wecom-approval-fixture` profile。
- 审批类 POC 默认禁止自审；WAPC2F/WAPPR1 默认测试链为申请人 `SMOKE002`、审批人 `SMOKE101`，两者必须 active、已绑定企微、可见、不是同一 OA 员工且不是同一企微 userid。若 `SMOKE101` 不可用，不自动换人，返回配置缺口并问答确认。正式模板不得让申请人任意选择审批人，必须按直属主管、部门负责人或指定审批角色自动带出审批人；规则缺口在真实试用前按 `NEEDS_CONFIG` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` 处理。
- WAPPR1 官方 API 边界：企微审批模板详情接口只返回模板控件，审批申请详情接口只返回已提交后的实际流程节点；当前未发现只读接口可读取原生审批模板的“申请人是否可手选审批人/审批规则配置”。审批规则门禁必须保留后台人工确认和真机提交页确认，API 只做提交后的实际审批链校验。
- WEGOV1 后不假设企业微信自建应用存在完整隔离 sandbox；企微开发默认使用真实企业内受控测试域、本地 synthetic 自动测试、公网 live runner 和少量真机确认。
- OA 自建留存策略优先保存规范化业务数据、完整外部关联键和必要快照；报告和日志只输出脱敏前缀，不保存 Secret、token、EncodingAESKey、原始密文或无治理原始 payload。
- WROAD2 后每日巡检只允许写 OA 自建留存库，不写企业微信；补偿归档写入必须同时具备进程级 `WECOM_ARCHIVE_WRITE=1` 和 runner 的 `--persist-to-db`，并固定使用 `WECOM_AGENT_SECRET`。
@@ -58,11 +59,12 @@
| 员工打卡规则 | [获取员工打卡规则](https://developer.work.weixin.qq.com/document/path/90263) | `/cgi-bin/checkin/getcheckinoption` | `POST` | `WECOM_AGENT_SECRET` 或显式 `WECOM_CHECKIN_SECRET` | `CAN_REUSE_NOW_FOR_ARCHIVE` | WCHECK1 已新增只读规则快照能力，只保存规则摘要和 hash；报告只输出脱敏 userid 前缀、计数和状态，不保存原始 payload。 |
| 打卡日报/月报/排班 | [日报](https://developer.work.weixin.qq.com/document/path/93374)、[月报](https://developer.work.weixin.qq.com/document/path/93387)、[排班](https://developer.work.weixin.qq.com/document/path/93380) | 官方打卡扩展接口 | `POST` 为主 | `WECOM_AGENT_SECRET` 或显式 `WECOM_CHECKIN_SECRET` | `NEEDS_API_POC` | 不进入当前运行优先主线；后续考勤镜像合同时再做只读 POC。 |
| 审批概述 | [审批](https://developer.work.weixin.qq.com/document/path/91854) | 模板、实例、回调、假期 | 混合 | `WECOM_AGENT_SECRET` | `PARTIAL_NEEDS_CONFIG` | HR/考勤员工日常审批可优先在企微处理，但 OA 镜像尚未实现。 |
| 审批模板详情 | [获取审批模板详情](https://developer.work.weixin.qq.com/document/path/91982) | `/cgi-bin/oa/gettemplatedetail` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_FOR_POC_FIXTURES` | WAPC2 runner 已可读模板详情；WAPC2FLIVE 已自动创建 OA-POC 请假/补卡测试模板并复跑得到 `PASS_APPROVAL_POC`。正式模板和外出/加班仍需单独配置或 POC。 |
| 审批申请详情 | [获取审批申请详情](https://developer.work.weixin.qq.com/document/path/91983) | `/cgi-bin/oa/getapprovaldetail` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_FOR_ARCHIVE` | WAPC2 runner 已可读审批详情；WAPC2FLIVE 已提交低风险请假/补卡测试审批单并自动复跑通过。WARCH1 复用该接口作为补偿拉取详情最终校准来源，可在 `--persist-to-db` + `WECOM_ARCHIVE_WRITE=1` 双开关下写 OA 自建留存表；WROAD2 每日巡检只通过该路径补齐 OA 留存，不写企业微信。测试单不得包含采购、合同、报销、发票、银行回单或高敏附件。 |
| 审批模板详情 | [获取审批模板详情](https://developer.work.weixin.qq.com/document/path/91982) | `/cgi-bin/oa/gettemplatedetail` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_FOR_POC_FIXTURES` | WAPC2 runner 已可读模板详情；WAPC2FLIVE 已自动创建 OA-POC 请假/补卡测试模板并复跑得到 `PASS_APPROVAL_POC`。该接口只返回模板控件和字段结构，不返回审批流程规则，也不能证明申请人是否可改审批人。正式模板和外出/加班仍需单独配置或 POC。 |
| 审批申请详情 | [获取审批申请详情](https://developer.work.weixin.qq.com/document/path/91983) | `/cgi-bin/oa/getapprovaldetail` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_FOR_ARCHIVE` | WAPC2 runner 已可读审批详情；WAPC2FLIVE 已提交低风险请假/补卡测试审批单并自动复跑通过。该接口可校验已提交审批单的实际审批节点、审批人和状态，但不能证明申请页是否允许手选或修改审批人。WARCH1 复用该接口作为补偿拉取详情最终校准来源，可在 `--persist-to-db` + `WECOM_ARCHIVE_WRITE=1` 双开关下写 OA 自建留存表；WROAD2 每日巡检只通过该路径补齐 OA 留存，不写企业微信。测试单不得包含采购、合同、报销、发票、银行回单或高敏附件。 |
| 审批状态回调 | [审批申请状态变化回调通知](https://developer.work.weixin.qq.com/document/path/91815) | 事件回调 | `GET` URL 验证 / `POST` 事件 | 自建应用回调 Token/EncodingAESKey | `CAN_REUSE_NOW_FOR_ARCHIVE` | WCBK1 已部署只读 `GET/POST /api/wecom/approval/callback` 和 `check:wecom-approval-callback-poc`；公网真实事件已确认。WARCH1 后 POST 回调默认把规范化事件写入 `WecomApprovalCallbackEvent` 和 `WecomApprovalArchive`，DB 写入失败返回非 200 触发企微重试；不保存 Token、EncodingAESKey、原始 XML、密文或原始 payload。 |
| 批量获取审批单号 | [批量获取审批单号](https://developer.work.weixin.qq.com/document/path/91816) | `/cgi-bin/oa/getapprovalinfo` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_FOR_ARCHIVE` | WACP3/WACP3R 已新增 `check:wecom-approval-compensation-poc`，支持按 `creator` 自动发现 OA-POC 模板，再按 `template_id` filters 拉审批单号，并用 `getapprovaldetail` 拉详情；WARCH1 增加 OA DB 持久化双开关、补偿 run/item 和对账 finding，用于解决回调证据文件跨部署丢失问题。WROAD2+OPS 每日巡检复用该 runner；只允许以 `WECOM_ARCHIVE_WRITE=1` + `--persist-to-db` 写 OA 留存库，不写企微、不无过滤拉取高风险业务单据。 |
| 提交审批申请 | [提交审批申请](https://developer.work.weixin.qq.com/document/path/91853) | `/cgi-bin/oa/applyevent` | `POST` | `WECOM_AGENT_SECRET` | `DONE_LIVE_VERIFIED_FOR_OA_POC_FIXTURES` | 已接入 WAPC2F QA-only runner；请假/补卡已完成一次 live 创建并保留审计。WEXT1 扩展外出/加班 payload，但本轮只 dry-run；live 写入仍需显式 CLI、`WECOM_APPROVAL_FIXTURE_WRITE=1`、非自审预检和人工批准。OA 主办报销、采购、合同、项目不迁到企微原生审批。 |
| 提交审批申请 | [提交审批申请](https://developer.work.weixin.qq.com/document/path/91853) | `/cgi-bin/oa/applyevent` | `POST` | `WECOM_AGENT_SECRET` | `DONE_LIVE_VERIFIED_FOR_OA_POC_FIXTURES` | 已接入 WAPC2F QA-only runner；请假/补卡已完成一次 live 创建并保留审计。`use_template_approver=1` 可使用管理后台设置的模板流程，但这是写入型验证，会创建审批单；且官方文档限制部分模板不能通过接口提交，不能作为 WAPPR1 通用只读门禁。WEXT1 扩展外出/加班 payload，但本轮只 dry-run；live 写入仍需显式 CLI、`WECOM_APPROVAL_FIXTURE_WRITE=1`、非自审预检和人工批准。OA 主办报销、采购、合同、项目不迁到企微原生审批。 |
| 审批规则配置读取 | 审批模板详情、审批申请详情、提交审批申请、[审批流程引擎](https://developer.work.weixin.qq.com/document/path/90269) | 无原生审批规则只读接口 | N/A | N/A | `NOT_SUPPORTED_BY_API / NEEDS_MANUAL_GATE` | 当前未发现官方只读 API 可读取企微原生审批模板的“申请人自选节点”“是否允许改审批人”或后台审批规则配置。WAPPR1 必须用管理后台人工确认 + 真机提交页确认 + `getapprovaldetail` 实际审批链校验；审批流程引擎面向自建/第三方应用流程，不等同于读取或修改企业微信原生审批应用规则。 |
| 假期余额 | [获取成员假期余额](https://developer.work.weixin.qq.com/document/path/93376) | `/cgi-bin/oa/vacation/getuservacationquota` | `POST` | `WECOM_AGENT_SECRET` | `CAN_REUSE_NOW_OR_NEEDS_PERMISSION` | WCPC 已证明可读但历史有权限错误；后续作为考勤镜像的只读项。 |
| 审批模板创建/更新 | [创建审批模板](https://developer.work.weixin.qq.com/document/path/97437)、[更新审批模板](https://developer.work.weixin.qq.com/document/path/97438) | `/cgi-bin/oa/approval/create_template` 等官方模板写接口 | `POST` | `WECOM_AGENT_SECRET` | `DONE_LIVE_VERIFIED_FOR_OA_POC_FIXTURES` | WAPC2FLIVE 已用 `template_name` + `property` controls 结构创建 OA-POC 请假/补卡测试模板并保留审计。WEXT1 只为外出/加班构建 dry-run payload；正式模板更新、外出/加班 live 创建和 RuleOps 写入仍留后期合同。 |
@@ -74,6 +76,7 @@ WAPC1 后，企微审批相关能力进入“配置准备”状态。该状态
- 首批模板：请假、补卡、外出、加班。
- 每个模板需记录：模板 ID、适用范围、字段项、审批人规则、可见范围、所属自建应用权限。
- 审批人规则属于企微后台配置事实，当前不能用 `gettemplatedetail` 只读拉取；必须由管理员后台确认并在真机提交页复核。
- 测试审批单 `sp_no`：必须为低风险样例，不含采购、合同、报销、发票、银行回单、高敏附件或真实敏感业务资料。
- 回调配置：公网 Callback URL、Token、EncodingAESKey 只进入部署环境；本地文档只记录 `WECOM_APPROVAL_CALLBACK_URL`、`WECOM_CALLBACK_TOKEN`、`WECOM_CALLBACK_ENCODING_AES_KEY` 变量名和配置状态。
- 后续 POC：模板详情读取、审批详情读取、回调验签/解密、事件幂等、重试语义和补偿拉取方案。
@@ -117,7 +120,7 @@ WPROC1 将 WAPC2 之后的审批路线固定为：
- `WCHECK1` 新增 `npm run check:wecom-checkin-summary-archive`，用 `getcheckindata` 和 `getcheckinoption` 生成打卡摘要与规则快照；默认离线只读，写 OA 留存需 `WECOM_CHECKIN_ARCHIVE_WRITE=1`。
- `WEXT1` 扩展 `npm run check:wecom-approval-fixtures` 支持 `--target=outing --target=overtime`，本轮只 dry-run，不 live 创建外出/加班模板或审批单。
- `WROAD2-BIZ1` 补充测试账号人工业务冒烟：打卡、低风险请假/补卡、审批详情查看和 OA 离线历史查看；它不新增企微 API，不替代 WARCH3 自动巡检。
- `WAPPR1` 不新增写接口；它是审批模板配置门禁，要求申请人不得任意选择审批人，正式模板必须自动带出审批人，规则未通过不得进入真实员工试用。
- `WAPPR1` 不新增写接口；它是审批模板配置门禁，要求申请人不得任意选择审批人，正式模板必须自动带出审批人，规则未通过不得进入真实员工试用。由于官方 API 不支持只读读取原生审批规则，WAPPR1 结论必须由后台人工确认、真机提交页确认和 `getapprovaldetail` 提交后实际审批链校验共同组成。
### 6.1 WADM1 数据留存与 API 结果边界
docs/企微优先开发路线图.md
+2 -2
查看文件
@@ -96,7 +96,7 @@
| 18 | `WOPS1 巡检告警降噪` | 修正管理员告警收件人和重复 finding 告警策略。 | WARCH3 已公网验证，用户要求告警只报新增异常。 | 已公网验证：`/app/artifacts/qa-flow/warch3-ops-20260520-070731/summary.json` 为 `PASS_WITH_FINDINGS`，告警 `/app/artifacts/qa-flow/wecom-ops-alert-20260520T070740Z/summary.json` 为 `PASS_ALERT_SKIPPED_NO_FINDINGS`；默认收件员工号 `HYD000006`，重复已知 finding 不发送。 |
| 19 | `WROAD2-CLOSEOUT 三天验收` | 汇总 Day 0/1/2/3 巡检报告，决定是否进入外出/加班 live POC。 | WOPS1 本地和公网验证通过；WARCH3 timer 正常。 | 输出 `PASS_CONTROLLED_OPS_READY`、`PASS_WITH_FINDINGS`、`PAUSED_MANUAL_CONFIRMATION` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，并结合 WROAD2-BIZ1 人工业务冒烟结果问答确认。 |
| 20 | `WROAD2-BIZ1 三天业务冒烟` | 在测试账号范围补充真实业务动作：打卡、请假、补卡、OA 离线查看，并为外出/加班 live POC 准备人工验收清单。 | 用户选择三天内测试更多业务；仍限定测试账号。 | 输出 `PASS_BUSINESS_SMOKE_READY`、`PASS_WITH_FINDINGS`、`PAUSED_MANUAL_CONFIRMATION` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`；不写企微、不创建外出/加班样件。 |
| 21 | `WAPPR1 审批规则规范化门禁` | 统一企微 HR/考勤审批人规则，禁止申请人任意选择审批人。 | 发现补卡申请需要手动选择审批人；用户要求审批规则按规范自动化。 | 四类模板按模板给出 `PASS_APPROVER_RULES_READY`、`PASS_WITH_TEMPLATE_ADJUSTMENTS`、`FAIL_KEEP_OA_PRIMARY_FOR_THIS_TEMPLATE` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`；规则不通过不得进入真实试用。 |
| 21 | `WAPPR1 审批规则规范化门禁` | 统一企微 HR/考勤审批人规则，禁止申请人任意选择审批人。 | 发现补卡申请需要手动选择审批人；用户要求审批规则按规范自动化；官方 API 不支持只读读取原生模板审批规则。 | 四类模板按模板给出 `PASS_APPROVER_RULES_READY`、`PASS_WITH_TEMPLATE_ADJUSTMENTS`、`FAIL_KEEP_OA_PRIMARY_FOR_THIS_TEMPLATE` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`；规则不通过不得进入真实试用。WAPPR1 必须保留后台人工确认和真机提交页确认，API 只校验提交后的实际审批链。 |
| 22 | `WAUTO1 受控试用证据自动汇总` | 自动汇总三天受控试用证据，准备 WAPPR1 人工确认和 WEXT1-LIVE 问答。 | WROAD2-BIZ1/WAPPR1 已建档，用户要求能自动执行的全部脚本化。 | 新脚本默认只读，不触发补偿归档写库，不写企微；输出脱敏 summary 和 WAPPR1 人工清单。 |
| 23 | `WEXT1LD 外出/加班 live 前 dry-run gate` | 在 live 创建前远端只执行外出/加班 dry-run。 | WEXT1 dry-run runner 已存在；用户要求 live 前先自动 dry-run。 | 不带 live 写入参数；通过后只进入问答，不自动创建模板或审批单。 |
| 24 | `WFULLSMOKE1 三天全域最终目标测试` | 汇总企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检主路径。 | 用户要求三天内测试整个项目最终目标；WROAD2/WARCH3/WCHECK1/WROAD2-BIZ1/WAPPR1/WAUTO1/WEXT1LD 已建立。 | 输出 `PASS_FULL_GOAL_SMOKE_READY`、`PASS_WITH_FINDINGS`、`PAUSED_MANUAL_CONFIRMATION` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`；只允许 `TEST/SMOKE/WFULL` OA 测试数据，不写企微、不真实付款、不写 ERP、不导入银行流水。 |
@@ -365,7 +365,7 @@ WROAD2+OPS 把 WARCH2 后的可用能力先进入测试账号受控使用，不
- 结果边界：结论只允许 `PASS_CONTROLLED_OPS_READY`、`PASS_WITH_FINDINGS`、`PAUSED_MANUAL_CONFIRMATION` 或真实 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
- 后续顺序：WROAD2+OPS 后优先 `WARCH3` 归档稳定化，再做 `WCHECK1` 打卡摘要留存；外出/加班进入 `WEXT1` dry-run。上述阶段完成前，不启动完整深度镜像、应急接管、恢复回写或 RuleOps。
- 业务冒烟：WROAD2-BIZ1 在三天内补充人工业务动作，不替代自动巡检。`SMOKE002` 每天按企微规则尝试上/下班打卡，提交低风险请假和补卡；`SMOKE101` 必须先打开详情再审批；`HYD000006` 每天查看 OA 企微审批归档和打卡摘要。无法打卡、无法审批或仍需手选审批人时按 finding 记录，不伪造成通过。
- 审批规则：WAPPR1 把“申请人不得任意选择审批人”列为真实试用前门禁。测试模板固定 `SMOKE002 -> SMOKE101`；正式模板必须按直属主管、部门负责人或指定审批角色自动带出审批人；审批人缺失、停用、未绑定、不可见或等于申请人本人时阻断。
- 审批规则：WAPPR1 把“申请人不得任意选择审批人”列为真实试用前门禁。测试模板固定 `SMOKE002 -> SMOKE101`；正式模板必须按直属主管、部门负责人或指定审批角色自动带出审批人；审批人缺失、停用、未绑定、不可见或等于申请人本人时阻断。企微 API 不能只读读取原生模板的审批规则配置，因此后台人工确认和真机提交页确认是 WAPPR1 必要证据，`getapprovaldetail` 只作为提交后实际审批链校验。
- 自动证据：WAUTO1 使用 `scripts/qa/collect-wecom-controlled-trial-evidence.sh` 只读汇总三天证据，读取既有 WROAD2/WARCH3/WCHECK1/WEXT1 报告并复跑只读/离线 runner；该脚本不设置 `WECOM_ARCHIVE_WRITE=1`、`WECOM_CHECKIN_ARCHIVE_WRITE=1` 或 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不替代 WARCH3 定时巡检和人工业务冒烟。
- 全域总控：WFULLSMOKE1 使用 `scripts/qa/run-three-day-full-goal-smoke.sh` 聚合企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检；具备 live smoke 凭据时只允许创建 `TEST/SMOKE/WFULL` 标记的 OA 测试业务数据，不写企业微信、不真实付款、不接真实支付、不写 ERP、不导入银行流水。
docs/文档事实源状态矩阵.md
+4 -4
查看文件
@@ -97,7 +97,7 @@
| `WOPS1` | `issues/2026-05-20_14-35-42-warch3-ops-alert-tuning-v1.csv` | `CURRENT` | 巡检告警降噪与管理员收件人修正已公网验证：默认收件员工号为 `HYD000006`（`wangshunli` 的员工号），状态文件记录上次状态和 finding 摘要；远端 WARCH3 `/app/artifacts/qa-flow/warch3-ops-20260520-070731/summary.json` 为 `PASS_WITH_FINDINGS`，告警 `/app/artifacts/qa-flow/wecom-ops-alert-20260520T070740Z/summary.json` 为 `PASS_ALERT_SKIPPED_NO_FINDINGS`；已知 finding 不重复告警，仅阻断、脚本失败、新增 finding、状态恶化或人工 `--force` 发送脱敏消息 |
| `WROAD2-CLOSEOUT` | `issues/2026-05-20_14-35-42-wroad2-controlled-ops-closeout-v1.csv` | `CURRENT` | 三天受控巡检验收合同：Day 1/2/3 由 WARCH3 timer 采集后汇总，已知 live smoke 凭据、pending OCR 和历史 callback gap 作为 observation 不阻断；结束后需结合 WROAD2-BIZ1 和 WAPPR1 结论，再问答确认进入 WEXT1-LIVE、先处理 finding 或暂停，不直接启用真实员工 |
| `WROAD2-BIZ1` | `issues/2026-05-20_17-13-57-wroad2-business-smoke-v1.csv` | `CURRENT` | 三天测试账号业务冒烟合同：不替代 WARCH3 自动巡检；`SMOKE002` 每天按企微规则尝试打卡并提交低风险请假/补卡，`SMOKE101` 先看详情再审批，`HYD000006` 查看 OA 企微审批归档和打卡摘要；无法打卡、无法审批或仍需手选审批人时记录 finding；不写企业微信、不启用真实员工 |
| `WAPPR1` | `issues/2026-05-20_17-13-57-wecom-approval-rule-governance-v1.csv` | `CURRENT` | 企微审批规则规范化门禁合同：补卡手动选择审批人现象作为 blocking finding；测试模板固定 `SMOKE002 -> SMOKE101`；正式请假、补卡、外出、加班模板必须按直属主管、部门负责人或指定审批角色自动带出审批人；申请人不得任意选择审批人；审批人缺失、停用、未绑定、不可见或自审时阻断；规则未通过不得进入真实试用 |
| `WAPPR1` | `issues/2026-05-20_17-13-57-wecom-approval-rule-governance-v1.csv` | `CURRENT` | 企微审批规则规范化门禁合同：补卡手动选择审批人现象作为 blocking finding；测试模板固定 `SMOKE002 -> SMOKE101`；正式请假、补卡、外出、加班模板必须按直属主管、部门负责人或指定审批角色自动带出审批人；申请人不得任意选择审批人；审批人缺失、停用、未绑定、不可见或自审时阻断；官方 API 不支持只读读取原生模板审批规则，WAPPR1 需后台人工确认 + 真机提交页确认 + API 实际审批链校验；规则未通过不得进入真实试用 |
| `WAUTO1` | `issues/2026-05-20_18-04-16-wecom-controlled-trial-auto-evidence-v1.csv` | `CURRENT` | 受控试用证据自动汇总合同已实现：新增 `scripts/qa/collect-wecom-controlled-trial-evidence.sh`，只读汇总 WROAD2/WARCH3/WCHECK1/WROAD2-BIZ1/WAPPR1/WEXT1 dry-run 证据，复跑 `/ready`、WARCH3 summary-only、审批补偿只读、审批归档离线、打卡摘要 offline、外出/加班 dry-run 和隐私扫描；默认不写 OA DB、不写企业微信、不创建模板或审批单 |
| `WEXT1LD` | `issues/2026-05-20_18-04-16-wecom-outing-overtime-live-dryrun-gate-v1.csv` | `CURRENT` | 外出/加班 live 前 dry-run gate 已实现：远端只执行 `npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime`，固定 `SMOKE002 -> SMOKE101` 与 `WECOM_AGENT_SECRET`；不设置写入环境变量、不带 live 写入参数，dry-run 通过后仍需人工问答批准或暂停 |
| `WFULLSMOKE1` | `issues/2026-05-20_19-01-12-three-day-full-goal-smoke-v1.csv` | `CURRENT` | 三天全域最终目标测试总控合同已建立：新增 `scripts/qa/run-three-day-full-goal-smoke.sh` 聚合企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检；允许带 `TEST/SMOKE/WFULL` 标记的 OA 测试业务数据，不写企业微信、不创建外出/加班样件、不启用真实员工、不真实付款、不接真实支付、不写 ERP、不导入银行流水 |
@@ -117,18 +117,18 @@
| `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WAPC1,WAPC2FLIVE,WCBK1,WEGOV1` | `rg` | none | 2026-05-19 | `rg` | high | 记录已拍板产品边界、企微/OA 设计门禁、开发路线图、WCBK1 真实回调事件证据、WEGOV1 混合主办边界和 OA 自建留存策略 |
| `DESIGN-UI` | `docs/产品设计规则.md` | 设计事实源 | PC/移动/企业微信设计事实源 | `CURRENT` | design/frontend | `MIA7,MIF7,GOV8,DG8,DG9,WFDG` | Playwright/视觉审查/DG8/DG9/WFDG | none | 2026-05-18 | `rg` | high | 页面改动必须读取；DG8 后飞书为主 UI/布局参考；DG9 后按页面分层和样板选型；WFDG 后区分 OA 主办、企微镜像和 OA 应急接管 |
| `ROADMAP-WECOM` | `docs/企微优先开发路线图.md` | 开发治理 | 企微优先开发路线图事实源 | `CURRENT` | product/dev | `WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WOUAFIX,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WROUTE2,WTCLOSE1,WREAL1P` | Issue CSV | none | 2026-05-20 | `rg` | high | WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE1 后固定最小审批历史留存、正式只读历史查询、受控上线自动巡检、三天业务冒烟、审批规则规范化、自动证据汇总、全域最终目标测试、小团队一层审批 + 管理员兜底、告警降噪、打卡摘要、外出/加班 dry-run、live 前 dry-run gate、WEXT1-LIVE 前置和真实试用准备；仍禁止直接进入深度镜像 |
| `WECOM-API-CATALOG` | `docs/企微API能力目录.md` | 集成事实源 | 企微 API 能力目录和 Secret 矩阵事实源 | `CURRENT` | product/backend/qa | `WAPI,WRRA,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1` | 官方企业微信开发者中心链接/Issue CSV | none | 2026-05-20 | `rg` | high | 企微开发先读；只保存摘要、链接和项目决策，不保存 Secret、token、完整 userid、手机号、邮箱或原始 payload；记录审批补偿、打卡摘要和巡检只写 OA 留存、不写企业微信的边界 |
| `WECOM-API-CATALOG` | `docs/企微API能力目录.md` | 集成事实源 | 企微 API 能力目录和 Secret 矩阵事实源 | `CURRENT` | product/backend/qa | `WAPI,WRRA,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WAPPR1,WTCLOSE1` | 官方企业微信开发者中心链接/Issue CSV | none | 2026-05-20 | `rg` | high | 企微开发先读；只保存摘要、链接和项目决策，不保存 Secret、token、完整 userid、手机号、邮箱或原始 payload；记录审批补偿、打卡摘要、巡检只写 OA 留存、不写企业微信，以及企微原生审批规则不可只读 API 化、需人工门禁的边界 |
| `DELIVERY` | `docs/开发交付与变更管理规约.md` | 开发治理 | 开发交付事实源 | `CURRENT` | dev/qa | `GOV8,WDRG,WRRA,WAPC1,WPROC1,WPROC2,WCBK1,WEGOV1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1` | `rg` | none | 2026-05-20 | `rg` | high | Issue、review、commit、交付规则；WFULLSMOKE1 后固定 WAUTO1、WEXT1LD、全域最终目标测试和 WEXT1-LIVE/WREAL1 前置门禁 |
| `QA-GATE` | `docs/测试规约与回归门禁.md` | 测试验收 | 测试和回归门禁事实源 | `CURRENT` | qa | `QAF8,GOV8,WPROC1,WPROC2,WAPC2FLIVE,WCBK1,WEGOV1` | 回归脚本/Playwright | none | 2026-05-19 | `rg` | high | 测试计划、DONE 门禁、企微三层门禁、自动化优先、非自审、无完整 sandbox 假设、WREAD1 真机可读性和 WARCH1 留存验收门禁 |
| `AGENT-PRACTICE` | `docs/Agent开发交付实践.md` | Agent 治理 | Agent 协作事实源 | `CURRENT` | dev | `GOV8,DG8` | Skill 校验 | none | 2026-05-13 | `rg` | medium | Agent 协作开发实践和设计主参考层级 |
| `AGENTS` | `AGENTS.md` | 执行硬约束 | 项目硬规则 | `CURRENT` | lead | `GOV8` | 人工核对 | none | 2026-05-13 | `rg` | high | 不可违反约束 |
| `SKILL-HYB` | `.agents/skills/hyb-oa-delivery/SKILL.md` | Skill | 项目交付 Skill | `CURRENT` | dev | `GOV8,DG8,WFDG,WDRG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WROUTE2,WTCLOSE1,WREAL1P` | quick_validate | none | 2026-05-20 | `quick_validate.py` | medium | 每轮交付操作入口；企微/OA 后续先读 API 能力目录、Secret 矩阵、路线图、WEGOV1/WADM1/WARCH1/WARCH2/WROAD2/WARCH3/WCHECK1/WEXT1/WOPS1/WROAD2B/WAPPR1/WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE1 自建留存、受控巡检、业务冒烟、审批规则、自动证据汇总、全域收口 dry-run 和告警降噪边界；不得绕过 WROAD2C/WROAD2B/WAPPR1/WAUTO1/WEXT1LD/WFULLSMOKE1/WTCLOSE1/WEXT1-LIVE/WREAL1 或后续独立合同直接做完整考勤审批镜像 |
| `REQ-WF` | `docs/需求-统一审批中心规约.md` | 需求事实源 | 审批模块规约 | `CURRENT` | product/backend | `AP6,WF8,WFOC,DBWFOC,WFDG,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1` | workflow 回归 | none | 2026-05-20 | `rg` | high | OA 主办审批、企微主办 HR/考勤审批、OA 自建留存、真实回调事件证据、WACP3R 补偿拉取 findings、WREAD1 请假/补卡真机可读性结论、WARCH1 最小历史留存、WAPPR1 审批规则规范化、WTCLOSE1 小团队一层审批 + 管理员兜底目标 A、WAUTO1/WEXT1LD/WFULLSMOKE1 前置和 OA 应急接管边界 |
| `REQ-WF` | `docs/需求-统一审批中心规约.md` | 需求事实源 | 审批模块规约 | `CURRENT` | product/backend | `AP6,WF8,WFOC,DBWFOC,WFDG,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WREAD1F,WADM1,WARCH1,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1` | workflow 回归 | none | 2026-05-20 | `rg` | high | OA 主办审批、企微主办 HR/考勤审批、OA 自建留存、真实回调事件证据、WACP3R 补偿拉取 findings、WREAD1 请假/补卡真机可读性结论、WARCH1 最小历史留存、WAPPR1 审批规则规范化和 API 不支持读取规则边界、WTCLOSE1 小团队一层审批 + 管理员兜底目标 A、WAUTO1/WEXT1LD/WFULLSMOKE1 前置和 OA 应急接管边界 |
| `REQ-OCR` | `docs/需求-报销发票OCR规约.md` | 需求事实源 | OCR 模块规约 | `CURRENT` | product/backend | `RI6,OCR8,BIZ8` | OCR 回归 | none | 2026-05-13 | `rg` | high | OCR 和发票边界 |
| `RULE-REIMB` | `docs/报销发票附件规则.md` | 需求事实源 | 报销发票附件规则 | `CURRENT` | product/finance | `RI6,BIZ8` | 报销回归 | none | 2026-05-13 | `rg` | high | 报销、发票、附件细则 |
| `REQ-WECOM` | `docs/需求-企业微信基础设施规约.md` | 需求事实源 | 企业微信边界规约 | `CURRENT` | product/backend | `R7E,ORG8,WF8,ATTV1,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WCP1,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1` | live smoke/真机反馈/Issue CSV | none | 2026-05-20 | `rg` | high | 企微优先承担 HR/考勤员工日常审批和人事/打卡能力；WARCH2 已提供请假/补卡正式只读历史查询，WARCH3 固定受控上线自动巡检，WCHECK1 固定打卡摘要留存，WEXT1 固定外出/加班 dry-run，WROAD2B 固定三天人工业务冒烟，WAPPR1/WTCLOSE1 固定审批规则规范化和小团队目标 A，WFULLSMOKE1 固定全域主路径测试边界，WEXT1-LIVE 需三天验收后另建合同；采购、合同、项目、报销和财务继续 OA 主办 |
| `RUNBOOK-TRIAL` | `docs/试运行与自动化验证手册.md` | 操作手册 | 试运行验证手册 | `CURRENT` | qa/ops | `R7E,QAOPS8` | live readiness | none | 2026-05-13 | `rg` | medium | 本地、公网、企业微信和真实 OCR 验证 |
| `MANUAL-ADMIN` | `docs/管理员手册.md` | 操作手册 | 管理员手册 | `CURRENT` | ops/admin | `ORG8,R7E,WFOC,DBWFOC,WFDG,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WREAL1P` | 人工验收 | none | 2026-05-20 | `rg` | medium | 管理员上线、企微优先边界、Secret 矩阵、WARCH3 自动巡检与脱敏告警、WOPS1 告警降噪、WCHECK1 打卡摘要留存、WROAD2B 三天业务冒烟、WAPPR1/WTCLOSE1 审批规则规范化和小团队目标 A、WAUTO1 自动证据汇总、WFULLSMOKE1 全域最终目标测试、WEXT1 外出/加班 dry-run、WEXT1-LIVE 前置、WREAL1 准备和深度镜像前置关注点 |
| `MANUAL-ADMIN` | `docs/管理员手册.md` | 操作手册 | 管理员手册 | `CURRENT` | ops/admin | `ORG8,R7E,WFOC,DBWFOC,WFDG,WCPC,WHMS,WHMSLIVE,WOUA,WAPI,WRRA,WRV1,WRA1,WMSG1,WAPC1,WAPC2,WPROC1,WPROC2,WAPC2F,WAPC2FLIVE,WCBK1,WEGOV1,WACP3,WACP3R,WREAD1,WADM1,WARCH1,WARCH2,WROAD2,WARCH3,WCHECK1,WEXT1,WOPS1,WROAD2C,WROAD2B,WAPPR1,WAUTO1,WEXT1LD,WFULLSMOKE1,WTCLOSE1,WREAL1P` | 人工验收 | none | 2026-05-20 | `rg` | medium | 管理员上线、企微优先边界、Secret 矩阵、WARCH3 自动巡检与脱敏告警、WOPS1 告警降噪、WCHECK1 打卡摘要留存、WROAD2B 三天业务冒烟、WAPPR1/WTCLOSE1 审批规则规范化和 API 不支持读取规则后的人工后台/真机门禁、小团队目标 A、WAUTO1 自动证据汇总、WFULLSMOKE1 全域最终目标测试、WEXT1 外出/加班 dry-run、WEXT1-LIVE 前置、WREAL1 准备和深度镜像前置关注点 |
| `MANUAL-EMPLOYEE` | `docs/员工快速上手.md` | 操作手册 | 员工手册 | `CURRENT` | product | `R7E,WFOC,DBWFOC,WFDG` | 人工验收 | none | 2026-05-18 | `rg` | low | 员工侧使用说明，HR/考勤优先企业微信，采购/合同/财务仍在 OA；区分企微镜像和 OA 应急接管 |
| `R7-DRAFT` | `docs/trialrun/R7扩大试运行草案.md` | 草案 | R7 准备材料 | `DRAFT` | product/qa | `R7E` | R7EP 报告 | none | 2026-05-13 | `rg` | medium | 不代表当前 R7E 执行状态 |
| `OPS-RUNBOOK` | `docs/trialrun/OPS7运维交接Runbook.md` | 运维草案 | OPS 准备材料 | `DRAFT` | ops | `OPS8,QAOPS8` | 只读检查 | none | 2026-05-13 | `rg` | medium | 不代表恢复演练已执行 |
docs/文档索引.md
+2 -2
查看文件
@@ -63,7 +63,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
- WCPC 是 WCP1 后的配置收口合同：已使用既有在职低风险测试号 `SMOKE002/测试员工`（报告只记录 `oa_smoke***`）完成远端只读复跑，报告 `/tmp/wecom-capability-poc-wcpc-smoke002/summary.json`，结论 `GO_TO_HR_MASTER_SYNC`。WHMS 已承接该准入结论；审批模板 ID、审批单号 `sp_no`、真实回调配置和 HR 写接口仍需后续独立合同处理。
- WHMS/WHMSLIVE 是 WCPC 后的企微 HR 主数据镜像合同和部署验证合同：已实现并部署 `wecom_hr_master_sync_v1`、企微/人事助手读取服务、dry-run/apply、同步批次/逐员工记录、People 管理入口和 QA-only runner；公网对 `SMOKE002`（脱敏 `oa_smoke***`）完成 dry-run/apply 管道验证，缺手机号、邮箱和部门按 `missing_required_field` 跳过；权限负例 403；最终 `force_off`，未执行生产真实员工批量 apply。WAPI 后其读取口径被修正为通讯录 `user/list_id` + 人事助手 `get_staff_info`，不再用运行时 Secret fallback。
- WOUA 是 WHMSLIVE 后的 OA/企微用户一致性只读审计合同：已新增 QA-only runner `server/src/scripts/audit-wecom-oa-user-consistency.js`，本地静态/单测门禁通过并以 `SYNC_ENV=0` 部署执行；初始公网报告因旧读取路径为 `SKIP / BLOCKED_BY_EXTERNAL_CONFIG`。WAPI 后按新 API/Secret 口径复跑成功，远端脱敏报告 `/app/artifacts/qa-flow/wecom-oa-user-consistency-20260518T142544Z/summary.json` 为 `PASS_WITH_FINDINGS`，计数为 `oaEmployees=13`、`oaActiveEmployees=12`、`oaActiveWithBinding=5`、`wecomProfiles=5`、`matchedActive=5`、`oaActiveMissingInWecom=7`、`inactiveWithBinding=1`、`missingRequiredFields=5`。本轮未修改 OA/企微用户，未执行真实员工批量 apply，不代表 OA/企微用户已经一致。
- WAPI 是 WOUA 后的企微 API 能力目录与运行优先纠偏合同：新增 [企微 API 能力目录](./企微API能力目录.md)，固定通讯录用 `WECOM_CONTACT_SECRET`、人事助手/打卡/消息/OAuth 用 `WECOM_AGENT_SECRET`、`WECOM_CHECKIN_SECRET` 仅作显式打卡 override、`WECOM_HR_ASSISTANT_SECRET` 仅历史兼容；后续企微能力不清楚时先查官方 API 和本地目录，不在运行时代码里轮询多个 Secret 试错。WAPI 已把通讯录成员详情降级为可选富化并完成 WOUA 公网复跑，后续由 WRRA/WOUA-FIX 承接路线与差异收口。
- WAPI 是 WOUA 后的企微 API 能力目录与运行优先纠偏合同：新增 [企微 API 能力目录](./企微API能力目录.md)，固定通讯录用 `WECOM_CONTACT_SECRET`、人事助手/打卡/消息/OAuth 用 `WECOM_AGENT_SECRET`、`WECOM_CHECKIN_SECRET` 仅作显式打卡 override、`WECOM_HR_ASSISTANT_SECRET` 仅历史兼容；后续企微能力不清楚时先查官方 API 和本地目录，不在运行时代码里轮询多个 Secret 试错。WAPPR1 后已补充审批规则 API 边界：原生审批模板的“申请人是否可手选审批人/审批规则配置”不能只读读取，必须保留后台人工确认和真机门禁。WAPI 已把通讯录成员详情降级为可选富化并完成 WOUA 公网复跑，后续由 WRRA/WOUA-FIX 承接路线与差异收口。
- WRRA 是 WAPI 后的企微路线门禁修正合同：只做 docs-only 路线修正，不改业务代码、不部署、不写 OA/企微数据；明确 `PASS_WITH_FINDINGS` 不能直接放行深度镜像，并已由 WOUA-FIX 承接测试账号差异收口；后续默认进入 `WECOM-RUNTIME-READY-V1`。
- WOUA-FIX 是 WRRA 后的 OA/企微用户一致性差异收口合同：按用户确认软归档 7 个缺企微测试/Smoke 账号，修正 `T0000` seed 复活，转交 `SMOKE201` 归档后的测试主管和待办副作用；复检 OA active 5、企微 active 5、匹配 5、OA active 缺企微 0。企微缺字段先接受不补，归档绑定保留审计，不写企微资料、不执行真实员工 WHMS 批量 apply。
- WRV1 是 WOUA-FIX 后的企业微信运行优先门禁合同：新增 `server/src/scripts/check-wecom-runtime-ready.js` 和 `npm run check:wecom-runtime-ready`，检查工作台入口、OAuth/绑定、脱敏消息、OA deeplink、通讯录 `user/list_id`、人事助手 `get_staff_info` 和打卡短窗口读取；已部署并远端 live 只读验证，报告 `/app/artifacts/qa-flow/wecom-runtime-ready-20260518T173402Z/summary.json` 为 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，阻断点是 `WECOM_CHECKIN_SYNC_ENABLED=true` 未启用；审批模板、测试 `sp_no` 和真实回调缺口记录为 `NEEDS_CONFIG`，不放行深度镜像。
@@ -163,7 +163,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| `WEXT1LD` | `issues/2026-05-20_18-04-16-wecom-outing-overtime-live-dryrun-gate-v1.csv` | 当前外出/加班 live 前 dry-run gate：只做远端 dry-run，不授权 live 写入 | 远端执行 `npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime`；固定 `SMOKE002 -> SMOKE101` 和 `WECOM_AGENT_SECRET` | 不设置 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不带 live 写入参数；通过后仍需问答是否 live 创建样件 |
| `WFULLSMOKE1` | `issues/2026-05-20_19-01-12-three-day-full-goal-smoke-v1.csv` | 当前三天全域最终目标测试总控：覆盖企微 HR/考勤、OA 主办域、移动端和运维巡检 | 新增 `scripts/qa/run-three-day-full-goal-smoke.sh`，聚合 `/ready`、feature flag、WARCH3/WAUTO1、审批归档、打卡摘要、OA 报销/采购/付款批次主路径、移动/企微入口和隐私扫描 | 只允许 `TEST/SMOKE/WFULL` OA 测试业务数据；不写企业微信、不创建外出/加班样件、不启用真实员工、不真实付款、不接真实支付、不写 ERP、不导入银行流水 |
| `WROUTE2` | `issues/2026-05-20_20-15-29-wecom-test-account-closeout-to-minimal-mirror-route-v1.csv` | 当前后续路线锁定：测试号全域收口 -> 外出/加班 live POC -> 真实小试用 -> 最小完整镜像 | 固化 WAPPR1 A 为 WEXT1-LIVE 和 WREAL1 硬门禁；WREAL1 首批固定为 1 名真实员工 + 1 名审批人/管理员观察；WREAL1 通过后优先规划 `wecom_attendance_approval_mirror_v1` 最小完整镜像 | 不写企业微信；不启用真实员工；不创建外出/加班样件；应急接管、恢复回写和 RuleOps 继续后置 |
| `WTCLOSE1` | `issues/2026-05-20_21-10-00-wecom-test-account-closeout-auto-dryrun-v1.csv` | 当前小团队自动审批规则与测试号全域收口 dry-run：公司不到 10 人时，四类 HR/考勤模板目标均为 A | 固化一层主管或指定审批角色 + 管理员兜底规则；公网 WAUTO1 `/app/artifacts/qa-flow/wecom-controlled-trial-evidence-20260520-130010/summary.json` 为 `PAUSED_MANUAL_CONFIRMATION`，WFULLSMOKE1 `/app/artifacts/qa-flow/three-day-full-goal-smoke-20260520-125909/summary.json` 为 `PASS_WITH_FINDINGS`，外出/加班 dry-run `/app/artifacts/qa-flow/wecom-approval-fixtures-20260520T125941Z/summary.json` 为 `PASS_FIXTURE_DRY_RUN_READY` | 不写企业微信；不创建外出/加班模板或审批单；不启用真实员工；WAPPR1 四类未达到 A 前不进入 WEXT1-LIVE 或 WREAL1 |
| `WTCLOSE1` | `issues/2026-05-20_21-10-00-wecom-test-account-closeout-auto-dryrun-v1.csv` | 当前小团队自动审批规则与测试号全域收口 dry-run：公司不到 10 人时，四类 HR/考勤模板目标均为 A | 固化一层主管或指定审批角色 + 管理员兜底规则；公网 WAUTO1 `/app/artifacts/qa-flow/wecom-controlled-trial-evidence-20260520-130010/summary.json` 为 `PAUSED_MANUAL_CONFIRMATION`，WFULLSMOKE1 `/app/artifacts/qa-flow/three-day-full-goal-smoke-20260520-125909/summary.json` 为 `PASS_WITH_FINDINGS`，外出/加班 dry-run `/app/artifacts/qa-flow/wecom-approval-fixtures-20260520T125941Z/summary.json` 为 `PASS_FIXTURE_DRY_RUN_READY`；WAPPR1 API 边界已补充为 `NOT_SUPPORTED_BY_API / NEEDS_MANUAL_GATE` | 不写企业微信；不创建外出/加班模板或审批单；不启用真实员工；WAPPR1 四类未达到 A 前不进入 WEXT1-LIVE 或 WREAL1 |
| `WREAL1-PREP` | `issues/2026-05-20_14-35-42-wecom-real-trial-prep-v1.csv` | 当前真实试用准备：不启用真实员工 | 固化候选员工、非自审审批人、回滚联系人、允许流程、暂停条件和验收标准；真实试用必须等请假、补卡、外出、加班四类测试号证据、WAPPR1 和 WFULLSMOKE1 通过后再问 | 当前不创建外出/加班 live 样件；真实员工名单不写入 Issue 或文档，后续通过问答确认 |
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
docs/管理员手册.md
+11 -9
查看文件
@@ -340,15 +340,17 @@ WROAD2/WARCH3 企微受控上线每日巡检：
10. WEXT1 外出/加班 dry-run：`cd server && npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime`；live 创建必须另起 `WEXT1-LIVE` 合同，并再次说明状态、测试结果、企微留痕和清理/保留边界后人工确认。
11. WROAD2-BIZ1 三天人工业务冒烟：`SMOKE002` 每天按企微规则尝试上/下班打卡，提交低风险请假和补卡；`SMOKE101` 每条审批必须先打开详情再同意或驳回；`HYD000006` 每天查看 OA 企微审批归档历史和打卡摘要。无法打卡、无法审批或仍需手动选择审批人时，按 finding 记录，不伪造成通过。
12. WAPPR1 审批规则规范化：测试模板固定 `SMOKE002 -> SMOKE101`；正式请假、补卡、外出、加班模板必须按一层直属主管或指定审批角色自动带出审批人。申请人不得任意选择审批人；审批人缺失、停用、未绑定、不可见、主管链断裂或自审时，必须由管理员兜底或阻断，不能直接进入真实试用。
13. WAUTO1 自动证据汇总：`bash scripts/qa/collect-wecom-controlled-trial-evidence.sh`。该脚本只读汇总 `/ready`、WARCH3 summary、审批补偿只读、审批归档离线、打卡摘要 offline、外出/加班 dry-run 和隐私扫描；不会设置 `WECOM_ARCHIVE_WRITE=1`、`WECOM_CHECKIN_ARCHIVE_WRITE=1` 或 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不写 OA DB、不写企业微信。
14. WFULLSMOKE1 三天全域最终目标测试：`bash scripts/qa/run-three-day-full-goal-smoke.sh`。该脚本聚合企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检；若只想做只读汇总，可设置 `WFULLSMOKE_ALLOW_PUBLIC_WRITES=0`。默认只允许带 `TEST/SMOKE/WFULL` 标记的 OA 测试业务数据；不写企业微信、不创建外出/加班样件、不启用真实员工、不真实付款、不接真实支付、不写 ERP、不导入银行流水。
15. WAPPR1 人工确认清单按请假、补卡、外出、加班逐模板填写：模板入口、适用范围、审批人规则、是否允许申请人手选、是否可能自审、主管链缺失时表现、审批人不可见或停用时表现。每个模板只选一个结论：A 审批人自动带出且申请人不能任意选择；B 默认带出但申请人仍可改人；C 必须申请人手选审批人；D 当前看不到或模板未配置。B/C/D 均不得直接进入真实员工试用。
16. WEXT1LD live 前 dry-run：远端只执行 `npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime`；不要设置 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不要带 `--live`、`--create-templates` 或 `--submit-test-approvals`。通过后仍需问答选择：批准一次 live 创建外出+加班 OA-POC 样件、只保留 dry-run、或外出/加班移出 V1。
17. WEXT1-LIVE 已锁定为外出+加班两类一起创建 OA-POC 测试模板和低风险审批单，固定 `SMOKE002 -> SMOKE101`、`WECOM_AGENT_SECRET` 和双开关；样件保留审计，由 `SMOKE101` 真机确认消息卡片、列表、详情页、按钮风险和审批人是否自动带出。
18. Day 0 公网报告为 `/app/artifacts/qa-flow/wroad2-ops-20260520-041941/summary.json`，结论 `PASS_WITH_FINDINGS`：企微 runtime、补偿归档、离线归档读取和隐私扫描通过；finding 为缺 live smoke 登录凭据/pending OCR 子检查异常以及历史 callback gap，不阻断测试账号受控试用。
19. WROAD2-CLOSEOUT/WROAD2-BIZ1/WAPPR1/WAUTO1/WEXT1LD/WFULLSMOKE1 三天结束后再做人工问答：进入 WEXT1-LIVE、先处理指定 finding、或暂停；未确认前不启用真实员工，不创建外出/加班 live 样件。
20. WREAL1-PREP/WROUTE2 当前只准备和锁定路线，不要求提供真实员工；后续真实试用必须等请假、补卡、外出、加班四类测试号证据、WAPPR1 审批规则门禁和 WFULLSMOKE1 可解释通过后再问，首批固定为 1 名真实员工 + 1 名审批人/管理员观察。
21. `wecom_attendance_approval_mirror_v1` 最小完整镜像必须等 WREAL1 通过后优先规划；应急接管、恢复回写、RuleOps、图片 OCR、复杂 BPM、预算、ERP 和银行流水导入继续冻结。
13. WAPPR1 管理员后台检查位置：进入企业微信管理后台的审批应用或自建应用审批接口模板配置，打开请假、补卡、外出、加班对应模板的编辑页，检查“审批流程/规则”是否存在“申请人自选”节点，是否按直属主管、部门负责人或指定审批角色自动带出审批人，以及主管链缺失、自审、审批人停用或不可见时是否阻断或进入管理员兜底。
14. WAPPR1 真机确认方式：用 `SMOKE002` 进入对应模板提交页，不提交敏感内容，只观察审批人是否自动带出、是否可以任意改人；提交低风险样例后，由系统用 `getapprovaldetail` 校验实际审批链是否为 `SMOKE101` 且无自审。企业微信官方 API 不能只读读取后台审批规则本身，管理员手动设置后系统只能检查提交后的实际结果。
15. WAUTO1 自动证据汇总：`bash scripts/qa/collect-wecom-controlled-trial-evidence.sh`。该脚本只读汇总 `/ready`、WARCH3 summary、审批补偿只读、审批归档离线、打卡摘要 offline、外出/加班 dry-run 和隐私扫描；不会设置 `WECOM_ARCHIVE_WRITE=1`、`WECOM_CHECKIN_ARCHIVE_WRITE=1` 或 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不写 OA DB、不写企业微信。
16. WFULLSMOKE1 三天全域最终目标测试：`bash scripts/qa/run-three-day-full-goal-smoke.sh`。该脚本聚合企微 HR/考勤、OA 报销、采购、合同/项目、付款批次、移动/企微入口和运维巡检；若只想做只读汇总，可设置 `WFULLSMOKE_ALLOW_PUBLIC_WRITES=0`。默认只允许带 `TEST/SMOKE/WFULL` 标记的 OA 测试业务数据；不写企业微信、不创建外出/加班样件、不启用真实员工、不真实付款、不接真实支付、不写 ERP、不导入银行流水。
17. WAPPR1 人工确认清单按请假、补卡、外出、加班逐模板填写：模板入口、适用范围、审批人规则、是否允许申请人手选、是否可能自审、主管链缺失时表现、审批人不可见或停用时表现。每个模板只选一个结论：A 审批人自动带出且申请人不能任意选择；B 默认带出但申请人仍可改人；C 必须申请人手选审批人；D 当前看不到或模板未配置。B/C/D 均不得直接进入真实员工试用。
18. WEXT1LD live 前 dry-run：远端只执行 `npm run check:wecom-approval-fixtures -- --format=json --target=outing --target=overtime`；不要设置 `WECOM_APPROVAL_FIXTURE_WRITE=1`，不要带 `--live`、`--create-templates` 或 `--submit-test-approvals`。通过后仍需问答选择：批准一次 live 创建外出+加班 OA-POC 样件、只保留 dry-run、或外出/加班移出 V1。
19. WEXT1-LIVE 已锁定为外出+加班两类一起创建 OA-POC 测试模板和低风险审批单，固定 `SMOKE002 -> SMOKE101`、`WECOM_AGENT_SECRET` 和双开关；样件保留审计，由 `SMOKE101` 真机确认消息卡片、列表、详情页、按钮风险和审批人是否自动带出。
20. Day 0 公网报告为 `/app/artifacts/qa-flow/wroad2-ops-20260520-041941/summary.json`，结论 `PASS_WITH_FINDINGS`：企微 runtime、补偿归档、离线归档读取和隐私扫描通过；finding 为缺 live smoke 登录凭据/pending OCR 子检查异常以及历史 callback gap，不阻断测试账号受控试用。
21. WROAD2-CLOSEOUT/WROAD2-BIZ1/WAPPR1/WAUTO1/WEXT1LD/WFULLSMOKE1 三天结束后再做人工问答：进入 WEXT1-LIVE、先处理指定 finding、或暂停；未确认前不启用真实员工，不创建外出/加班 live 样件。
22. WREAL1-PREP/WROUTE2 当前只准备和锁定路线，不要求提供真实员工；后续真实试用必须等请假、补卡、外出、加班四类测试号证据、WAPPR1 审批规则门禁和 WFULLSMOKE1 可解释通过后再问，首批固定为 1 名真实员工 + 1 名审批人/管理员观察。
23. `wecom_attendance_approval_mirror_v1` 最小完整镜像必须等 WREAL1 通过后优先规划；应急接管、恢复回写、RuleOps、图片 OCR、复杂 BPM、预算、ERP 和银行流水导入继续冻结。
问题登记最小字段：
docs/需求-统一审批中心规约.md
+3
查看文件
@@ -417,7 +417,10 @@ WAPPR1 承接 WROAD2 期间发现的补卡申请仍需申请人手动选择审
- 测试模板固定为 `SMOKE002 -> SMOKE101`，申请人不得选择自己，`SMOKE101` 不可用时不自动换人。
- 公司不到 10 人时，正式请假、补卡、外出、加班模板采用一层直属主管或指定审批角色自动带出审批人，不允许申请人任意选择审批人。
- 审批人缺失、停用、未绑定企微、不可见、主管链断裂或命中申请人本人时，必须由管理员兜底或阻断提交；若只能手选审批人，则阻断进入真实试用。
- 官方 API 边界：`gettemplatedetail` 只返回模板控件，`getapprovaldetail` 只返回已提交审批单的实际审批节点和审批人，均不能只读证明申请页是否允许手选或修改审批人；`applyevent` 的 `use_template_approver=1` 属于写入型验证，且不适合作为补卡等模板的通用只读门禁。
- WAPPR1 验收必须由三类证据组合：管理员在企微后台确认无“申请人自选”节点；`SMOKE002` 真机提交页确认审批人自动带出且不能任意改人；提交后用 `getapprovaldetail` 校验实际审批人为 `SMOKE101` 且无自审。
- 结论按模板分别记录：`PASS_APPROVER_RULES_READY`、`PASS_WITH_TEMPLATE_ADJUSTMENTS`、`FAIL_KEEP_OA_PRIMARY_FOR_THIS_TEMPLATE` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
- A/B/C/D 人工门禁口径不变：只有 A 可放行；B、C、D 均阻断 WEXT1-LIVE、WREAL1 和后续 `wecom_attendance_approval_mirror_v1`。
- 如果企微模板能力或后台配置暂时无法做到自动审批人规则，对应模板继续保持测试账号 POC 或 OA 主办，不进入 WREAL1 真实员工试用。
### 9.4 WEGOV1 / WACP3 / WREAD1 / WADM1 / WARCH1 前置门禁