17 KiB
17 KiB
文档事实源状态矩阵
文档状态：当前文档治理事实源。
分类：文档台账。
适用时间：DCL7 之后。
关联 Issue：GOV8。
最近审计：2026-05-17。
不得误读：本文登记文档权威性和状态，不替代具体 PRD、模块规约、测试规约或 Issue CSV。
治理口径：中文优先，物理精简，优先复用已有文档。历史资料不建 docs/archive/，已确认不用的文档从当前树移除，通过 git 历史恢复。
冲突优先级
最新 Issue CSV > 当前 PRD/模块规约 > 产品和设计规则 > 当前操作手册 > 技术参考 > 历史证据 > git 历史。
台账状态值
| Status | 含义 | 是否可直接指导开发 |
|---|---|---|
CURRENT |
当前事实源或当前执行合同 | 可以 |
DRAFT |
草案或准备材料，未完成启动确认 | 不可以 |
EVIDENCE |
试运行、测试、审计或验收证据 | 不可以 |
HISTORICAL |
历史快照或旧合同 | 不可以 |
SUPERSEDED |
已被新文档或新合同替代 | 不可以 |
REMOVED |
已从当前树物理移除，只能从 git 历史恢复 | 不可以 |
当前活跃治理流
| Stream | Contract | Status | 用途 |
|---|---|---|---|
GOV8 |
issues/2026-05-13_16-31-09-gov8-system-governance.csv |
EVIDENCE |
连续型 Issue 治理、文档台账、流程模板和审计脚本，已收口 |
DG8 |
issues/2026-05-13_22-56-49-design-ui-governance.csv |
EVIDENCE |
设计治理主参考系统收口；飞书工作台/飞书审批为唯一主 UI/布局参考，不代表页面已整改 |
DG9 |
issues/2026-05-13_23-30-00-dg9-ui-layout-rollout.csv |
EVIDENCE |
全站 UI/布局样板迁移已收口；最新代码已作为 R7E 基线部署到公网，不替代 WF8/UX8/BIZ8 |
R7E |
issues/2026-05-13_17-11-44-r7e-human-trialrun.csv |
EVIDENCE |
真实扩大试运行阶段验收、P2 排序和 R7E 收口已完成，P0/P1 阻断为 0 |
ORG8 |
issues/2026-05-13_18-23-51-org8-master-data-permission.csv |
EVIDENCE |
组织账号和权限主数据治理已阶段收口；本地代表性角色验收通过，不替代 R7E 真实人工试运行 |
WF8 |
issues/2026-05-13_18-23-52-wf8-approval-notification.csv |
EVIDENCE |
审批与通知增强已阶段收口；deeplink 过期修复已部署并经代表设备真机点击回 OA 验证 |
BIZ8 |
issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv |
EVIDENCE |
报销/OCR/财务/项目轻量增强已阶段收口；财务移动入口真机通过，财务/项目权限回归完成，付款批次延期到 P2 |
QAOPS8 |
issues/2026-05-13_17-30-00-qaops8-test-release-ops.csv |
EVIDENCE |
Go/No-Go 与上线硬化阶段收口已完成；后续硬化另起 QAOPS9 或等价连续合同 |
FBA |
issues/2026-05-15_23-45-41-r7e-post-function-boundary-audit.csv |
EVIDENCE |
R7E 后全端功能边界审计和后续 Issue 草案；不启动 P2 功能开发 |
QAOPS9 |
issues/2026-05-16_00-19-20-qaops9-release-hardening.csv |
EVIDENCE |
R7E 后上线硬化连续合同已收口；核心业务流、live smoke、真实 OCR、移动矩阵和恢复演练 dry-run 均有证据，未部署新 commit |
P2D |
issues/2026-05-16_00-19-21-p2-decision-followup.csv |
EVIDENCE |
P2 功能决策分流已完成：P2-ORG 只读巡检可进独立合同，其余 P2 候选保持 HOLD_FOR_PREREQ，冻结项继续冻结 |
P2-ORG |
issues/2026-05-16_02-04-27-p2-org-readonly-master-data-audit.csv |
EVIDENCE |
组织账号主数据只读巡检已完成；当前连接数据源高/中风险为 0，仅有低风险观察项，不需要写修复合同 |
P2-FIN-DECISION |
issues/2026-05-16_09-02-42-p2-fin-payment-batch-decision.csv |
EVIDENCE |
付款批次启用决策准备已完成，结论 GO_TO_IMPLEMENT；后续必须另建 P2-FIN-V1 实现合同，当前不启用 payment_batch_v1 |
P2-FIN-V1 |
issues/2026-05-16_09-42-43-p2-fin-payment-batch-v1.csv |
EVIDENCE |
付款批次启用前本地/隔离硬化已完成；后端 focused 回归、前端构建、隔离闭环、权限审计和公网 readiness 通过，公网仍不启用 payment_batch_v1 |
P2-OCR-SAMPLE |
issues/2026-05-16_10-15-21-p2-ocr-image-sample-governance.csv |
EVIDENCE |
图片 OCR 样票治理和实现前置确认已完成；P2AF 纠偏后当前默认 FREEZE_BY_DEFAULT，保持 PDF-only，不开放图片 OCR |
P2Q |
issues/2026-05-16_10-35-22-p2-post-p2ocrs-followup-queue.csv |
EVIDENCE |
P2OCRS 后续任务队列已锁定；图片 OCR 默认冻结，后续实现均需另建独立合同，当前不部署、不改业务代码 |
P2AUTO |
issues/2026-05-16_20-09-49-p2-automated-regression-sweep.csv |
EVIDENCE |
自动化优先回归已收口；后端/前端/隔离业务流/公网 readiness/PDF live OCR/移动与企业微信自动化均有证据，provider-only 默认决策为 FREEZE_BY_DEFAULT |
P2AF |
issues/2026-05-16_22-11-10-p2-automatable-followup.csv |
EVIDENCE |
可自动实施收口已完成；纠正图片 OCR 默认冻结口径，补 QA-only 安全回归、付款批次公网关闭态只读门禁和 UX8 自动矩阵扫尾；报告 artifacts/qa-flow/p2-safe-regression-20260516-222222/ |
P2-FIN-LIVE-DECISION |
issues/2026-05-16_22-49-05-p2-fin-payment-batch-live-decision.csv |
EVIDENCE |
公网付款批次启用窗口决策已收口；readiness 和 flag-off 只读门禁通过，初始结论 HOLD_FOR_WINDOW，随后用户批准进入 P2-FIN-LIVE |
P2-FIN-LIVE |
issues/2026-05-16_23-42-08-p2-fin-payment-batch-live-enable.csv |
EVIDENCE |
公网付款批次短窗口受控测试已收口；测试报销、付款批次、AP 导出和审计核验通过，最终 payment_batch_v1=flag_force_off，未部署 |
PRELAUNCH |
issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv |
EVIDENCE |
正式启用前公网预回归已收口；公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信矩阵和 Go/No-Go 摘要完成；最终 payment_batch_v1=flag_force_off，未部署 |
CASHIER-VOUCHER-V1 |
issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv |
EVIDENCE |
正式启用前财务闭环与银行回单附件已收口；新增付款批次银行回单附件、复核后补凭证和银行渠道执行前回单阻断；未部署，公网 payment_batch_v1 状态未改变 |
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 docs/archive/ 或其他归档目录。新连续合同如替代旧合同，只在新合同 Notes 或文档索引中说明 supersedes。
文档台账
| 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 |
rg |
none | 2026-05-17 | 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 |
audit-docs |
none | 2026-05-17 | audit-docs --check-registry |
medium | 判断文档权威性 |
PRD-MVP |
docs/海音达OA-MVP需求规格说明书.md |
需求事实源 | PRD 主事实源 | CURRENT |
product | REQ8,P2T,GOV8 |
Issue CSV | docs/requirements-specification.md |
2026-05-13 | rg |
high | 定义做什么、不做什么和验收口径 |
PRODUCT-SCOPE |
docs/产品口径.md |
需求事实源 | 产品边界事实源 | CURRENT |
product | REQ8,P2T |
rg |
none | 2026-05-13 | rg |
high | 记录已拍板产品边界 |
DESIGN-UI |
docs/产品设计规则.md |
设计事实源 | PC/移动/企业微信设计事实源 | CURRENT |
design/frontend | MIA7,MIF7,GOV8,DG8,DG9 |
Playwright/视觉审查/DG8/DG9 | none | 2026-05-13 | rg |
high | 页面改动必须读取；DG8 后飞书为主 UI/布局参考；DG9 后按页面分层和样板选型 |
DELIVERY |
docs/开发交付与变更管理规约.md |
开发治理 | 开发交付事实源 | CURRENT |
dev/qa | GOV8 |
rg |
none | 2026-05-13 | rg |
high | Issue、review、commit 和交付规则 |
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 |
quick_validate | none | 2026-05-13 | quick_validate.py |
medium | 每轮交付操作入口，UI 任务读取设计主参考层级 |
REQ-WF |
docs/需求-统一审批中心规约.md |
需求事实源 | 审批模块规约 | CURRENT |
product/backend | AP6,WF8 |
workflow 回归 | none | 2026-05-13 | rg |
high | 审批、催办、通知和状态流 |
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 |
live smoke/真机反馈 | none | 2026-05-13 | rg |
high | 企业微信只做入口、身份和通知 |
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 |
人工验收 | none | 2026-05-13 | rg |
medium | 管理员上线和配置 |
MANUAL-EMPLOYEE |
docs/员工快速上手.md |
操作手册 | 员工手册 | CURRENT |
product | R7E |
人工验收 | none | 2026-05-13 | rg |
low | 员工侧使用说明 |
R7-DRAFT |
docs/trialrun/R7扩大试运行草案.md |
草案 | R7 准备材料 | DRAFT |
product/qa | R7E |
R7EP 报告 | none | 2026-05-13 | rg |
medium | 不代表当前 R7E 执行状态 |
OPS-RUNBOOK |
docs/trialrun/OPS7运维交接Runbook.md |
运维草案 | OPS 准备材料 | DRAFT |
ops | OPS8,QAOPS8 |
只读检查 | none | 2026-05-13 | rg |
medium | 不代表恢复演练已执行 |
TRIAL-REPORT |
docs/trialrun/人工试运行报告.md |
证据材料 | 试运行证据入口 | EVIDENCE |
qa | R7EP,OPS8,QAF8 |
artifacts/qa-flow | none | 2026-05-13 | rg |
medium | 只证明发生过，不直接派工 |
FBA-AUDIT |
docs/trialrun/R7E后功能边界审计.md |
证据材料 | R7E 后功能边界审计 | EVIDENCE |
product/dev/qa | FBA,R7E,QAOPS8,P2T |
Issue CSV | none | 2026-05-15 | rg |
medium | 只作为功能边界、P2 候选和 Issue 草案证据，不直接派工 |
HISTORY-MATRIX |
docs/历史功能状态矩阵.md |
历史材料 | 历史功能索引 | HISTORICAL |
product | DCL7 |
git 历史 | none | 2026-05-13 | rg |
low | 只追溯历史 |
OLD-IMPL-PLAN |
docs/implementation_plan.md |
已移除历史 | 早期实施计划 | REMOVED |
product | DCL7 |
git history | none | 2026-05-13 | manual | low | 从 git 历史恢复 |
当前事实源
| 路径 | 分类 | 当前用途 |
|---|---|---|
docs/文档索引.md |
当前事实源 | 唯一文档入口 |
docs/文档事实源状态矩阵.md |
当前事实源 | 文档分类和恢复规则 |
docs/海音达OA-MVP需求规格说明书.md |
当前事实源 | PRD 主事实源 |
docs/产品设计规则.md |
当前事实源 | PC、移动、企业微信设计规则；DG8 主 UI/布局参考层级 |
docs/产品口径.md |
当前事实源 | 产品边界和业务规则 |
docs/需求-统一审批中心规约.md |
当前事实源 | 审批、催办、超时、效率摘要 |
docs/报销发票附件规则.md |
当前事实源 | 报销、发票、附件细则 |
docs/需求-报销发票OCR规约.md |
当前事实源 | OCR 和报销模块规约 |
docs/需求-企业微信基础设施规约.md |
当前事实源 | 企业微信入口、身份、消息、deeplink |
docs/需求-请假考勤修正规约.md |
当前事实源 | 请假和考勤修正 |
docs/需求-采购费用审批规约.md |
当前事实源 | 采购和费用审批 |
docs/需求-合同附件归档规约.md |
当前事实源 | 合同台账和附件归档 |
docs/需求-项目轻管理规约.md |
当前事实源 | 项目轻管理 |
docs/测试规约与回归门禁.md |
当前事实源 | 测试和回归门禁 |
docs/开发交付与变更管理规约.md |
当前事实源 | Issue CSV、review、提交和交付 |
docs/Agent开发交付实践.md |
当前事实源 | Agent 协作开发实践 |
AGENTS.md |
当前事实源 | 项目硬约束 |
.agents/skills/hyb-oa-delivery/SKILL.md |
当前事实源 | 项目交付 Skill |
当前操作手册
| 路径 | 当前用途 |
|---|---|
docs/管理员手册.md |
管理员上线、权限、试运行配置 |
docs/员工快速上手.md |
员工使用说明 |
docs/试运行与自动化验证手册.md |
本地、公网、企业微信和真实 OCR 验证 |
docs/trialrun/发布试运行准备清单.md |
发布和试运行门禁 |
docs/trialrun/公网LiveSmoke准备清单.md |
公网 live smoke 和真实 OCR readiness |
docs/trialrun/真机公网测试清单.md |
真实手机和企业微信人工验收 |
草案和证据
| 路径 | 分类 | 当前口径 |
|---|---|---|
docs/trialrun/R7扩大试运行草案.md |
草案 | 当前执行状态以 R7E CSV 为准 |
docs/trialrun/OPS7运维交接Runbook.md |
草案 | 不代表已执行生产配置或恢复演练 |
docs/trialrun/R7用户手册与FAQ.md |
草案 | 不承诺未实现能力 |
docs/历史功能状态矩阵.md |
历史证据 | 轻量索引，旧大表从 git 历史恢复 |
docs/trialrun/人工试运行报告.md |
历史证据 | R6 后状态摘要和关键证据索引 |
docs/trialrun/R7E后功能边界审计.md |
当前证据 | R7E 后全端功能边界、P2 候选和 Issue 草案 |
docs/trialrun/试运行覆盖矩阵.csv |
历史证据 | 轻量覆盖摘要 |
docs/trialrun/项目级流程覆盖矩阵.csv |
QA 参考 | check-flow-coverage 使用 |
docs/trialrun/权限直连审计记录.md |
当前证据 | 权限直连审计 |
docs/trialrun/移动信息架构视觉流程审查.md |
当前证据 | MIA7 审查结论；MIF7/MIF7T 收口以最新 Issue CSV 和人工试运行报告为准 |
技术参考
| 路径 | 说明 |
|---|---|
docs/架构概览.md |
架构和运行时边界 |
docs/集成边界.md |
集成边界，不扩大 MVP 范围 |
docs/领域事件清单.md |
领域事件 |
docs/mcp-tools.md |
脚本和 AGENTS 强引用，保留英文文件名 |
docs/ops/*.md |
非功能、SLO、测试、CI、DORA、追踪 |
docs/adr/*.md |
ADR 历史决策 |
已从当前树移除
这些文件已物理删除，不再维护当前副本；需要时通过 git 历史恢复。
| 旧路径 | 原用途 |
|---|---|
docs/implementation_plan.md |
早期实施计划 |
docs/tech_stack_report.md |
早期技术栈报告 |
docs/invoice-pool-refactor-plan.md |
invoicePool 一次性方案 |
docs/migration-mapping.md |
旧迁移映射 |
docs/MVP主线代码差距盘点.md |
旧 MVP 代码差距盘点 |
docs/todo-reconciliation.md |
旧 TODO 清账 |
docs/mobile/pwa-regression-checklist.md |
旧 PWA 回归清单 |
docs/trialrun/domestic-oa-best-practices.md |
旧国内 OA 调研快照 |
docs/trialrun/async-ux-audit.csv |
旧异步体验审计 |
docs/trialrun/deployment-preflight-2026-05-10.md |
旧部署预检记录 |
docs/requirements-specification.md |
旧 PRD 跳转入口 |
当前门禁
ME6-3代表性企业微信真机门禁已关闭。- MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归和 CASHIER-VOUCHER-V1 财务闭环与银行回单附件均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；P2-FIN-LIVE 和 PRELAUNCH 均验证付款批次公网短窗口并回到
payment_batch_v1=flag_force_off；CASHIER-VOUCHER-V1 代码尚未部署，后续部署最新代码、正式常开付款批次和代账交接 SOP 必须另建或延续对应连续合同。