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

WDRG 收口企微优先开发路线图

浏览代码
这个提交包含在：
wangsli
2026-05-18 12:54:59 +08:00
父节点 d128161a95
当前提交 6143dfcbb2
共修改 16 个文件，包含 166 行新增和 26 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
.agents/skills/hyb-oa-delivery/SKILL.md
+2 -1
查看文件
@@ -16,6 +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 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`.
@@ -104,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 WFDG, 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, 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. 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 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`.
- 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
查看文件
@@ -43,6 +43,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
- 2026-05-18 WFOC 已完成“企微优先 + OA 无痛接管”需求重构：用户确认能用企业微信成熟能力就优先使用企业微信，第一批聚焦 HR/考勤员工日常审批；OA 目标调整为镜像、人工接管、恢复回写、RuleOps、财务闭环和审计中台。员工主数据后续以企微/人事助手为主，OA 同步镜像；企微故障时由管理员人工开启 OA 应急模式；企微恢复后 OA 对应急数据 dry-run 并自动回写。本轮只更新需求事实源、手册、索引和 Issue CSV，不改业务代码、不部署、不改公网配置；后续实现需另拆 `wecom_hr_master_sync_v1`、`wecom_native_approval_mirror_v1`、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1`、`wecom_ruleops_v1`。DBWFOC 后该口径进一步收窄为按域镜像和 OA 主办数据边界。
- 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，不改业务代码、不部署、不调用公网写接口。
## 关键证据索引
@@ -128,6 +129,7 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
| WFOC 企微优先 + OA 无痛接管需求重构 | 通过，无运行时变更 | Issue `issues/2026-05-18_10-25-18-wecom-first-oa-continuity-requirements.csv`；PRD、企业微信基础设施规约、统一审批规约、请假考勤规约、管理员手册、员工快速上手、文档索引和事实源矩阵已回写。结论只代表需求方向冻结，不代表企微审批镜像、OA 接管或恢复回写已实现。 |
| 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`；不代表运行时迁移已完成。 |
## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
docs/trialrun/发布试运行准备清单.md
+1 -1
查看文件
@@ -16,7 +16,7 @@
- 当前状态：本地门禁已闭环；R4 部署预检、D3 受控同步、D4 只读复检、R5 公网 live smoke、真实 PDF OCR、PC/自动化审批链、企业微信真机入口、个人应用消息和 deeplink 均已完成。
- 当前最大缺口：MIF7-7 已收口；若要启动 R7，必须另建 R7E 执行合同，固定试运行名单、时间窗口、回滚联系人和问题登记规则后再开始。
本清单中的 A1-A8/R5/R6/R7E 证据保留当时路线：OA 是首轮主业务系统和正式审批中心，企业微信只做入口、身份、通知、deeplink 和打卡原始采集边界。当前最新产品口径已由 WFOC/DBWFOC/WFDG 覆盖：HR/考勤员工日常审批优先复用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；财务、报销、采购、合同、项目、付款批次、AP、代账交接和高敏附件仍由 OA 主办。后续正式迁移前先做 `WECOM-CAPABILITY-POC-V1`，不直接大规模开发。
本清单中的 A1-A8/R5/R6/R7E 证据保留当时路线：OA 是首轮主业务系统和正式审批中心，企业微信只做入口、身份、通知、deeplink 和打卡原始采集边界。当前最新产品口径已由 WFOC/DBWFOC/WFDG/WDRG 覆盖：HR/考勤员工日常审批优先复用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；财务、报销、采购、合同、项目、付款批次、AP、代账交接和高敏附件仍由 OA 主办。后续正式迁移前先读 [企微优先开发路线图](../企微优先开发路线图.md)，再做 `WECOM-CAPABILITY-POC-V1`，不直接大规模开发。
## 2. 已完成证据
docs/产品口径.md
+7
查看文件
@@ -33,6 +33,13 @@
- 企业微信同步、镜像和回写必须具备幂等、重试、脱敏日志、审计记录和 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG` 状态；缺 Secret、权限、模板或可信 IP 时不得伪造成成功。
- 下一轮先做 `WECOM-CAPABILITY-POC-V1`，输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 能力矩阵，再进入正式开发。
### P0-5 WDRG 开发路线图门禁
- WDRG 后采用“路线图门禁 + 单功能 Issue CSV”：路线图只控制阶段顺序、准入/退出门禁、并行规则和禁止跳阶段，具体功能仍单独方案、单独 Issue CSV、单独验证。
- 当前企微优先 HR/考勤路线顺序固定为：`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`。
- `WECOM-CAPABILITY-POC-V1` 未完成前，不得直接开发 HR 主数据镜像、考勤/审批镜像、OA 应急接管、恢复回写或 RuleOps 正式写入。
- 线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护可以另开合同并行；采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不混入企微 HR/考勤路线。
- 路线图事实源为 [企微优先开发路线图](./企微优先开发路线图.md)；该路线图不代表任何运行时迁移能力已完成。
---
## 请假模块
docs/企微优先开发路线图.md
+67
查看文件
@@ -0,0 +1,67 @@
# 企微优先开发路线图
**文档状态**：当前开发路线图事实源。
**分类**：开发治理 / 路线图。
**适用时间**：WDRG 之后。
**关联 Issue**：`WDRG`。
**最近审计**：2026-05-18。
**不得误读**：本文只控制后续开发节奏、阶段顺序和门禁，不代表企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 已完成运行时实现。
## 1. 路线图原则
- 采用“路线图门禁 + 单功能 Issue CSV”的工程流程；路线图管顺序和边界，具体实现仍以每个功能的 Issue CSV 为准。
- 当前路线只覆盖企微优先 HR/考勤域改造：人事助手、通讯录、打卡、HR/考勤审批、OA 镜像、OA 应急接管、恢复回写和 RuleOps。
- 采购、费用、合同、项目、报销、付款批次、AP、代账交接、审计和高敏附件继续 OA 主办；企业微信只做脱敏消息、deeplink、入口和成熟能力参考。
- 阶段未满足退出条件前不得跳阶段。线上缺陷、安全风险、正式使用阻断或真实反馈可以另开独立 Issue CSV，但不得混入企微 HR/考勤主路线。
- ERP 未来不接入 OA；真实支付、图片 OCR、银行流水导入、复杂 BPM、审批设计器和重预算继续不进入当前路线。
## 2. 当前阶段
| 阶段 | 状态 | 结论 |
| --- | --- | --- |
| `DBWFOC` | 已完成 | 固定数据边界：HR/考勤员工日常审批企微优先，OA 主办高敏业务不进企微原生审批或企微附件。 |
| `WFDG` | 已完成 | 固定设计门禁：先判定主办方、数据边界、入口交互、隐私消息、同步审计、应急接管、恢复回写和 RuleOps 边界。 |
| `WDRG` | 当前 | 固定开发路线图和节奏，下一步只允许进入 `WECOM-CAPABILITY-POC-V1`。 |
## 3. 阶段路线
| 顺序 | 阶段 | 目标 | 进入条件 | 退出条件 |
| --- | --- | --- | --- | --- |
| 1 | `WECOM-CAPABILITY-POC-V1` | 只读或低风险探测企微 API 能力，输出能力矩阵。 | WDRG 完成；企微后台权限、Secret、可信 IP、模板和可见范围按现状记录。 | 人事助手、通讯录、打卡、审批、假期余额、回调和权限配置均有 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY` 或 `NOT_SUPPORTED_BY_API` 结论。 |
| 2 | `wecom_hr_master_sync_v1` | 企微/人事助手员工、部门、主管、职位、联系方式和在职状态镜像到 OA。 | POC 证明人事助手/通讯录读取和回调能力可用，或明确缺口处理方式。 | OA 可自动创建/更新员工档案、账号、角色、企微绑定和审计；缺配置时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。 |
| 3 | `wecom_attendance_approval_mirror_v1` | 企微打卡、请假、补卡、外出、加班、假期余额和审批历史镜像到 OA。 | HR 主数据镜像稳定；审批模板、打卡规则和回调能力已完成 POC 或有可解释替代方案。 | OA 可查询企微 HR/考勤镜像、附件摘要、审批历史、考勤解释和审计；不把 OA 主办高敏审批迁到企微。 |
| 4 | `oa_hr_emergency_mode_v1` | 企业微信不可用时，由管理员人工开启 OA HR/考勤应急接管。 | 企微镜像数据可支撑对账；OA 应急入口、权限和审计方案明确。 | 管理员可填写原因、范围、预计结束时间和责任人后开启/关闭；应急单据带 `EMERGENCY` 标记。 |
| 5 | `wecom_recovery_writeback_v1` | 企微恢复后，OA 应急数据先 dry-run，再回写企微。 | 应急接管模式完成；企微写回接口、冲突规则和回滚策略已单独批准。 | 系统生成成功、失败、跳过和冲突清单；无冲突项可自动回写，冲突进入人工确认。 |
| 6 | `wecom_ruleops_v1` | AI 草拟企微规则、生成差异报告和 dry-run，人工确认后写入企微。 | 前述同步/回写链路稳定；企微规则 API 能力和权限已验证。 | 每次写入保存前后快照、确认人、API `errcode`、失败原因、回滚建议和审计记录。 |
## 4. 每阶段固定门禁
每个正式阶段必须单独建立 Issue CSV，并至少包含：
- 需求边界：本阶段做什么、不做什么、涉及哪些角色和业务流程。
- 接口边界：新增或复用的企微 API、OA API、schema、feature flag、配置和权限。
- 数据边界：主事实源、镜像方向、附件归属、脱敏字段和审计责任。
- 失败处理：缺 Secret、权限、模板、可信 IP、回调、外部配置时必须记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，不得伪造成成功。
- 测试门禁：本地静态检查、focused 单测、必要 Playwright、权限负例、文档审计和公网复检。
- 部署规则：本地全测通过后才能部署；生产写接口、企微规则写入、应急模式开启或恢复回写必须单独批准。
## 5. 并行工作规则
- 可以并行：线上缺陷修复、首周运营保障、真实反馈扫尾、QA-only 脚本维护、文档审计修正。
- 必须另开合同：OA 主办域的采购、合同、报销、付款、AP、代账、审计和高敏附件功能变更。
- 不允许混入：在 POC 未完成前开发 HR 主数据镜像；在 HR 主数据未稳定前开发恢复回写；在应急接管未完成前开发 RuleOps 正式写入。
- 不允许把企业微信原生审批用于报销、采购、合同、项目、财务付款或高敏附件审批。
## 6. 下一轮 POC 验收口径
`WECOM-CAPABILITY-POC-V1` 必须输出能力矩阵：
| 状态 | 含义 |
| --- | --- |
| `CAN_REUSE_NOW` | 当前配置和 API 能力足以进入正式实现设计。 |
| `NEEDS_CONFIG` | 需要企微后台配置、授权、可信 IP、模板、可见范围或 Secret 后再测。 |
| `NEEDS_API_POC` | 文档显示可能支持，但需 QA-only 探测脚本确认。 |
| `KEEP_OA_PRIMARY` | 该能力继续由 OA 主办，企微只做入口、消息或参考。 |
| `NOT_SUPPORTED_BY_API` | 企业微信 API 不支持或风险过高，不进入自动化实现。 |
POC 默认只读或低风险探测。任何生产写操作、企微规则写入、真实员工批量变更、恢复回写或应急切换都必须另建合同并获得明确批准。
docs/员工快速上手.md
+1 -1
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 员工快速上手（10 人以下团队版）
**当前状态（2026-05-18 / WFDG）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`。WFOC 已冻结新的产品方向，DBWFOC 已修正数据边界，WFDG 已固定后续设计门禁：能用企业微信成熟能力的 HR/考勤员工日常审批优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、报销和财务资料仍由 OA 主办。本轮只是设计规约和 POC 口径调整，不代表页面入口已全部迁移完成。
**当前状态（2026-05-18 / WDRG）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`。WFOC 已冻结新的产品方向，DBWFOC 已修正数据边界，WFDG 已固定设计门禁，WDRG 已固定后续开发路线图：能用企业微信成熟能力的 HR/考勤员工日常审批优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、报销和财务资料仍由 OA 主办。本轮只是开发节奏和路线图调整，不代表页面入口已全部迁移完成。
## 1. 你每周主要会用到什么
- `Portal`：看公告、我的待办、我的资产、本周周报入口。
docs/开发交付与变更管理规约.md
+26 -4
查看文件
@@ -3,10 +3,10 @@
**文档状态**：当前开发交付事实源。
**分类**：开发治理。
**适用范围**：hyb-oa 所有非微小代码、文档、测试、脚本和部署准备变更。
**关联 Issue**：`GOV8`。
**最近审计**：2026-05-13。
**关联 Issue**：`GOV8,WDRG`。
**最近审计**：2026-05-18。
**不得误读**：本文定义开发和变更流程，不替代具体业务 PRD、模块规约或测试规约。
**路线口径**：开发必须围绕最新 Issue CSV 执行；hyb-oa 是唯一业务主系统，企业微信只做基础设施，飞书路线已废弃。
**路线口径**：开发必须围绕最新 Issue CSV 执行；WDRG 后企微优先 HR/考勤改造必须先读 [企微优先开发路线图](./企微优先开发路线图.md)，再按单功能 Issue CSV 实施。采购、合同、报销、财务、AP、代账和高敏附件继续 OA 主办，ERP 未来不接入 OA。
本文回答“一个变更怎么开始、怎么审查、什么时候提交、怎么交付”。测试细节以 [测试规约与回归门禁](./测试规约与回归门禁.md) 为准。
@@ -18,6 +18,12 @@
不得跳过 Issue CSV 直接开发非微小变更。需求、方案或验收口径不清时，先澄清或补文档。
WDRG 后，企微优先 HR/考勤改造增加一层路线图门禁：
`需求事实源 -> 设计门禁 -> 路线图门禁 -> 企微能力 POC -> 单功能 Issue CSV -> 方案批准 -> 开发实现 -> review -> QA 回归 -> 部署 / 公网验证`
路线图只控制顺序、边界、准入和退出条件；具体接口、schema、页面、权限、审计和测试仍必须在单功能 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`。
## 2. Issue 生命周期
| 状态 | 含义 | 可进入条件 |
@@ -79,12 +85,28 @@
| 测试影响 | 原测试是否仍有效，是否新增权限/视觉/公网/真机验证 |
| 回滚路径 | 如何撤销或延后 |
### 2.3 路线图门禁和单功能合同
WDRG 后，企微优先 HR/考勤路线采用“路线图门禁 + 单功能 Issue CSV”：
| 层级 | 作用 | 不承担 |
| --- | --- | --- |
| 路线图 | 固定阶段顺序、准入/退出门禁、并行规则和禁止跳过项 | 不写详细接口、schema、页面或迁移 |
| POC 合同 | 只读或低风险探测企微 API、配置、回调、模板和权限能力 | 不迁移运行时主流程 |
| 单功能合同 | 明确一个功能的接口、数据、权限、页面、审计、失败处理、测试和回滚 | 不顺手开发下一个阶段 |
当前企微优先路线顺序固定为：
`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`
允许并行处理线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护；但采购、合同、报销、付款、AP、代账和高敏附件等 OA 主办域必须另开合同，不得混入企微 HR/考勤路线。
## 3. 开发边界
- 每次只做当前 Issue 范围内的事，不顺手重构无关模块。
- 跨后端和前端的任务，先稳定后端 API / 数据契约，再接前端。
- 涉及权限、状态机、审批规则、财务状态、Prisma migration 的改动，必须写明回滚策略。
- 不在当前 MVP 首批范围内扩展预算、ERP、AI 自动处理、飞书、复杂 BPM 或重型项目管理；企业微信原生审批只按 WFOC/DBWFOC/WFDG 口径用于 HR/考勤员工日常审批优先复用，不迁移报销、财务、采购、合同、项目或高敏附件等 OA 主办流程。后续企微/OA 运行时迁移先做 `WECOM-CAPABILITY-POC-V1`，再按单功能 Issue CSV 开发。
- 不在当前 MVP 首批范围内扩展预算、ERP、AI 自动处理、飞书、复杂 BPM 或重型项目管理；ERP 未来不接入 OA。企业微信原生审批只按 WFOC/DBWFOC/WFDG/WDRG 口径用于 HR/考勤员工日常审批优先复用，不迁移报销、财务、采购、合同、项目或高敏附件等 OA 主办流程。后续企微/OA 运行时迁移先做 `WECOM-CAPABILITY-POC-V1`，再按 [企微优先开发路线图](./企微优先开发路线图.md) 拆单功能 Issue CSV 开发。
- 未经确认不得重置数据库、编辑迁移历史、修改生产配置、暴露真实密钥或处理真实敏感数据。
## 3.1 只读审计和排障边界
docs/文档事实源状态矩阵.md
+12 -9
查看文件
@@ -4,7 +4,7 @@
**分类**：文档台账。
**适用时间**：DCL7 之后。
**关联 Issue**：`GOV8`。
**最近审计**：2026-05-17。
**最近审计**：2026-05-18。
**不得误读**：本文登记文档权威性和状态，不替代具体 PRD、模块规约、测试规约或 Issue CSV。
**治理口径**：中文优先，物理精简，优先复用已有文档。历史资料不建 `docs/archive/`，已确认不用的文档从当前树移除，通过 git 历史恢复。
@@ -63,7 +63,8 @@
| `WCFB` | `issues/2026-05-17_22-57-39-wecom-checkin-agent-secret-fallback.csv` | `LOCAL_VERIFIED` | 企微打卡同步 Secret 兼容修正：`WECOM_CHECKIN_SECRET` 显式优先，未配置时复用已授权工作台应用的 `WECOM_AGENT_SECRET`；本地语法和 focused 单测通过，待部署后公网复检 |
| `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` | `CURRENT` | 企微优先设计规约门禁：固定主办方与数据边界矩阵、入口交互、隐私附件消息、同步审计失败处理、应急接管、恢复回写、RuleOps 和 `WECOM-CAPABILITY-POC-V1` 验收口径 |
| `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 合同口径 |
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
@@ -71,16 +72,17 @@
| 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` | `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` | `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` | Issue CSV | `docs/requirements-specification.md` | 2026-05-18 | `rg` | high | WFDG 后定义企微优先设计门禁、按域镜像、OA 主办数据边界和 POC 前置；ERP 未来不接入 OA |
| `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T,WFDG` | `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` | `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 设计门禁和开发路线图 |
| `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 应急接管 |
| `DELIVERY` | `docs/开发交付与变更管理规约.md` | 开发治理 | 开发交付事实源 | `CURRENT` | dev/qa | `GOV8` | `rg` | none | 2026-05-13 | `rg` | high | Issue、review、commit 和交付规则 |
| `ROADMAP-WECOM` | `docs/企微优先开发路线图.md` | 开发治理 | 企微优先开发路线图事实源 | `CURRENT` | product/dev | `WDRG` | Issue CSV | none | 2026-05-18 | `rg` | high | WDRG 后控制企微 HR/考勤路线的阶段顺序、准入/退出门禁、并行规则和禁止跳阶段 |
| `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` | 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` | quick_validate | none | 2026-05-18 | `quick_validate.py` | medium | 每轮交付操作入口，UI 任务读取设计主参考层级；企微/OA 后续先读路线图、再做 POC、再开发 |
| `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 | 报销、发票、附件细则 |
@@ -103,6 +105,7 @@
| `docs/文档事实源状态矩阵.md` | 当前事实源 | 文档分类和恢复规则 |
| `docs/海音达OA-MVP需求规格说明书.md` | 当前事实源 | PRD 主事实源 |
| `docs/产品设计规则.md` | 当前事实源 | PC、移动、企业微信设计规则；DG8 主 UI/布局参考层级 |
| `docs/企微优先开发路线图.md` | 当前事实源 | WDRG 后企微优先 HR/考勤改造阶段顺序、准入/退出门禁和禁止跳阶段 |
| `docs/产品口径.md` | 当前事实源 | 产品边界和业务规则 |
| `docs/需求-统一审批中心规约.md` | 当前事实源 | 审批、催办、超时、效率摘要 |
| `docs/报销发票附件规则.md` | 当前事实源 | 报销、发票、附件细则 |
@@ -177,4 +180,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 和银行流水导入继续不进入当前路线。WFDG 后 HR/考勤员工日常审批优先复用企业微信，OA 目标是按域镜像、人工接管、恢复回写和 RuleOps；采购、费用、合同、项目、报销、付款、AP、代账交接、审计和高敏附件继续 OA 主办。该方向尚未实现运行时迁移，下一步必须先做 `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`。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 设计门禁均已完成，当前 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 验证；测试成员按审计要求保留离职/禁用状态。
docs/文档索引.md
+6 -3
查看文件
@@ -4,7 +4,7 @@
**分类**：入口索引。
**适用时间**：DCL7 之后。
**关联 Issue**：`GOV8`。
**最近审计**：2026-05-17。
**最近审计**：2026-05-18。
**不得误读**：本文只指示当前事实源和读取顺序；历史 Issue CSV 只能用于追溯，不直接生成新开发任务。
**治理口径**：中文优先，物理精简，优先复用已有文档。已确认不用的历史文档不放 `docs/archive/`，直接从当前工作树移除；需要时从 git 历史恢复。
@@ -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。
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 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
@@ -58,6 +58,7 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
- WFOC 是企微优先 + OA 无痛接管需求重构合同：用户已确认优先复用企业微信成熟能力，OA 做镜像、人工接管、恢复回写、财务闭环和审计中台；其“HR/考勤/行政审批”和“完整镜像”宽口径已由 DBWFOC 修正为 HR/考勤员工日常审批和按域镜像。本轮只冻结需求和事实源，不改业务代码、不部署、不切换公网配置；后续实现需拆 `wecom_hr_master_sync_v1`、`wecom_native_approval_mirror_v1`、`oa_hr_emergency_mode_v1`、`wecom_recovery_writeback_v1`、`wecom_ruleops_v1`。
- 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。本轮不改业务代码、不部署、不调用公网写接口。
## 当前活跃治理流
@@ -101,7 +102,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| `WCFB` | `issues/2026-05-17_22-57-39-wecom-checkin-agent-secret-fallback.csv` | 本地通过：企微打卡同步 Secret 兼容修正 | `WECOM_CHECKIN_SECRET` 显式优先；未配置时复用已授权工作台应用的 `WECOM_AGENT_SECRET`，避免重复维护同一个 Secret；本地语法、focused 单测和文档/skill 校验通过 | 不新增业务 API/schema/UI；不改变企微权限边界；部署后需公网复检打卡同步 |
| `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、不部署、不改公网配置、不调用生产写接口；不代表运行时迁移已完成 |
| `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、不部署、不改公网配置、不调用公网写接口；不代表任何运行时迁移已完成 |
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
@@ -124,6 +126,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) | 已拍板产品边界和业务规则 |
| [需求 - 统一审批中心规约](./需求-统一审批中心规约.md) | OA 主办审批、企微主办 HR/考勤员工日常审批镜像、催办、超时提醒、审批效率 |
| [报销发票附件规则](./报销发票附件规则.md) | 报销、发票、OCR、附件细则 |
docs/测试规约与回归门禁.md
+1 -1
查看文件
@@ -2,7 +2,7 @@
**文档状态**：当前测试事实源。
**适用范围**：hyb-oa MVP 首轮开发 A3-A8，以及后续所有非微小改动。
**路线口径**：WFOC/DBWFOC/WFDG 后，HR/考勤员工日常审批优先复用企业微信成熟能力，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；报销、采购、合同、项目、PDF OCR、付款批次、AP 台账、代账交接和高敏附件继续由 OA 主办；企业微信只做脱敏消息和 OA deeplink；飞书不进入当前路线。后续企微/OA 运行时迁移前必须先做 `WECOM-CAPABILITY-POC-V1`，缺配置或权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，不得伪造成通过。
**路线口径**：WFOC/DBWFOC/WFDG/WDRG 后，HR/考勤员工日常审批优先复用企业微信成熟能力，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；报销、采购、合同、项目、PDF OCR、付款批次、AP 台账、代账交接和高敏附件继续由 OA 主办；企业微信只做脱敏消息和 OA deeplink；飞书不进入当前路线。后续企微/OA 运行时迁移前必须先读 [企微优先开发路线图](./企微优先开发路线图.md)，再做 `WECOM-CAPABILITY-POC-V1`；缺配置或权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`，不得伪造成通过。
本文回答“什么时候测试、测什么、怎么判定通过、怎么记录跳过”。具体业务验收仍以主 PRD、模块规约和最新 Issue CSV 为准。
docs/海音达OA-MVP需求规格说明书.md
+17 -2
查看文件
@@ -27,7 +27,7 @@
### 1.1 背景
海音达需要一套适合 10 人以下科技公司的轻量 OA，用来把报销、采购、费用、合同、项目资料、财务闭环、审计和关键行政数据集中到一个可审计、可回归、可持续迭代的系统中。WFOC 起产品方向调整为“企微优先 + OA 无痛接管”；DBWFOC 进一步修正边界：能复用企业微信成熟功能的 HR/考勤员工日常场景优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、财务和高敏附件仍由 OA 主办和存储。WFDG 固定后续开发前必须先过设计规约门禁和企微 API 能力 POC，不再直接进入大规模运行时改造。
海音达需要一套适合 10 人以下科技公司的轻量 OA，用来把报销、采购、费用、合同、项目资料、财务闭环、审计和关键行政数据集中到一个可审计、可回归、可持续迭代的系统中。WFOC 起产品方向调整为“企微优先 + OA 无痛接管”；DBWFOC 进一步修正边界：能复用企业微信成熟功能的 HR/考勤员工日常场景优先使用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、合同、项目、财务和高敏附件仍由 OA 主办和存储。WFDG 固定后续开发前必须先过设计规约门禁和企微 API 能力 POC；WDRG 进一步固定后续采用“路线图门禁 + 单功能 Issue CSV”的开发节奏，不再直接进入大规模运行时改造。
### 1.2 总目标
@@ -79,11 +79,26 @@ WFDG 将 DBWFOC 后的产品方向固化为开发前设计门禁。本节只代
下一轮必须先执行 `WECOM-CAPABILITY-POC-V1`，以 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 输出人事助手、通讯录、打卡、审批、假期余额、回调和权限配置能力矩阵。POC 默认只读或低风险探测；生产写接口必须单独批准。正式开发顺序为 `wecom_hr_master_sync_v1` -> `wecom_attendance_approval_mirror_v1`（承接旧口径 `wecom_native_approval_mirror_v1`）-> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` -> `wecom_ruleops_v1`。
### 1.7 WDRG 开发路线图门禁
WDRG 将 WFDG 后的设计门禁转化为开发节奏门禁。本节只代表路线图和治理节奏冻结，不代表任何运行时同步、镜像、应急接管、恢复回写或 RuleOps 能力已完成。
| 阶段 | 目标 | 退出门禁 |
| --- | --- | --- |
| `WECOM-CAPABILITY-POC-V1` | 只读或低风险探测人事助手、通讯录、打卡、审批、假期余额、回调和权限配置 | 输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 能力矩阵 |
| `wecom_hr_master_sync_v1` | 企微/人事助手员工、部门、主管、职位、联系方式和在职状态镜像到 OA | OA 可自动创建/更新员工档案、账号、角色、企微绑定和审计 |
| `wecom_attendance_approval_mirror_v1` | 企微打卡、请假、补卡、外出、加班、假期余额和审批历史镜像到 OA | OA 可查询企微 HR/考勤镜像、考勤解释和审计 |
| `oa_hr_emergency_mode_v1` | 企业微信不可用时管理员人工开启 OA HR/考勤应急接管 | 应急单据带 `EMERGENCY` 标记，开启/关闭均有原因、范围、责任人和审计 |
| `wecom_recovery_writeback_v1` | 企微恢复后，OA 应急数据先 dry-run，再回写企微 | 生成成功、失败、跳过和冲突清单，不静默覆盖企微正式记录 |
| `wecom_ruleops_v1` | AI 草拟规则、生成差异报告和 dry-run，人工确认后写入企微 | 保存前后快照、确认人、API `errcode`、失败原因、回滚建议和审计 |
阶段未满足退出条件前不得跳阶段。采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办，不混入企微 HR/考勤开发路线。路线图事实源为 [企微优先开发路线图](./企微优先开发路线图.md)。
---
## 2. 软件开发项目流程
后续所有非微小改动按标准软件开发流程推进。流程目标不是增加仪式感，而是保证每轮都有清晰需求、可执行方案、可验证结果、可回滚边界和可追溯记录。
后续所有非微小改动按标准软件开发流程推进。流程目标不是增加仪式感，而是保证每轮都有清晰需求、可执行方案、可验证结果、可回滚边界和可追溯记录。WDRG 后，企微优先 HR/考勤路线必须先经过路线图门禁，再进入 POC 和单功能 Issue CSV，避免散点式开发。
| 阶段 | 目标 | 输入 | 输出 | 门禁 |
| --- | --- | --- | --- | --- |
docs/管理员手册.md
+4 -4
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 管理员手册（10 人以下团队版）
**当前状态（2026-05-18 / WFDG）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、ATTV1、HR-WECOM-DIRECTORY-V1 和 HRWD-CONTACT-LIVE-TEST 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。WFOC 已冻结“企微优先 + OA 无痛接管”需求方向，DBWFOC 已修正数据边界，WFDG 进一步固定设计门禁：HR/考勤员工日常审批优先复用企业微信，OA 做按域镜像、人工接管、恢复回写、财务闭环和审计中台；采购、费用、合同、项目、报销、付款、AP、代账交接和高敏附件继续 OA 主办，企业微信只做脱敏提醒和 OA deeplink。本轮只更新设计规约和 POC 口径，不代表运行时代码已完成迁移。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，且 ERP 未来不接入 OA；财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
**当前状态（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 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
## 1. 适用范围
- 适用于 `small_team_internal` 工作区模式。
@@ -190,11 +190,11 @@ RuleOps：
- 正式写入前必须人工确认；每次写入保存前后快照、确认人、API `errcode`、失败原因、回滚建议和审计记录。
- 不得在报告、日志或截图中暴露 Secret、access token、完整位置、人脸数据、身份证号、完整手机号或原始密钥材料。
WFDG 后续推进：
WDRG 后续推进：
1. 下一步先执行 `WECOM-CAPABILITY-POC-V1`，核对人事助手、通讯录、打卡、审批、假期余额、回调和权限配置。
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` 分合同实施。
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 或可审计记录。
### 3.3 正式财务闭环与代账交接
docs/需求-企业微信基础设施规约.md
+8
查看文件
@@ -219,6 +219,14 @@ REQAUD 复核后，ATTV1 已完成统一入口实现，企业微信打卡边界
- `oa_hr_emergency_mode_v1` 只能由管理员人工开启；恢复后由 `wecom_recovery_writeback_v1` 先 dry-run，再对无冲突项回写，冲突、权限不足或 API 不支持进入人工确认。
- `wecom_ruleops_v1` 中 AI 只负责草拟规则、差异报告和 dry-run；正式写入企微审批模板、打卡规则、排班、假期余额或人事字段前必须人工确认，并保存前后快照、确认人、API `errcode`、失败原因和回滚建议。
## 7.8 WDRG 开发路线图门禁
- WDRG 后，企业微信相关运行时迁移采用“路线图门禁 + 单功能 Issue CSV”，路线图事实源为 [企微优先开发路线图](./企微优先开发路线图.md)。
- 阶段顺序固定为 `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`。
- `WECOM-CAPABILITY-POC-V1` 未完成前，不得直接开发人事助手主数据镜像、企微 HR/考勤审批镜像、OA 应急接管、恢复回写或 RuleOps 正式写入。
- 线上缺陷、正式使用阻断、真实反馈扫尾和 QA-only 脚本维护可另开合同并行；采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办，不混入企微 HR/考勤路线。
- 本路线图只代表开发节奏和门禁，不代表任何企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps 运行时能力已完成。
---
## 8. 验收场景
docs/需求-统一审批中心规约.md
+1
查看文件
@@ -354,6 +354,7 @@ WF8-3、WF8-4、WF8-5 实现前必须基于本设计给技术方案；实现后
- 采购单附件、合同正文、报价、供应商资料、发票、银行回单、代账资料和其他高敏附件不进入企业微信原生审批或企业微信附件；企业微信只做提醒、deeplink 和免登录回流。
- 按域镜像是默认规则：企微主办 HR/考勤域镜像到 OA；OA 主办采购、合同、项目、财务和报销域不反向全量镜像到企微。
- WFDG 后，审批相关页面和接口必须区分 `OA 主办`、`企微镜像` 和 `OA 应急接管`；企微镜像不得被误用为 OA 日常新建入口，OA 应急接管单据必须带 `EMERGENCY` 并进入恢复回写队列。
- WDRG 后，审批相关运行时迁移必须先读 [企微优先开发路线图](./企微优先开发路线图.md)，按 `WECOM-CAPABILITY-POC-V1` -> `wecom_attendance_approval_mirror_v1` -> `oa_hr_emergency_mode_v1` -> `wecom_recovery_writeback_v1` 的顺序拆单功能 Issue CSV；POC 未完成前不得直接开发企微审批镜像或恢复回写。
- 后续企微审批同步的 POC 必须输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API`，缺模板、回调、Secret 或权限时记录 `SKIP/BLOCKED_BY_EXTERNAL_CONFIG`。
- 若企业微信返回 `invaliduser`、`unlicenseduser`、不可见范围或权限类错误，业务提交和审批动作不应回滚，但通知记录必须可审计、可重试，并提示管理员修正企业微信应用可见范围或账号绑定。
- 真机验收以企业微信手机端收到应用消息并可点击回流为准；系统级弹窗是否出现受客户端通知权限影响，不作为 OA 通知链路硬门槛。
docs/需求-请假考勤修正规约.md
+1
查看文件
@@ -220,6 +220,7 @@ WFOC 后，正常审批规则优先以企业微信审批模板和打卡/假期
## 10. 后续开发拆分建议
- 已完成：OA 侧补卡/外出/加班申请对象、统一审批接入、月度考勤解释页、移动入口和企业微信 deeplink 回 OA；WFOC 后这些能力默认作为历史查询和应急接管基础。
- WDRG 后：后续开发先读 [企微优先开发路线图](./企微优先开发路线图.md)，阶段未退出前不得跳阶段；`WECOM-CAPABILITY-POC-V1` 未完成前不得直接开发企微 HR/考勤镜像、OA 应急接管、恢复回写或 RuleOps。
- 后续 A1：`wecom_attendance_approval_mirror_v1`，同步企微请假、补卡、外出、加班审批、附件、历史和状态回调；该命名承接旧口径 `wecom_native_approval_mirror_v1`。正式开发前先执行 `WECOM-CAPABILITY-POC-V1`，输出 `CAN_REUSE_NOW`、`NEEDS_CONFIG`、`NEEDS_API_POC`、`KEEP_OA_PRIMARY`、`NOT_SUPPORTED_BY_API` 能力矩阵。
- 后续 A2：企微打卡规则、排班、记录、日报、月报按域镜像，覆盖 Secret/API 权限、短窗口同步、错误码和脱敏证据。
- 后续 A3：`oa_hr_emergency_mode_v1`，管理员人工接管、应急提交、应急审批和恢复队列。
issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv
+10
查看文件
@@ -0,0 +1,10 @@
ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
"WDRG-0","合同建档","建立 WECOM-DEVELOPMENT-ROADMAP-GATE 合同，锁定本轮只做开发路线图、交付治理、事实源和 skill 同步，不改业务代码、不部署、不调用公网写接口。","1) CSV 校验通过；2) 本轮范围明确为路线图门禁；3) 不新增业务 API/schema/UI/feature flag；4) 不触碰生产配置或公网数据。","受影响流程：WFDG 设计门禁 -> 开发路线图门禁 -> WECOM-CAPABILITY-POC-V1；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv。","python3|manual","DONE","DONE","DONE","issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv","[]","回滚路径：回退本 CSV 和本轮文档/skill 口径；不涉及运行时、数据库或公网配置。"
"WDRG-1","当前基线复核","确认 DBWFOC 和 WFDG 已收口，当前下一步不是直接开发，而是先完成企微 API 能力 POC。","1) 文档索引和事实源矩阵显示 DBWFOC/WFDG 已收口；2) 下一步明确为 WECOM-CAPABILITY-POC-V1；3) 不把 HR/考勤镜像、应急接管、恢复回写或 RuleOps 写成已实现。","受影响流程：事实源读取 -> 阶段判断 -> 后续合同选择；验证步骤：rg -n 'DBWFOC|WFDG|WECOM-CAPABILITY-POC-V1|不代表运行时|下一步' docs issues。","rg","DONE","DONE","DONE","docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md","[""WDRG-0""]","none"
"WDRG-2","路线图文档","新增 docs/企微优先开发路线图.md，作为后续开发节奏事实源，只写阶段、边界、准入/退出门禁、验收证据和禁止跳过项，不写过细接口实现。","1) 路线图文档存在并登记；2) 文档清楚说明当前阶段和后续阶段；3) 每阶段有目标、进入条件、退出条件、允许/禁止项和测试门禁；4) 不承诺运行时能力已完成。","受影响流程：路线图读取 -> 单功能合同拆分 -> 开发节奏控制；验证步骤：rg -n '企微优先开发路线图|路线图门禁|进入条件|退出条件|禁止跳阶段|单功能 Issue CSV' docs/企微优先开发路线图.md。","rg","DONE","DONE","DONE","docs/企微优先开发路线图.md","[""WDRG-1""]","新增文档原因：用户明确要求开发计划文档，且现有规约不足以承载阶段路线图和节奏控制。"
"WDRG-3","阶段顺序固定","在路线图和事实源中固定后续顺序：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。","1) 阶段顺序在路线图、产品口径、PRD 和 skill 中一致；2) 明确 POC 是开发前置；3) 禁止跳过 POC 直接做运行时迁移。","受影响流程：POC -> HR 主数据镜像 -> 考勤/审批镜像 -> OA 应急接管 -> 恢复回写 -> RuleOps；验证步骤：rg -n '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' docs .agents/skills/hyb-oa-delivery/SKILL.md。","rg","DONE","DONE","DONE","docs/企微优先开发路线图.md|docs/产品口径.md|docs/海音达OA-MVP需求规格说明书.md|.agents/skills/hyb-oa-delivery/SKILL.md","[""WDRG-2""]","none"
"WDRG-4","并行与冻结规则","固定采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办；只有线上缺陷、真实反馈或上线阻断才另开合同，不混入企微 HR/考勤路线。","1) 路线图和交付规约写明并行/冻结规则；2) OA 主办域不进入企微原生审批或企微附件；3) 真实支付、ERP、图片 OCR、银行流水导入、复杂 BPM、审批设计器和重预算继续不进入当前路线。","受影响流程：企微 HR/考勤路线推进；OA 主办业务反馈处理；验证步骤：rg -n 'OA 主办|不混入企微 HR/考勤路线|真实反馈|上线阻断|ERP 未来不接入|不进入企微原生审批|高敏附件' docs。","rg","DONE","DONE","DONE","docs/企微优先开发路线图.md|docs/开发交付与变更管理规约.md|docs/产品口径.md","[""WDRG-3""]","none"
"WDRG-5","交付规约更新","在开发交付规约中补充路线图门禁 + 单功能 Issue CSV 的工程流程，替换散点推进口径，并说明非阻断反馈不得打断当前阶段。","1) 开发交付规约包含路线图门禁流程；2) 明确每个正式功能仍需单独 Issue CSV；3) 明确阶段未退出前不得跳阶段。","受影响流程：需求 -> 设计 -> 路线图 -> POC -> 单功能合同 -> 实现 -> QA -> 部署；验证步骤：rg -n '路线图门禁|单功能 Issue CSV|禁止跳阶段|WECOM-DEVELOPMENT-ROADMAP-GATE' docs/开发交付与变更管理规约.md。","rg","DONE","DONE","DONE","docs/开发交付与变更管理规约.md","[""WDRG-4""]","none"
"WDRG-6","事实源回写","回写文档索引、事实源矩阵、产品口径、PRD、管理员手册、员工手册和人工试运行报告，明确路线图只管节奏，不代表运行时能力完成。","1) 文档索引和事实源矩阵登记路线图文档；2) 相关事实源包含 WDRG 当前状态；3) 手册不误导员工立即迁移入口；4) 人工试运行报告记录本轮无运行时变更。","受影响流程：后续 agent/人工读取事实源 -> 判断当前阶段 -> 拆分下一轮 POC；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；rg -n 'WDRG|企微优先开发路线图|不代表运行时|WECOM-CAPABILITY-POC-V1' docs。","node|rg","DONE","DONE","DONE","docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/产品口径.md|docs/海音达OA-MVP需求规格说明书.md|docs/管理员手册.md|docs/员工快速上手.md|docs/trialrun/人工试运行报告.md","[""WDRG-5""]","none"
"WDRG-7","项目 skill 回写","更新 hyb-oa-delivery skill，加入后续执行默认规则：先读路线图，再做 POC，再按单功能合同开发，禁止跳阶段。","1) skill 明确 WDRG 后默认读取路线图；2) skill 明确不得跳过 WECOM-CAPABILITY-POC-V1；3) skill 校验通过。","受影响流程：后续 agent 交付入口 -> 读取路线图 -> 拆分 POC/功能合同；验证步骤：python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；rg -n '企微优先开发路线图|禁止跳阶段|WECOM-CAPABILITY-POC-V1' .agents/skills/hyb-oa-delivery/SKILL.md。","python3|rg","DONE","DONE","DONE",".agents/skills/hyb-oa-delivery/SKILL.md","[""WDRG-6""]","none"
"WDRG-8","下一轮 POC 合同准备","为 WECOM-CAPABILITY-POC-V1 固定最小验收口径：覆盖人事助手、通讯录、打卡、审批、假期余额、回调和权限配置，状态包括 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API。","1) 路线图和事实源写明下一轮 POC 的能力矩阵；2) POC 默认只读或低风险探测；3) 生产写操作必须单独批准；4) 本轮结论为 DONE_ROADMAP_READY 或 PAUSE_FOR_CLARIFICATION。","受影响流程：路线图门禁 -> WECOM-CAPABILITY-POC-V1；验证步骤：rg -n 'CAN_REUSE_NOW|NEEDS_CONFIG|NEEDS_API_POC|KEEP_OA_PRIMARY|NOT_SUPPORTED_BY_API|DONE_ROADMAP_READY|PAUSE_FOR_CLARIFICATION' docs issues .agents/skills/hyb-oa-delivery/SKILL.md；git diff --check。","rg|git","DONE","DONE","DONE","docs|issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv|.agents/skills/hyb-oa-delivery/SKILL.md","[""WDRG-7""]","none"
1 ID Title Description Acceptance Test_Method Tools Dev_Status Review1_Status Regression_Status Files Dependencies Notes
2 WDRG-0 合同建档 建立 WECOM-DEVELOPMENT-ROADMAP-GATE 合同，锁定本轮只做开发路线图、交付治理、事实源和 skill 同步，不改业务代码、不部署、不调用公网写接口。 1) CSV 校验通过；2) 本轮范围明确为路线图门禁；3) 不新增业务 API/schema/UI/feature flag；4) 不触碰生产配置或公网数据。 受影响流程：WFDG 设计门禁 -> 开发路线图门禁 -> WECOM-CAPABILITY-POC-V1；验证步骤：python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv。 python3|manual DONE DONE DONE issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv [] 回滚路径：回退本 CSV 和本轮文档/skill 口径；不涉及运行时、数据库或公网配置。
3 WDRG-1 当前基线复核 确认 DBWFOC 和 WFDG 已收口，当前下一步不是直接开发，而是先完成企微 API 能力 POC。 1) 文档索引和事实源矩阵显示 DBWFOC/WFDG 已收口；2) 下一步明确为 WECOM-CAPABILITY-POC-V1；3) 不把 HR/考勤镜像、应急接管、恢复回写或 RuleOps 写成已实现。 受影响流程：事实源读取 -> 阶段判断 -> 后续合同选择；验证步骤：rg -n 'DBWFOC|WFDG|WECOM-CAPABILITY-POC-V1|不代表运行时|下一步' docs issues。 rg DONE DONE DONE docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/人工试运行报告.md ["WDRG-0"] none
4 WDRG-2 路线图文档 新增 docs/企微优先开发路线图.md，作为后续开发节奏事实源，只写阶段、边界、准入/退出门禁、验收证据和禁止跳过项，不写过细接口实现。 1) 路线图文档存在并登记；2) 文档清楚说明当前阶段和后续阶段；3) 每阶段有目标、进入条件、退出条件、允许/禁止项和测试门禁；4) 不承诺运行时能力已完成。 受影响流程：路线图读取 -> 单功能合同拆分 -> 开发节奏控制；验证步骤：rg -n '企微优先开发路线图|路线图门禁|进入条件|退出条件|禁止跳阶段|单功能 Issue CSV' docs/企微优先开发路线图.md。 rg DONE DONE DONE docs/企微优先开发路线图.md ["WDRG-1"] 新增文档原因：用户明确要求开发计划文档，且现有规约不足以承载阶段路线图和节奏控制。
5 WDRG-3 阶段顺序固定 在路线图和事实源中固定后续顺序：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。 1) 阶段顺序在路线图、产品口径、PRD 和 skill 中一致；2) 明确 POC 是开发前置；3) 禁止跳过 POC 直接做运行时迁移。 受影响流程：POC -> HR 主数据镜像 -> 考勤/审批镜像 -> OA 应急接管 -> 恢复回写 -> RuleOps；验证步骤：rg -n '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' docs .agents/skills/hyb-oa-delivery/SKILL.md。 rg DONE DONE DONE docs/企微优先开发路线图.md|docs/产品口径.md|docs/海音达OA-MVP需求规格说明书.md|.agents/skills/hyb-oa-delivery/SKILL.md ["WDRG-2"] none
6 WDRG-4 并行与冻结规则 固定采购、合同、报销、付款、AP、代账和高敏附件继续 OA 主办；只有线上缺陷、真实反馈或上线阻断才另开合同，不混入企微 HR/考勤路线。 1) 路线图和交付规约写明并行/冻结规则；2) OA 主办域不进入企微原生审批或企微附件；3) 真实支付、ERP、图片 OCR、银行流水导入、复杂 BPM、审批设计器和重预算继续不进入当前路线。 受影响流程：企微 HR/考勤路线推进；OA 主办业务反馈处理；验证步骤：rg -n 'OA 主办|不混入企微 HR/考勤路线|真实反馈|上线阻断|ERP 未来不接入|不进入企微原生审批|高敏附件' docs。 rg DONE DONE DONE docs/企微优先开发路线图.md|docs/开发交付与变更管理规约.md|docs/产品口径.md ["WDRG-3"] none
7 WDRG-5 交付规约更新 在开发交付规约中补充路线图门禁 + 单功能 Issue CSV 的工程流程，替换散点推进口径，并说明非阻断反馈不得打断当前阶段。 1) 开发交付规约包含路线图门禁流程；2) 明确每个正式功能仍需单独 Issue CSV；3) 明确阶段未退出前不得跳阶段。 受影响流程：需求 -> 设计 -> 路线图 -> POC -> 单功能合同 -> 实现 -> QA -> 部署；验证步骤：rg -n '路线图门禁|单功能 Issue CSV|禁止跳阶段|WECOM-DEVELOPMENT-ROADMAP-GATE' docs/开发交付与变更管理规约.md。 rg DONE DONE DONE docs/开发交付与变更管理规约.md ["WDRG-4"] none
8 WDRG-6 事实源回写 回写文档索引、事实源矩阵、产品口径、PRD、管理员手册、员工手册和人工试运行报告，明确路线图只管节奏，不代表运行时能力完成。 1) 文档索引和事实源矩阵登记路线图文档；2) 相关事实源包含 WDRG 当前状态；3) 手册不误导员工立即迁移入口；4) 人工试运行报告记录本轮无运行时变更。 受影响流程：后续 agent/人工读取事实源 -> 判断当前阶段 -> 拆分下一轮 POC；验证步骤：node scripts/qa/audit-docs.mjs --check-registry；rg -n 'WDRG|企微优先开发路线图|不代表运行时|WECOM-CAPABILITY-POC-V1' docs。 node|rg DONE DONE DONE docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/产品口径.md|docs/海音达OA-MVP需求规格说明书.md|docs/管理员手册.md|docs/员工快速上手.md|docs/trialrun/人工试运行报告.md ["WDRG-5"] none
9 WDRG-7 项目 skill 回写 更新 hyb-oa-delivery skill，加入后续执行默认规则：先读路线图，再做 POC，再按单功能合同开发，禁止跳阶段。 1) skill 明确 WDRG 后默认读取路线图；2) skill 明确不得跳过 WECOM-CAPABILITY-POC-V1；3) skill 校验通过。 受影响流程：后续 agent 交付入口 -> 读取路线图 -> 拆分 POC/功能合同；验证步骤：python3 /home/shunli/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/hyb-oa-delivery；rg -n '企微优先开发路线图|禁止跳阶段|WECOM-CAPABILITY-POC-V1' .agents/skills/hyb-oa-delivery/SKILL.md。 python3|rg DONE DONE DONE .agents/skills/hyb-oa-delivery/SKILL.md ["WDRG-6"] none
10 WDRG-8 下一轮 POC 合同准备 为 WECOM-CAPABILITY-POC-V1 固定最小验收口径：覆盖人事助手、通讯录、打卡、审批、假期余额、回调和权限配置，状态包括 CAN_REUSE_NOW、NEEDS_CONFIG、NEEDS_API_POC、KEEP_OA_PRIMARY、NOT_SUPPORTED_BY_API。 1) 路线图和事实源写明下一轮 POC 的能力矩阵；2) POC 默认只读或低风险探测；3) 生产写操作必须单独批准；4) 本轮结论为 DONE_ROADMAP_READY 或 PAUSE_FOR_CLARIFICATION。 受影响流程：路线图门禁 -> WECOM-CAPABILITY-POC-V1；验证步骤：rg -n 'CAN_REUSE_NOW|NEEDS_CONFIG|NEEDS_API_POC|KEEP_OA_PRIMARY|NOT_SUPPORTED_BY_API|DONE_ROADMAP_READY|PAUSE_FOR_CLARIFICATION' docs issues .agents/skills/hyb-oa-delivery/SKILL.md；git diff --check。 rg|git DONE DONE DONE docs|issues/2026-05-18_12-44-10-wecom-development-roadmap-gate.csv|.agents/skills/hyb-oa-delivery/SKILL.md ["WDRG-7"] none