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

WCP1 收口企业微信能力POC

浏览代码
这个提交包含在：
wangsli
2026-05-18 13:56:52 +08:00
父节点 6143dfcbb2
当前提交 5369e7d258
共修改 12 个文件，包含 1209 行新增和 30 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
.agents/skills/hyb-oa-delivery/SKILL.md
+2 -2
查看文件
@@ -16,7 +16,7 @@ Read only what is relevant:
- For UI/page work, PC/mobile/WeCom experience, approval UX, or domestic OA benchmarking, read `docs/产品设计规则.md` and `references/visual-qa.md`. DG8 makes Feishu workbench/approval the single main UI/layout reference, with Hyinda branding and project rules taking priority. DG9 adds the A/B/C page layering and shared workbench/mobile samples; choose the DG9 sample before designing or coding a page. Other products are only function/process/control references. Mobile page work must treat `docs/产品设计规则.md` as the source of truth for the unified mobile shell, icon grid, card lists, deep Push pages, sticky actions, safe-area, and cross-viewport matrix. 移动页必须先对齐该设计事实源，再进入实现或验证。
- For approval workflow, roles, self-approval, notification, deeplink, reminder, or escalation work, read `docs/需求-统一审批中心规约.md`.
- For HR lifecycle, employee onboarding/offboarding, Enterprise WeChat directory sync, or account disablement work, read `docs/需求-企业微信基础设施规约.md`, `docs/管理员手册.md`, and the latest HCLT/HRWD Issue CSV evidence first.
- For Enterprise WeChat-first HR/attendance runtime migration, read `docs/企微优先开发路线图.md` before planning or coding. WDRG makes the roadmap authoritative for stage order; do not skip `WECOM-CAPABILITY-POC-V1` before `wecom_hr_master_sync_v1`, `wecom_attendance_approval_mirror_v1`, `oa_hr_emergency_mode_v1`, `wecom_recovery_writeback_v1`, or `wecom_ruleops_v1`.
- For Enterprise WeChat-first HR/attendance runtime migration, read `docs/企微优先开发路线图.md` before planning or coding. WDRG makes the roadmap authoritative for stage order; WCP1 currently concludes `PAUSE_FOR_CONFIG`, so do not start `wecom_hr_master_sync_v1`, `wecom_attendance_approval_mirror_v1`, `oa_hr_emergency_mode_v1`, `wecom_recovery_writeback_v1`, or `wecom_ruleops_v1` until the capability POC is rerun and reaches the required gate.
- For reimbursement, invoice, OCR, duplicate invoice, or attachment work, read `docs/报销发票附件规则.md` and `references/reimbursement.md`.
- For local/WeCom/public trial-run, OCR runtime, Caddy, or DB drift work, read `docs/试运行与自动化验证手册.md` and `references/trialrun.md`.
- For how this skill should evolve, read `docs/Agent开发交付实践.md`.
@@ -105,7 +105,7 @@ Final responses should include:
- R6 scope defaults to reimbursement, leave, procurement, approval, Enterprise WeChat entry/notification, finance payment/export.
- Do not expand to budget, ERP, AI, full travel, or complex BPM during R6; record those as follow-up Issues.
- Enterprise WeChat personal app message is the formal approval notification channel after R5; mock and group bots are not acceptance evidence for R6 business notification.
- After WDRG, ERP is not a future OA integration target. HR/attendance employee daily approvals (leave, missed punch, outing, overtime) should reuse mature Enterprise WeChat capabilities first, while OA provides domain-based mirror, manual takeover, recovery writeback, finance closeout, and audit. Reimbursement, payment batches, AP, accounting handoff, procurement, expenses, contracts, projects, sensitive attachments, invoices, bank receipts, and accounting handoff materials remain OA-primary unless a later Issue changes that domain explicitly. OA-primary approvals may send Enterprise WeChat personal-app notifications, but messages must contain only dehydrated title/type/no/status/deeplink; do not upload procurement forms, contract bodies, quotes, supplier files, invoices, bank receipts, or accounting materials to WeCom native approvals or WeCom attachments. Before runtime migration, read `docs/企微优先开发路线图.md`, run `WECOM-CAPABILITY-POC-V1`, and classify each capability as `CAN_REUSE_NOW`, `NEEDS_CONFIG`, `NEEDS_API_POC`, `KEEP_OA_PRIMARY`, or `NOT_SUPPORTED_BY_API`; missing Secret, callback, template, trusted IP, visible scope, or API permission must be recorded as `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`, not PASS. Do not skip stage order: `WECOM-CAPABILITY-POC-V1` -> `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1`. UI and API work must distinguish `OA 主办`, `企微镜像`, and `OA 应急接管`. OA-driven Enterprise WeChat directory create/update/disable is live verified; for later HR/WeCom directory issues, first check configuration, permission, department, and data-specific causes before treating the capability as unfinished. After WCFB, Enterprise WeChat check-in sync uses an authorized custom app Secret: `WECOM_CHECKIN_SECRET` is an explicit override for a dedicated check-in app, and when it is empty OA can reuse the authorized workbench app `WECOM_AGENT_SECRET`.
- After WCP1, ERP is not a future OA integration target. HR/attendance employee daily approvals (leave, missed punch, outing, overtime) should reuse mature Enterprise WeChat capabilities first, while OA provides domain-based mirror, manual takeover, recovery writeback, finance closeout, and audit. Reimbursement, payment batches, AP, accounting handoff, procurement, expenses, contracts, projects, sensitive attachments, invoices, bank receipts, and accounting handoff materials remain OA-primary unless a later Issue changes that domain explicitly. OA-primary approvals may send Enterprise WeChat personal-app notifications, but messages must contain only dehydrated title/type/no/status/deeplink; do not upload procurement forms, contract bodies, quotes, supplier files, invoices, bank receipts, or accounting materials to WeCom native approvals or WeCom attachments. Before runtime migration, read `docs/企微优先开发路线图.md`, run or check `WECOM-CAPABILITY-POC-V1`, and classify each capability as `CAN_REUSE_NOW`, `NEEDS_CONFIG`, `NEEDS_API_POC`, `KEEP_OA_PRIMARY`, or `NOT_SUPPORTED_BY_API`; missing Secret, callback, template, trusted IP, visible scope, or API permission must be recorded as `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`, not PASS. Current WCP1 result is `PAUSE_FOR_CONFIG`: workbench token, HCLT directory create/update/disable, department read, and HR field read are reusable; `contact.member_read` returned `wecom_errcode_48009`, `hr.staff_read` returned `wecom_errcode_60021`, check-in sync is not enabled, approval template/instance IDs and callback config are missing, and vacation quota returned `wecom_errcode_301062`. Do not skip stage order: rerun/clear `WECOM-CAPABILITY-POC-V1` -> `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1`. UI and API work must distinguish `OA 主办`, `企微镜像`, and `OA 应急接管`. OA-driven Enterprise WeChat directory create/update/disable is live verified; for later HR/WeCom directory issues, first check configuration, permission, department, and data-specific causes before treating the capability as unfinished. After WCFB, Enterprise WeChat check-in sync uses an authorized custom app Secret: `WECOM_CHECKIN_SECRET` is an explicit override for a dedicated check-in app, and when it is empty OA can reuse the authorized workbench app `WECOM_AGENT_SECRET`.
- Approval-chain correctness can be proven by PC or automation, while Enterprise WeChat validates entry, binding,免登录, notification, deeplink, and mobile layout.
- If real-device mobile validation is paused after automation passes, record the gate as `PAUSED`; do not close RS6/UI6/R6 mobile blockers until representative real-device confirmation is recorded.
- Role-specific pages should use one shared OA/mobile framework and tailor summaries, entries, actions, and sensitive fields by role. Do not create unrelated UI systems for employee, approver, finance, admin, or CEO views.
docs/trialrun/人工试运行报告.md
+2
查看文件
@@ -44,6 +44,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
- 2026-05-18 DBWFOC 已完成“企微能力参考 + OA 主办数据边界”修正：HR/考勤员工日常审批优先复用企业微信；采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办。企业微信成熟功能可作为流程、字段、交互和规则参考，但不默认托管 OA 主办业务数据；企业微信消息只承载脱敏标题、业务类型、编号、状态和 OA deeplink。采购单附件、合同正文、报价、供应商资料、发票、银行回单和代账资料不进入企业微信原生审批或企业微信附件。本轮只更新需求事实源、手册、索引、项目 skill 和 Issue CSV，不改业务代码、不部署、不改公网配置。
- 2026-05-18 WFDG 已完成“企微优先 + OA 主办数据边界”的设计规约门禁：后续开发前必须先判定业务域主办方、主事实源、操作端、镜像方向、附件归属和审计责任；PC/移动页面需区分 `OA 主办`、`企微镜像` 和 `OA 应急接管`；企微同步必须具备幂等、重试、脱敏日志、审计记录和 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。下一轮先做 `WECOM-CAPABILITY-POC-V1`，输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 能力矩阵；本轮不改业务代码、不部署、不调用生产写接口。
- 2026-05-18 WDRG 已完成“企微优先后续开发路线图”门禁：新增 `docs/企微优先开发路线图.md`，固定“路线图门禁 + 单功能 Issue CSV”的工程节奏。后续顺序为 `WECOM-CAPABILITY-POC-V1` -> `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1`；阶段未退出前禁止跳阶段。本轮只更新路线图、交付规约、事实源、手册、项目 skill 和 Issue CSV，不改业务代码、不部署、不调用公网写接口。
- 2026-05-18 WCP1 已完成企业微信能力 POC：新增 QA-only 只读 runner `scripts/qa/check-wecom-capability-poc.mjs`，本地不开启 live read 时可解释为 `PAUSE_FOR_API_POC`，本地开启 live read 但无真实 env 时可解释为 `PAUSE_FOR_CONFIG`；部署服务器容器内 live 只读探测报告为远端 `/tmp/wecom-capability-poc-wcp1/summary.json`，结论同为 `PAUSE_FOR_CONFIG`。当前可复用工作台 token、HCLT 通讯录 create/update/disable、部门读取和人事字段读取；仍需补通讯录测试成员读取 `wecom_errcode_48009`、人事助手测试员工读取 `wecom_errcode_60021`、打卡同步、审批模板/实例、假期权限 `wecom_errcode_301062` 和回调配置。因此不得进入 `wecom_hr_master_sync_v1`，需先补配置并复跑 POC。
## 关键证据索引
@@ -130,6 +131,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
| DBWFOC 企微能力参考 + OA 主办数据边界 | 通过，无运行时变更 | Issue `issues/2026-05-18_11-35-39-data-boundary-wfoc-revision.csv`；PRD、产品口径、企微基础设施规约、统一审批规约、请假考勤规约、采购/合同/报销/项目规约、管理员手册、员工快速上手、文档索引、事实源矩阵和项目 skill 已回写。结论固定：HR/考勤员工日常审批企微优先，OA 主办高敏业务不进企微原生审批或企微附件。 |
| WFDG 企微优先设计门禁 | 通过，无运行时变更 | Issue `issues/2026-05-18_12-21-01-wecom-first-design-gate.csv`；产品口径、PRD、产品设计规则、企业微信基础设施规约、统一审批规约、请假考勤规约、管理员手册、员工快速上手、文档索引、事实源矩阵和项目 skill 已回写。结论 `DONE_DESIGN_READY`，下一步进入 `WECOM-CAPABILITY-POC-V1`；不代表企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 已实现。 |
| WDRG 企微优先开发路线图门禁 | 通过，无运行时变更 | Issue `issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv`；新增 `docs/企微优先开发路线图.md`，并回写交付规约、产品口径、PRD、管理员手册、员工快速上手、文档索引、事实源矩阵和项目 skill。结论 `DONE_ROADMAP_READY`，下一步仍是 `WECOM-CAPABILITY-POC-V1`；不代表运行时迁移已完成。 |
| WCP1 企业微信能力 POC | 完成只读 POC，结论 `PAUSE_FOR_CONFIG` | Issue `issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv`；新增 `scripts/qa/check-wecom-capability-poc.mjs`。本地脚本门禁通过，远端容器内 live 只读报告为 `/tmp/wecom-capability-poc-wcp1/summary.json`：`CAN_REUSE_NOW=9`、`NEEDS_CONFIG=8`、`NEEDS_API_POC=1`、`KEEP_OA_PRIMARY=1`。阻断为 `contact.member_read=wecom_errcode_48009`、`hr.staff_read=wecom_errcode_60021`、打卡同步未开启、缺审批模板/实例、假期权限 `wecom_errcode_301062` 和回调配置；当前不得进入 HR 主数据镜像开发。 |
## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
docs/产品口径.md
+6
查看文件
@@ -40,6 +40,12 @@
- 线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护可以另开合同并行；采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不混入企微 HR/考勤路线。
- 路线图事实源为 [企微优先开发路线图](./企微优先开发路线图.md)；该路线图不代表任何运行时迁移能力已完成。
### P0-6 WCP1 企业微信能力 POC 结论
- WCP1 已完成 QA-only 只读 POC，结论为 `PAUSE_FOR_CONFIG`，不是 `GO_TO_HR_MASTER_SYNC`。
- 已可复用：工作台应用 token、核心配置、HCLT 通讯录 create/update/disable 证据、通讯录部门读取、人事助手字段配置读取。
- 需配置后复跑：通讯录测试成员读取 `wecom_errcode_48009`、人事助手测试员工读取 `wecom_errcode_60021`、打卡同步开关、审批模板 ID、测试审批单号、假期权限 `wecom_errcode_301062`、回调 URL/Token/AESKey。
- 在 POC 复跑得出 `GO_TO_HR_MASTER_SYNC` 前，不得启动 `wecom_hr_master_sync_v1`、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps 正式写入。
---
## 请假模块
docs/企微优先开发路线图.md
+27 -3
查看文件
@@ -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 主数据镜像合同。
docs/员工快速上手.md
+1 -1
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 员工快速上手（10 人以下团队版）
**当前状态（2026-05-18 / WDRG）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`。WFOC 已冻结新的产品方向，DBWFOC 已修正数据边界，WFDG 已固定设计门禁，WDRG 已固定后续开发路线图：能用企业微信成熟能力的 HR/考勤员工日常审批优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、报销和财务资料仍由 OA 主办。本轮只是开发节奏和路线图调整，不代表页面入口已全部迁移完成。
**当前状态（2026-05-18 / WCP1）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`。WFOC 已冻结新的产品方向，DBWFOC 已修正数据边界，WFDG 已固定设计门禁，WDRG 已固定后续开发路线图；WCP1 已完成企业微信能力只读 POC，当前因企业微信配置/权限缺口结论为 `PAUSE_FOR_CONFIG`，不代表页面入口或 HR/考勤流程已全部迁移完成。能用企业微信成熟能力的 HR/考勤员工日常审批优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、报销和财务资料仍由 OA 主办。
## 1. 你每周主要会用到什么
- `Portal`：看公告、我的待办、我的资产、本周周报入口。
docs/文档事实源状态矩阵.md
+11 -10
查看文件
@@ -64,7 +64,8 @@
| `WFOC` | `issues/2026-05-18_10-25-18-wecom-first-oa-continuity-requirements.csv` | `EVIDENCE` | 企微优先 + OA 无痛接管需求重构已收口；其中“HR/考勤/行政审批企微优先”和“完整镜像”宽口径已由 DBWFOC 收窄为 HR/考勤员工日常审批优先和按域镜像 |
| `DBWFOC` | `issues/2026-05-18_11-35-39-data-boundary-wfoc-revision.csv` | `EVIDENCE` | 企微能力参考 + OA 主办数据边界修正已收口；HR/考勤员工日常审批企微优先，采购/合同/财务等 OA 主办高敏业务不进入企微原生审批或企微附件 |
| `WFDG` | `issues/2026-05-18_12-21-01-wecom-first-design-gate.csv` | `EVIDENCE` | 企微优先设计规约门禁已收口：固定主办方与数据边界矩阵、入口交互、隐私附件消息、同步审计失败处理、应急接管、恢复回写、RuleOps 和 `WECOM-CAPABILITY-POC-V1` 验收口径 |
| `WDRG` | `issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv` | `CURRENT` | 企微优先开发路线图门禁：固定路线图门禁、单功能 Issue CSV 节奏、阶段顺序、并行规则和下一轮 POC 合同口径 |
| `WDRG` | `issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv` | `EVIDENCE` | 企微优先开发路线图门禁已收口：固定路线图门禁、单功能 Issue CSV 节奏、阶段顺序、并行规则和下一轮 POC 合同口径 |
| `WCP1` | `issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv` | `CURRENT` | 企业微信能力 POC 已完成，结论 `PAUSE_FOR_CONFIG`；当前不得进入 HR 主数据镜像开发，需先补配置/权限并复跑 POC |
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
@@ -72,21 +73,21 @@
| Doc_ID | Path | Category | Authority | Status | Owner | Related_Issues | Evidence | Supersedes | Last_Audited | Audit_Method | Risk | Notes |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG` | `rg` | none | 2026-05-18 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG` | `audit-docs` | none | 2026-05-18 | `audit-docs --check-registry` | medium | 判断文档权威性 |
| `PRD-MVP` | `docs/海音达OA-MVP需求规格说明书.md` | 需求事实源 | PRD 主事实源 | `CURRENT` | product | `REQ8,P2T,GOV8,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG` | Issue CSV | `docs/requirements-specification.md` | 2026-05-18 | `rg` | high | WDRG 后定义企微优先开发路线图门禁、阶段顺序和 POC 前置；ERP 未来不接入 OA |
| `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T,WFDG,WDRG` | `rg` | none | 2026-05-18 | `rg` | high | 记录已拍板产品边界、企微/OA 设计门禁和开发路线图 |
| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1` | `rg` | none | 2026-05-18 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1,REQ-COMPLETE-AUDIT,ATTV1,LAUNCH-AUTO-OPS-V1,AUTO-REMAINING-CLOSEOUT,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1` | `audit-docs` | none | 2026-05-18 | `audit-docs --check-registry` | medium | 判断文档权威性 |
| `PRD-MVP` | `docs/海音达OA-MVP需求规格说明书.md` | 需求事实源 | PRD 主事实源 | `CURRENT` | product | `REQ8,P2T,GOV8,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WDRG,WCP1` | Issue CSV | `docs/requirements-specification.md` | 2026-05-18 | `rg` | high | WCP1 后定义企微能力 POC 结论为 `PAUSE_FOR_CONFIG`，尚不能进入 HR 主数据镜像；ERP 未来不接入 OA |
| `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T,WFDG,WDRG,WCP1` | `rg` | none | 2026-05-18 | `rg` | high | 记录已拍板产品边界、企微/OA 设计门禁、开发路线图和 WCP1 配置阻断 |
| `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` | Issue CSV | none | 2026-05-18 | `rg` | high | WDRG 后控制企微 HR/考勤路线的阶段顺序、准入/退出门禁、并行规则和禁止跳阶段 |
| `ROADMAP-WECOM` | `docs/企微优先开发路线图.md` | 开发治理 | 企微优先开发路线图事实源 | `CURRENT` | product/dev | `WDRG,WCP1` | Issue CSV | none | 2026-05-18 | `rg` | high | WCP1 后记录企微 HR/考勤路线阶段顺序和当前 POC `PAUSE_FOR_CONFIG` 阻断 |
| `DELIVERY` | `docs/开发交付与变更管理规约.md` | 开发治理 | 开发交付事实源 | `CURRENT` | dev/qa | `GOV8,WDRG` | `rg` | none | 2026-05-18 | `rg` | high | Issue、review、commit、交付规则；WDRG 后采用路线图门禁 + 单功能 Issue CSV |
| `QA-GATE` | `docs/测试规约与回归门禁.md` | 测试验收 | 测试和回归门禁事实源 | `CURRENT` | qa | `QAF8,GOV8` | 回归脚本/Playwright | none | 2026-05-13 | `rg` | high | 测试计划和 DONE 门禁 |
| `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` | quick_validate | none | 2026-05-18 | `quick_validate.py` | medium | 每轮交付操作入口，UI 任务读取设计主参考层级；企微/OA 后续先读路线图、再做 POC、再开发 |
| `SKILL-HYB` | `.agents/skills/hyb-oa-delivery/SKILL.md` | Skill | 项目交付 Skill | `CURRENT` | dev | `GOV8,DG8,WFDG,WDRG,WCP1` | quick_validate | none | 2026-05-18 | `quick_validate.py` | medium | 每轮交付操作入口；企微/OA 后续先读路线图和 WCP1 结论，当前不得直接开发 HR 主数据镜像 |
| `REQ-WF` | `docs/需求-统一审批中心规约.md` | 需求事实源 | 审批模块规约 | `CURRENT` | product/backend | `AP6,WF8,WFOC,DBWFOC,WFDG` | workflow 回归 | none | 2026-05-18 | `rg` | high | OA 主办审批、企微镜像和 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` | live smoke/真机反馈/Issue CSV | none | 2026-05-18 | `rg` | high | 企微优先承担 HR/考勤员工日常审批和人事/打卡能力；采购、合同、项目、报销和财务继续 OA 主办；WFDG 固定 POC 能力矩阵 |
| `REQ-WECOM` | `docs/需求-企业微信基础设施规约.md` | 需求事实源 | 企业微信边界规约 | `CURRENT` | product/backend | `R7E,ORG8,WF8,ATTV1,HR-WECOM-DIRECTORY-V1,WFOC,DBWFOC,WFDG,WCP1` | live smoke/真机反馈/Issue CSV | none | 2026-05-18 | `rg` | high | 企微优先承担 HR/考勤员工日常审批和人事/打卡能力；WCP1 记录当前配置阻断；采购、合同、项目、报销和财务继续 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` | 人工验收 | none | 2026-05-18 | `rg` | medium | 管理员上线、企微优先边界、OA 主办数据边界、OA 应急接管、恢复回写和 POC 前置 |
| `MANUAL-EMPLOYEE` | `docs/员工快速上手.md` | 操作手册 | 员工手册 | `CURRENT` | product | `R7E,WFOC,DBWFOC,WFDG` | 人工验收 | none | 2026-05-18 | `rg` | low | 员工侧使用说明，HR/考勤优先企业微信，采购/合同/财务仍在 OA；区分企微镜像和 OA 应急接管 |
@@ -105,7 +106,7 @@
| `docs/文档事实源状态矩阵.md` | 当前事实源 | 文档分类和恢复规则 |
| `docs/海音达OA-MVP需求规格说明书.md` | 当前事实源 | PRD 主事实源 |
| `docs/产品设计规则.md` | 当前事实源 | PC、移动、企业微信设计规则；DG8 主 UI/布局参考层级 |
| `docs/企微优先开发路线图.md` | 当前事实源 | WDRG 后企微优先 HR/考勤改造阶段顺序、准入/退出门禁和禁止跳阶段 |
| `docs/企微优先开发路线图.md` | 当前事实源 | WDRG/WCP1 后企微优先 HR/考勤改造阶段顺序、准入/退出门禁、禁止跳阶段和当前 POC 配置阻断 |
| `docs/产品口径.md` | 当前事实源 | 产品边界和业务规则 |
| `docs/需求-统一审批中心规约.md` | 当前事实源 | 审批、催办、超时、效率摘要 |
| `docs/报销发票附件规则.md` | 当前事实源 | 报销、发票、附件细则 |
@@ -180,4 +181,4 @@
- `ME6-3` 代表性企业微信真机门禁已关闭。
- MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障、REQ-COMPLETE-AUDIT 需求完成度复核、ATTV1 考勤统一入口、AUTO-REMAINING-CLOSEOUT 剩余自动化收口、HRWD-CONTACT-LIVE-TEST 公网企微通讯录真实写入闭环、WFOC 需求重构、DBWFOC 数据边界修正和 WFDG 设计门禁均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同。LAUNCH-AUTO-OPS-V1 发现的公网 `payment_batch_v1=force_off` 漂移已由 AUTOREM 恢复为 `force_on`，正式自动巡检结论为 `GO_TO_OPERATE`；`erp_sync=force_off`，ERP 未来不接入 OA，正式支付接口、图片 OCR 和银行流水导入继续不进入当前路线。WDRG 后 HR/考勤员工日常审批优先复用企业微信，OA 目标是按域镜像、人工接管、恢复回写和 RuleOps；采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办。该方向尚未实现运行时迁移，下一步必须先做 `WECOM-CAPABILITY-POC-V1`，再按 [企微优先开发路线图](./企微优先开发路线图.md) 另拆 `wecom_hr_master_sync_v1`、`wecom_attendance_approval_mirror_v1`、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1`、`wecom_ruleops_v1`；阶段未退出前不得跳阶段。HRWD 已完成 OA 驱动企业微信通讯录同步，并通过 `HRWDTEST-20260517214548` 真实公网 create/update/disable 验证；测试成员按审计要求保留离职/禁用状态。
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障、REQ-COMPLETE-AUDIT 需求完成度复核、ATTV1 考勤统一入口、AUTO-REMAINING-CLOSEOUT 剩余自动化收口、HRWD-CONTACT-LIVE-TEST 公网企微通讯录真实写入闭环、WFOC 需求重构、DBWFOC 数据边界修正、WFDG 设计门禁和 WDRG 路线图门禁均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同。LAUNCH-AUTO-OPS-V1 发现的公网 `payment_batch_v1=force_off` 漂移已由 AUTOREM 恢复为 `force_on`，正式自动巡检结论为 `GO_TO_OPERATE`；`erp_sync=force_off`，ERP 未来不接入 OA，正式支付接口、图片 OCR 和银行流水导入继续不进入当前路线。WCP1 已完成企业微信能力 QA-only 只读 POC，结论 `PAUSE_FOR_CONFIG`：工作台 token、HCLT 通讯录 create/update/disable、部门读取和人事字段读取可用；通讯录测试成员读取 `wecom_errcode_48009`、人事助手测试员工读取 `wecom_errcode_60021`、打卡同步、审批模板/实例、假期权限和回调配置仍需补齐。HR/考勤员工日常审批优先复用企业微信，OA 目标是按域镜像、人工接管、恢复回写和 RuleOps；采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办。该方向尚未实现运行时迁移，当前不得进入 `wecom_hr_master_sync_v1`，需先补配置并复跑 `WECOM-CAPABILITY-POC-V1`，再按 [企微优先开发路线图](./企微优先开发路线图.md) 另拆 `wecom_hr_master_sync_v1`、`wecom_attendance_approval_mirror_v1`、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1`、`wecom_ruleops_v1`；阶段未退出前不得跳阶段。HRWD 已完成 OA 驱动企业微信通讯录同步，并通过 `HRWDTEST-20260517214548` 真实公网 create/update/disable 验证；测试成员按审计要求保留离职/禁用状态。
docs/文档索引.md
+5 -3
查看文件
@@ -20,7 +20,7 @@
## 最近事实源链
R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1 -> REQ-COMPLETE-AUDIT -> ATTV1 -> LAUNCH-AUTO-OPS-V1 -> AUTO-REMAINING-CLOSEOUT -> HR-WECOM-DIRECTORY-V1 -> HRWD-CONTACT-LIVE-TEST -> WCFB -> WFOC -> DBWFOC -> WFDG -> WDRG。
R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1 -> REQ-COMPLETE-AUDIT -> ATTV1 -> LAUNCH-AUTO-OPS-V1 -> AUTO-REMAINING-CLOSEOUT -> HR-WECOM-DIRECTORY-V1 -> HRWD-CONTACT-LIVE-TEST -> WCFB -> WFOC -> DBWFOC -> WFDG -> WDRG -> WCP1。
- R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
- ME6 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
@@ -59,6 +59,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
- DBWFOC 是 WFOC 后的数据边界修正合同：将“企微优先”收窄为 HR/考勤员工日常审批优先，采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办；企业微信成熟功能可作为流程/字段/交互/规则参考，OA 主办审批只向企业微信发送脱敏提醒和 OA deeplink，不上传高敏附件到企微原生审批。
- WFDG 是 DBWFOC 后的设计规约门禁合同：固定后续开发前必须先判定主办方、主事实源、操作端、镜像方向、附件归属和审计责任；PC/移动页面需区分 `OA 主办`、`企微镜像` 和 `OA 应急接管`；下一轮进入 `WECOM-CAPABILITY-POC-V1`，输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 能力矩阵。本轮不改业务代码、不部署、不调用生产写接口。
- WDRG 是 WFDG 后的开发路线图门禁合同：新增 [企微优先开发路线图](./企微优先开发路线图.md)，固定“路线图门禁 + 单功能 Issue CSV”的开发节奏和阶段顺序；下一步仍是 `WECOM-CAPABILITY-POC-V1`，不得跳过 POC 直接开发 HR 主数据镜像、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。本轮不改业务代码、不部署、不调用公网写接口。
- WCP1 是 WDRG 后的企业微信能力 POC 合同：新增 QA-only 只读 runner `scripts/qa/check-wecom-capability-poc.mjs`，对人事助手、通讯录、打卡、审批、假期余额、回调和权限配置输出脱敏能力矩阵。远端 live 只读结论为 `PAUSE_FOR_CONFIG`：工作台 token、HCLT 通讯录 create/update/disable、部门读取和人事字段读取可用；通讯录测试成员读取 `wecom_errcode_48009`、人事助手测试员工读取 `wecom_errcode_60021`、打卡同步、审批模板/实例、假期权限和回调配置仍需补齐。当前不得进入 `wecom_hr_master_sync_v1`。
## 当前活跃治理流
@@ -103,7 +104,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| `WFOC` | `issues/2026-05-18_10-25-18-wecom-first-oa-continuity-requirements.csv` | 已收口：企微优先 + OA 无痛接管需求重构 | 原宽口径已由 DBWFOC 修正：HR/考勤员工日常审批企微优先，OA 按域镜像、人工接管、恢复回写、RuleOps 和财务主办边界；PRD、模块规约、手册、索引和事实源矩阵已回写 | 不改业务代码、不新增 API/schema/UI、不部署、不改公网配置；不代表镜像、接管或回写运行时已完成 |
| `DBWFOC` | `issues/2026-05-18_11-35-39-data-boundary-wfoc-revision.csv` | 已收口：企微能力参考 + OA 主办数据边界修正 | HR/考勤员工日常审批企微优先；采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办；企业微信只做成熟能力参考、脱敏消息和 OA deeplink | 不改业务代码、不新增 API/schema/UI、不部署、不改公网配置；不把 OA 主办域全量镜像到企微 |
| `WFDG` | `issues/2026-05-18_12-21-01-wecom-first-design-gate.csv` | 已收口：企微优先设计规约门禁完成，结论 `DONE_DESIGN_READY` | 固定主办方/数据边界矩阵、入口与交互规约、隐私附件消息规约、同步审计失败处理、应急接管、恢复回写、RuleOps 和下一轮 POC 验收口径 | 不改业务代码、不新增 API/schema/UI、不部署、不改公网配置、不调用生产写接口；不代表运行时迁移已完成 |
| `WDRG` | `issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv` | 当前：企微优先开发路线图门禁 | 固定路线图门禁、阶段顺序、单功能 Issue CSV 节奏、并行规则和下一轮 POC 合同口径 | 不改业务代码、不新增 API/schema/UI、不部署、不改公网配置、不调用公网写接口；不代表任何运行时迁移已完成 |
| `WDRG` | `issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv` | 已收口：企微优先开发路线图门禁 | 固定路线图门禁、阶段顺序、单功能 Issue CSV 节奏、并行规则和下一轮 POC 合同口径 | 不改业务代码、不新增 API/schema/UI、不部署、不改公网配置、不调用公网写接口；不代表任何运行时迁移已完成 |
| `WCP1` | `issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv` | 当前：企业微信能力 POC 已完成，结论 `PAUSE_FOR_CONFIG` | QA-only 只读探测人事助手、通讯录、打卡、审批、假期余额、回调和权限配置；输出能力矩阵和配置阻断清单 | 不改业务代码、不新增 API/schema/UI、不部署、不调用生产写接口；未达到 HR 主数据镜像准入 |
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
@@ -126,7 +128,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| [海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md) | PRD 主事实源 |
| [文档事实源状态矩阵](./文档事实源状态矩阵.md) | 文档分类、删除恢复和冲突规则 |
| [产品设计规则](./产品设计规则.md) | PC、移动、企业微信 WebView 设计事实源；DG8 后飞书工作台/飞书审批为唯一主 UI/布局参考；DG9 后按页面分层和样板选型 |
| [企微优先开发路线图](./企微优先开发路线图.md) | WDRG 后企微优先 HR/考勤改造的阶段顺序、准入/退出门禁、并行规则和禁止跳阶段事实源 |
| [企微优先开发路线图](./企微优先开发路线图.md) | WDRG/WCP1 后企微优先 HR/考勤改造的阶段顺序、准入/退出门禁、并行规则、禁止跳阶段和当前 POC 配置阻断事实源 |
| [产品口径](./产品口径.md) | 已拍板产品边界和业务规则 |
| [需求 - 统一审批中心规约](./需求-统一审批中心规约.md) | OA 主办审批、企微主办 HR/考勤员工日常审批镜像、催办、超时提醒、审批效率 |
| [报销发票附件规则](./报销发票附件规则.md) | 报销、发票、OCR、附件细则 |
docs/海音达OA-MVP需求规格说明书.md
+16 -1
查看文件
@@ -27,7 +27,7 @@
### 1.1 背景
海音达需要一套适合 10 人以下科技公司的轻量 OA，用来把报销、采购、费用、合同、项目资料、财务闭环、审计和关键行政数据集中到一个可审计、可回归、可持续迭代的系统中。WFOC 起产品方向调整为“企微优先 + OA 无痛接管”；DBWFOC 进一步修正边界：能复用企业微信成熟功能的 HR/考勤员工日常场景优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、财务和高敏附件仍由 OA 主办和存储。WFDG 固定后续开发前必须先过设计规约门禁和企微 API 能力 POC；WDRG 进一步固定后续采用“路线图门禁 + 单功能 Issue CSV”的开发节奏，不再直接进入大规模运行时改造。
海音达需要一套适合 10 人以下科技公司的轻量 OA，用来把报销、采购、费用、合同、项目资料、财务闭环、审计和关键行政数据集中到一个可审计、可回归、可持续迭代的系统中。WFOC 起产品方向调整为“企微优先 + OA 无痛接管”；DBWFOC 进一步修正边界：能复用企业微信成熟功能的 HR/考勤员工日常场景优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、财务和高敏附件仍由 OA 主办和存储。WFDG 固定后续开发前必须先过设计规约门禁和企微 API 能力 POC；WDRG 进一步固定后续采用“路线图门禁 + 单功能 Issue CSV”的开发节奏，不再直接进入大规模运行时改造。WCP1 已完成企业微信能力只读 POC，当前结论为 `PAUSE_FOR_CONFIG`，因此尚不能进入 HR 主数据镜像运行时开发。
### 1.2 总目标
@@ -94,6 +94,21 @@ WDRG 将 WFDG 后的设计门禁转化为开发节奏门禁。本节只代表路
阶段未满足退出条件前不得跳阶段。采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办，不混入企微 HR/考勤开发路线。路线图事实源为 [企微优先开发路线图](./企微优先开发路线图.md)。
### 1.8 WCP1 企业微信能力 POC 结果
WCP1 已按“Live 只读 + 测试员工优先”完成企业微信能力 POC。本节只代表能力分类和后续准入判断，不代表 HR 主数据镜像、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps 已实现。
| 能力域 | POC 状态 | 当前结论 |
| --- | --- | --- |
| 工作台和基础权限 | `CAN_REUSE_NOW` | 工作台应用 access token 可获取，核心 CorpID/Agent/Secret/OAuth 配置存在。 |
| 通讯录 | `PARTIAL_CAN_REUSE` | HCLT 已证明 `HRWDTEST-20260517214548` create/update/disable 成功，部门读取可用；测试成员读取当前返回 `wecom_errcode_48009`，需要补权限、可见范围或测试成员状态。 |
| 人事助手 | `PARTIAL_NEEDS_CONFIG` | 字段配置读取可用；测试员工花名册读取返回 `wecom_errcode_60021`，资料更新属于写接口，需后续单独批准 POC。 |
| 打卡 | `NEEDS_CONFIG` | 远端 `WECOM_CHECKIN_SYNC_ENABLED` 未开启，短窗口打卡记录和规则读取未达到镜像开发准入。 |
| 审批与假期余额 | `NEEDS_CONFIG` | 缺审批模板 ID、测试审批单号，假期余额返回 `wecom_errcode_301062`，回调配置尚未可读。 |
| OA 主办高敏审批 | `KEEP_OA_PRIMARY` | 报销、采购、合同、项目、付款、AP 和代账继续 OA 主办，企微只做脱敏消息和 OA deeplink。 |
WCP1 最终结论为 `PAUSE_FOR_CONFIG`，不是 `GO_TO_HR_MASTER_SYNC`。后续需要先补充或确认通讯录成员读取、人事助手花名册读取、打卡同步、审批模板/实例、假期权限和回调配置，再复跑 `scripts/qa/check-wecom-capability-poc.mjs`。只有 POC 结论进入 `GO_TO_HR_MASTER_SYNC`，才允许另建 `wecom_hr_master_sync_v1` 实现合同。
---
## 2. 软件开发项目流程
docs/管理员手册.md
+7 -6
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 管理员手册（10 人以下团队版）
**当前状态（2026-05-18 / WDRG）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、ATTV1、HR-WECOM-DIRECTORY-V1、HRWD-CONTACT-LIVE-TEST、DBWFOC 和 WFDG 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。WDRG 已固定后续“路线图门禁 + 单功能 Issue CSV”的开发节奏：HR/考勤员工日常审批优先复用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办，企业微信只做脱敏提醒和 OA deeplink。本轮只更新开发路线图和治理口径，不代表运行时代码已完成迁移。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，且 ERP 未来不接入 OA；财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
**当前状态（2026-05-18 / WCP1）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、ATTV1、HR-WECOM-DIRECTORY-V1、HRWD-CONTACT-LIVE-TEST、DBWFOC、WFDG 和 WDRG 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。WCP1 已完成企业微信能力 QA-only 只读 POC，当前结论为 `PAUSE_FOR_CONFIG`，不是 `GO_TO_HR_MASTER_SYNC`。后续“路线图门禁 + 单功能 Issue CSV”的开发节奏保持不变：HR/考勤员工日常审批优先复用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办，企业微信只做脱敏提醒和 OA deeplink。本轮不代表运行时代码已完成迁移。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，且 ERP 未来不接入 OA；财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
## 1. 适用范围
- 适用于 `small_team_internal` 工作区模式。
@@ -190,12 +190,13 @@ RuleOps：
- 正式写入前必须人工确认；每次写入保存前后快照、确认人、API `errcode`、失败原因、回滚建议和审计记录。
- 不得在报告、日志或截图中暴露 Secret、access token、完整位置、人脸数据、身份证号、完整手机号或原始密钥材料。
WDRG 后续推进：
WCP1 后续推进：
1. 后续先读取 [企微优先开发路线图](./企微优先开发路线图.md)，再执行 `WECOM-CAPABILITY-POC-V1`，核对人事助手、通讯录、打卡、审批、假期余额、回调和权限配置。
2. POC 输出只使用 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API`，缺配置时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
3. 正式开发按 `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1` 分合同实施；阶段未退出前禁止跳阶段。
4. 任何生产写接口、企微规则写入、应急模式开启或恢复回写都必须有单独批准、dry-run 或可审计记录。
1. 继续先读取 [企微优先开发路线图](./企微优先开发路线图.md) 和 WCP1 报告，再判断能否进入下一阶段。
2. WCP1 当前结论为 `PAUSE_FOR_CONFIG`：工作台 token、核心配置、HCLT 通讯录 create/update/disable、部门读取和人事字段读取可用；通讯录测试成员读取 `wecom_errcode_48009`、人事助手测试员工读取 `wecom_errcode_60021`、打卡同步、审批模板/实例、假期权限 `wecom_errcode_301062` 和回调配置仍需补齐或确认。
3. 补配置后复跑 `scripts/qa/check-wecom-capability-poc.mjs`。只有结论变为 `GO_TO_HR_MASTER_SYNC`，才允许另建 `wecom_hr_master_sync_v1` 合同。
4. 正式开发仍按 `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1` 分合同实施；阶段未退出前禁止跳阶段。
5. 任何生产写接口、企微规则写入、应急模式开启或恢复回写都必须有单独批准、dry-run 或可审计记录。
### 3.3 正式财务闭环与代账交接
docs/需求-企业微信基础设施规约.md
+26 -4
查看文件
@@ -32,10 +32,10 @@
| 能力 | 企微能力 | OA 使用程度 | 当前状态 |
| --- | --- | --- | --- |
| 通讯录 | 成员创建、读取、更新、禁用或删除 | 近期已验证 OA 写企微；后续改为企微主源同步 OA，OA 保留修复和审计 | `CAN_REUSE_NOW` |
| 人事助手 | 员工字段配置、花名册读取、花名册更新 | 作为员工主数据源，驱动 OA 员工、账号、角色、绑定和状态镜像 | `NEEDS_API_POC` |
| 打卡 | 打卡记录、员工规则、日报、月报、排班、补卡、规则管理 | 企微主办规则和采集，OA 同步按域镜像和应急对账 | `CAN_REUSE_NOW` |
| 审批 | 模板详情、提交审批、审批状态回调、审批详情、模板创建/更新、假期余额 | HR/考勤员工日常审批企微主办，OA 同步镜像；OA 主办财务、采购、合同、项目和报销审批不迁移 | `NEEDS_API_POC` |
| 通讯录 | 成员创建、读取、更新、禁用或删除 | 近期已验证 OA 写企微；后续改为企微主源同步 OA，OA 保留修复和审计 | `PARTIAL_CAN_REUSE`：HCLT create/update/disable 和部门读取可用，测试成员读取待配置 |
| 人事助手 | 员工字段配置、花名册读取、花名册更新 | 作为员工主数据源，驱动 OA 员工、账号、角色、绑定和状态镜像 | `PARTIAL_NEEDS_CONFIG`：字段配置可读，测试员工花名册读取待配置，更新接口需单独写入 POC |
| 打卡 | 打卡记录、员工规则、日报、月报、排班、补卡、规则管理 | 企微主办规则和采集，OA 同步按域镜像和应急对账 | `NEEDS_CONFIG`：WCP1 远端只读 POC 显示当前未开启打卡同步配置 |
| 审批 | 模板详情、提交审批、审批状态回调、审批详情、模板创建/更新、假期余额 | HR/考勤员工日常审批企微主办，OA 同步镜像；OA 主办财务、采购、合同、项目和报销审批不迁移 | `NEEDS_CONFIG`：缺模板、测试审批单、假期权限和回调配置 |
| 工作台和消息 | 自建应用入口、应用消息、deeplink | 继续作为 OA 移动入口和通知渠道 | `CAN_REUSE_NOW` |
| 财务/报销 | 企微不提供本项目需要的 PDF OCR、付款批次、银行回单和代账闭环 | OA 主办 | `KEEP_OA_PRIMARY` |
| 真实支付、ERP、图片 OCR、银行流水导入 | 非本路线目标 | 不进入当前路线 | `NOT_IN_SCOPE` |
@@ -227,6 +227,28 @@ REQAUD 复核后，ATTV1 已完成统一入口实现，企业微信打卡边界
- 线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护可另开合同并行；采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不混入企微 HR/考勤路线。
- 本路线图只代表开发节奏和门禁，不代表任何企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 运行时能力已完成。
## 7.9 WCP1 企业微信能力 POC 结果
2026-05-18 已完成 `WECOM-CAPABILITY-POC-V1`。本轮新增 QA-only 只读脚本 `scripts/qa/check-wecom-capability-poc.mjs`，默认不写生产数据、不改企微规则、不批量读取真实员工明细，只输出脱敏能力矩阵。部署服务器容器内 live 只读探测结论为 `PAUSE_FOR_CONFIG`，报告目录为远端 `/tmp/wecom-capability-poc-wcp1/summary.json`。
WCP1 当前分类：
| 能力 | WCP1 结论 | 说明 |
| --- | --- | --- |
| 工作台应用 token 和核心配置 | `CAN_REUSE_NOW` | CorpID、Agent、Secret、OAuth 等基础配置存在，access token 可获取。 |
| 通讯录 create/update/disable | `CAN_REUSE_NOW` | 复用 HCLT 证据：`HRWDTEST-20260517214548` create/update/disable 均 `errcode=0`。 |
| 通讯录部门读取 | `CAN_REUSE_NOW` | 工作台应用 token fallback 可读部门列表。 |
| 通讯录测试成员读取 | `NEEDS_CONFIG` | `contact.member_read` 返回 `wecom_errcode_48009`，需核对通讯录读取权限、应用可见范围或测试成员状态。 |
| 人事助手字段配置读取 | `CAN_REUSE_NOW` | `hr.fields_read` 可读。 |
| 人事助手测试员工花名册读取 | `NEEDS_CONFIG` | `hr.staff_read` 返回 `wecom_errcode_60021`，需将测试成员纳入应用/人事助手权限范围，或改用在职测试员工复跑。 |
| 人事助手资料更新 | `NEEDS_API_POC` | 属生产写接口，本轮只分类，不调用。 |
| 打卡记录和规则读取 | `NEEDS_CONFIG` | 远端 `WECOM_CHECKIN_SYNC_ENABLED` 未开启，短窗口打卡和规则读取按配置阻断记录。 |
| 审批模板、审批详情、假期余额 | `NEEDS_CONFIG` | 缺审批模板 ID、测试审批单号，假期余额返回 `wecom_errcode_301062`。 |
| 回调配置 | `NEEDS_CONFIG` | 回调 URL、Token、AESKey 未作为可读配置注入，本轮不能证明回调链路。 |
| 采购/合同/报销/财务审批 | `KEEP_OA_PRIMARY` | 继续 OA 主办，企业微信只做脱敏消息和 OA deeplink。 |
WCP1 结论不是 `GO_TO_HR_MASTER_SYNC`。在 `contact.member_read` 和 `hr.staff_read` 至少对一个在职测试成员通过、审批/打卡/回调关键配置有清晰处理方式，并复跑 POC 得到准入结论前，不得启动 `wecom_hr_master_sync_v1` 运行时开发。
---
## 8. 验收场景
issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv
+10
查看文件
@@ -0,0 +1,10 @@
ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
"WCP1-0","合同建档","建立 WECOM-CAPABILITY-POC-V1 合同，锁定本轮只做企业微信能力 POC：Live 只读 + 测试员工优先，不迁移运行时流程，不开发 HR 主数据镜像、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。","1) CSV 校验通过；2) 本轮不新增业务 API/schema/UI/feature flag；3) 不调用生产写接口、不写正式规则、不批量读取真实员工明细；4) 最终结论只允许 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC、NO_GO_REVISE_ROADMAP。","受影响流程：WDRG 路线图 -> WECOM-CAPABILITY-POC-V1 -> 后续 HR 主数据镜像准入判断；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv。","python3|manual","DONE","DONE","DONE","issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv","[]","回滚路径：回退本 CSV、QA-only 脚本和文档/skill 事实源回写；不涉及数据库、业务运行时或公网配置。"
"WCP1-1","基线与权限配置复核","复核 WDRG 已收口、下一阶段为 POC，并整理当前企业微信配置项、HCLT 通讯录证据、WCFB 打卡 Secret 口径和禁止跳阶段要求。","1) 路线图、PRD、企业微信规约和 skill 均显示当前阶段为 WECOM-CAPABILITY-POC-V1；2) 通讯录 HCLT 证据被纳入 POC；3) 缺 Secret、模板、可信 IP、回调或权限时记录 NEEDS_CONFIG 或 SKIP/BLOCKED_BY_EXTERNAL_CONFIG；4) 不打印 secret、token、cookie、完整手机号、完整位置或原始 payload。","受影响流程：事实源读取 -> POC 能力分类 -> 后续单功能合同准入；验证步骤：rg -n 'WECOM-CAPABILITY-POC-V1|HCLT|WCFB|SKIP/BLOCKED_BY_EXTERNAL_CONFIG|禁止跳阶段' docs issues .agents/skills/hyb-oa-delivery/SKILL.md。","rg","DONE","DONE","DONE","docs|issues|.agents/skills/hyb-oa-delivery/SKILL.md","[""WCP1-0""]","none"
"WCP1-2","QA-only POC runner","新增 scripts/qa/check-wecom-capability-poc.mjs，只读探测配置、access token、通讯录读取、测试员工状态、打卡短窗口、人事助手字段/花名册读取、审批模板/详情、假期余额和回调配置可用性，并输出脱敏报告。","1) 脚本默认不写生产数据；2) 支持 WECOM_CAPABILITY_POC_LIVE_READ=1、WECOM_CAPABILITY_POC_TEST_USERID、WECOM_CAPABILITY_POC_DAYS、WECOM_CAPABILITY_POC_JSON、--env-file、--json；3) 报告落到 artifacts/qa-flow/wecom-capability-poc-*；4) 输出不包含 Secret、access token、cookie、完整手机号、完整位置、身份证号、附件内容或原始 payload。","受影响流程：QA-only 企微能力探测 -> 脱敏能力矩阵报告；验证步骤：node --check scripts/qa/check-wecom-capability-poc.mjs；WECOM_CAPABILITY_POC_JSON=1 node scripts/qa/check-wecom-capability-poc.mjs --json。","node","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs","[""WCP1-1""]","只允许 QA-only 读取和脱敏报告；任何生产写入或规则写入必须另建合同。"
"WCP1-3","通讯录能力分类","结合 HCLT 证据和 live 只读成员/部门能力，确认通讯录读取、成员读取、部门读取和后续 HR 主数据镜像准入状态。","1) HCLT create/update/disable 真实写入证据纳入矩阵；2) 部门列表和测试成员读取若成功标 CAN_REUSE_NOW；3) 缺通讯录 Secret、测试 userid、可见范围或可信 IP 时标 NEEDS_CONFIG；4) 不保存完整手机号或成员原始 payload。","受影响流程：企微通讯录 -> OA 员工镜像准入；验证步骤：WECOM_CAPABILITY_POC_LIVE_READ=1 WECOM_CAPABILITY_POC_TEST_USERID=HRWDTEST-20260517214548 node scripts/qa/check-wecom-capability-poc.mjs --poc-env-file=deploy/trialrun/.env --json；若本地无 env 或需服务器可信 IP，则记录 PAUSE_FOR_CONFIG/PAUSE_FOR_API_POC。","node","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-*","[""WCP1-2""]","HCLT 测试成员已按审计要求保留离职/禁用状态，不删除。"
"WCP1-4","人事助手能力分类","探测人事助手字段配置和测试员工花名册读取能力；花名册更新仅做能力分类，不执行写入。","1) 字段配置和测试员工花名册读取有唯一状态和原因；2) 更新接口不在本轮调用，按 NEEDS_API_POC 或后续写入批准处理；3) 缺人事助手权限或 Secret 时标 NEEDS_CONFIG；4) 不打印员工完整个人信息。","受影响流程：人事助手主数据 -> OA 员工/账号/角色/绑定镜像；验证步骤：检查 POC 报告中 hr.fields_read、hr.staff_read、hr.staff_update_classification 均有状态。","node|rg","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-*","[""WCP1-2""]","none"
"WCP1-5","打卡能力分类","探测 getcheckindata 和员工打卡规则接口短窗口能力；优先测试员工和 1 天窗口，不读取批量真实员工明细。","1) getcheckindata 和 getcheckinoption 均有唯一状态和原因；2) 缺打卡 Secret/API 权限/可信 IP/测试员工时标 NEEDS_CONFIG；3) 测试员工无打卡数据不伪造成失败，只记录 count=0；4) 不保存完整位置、人脸、设备明文或原始 payload。","受影响流程：企微打卡采集/规则 -> OA 考勤镜像准入；验证步骤：检查 POC 报告中 checkin.records_read、checkin.rules_read 均有状态和脱敏证据。","node|rg","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-*","[""WCP1-2""]","none"
"WCP1-6","审批假期回调能力分类","探测审批模板详情、审批详情、假期余额和回调配置可用性；采购、合同、报销、财务继续标 KEEP_OA_PRIMARY。","1) 审批模板、审批详情、假期余额、回调配置均有唯一状态和原因；2) 缺模板 ID、审批单号、回调配置或权限时标 NEEDS_CONFIG；3) OA 主办高敏审批能力标 KEEP_OA_PRIMARY；4) 不下载或打印附件内容。","受影响流程：企微 HR/考勤审批 -> OA 镜像准入；OA 主办审批 -> 企业微信脱敏消息 deeplink；验证步骤：检查 POC 报告中 approval.template_detail、approval.instance_detail、approval.vacation_quota、callback.config、approval.oa_primary_sensitive_domains 均有状态。","node|rg","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-*","[""WCP1-2""]","采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不进入企微原生审批。"
"WCP1-7","能力矩阵与结论","汇总能力矩阵，状态只使用 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API，并生成允许结论之一。","1) 每个能力项都有 id/domain/status/reason/evidence；2) 结论只为 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC 或 NO_GO_REVISE_ROADMAP；3) 缺配置不得写 PASS；4) POC 结论不代表运行时迁移已完成。","受影响流程：POC 报告 -> 路线图下一阶段准入或暂停；验证步骤：rg -n 'CAN_REUSE_NOW|NEEDS_CONFIG|NEEDS_API_POC|KEEP_OA_PRIMARY|NOT_SUPPORTED_BY_API|GO_TO_HR_MASTER_SYNC|PAUSE_FOR_CONFIG|PAUSE_FOR_API_POC|NO_GO_REVISE_ROADMAP' docs issues scripts artifacts。","rg|node","DONE","DONE","DONE","scripts/qa/check-wecom-capability-poc.mjs|docs|issues|artifacts/qa-flow/wecom-capability-poc-*","[""WCP1-3"",""WCP1-4"",""WCP1-5"",""WCP1-6""]","none"
"WCP1-8","事实源与 skill 回写","更新路线图、企业微信规约、PRD、文档索引、事实源矩阵、人工试运行报告和项目 skill，记录 POC 只代表能力分类，不代表正式迁移。","1) 文档索引和事实源矩阵登记 WCP1；2) 路线图当前阶段更新为 WCP1 POC；3) 企业微信规约和 PRD 记录能力矩阵与后续准入；4) skill 明确后续先看 WCP1 结论再进入 HR 主数据镜像；5) 文档审计、skill 校验和 git diff --check 通过。","受影响流程：后续 agent/人工读取事实源 -> 依据 WCP1 结论拆下一阶段合同；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；git diff --check。","node|python3|git|rg","DONE","DONE","DONE","docs/企微优先开发路线图.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md|docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md|.agents/skills/hyb-oa-delivery/SKILL.md","[""WCP1-7""]","本轮不部署；只新增 QA-only 脚本和文档/skill 事实源。"
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 WCP1-0 合同建档 建立 WECOM-CAPABILITY-POC-V1 合同，锁定本轮只做企业微信能力 POC：Live 只读 + 测试员工优先，不迁移运行时流程，不开发 HR 主数据镜像、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps。 1) CSV 校验通过；2) 本轮不新增业务 API/schema/UI/feature flag；3) 不调用生产写接口、不写正式规则、不批量读取真实员工明细；4) 最终结论只允许 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC、NO_GO_REVISE_ROADMAP。 受影响流程：WDRG 路线图 -> WECOM-CAPABILITY-POC-V1 -> 后续 HR 主数据镜像准入判断；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv。 python3|manual DONE DONE DONE issues/2026-05-18_13-30-07-wecom-capability-poc-v1.csv [] 回滚路径：回退本 CSV、QA-only 脚本和文档/skill 事实源回写；不涉及数据库、业务运行时或公网配置。
3 WCP1-1 基线与权限配置复核 复核 WDRG 已收口、下一阶段为 POC，并整理当前企业微信配置项、HCLT 通讯录证据、WCFB 打卡 Secret 口径和禁止跳阶段要求。 1) 路线图、PRD、企业微信规约和 skill 均显示当前阶段为 WECOM-CAPABILITY-POC-V1；2) 通讯录 HCLT 证据被纳入 POC；3) 缺 Secret、模板、可信 IP、回调或权限时记录 NEEDS_CONFIG 或 SKIP/BLOCKED_BY_EXTERNAL_CONFIG；4) 不打印 secret、token、cookie、完整手机号、完整位置或原始 payload。 受影响流程：事实源读取 -> POC 能力分类 -> 后续单功能合同准入；验证步骤：rg -n 'WECOM-CAPABILITY-POC-V1|HCLT|WCFB|SKIP/BLOCKED_BY_EXTERNAL_CONFIG|禁止跳阶段' docs issues .agents/skills/hyb-oa-delivery/SKILL.md。 rg DONE DONE DONE docs|issues|.agents/skills/hyb-oa-delivery/SKILL.md ["WCP1-0"] none
4 WCP1-2 QA-only POC runner 新增 scripts/qa/check-wecom-capability-poc.mjs，只读探测配置、access token、通讯录读取、测试员工状态、打卡短窗口、人事助手字段/花名册读取、审批模板/详情、假期余额和回调配置可用性，并输出脱敏报告。 1) 脚本默认不写生产数据；2) 支持 WECOM_CAPABILITY_POC_LIVE_READ=1、WECOM_CAPABILITY_POC_TEST_USERID、WECOM_CAPABILITY_POC_DAYS、WECOM_CAPABILITY_POC_JSON、--env-file、--json；3) 报告落到 artifacts/qa-flow/wecom-capability-poc-*；4) 输出不包含 Secret、access token、cookie、完整手机号、完整位置、身份证号、附件内容或原始 payload。 受影响流程：QA-only 企微能力探测 -> 脱敏能力矩阵报告；验证步骤：node --check scripts/qa/check-wecom-capability-poc.mjs；WECOM_CAPABILITY_POC_JSON=1 node scripts/qa/check-wecom-capability-poc.mjs --json。 node DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs ["WCP1-1"] 只允许 QA-only 读取和脱敏报告；任何生产写入或规则写入必须另建合同。
5 WCP1-3 通讯录能力分类 结合 HCLT 证据和 live 只读成员/部门能力，确认通讯录读取、成员读取、部门读取和后续 HR 主数据镜像准入状态。 1) HCLT create/update/disable 真实写入证据纳入矩阵；2) 部门列表和测试成员读取若成功标 CAN_REUSE_NOW；3) 缺通讯录 Secret、测试 userid、可见范围或可信 IP 时标 NEEDS_CONFIG；4) 不保存完整手机号或成员原始 payload。 受影响流程：企微通讯录 -> OA 员工镜像准入；验证步骤：WECOM_CAPABILITY_POC_LIVE_READ=1 WECOM_CAPABILITY_POC_TEST_USERID=HRWDTEST-20260517214548 node scripts/qa/check-wecom-capability-poc.mjs --poc-env-file=deploy/trialrun/.env --json；若本地无 env 或需服务器可信 IP，则记录 PAUSE_FOR_CONFIG/PAUSE_FOR_API_POC。 node DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-* ["WCP1-2"] HCLT 测试成员已按审计要求保留离职/禁用状态，不删除。
6 WCP1-4 人事助手能力分类 探测人事助手字段配置和测试员工花名册读取能力；花名册更新仅做能力分类，不执行写入。 1) 字段配置和测试员工花名册读取有唯一状态和原因；2) 更新接口不在本轮调用，按 NEEDS_API_POC 或后续写入批准处理；3) 缺人事助手权限或 Secret 时标 NEEDS_CONFIG；4) 不打印员工完整个人信息。 受影响流程：人事助手主数据 -> OA 员工/账号/角色/绑定镜像；验证步骤：检查 POC 报告中 hr.fields_read、hr.staff_read、hr.staff_update_classification 均有状态。 node|rg DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-* ["WCP1-2"] none
7 WCP1-5 打卡能力分类 探测 getcheckindata 和员工打卡规则接口短窗口能力；优先测试员工和 1 天窗口，不读取批量真实员工明细。 1) getcheckindata 和 getcheckinoption 均有唯一状态和原因；2) 缺打卡 Secret/API 权限/可信 IP/测试员工时标 NEEDS_CONFIG；3) 测试员工无打卡数据不伪造成失败，只记录 count=0；4) 不保存完整位置、人脸、设备明文或原始 payload。 受影响流程：企微打卡采集/规则 -> OA 考勤镜像准入；验证步骤：检查 POC 报告中 checkin.records_read、checkin.rules_read 均有状态和脱敏证据。 node|rg DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-* ["WCP1-2"] none
8 WCP1-6 审批假期回调能力分类 探测审批模板详情、审批详情、假期余额和回调配置可用性；采购、合同、报销、财务继续标 KEEP_OA_PRIMARY。 1) 审批模板、审批详情、假期余额、回调配置均有唯一状态和原因；2) 缺模板 ID、审批单号、回调配置或权限时标 NEEDS_CONFIG；3) OA 主办高敏审批能力标 KEEP_OA_PRIMARY；4) 不下载或打印附件内容。 受影响流程：企微 HR/考勤审批 -> OA 镜像准入；OA 主办审批 -> 企业微信脱敏消息 deeplink；验证步骤：检查 POC 报告中 approval.template_detail、approval.instance_detail、approval.vacation_quota、callback.config、approval.oa_primary_sensitive_domains 均有状态。 node|rg DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs|artifacts/qa-flow/wecom-capability-poc-* ["WCP1-2"] 采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不进入企微原生审批。
9 WCP1-7 能力矩阵与结论 汇总能力矩阵，状态只使用 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API，并生成允许结论之一。 1) 每个能力项都有 id/domain/status/reason/evidence；2) 结论只为 GO_TO_HR_MASTER_SYNC、PAUSE_FOR_CONFIG、PAUSE_FOR_API_POC 或 NO_GO_REVISE_ROADMAP；3) 缺配置不得写 PASS；4) POC 结论不代表运行时迁移已完成。 受影响流程：POC 报告 -> 路线图下一阶段准入或暂停；验证步骤：rg -n 'CAN_REUSE_NOW|NEEDS_CONFIG|NEEDS_API_POC|KEEP_OA_PRIMARY|NOT_SUPPORTED_BY_API|GO_TO_HR_MASTER_SYNC|PAUSE_FOR_CONFIG|PAUSE_FOR_API_POC|NO_GO_REVISE_ROADMAP' docs issues scripts artifacts。 rg|node DONE DONE DONE scripts/qa/check-wecom-capability-poc.mjs|docs|issues|artifacts/qa-flow/wecom-capability-poc-* ["WCP1-3","WCP1-4","WCP1-5","WCP1-6"] none
10 WCP1-8 事实源与 skill 回写 更新路线图、企业微信规约、PRD、文档索引、事实源矩阵、人工试运行报告和项目 skill，记录 POC 只代表能力分类，不代表正式迁移。 1) 文档索引和事实源矩阵登记 WCP1；2) 路线图当前阶段更新为 WCP1 POC；3) 企业微信规约和 PRD 记录能力矩阵与后续准入；4) skill 明确后续先看 WCP1 结论再进入 HR 主数据镜像；5) 文档审计、skill 校验和 git diff --check 通过。 受影响流程：后续 agent/人工读取事实源 -> 依据 WCP1 结论拆下一阶段合同；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；git diff --check。 node|python3|git|rg DONE DONE DONE docs/企微优先开发路线图.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md|docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md|.agents/skills/hyb-oa-delivery/SKILL.md ["WCP1-7"] 本轮不部署；只新增 QA-only 脚本和文档/skill 事实源。
scripts/qa/check-wecom-capability-poc.mjs
+1096
查看文件
文件差异内容过多而无法显示 加载差异