WPROC1 固化企微路线与开发流程门禁

这个提交包含在:
2026-05-19 11:05:31 +08:00
父节点 08987ba921
当前提交 bb5e204d95
共修改 15 个文件,包含 220 行新增和 74 行删除
+27 -1
查看文件
@@ -2,7 +2,7 @@
**文档状态**:当前测试事实源。
**适用范围**:hyb-oa MVP 首轮开发 A3-A8,以及后续所有非微小改动。
**路线口径**:WFOC/DBWFOC/WFDG/WDRG 后,HR/考勤员工日常审批优先复用企业微信成熟能力,OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台;报销、采购、合同、项目、PDF OCR、付款批次、AP 台账、代账交接和高敏附件继续由 OA 主办;企业微信只做脱敏消息和 OA deeplink;飞书不进入当前路线。后续企微/OA 运行时迁移前必须先读 [企微优先开发路线图](./企微优先开发路线图.md),再做 `WECOM-CAPABILITY-POC-V1`;缺配置或权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`,不得伪造成通过。
**路线口径**:WFOC/DBWFOC/WFDG/WDRG 后,HR/考勤员工日常审批优先复用企业微信成熟能力,OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台;报销、采购、合同、项目、PDF OCR、付款批次、AP 台账、代账交接和高敏附件继续由 OA 主办;企业微信只做脱敏消息和 OA deeplink;飞书不进入当前路线。后续企微/OA 运行时迁移前必须先读 [企微优先开发路线图](./企微优先开发路线图.md),再做对应 POC。WPROC1 后,WAPC2 不能直接进入 `wecom_attendance_approval_mirror_v1`,必须先完成 WAPC2F、WCBK1、WACP3 和 WADM1;缺配置或权限时记录 `NEEDS_CONFIG` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`,不得伪造成通过。
本文回答“什么时候测试、测什么、怎么判定通过、怎么记录跳过”。具体业务验收仍以主 PRD、模块规约和最新 Issue CSV 为准。
@@ -13,6 +13,7 @@
- 自动化优先,自动化无法覆盖时必须写清人工步骤、执行人、环境和结论。
- 测试失败不得假通过;必须先归类为代码问题、测试桩问题、环境问题、数据问题或人工配置问题。
- 涉及公网、企业微信真机、真实 OCR、真实凭据时,只能在条件真实可用后给通过结论;缺配置必须标 `SKIP`。
- 企微审批类测试默认禁止自审;自动化样件必须预检申请人和审批人不是同一 OA 员工、不是同一企微 userid。
## 2. 测试分层
@@ -40,6 +41,31 @@
`Dev_Status=DONE` 表示开发完成且基础检查通过;`Review1_Status=DONE` 表示自查或 review 无阻断;`Regression_Status=DONE` 表示业务流程级验证通过或明确 SKIP。
### 3.1 企微工程化测试门禁
WPROC1 后,企微 HR/考勤相关 Issue 在测试层面同步执行三层门禁:
| 门禁 | 测试要求 |
| --- | --- |
| 路线门禁 | 测试前核对路线图,确认没有跳过 WAPC2F、WCBK1、WACP3、WADM1 等前置阶段。 |
| 能力门禁 | runner 必须输出真实 `PASS`、`NEEDS_CONFIG` 或 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`,不能把缺 Secret、权限、可信 IP、模板、回调或可见范围写成通过。 |
| 实现门禁 | Issue CSV、静态检查、单测、回归、公网验证、状态回填和中文提交必须按 `Test_Method` 闭环。 |
Definition of Ready:
- Issue CSV 已写清主流程、异常流程、权限、外部配置和脱敏报告边界。
- 已明确 API、Secret、可信 IP、模板、回调、测试账号、申请人、审批人和自审校验。
- live 写入必须有显式 CLI 参数和环境开关;默认 dry-run 或只读。
Definition of Done:
- `Test_Method` 全部执行并记录实际结果。
- 自动化能覆盖的样件生成、复跑、只读拉取、脱敏检查和错误分类已自动化执行。
- 人工只保留批准、密钥/回调配置、企微后台不可 API 化配置、真机确认和风险拍板。
- 若面向公网或企微可测,必须有 `/ready`、runtime smoke、public bundle scan 或对应 live runner 证据。
高风险企微能力的 POC 顺序固定为:WAPC2F 自动样件 -> WAPC2 自动复跑 -> WCBK1 回调只读 POC -> WACP3 补偿拉取 POC -> WADM1 镜像数据模型设计 -> `wecom_attendance_approval_mirror_v1`。真实回调必须先证明验签、解密、幂等和重复投递;补偿拉取必须先证明按时间窗口拿到审批单号并可拉详情;镜像实现前必须先有字段、状态机、幂等键、索引和隐私保留边界设计。
## 4. MVP 首轮测试矩阵
| Issue | 自动化测试 | 视觉 / 入口验证 | 备注 |