文件
hyb-oa/docs/文档事实源状态矩阵.md
T

21 KiB
原始文件 Blame 文件历史

文档事实源状态矩阵

文档状态:当前文档治理事实源。 分类:文档台账。 适用时间: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 正式启用前财务闭环与银行回单附件已收口;新增付款批次银行回单附件、复核后补凭证和银行渠道执行前回单阻断;已由 LAUNCH-DEPLOY-FINANCE 部署到公网
LAUNCH-DEPLOY-FINANCE issues/2026-05-17_09-38-55-launch-deploy-finance.csv EVIDENCE CASHV 部署与公网复检已收口;本地全流程/页面门禁、受控部署、migration 应用、公网 readiness、PDF live OCR、移动/企微矩阵和 CASHV 短窗口均通过;最终 payment_batch_v1=flag_force_off
FIN-PROD-ENABLE issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv EVIDENCE 公网付款批次正式常开已收口;测试报销 BX-20260517-0026 完成付款闭环、AP 导出、审计和移动/企微矩阵,最终 payment_batch_v1=force_on、erp_sync=force_off
ACCOUNTING-HANDOFF-V1 issues/2026-05-17_11-40-48-accounting-handoff-v1.csv EVIDENCE 月度代账交接 SOP 已收口;OA 侧导出和回单附件清单可用,银行流水和回单原件由出纳从银行侧导出,不导入 OA
SYSTEM-COMPLETE-GATE issues/2026-05-17_12-55-49-system-complete-gate.csv EVIDENCE 系统开发完成门禁已收口;公网 readiness、live smoke、PDF live OCR、flag 状态、移动/企微矩阵和事实源核对通过,结论 GO_TO_USE
LAUNCH-OPS-V1 issues/2026-05-17_12-55-50-launch-ops-v1.csv EVIDENCE 首周正式使用运营保障已收口;支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和冻结项口径已固定
REQ-COMPLETE-AUDIT issues/2026-05-17_13-32-26-requirements-completion-audit.csv EVIDENCE 需求完成度复核和考勤边界校正已收口;首批能力可交付不变,企业微信打卡作为原始采集和风控底座,OA 不重造定位/人脸/Wi-Fi/排班/防作弊;员工补卡/外出/加班审批和企微打卡 API 同步需后续合同
ATTV1 issues/2026-05-17_14-59-28-attendance-unified-wecom-sync-v1.csv EVIDENCE 考勤统一入口与企微打卡同步 V1 已收口:提交 916cc3b 和 b2b4447 已部署到公网;历史 OA 自建打卡关闭,补卡/外出/加班 OA 审批和月度解释可用;公网 readiness、PDF live OCR、移动/企业微信矩阵 14 passed,旧打卡 API 返回 409,企微打卡同步缺配置时记录 SKIP
LAUNCH-AUTO-OPS-V1 issues/2026-05-17_17-47-45-launch-auto-ops-v1.csv EVIDENCE 正式启用后自动化收口已阶段完成,结论 PAUSE_FOR_FIX:本地门禁、公网 readiness/PDF live OCR、考勤统一入口、移动矩阵和企业微信 UA/渲染矩阵通过;企微打卡同步显式检查为 SKIP wecom_checkin_sync_disabled;公网 payment_batch_v1=force_off 与正式常开口径不一致,付款批次写入已安全跳过
AUTO-REMAINING-CLOSEOUT issues/2026-05-17_19-30-44-auto-remaining-closeout.csv EVIDENCE 剩余无需人工操作事项已收口,结论 GO_TO_OPERATE:公网 payment_batch_v1 已恢复 force_on,erp_sync=force_off;正式自动巡检报告 artifacts/qa-flow/launch-auto-ops-20260517-193317/ 为 PASS,付款批次常开闭环、移动矩阵和企业微信渲染矩阵通过;企微打卡同步仍因外部配置 SKIP wecom_checkin_sync_disabled

旧 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,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 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,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 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 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁、LAUNCH-OPS-V1 首周运营保障、REQ-COMPLETE-AUDIT 需求完成度复核、ATTV1 考勤统一入口和 AUTO-REMAINING-CLOSEOUT 剩余自动化收口均已完成,当前 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、图片 OCR 和银行流水导入继续冻结。ATTV1 已部署:历史 OA 自建打卡 attendance_v1 关闭,OA 补卡/外出/加班审批和月度考勤解释已纳入统一考勤主线;企微打卡 live 同步能力依赖 WECOM_CHECKIN_SECRET 和企微 API 权限,缺配置时记录 SKIP。