hyb-oa/docs/文档索引.md

hyb-oa 文档索引

文档状态：当前唯一文档入口。 分类：入口索引。 适用时间：DCL7 之后。 关联 Issue：GOV8。 最近审计：2026-05-13。 不得误读：本文只指示当前事实源和读取顺序；历史 Issue CSV 只能用于追溯，不直接生成新开发任务。 治理口径：中文优先，物理精简。已确认不用的历史文档不放 docs/archive/，直接从当前工作树移除；需要时从 git 历史恢复。

读取规则

• 判断当前需求、开发、验收：读最新 Issue CSV、当前 PRD、模块规约和本索引。
• 判断历史证据：读轻量历史索引，必要时用 git show <commit>:<old-path> 恢复旧文档。
• 判断冲突：最新 Issue CSV > 当前 PRD/模块规约 > 设计和产品规则 > 当前操作手册 > 技术参考 > 历史证据。
• 英文文件名只在技术生态或脚本强引用时保留，例如 docs/mcp-tools.md。
• 判断当前可执行任务：只读当前活跃治理流和对应连续型 Issue CSV；旧 Issue CSV 默认是历史审计证据。
• 新需求或试运行反馈：优先进入当前同类型连续治理流；只有跨业务域、跨风险等级或阶段收口后，才新建下一版 CSV。

最近事实源链

R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9。

• R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
• ME6 自动化、公网视觉矩阵和 ME6-3 代表性企业微信真机门禁已完成。
• QG6 已完成 QA 治理升级。
• MIA7 已完成移动信息架构、视觉和流程审查；MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
• DG8 已完成设计治理主参考系统收口：飞书工作台/飞书审批是唯一主 UI/布局参考；本结论只更新设计事实源，不代表已做页面整改。
• DG9 承接 DG8 后的页面整改：按 A/B/C 页面分层和 DG9 样板统一 PC、移动和企业微信入口布局；最新代码已作为 R7E 试运行基线部署到公网，不替代 WF8、UX8 或 BIZ8 业务验收。
• R7/OPS7/DOC7 是准备材料，不代表已上线或已启动真实 R7。

当前活跃治理流

后续不再为每次聊天、小反馈或单点修正单独创建 Issue CSV。同类型、同目标、同风险域的任务优先进入同一个连续型 Issue CSV，直到该治理流完成明确阶段。

治理流	当前合同	当前状态	范围	不做
GOV8	issues/2026-05-13_16-31-09-gov8-system-governance.csv	已收口	文档分类、台账、流程模板、审计脚本、需求冻结、变更控制	不改业务代码、不部署
DG8	issues/2026-05-13_22-56-49-design-ui-governance.csv	已收口：设计事实源主参考系统更新	主 UI/布局参考层级、外部参考降级、Agent/Skill 设计入口、设计检查门禁	不改业务页面、不部署、不接入飞书
DG9	issues/2026-05-13_23-30-00-dg9-ui-layout-rollout.csv	已收口；最新代码已随 R7E 部署到试运行环境	A/B/C 页面分层、共享工作台骨架、移动槽位、审批/报销/首页/通知样板、设计门禁	不替代 WF8、UX8 或 BIZ8 业务验收
R7E	issues/2026-05-13_17-11-44-r7e-human-trialrun.csv	当前执行：最新代码已部署，待真实流程和真机反馈	人工确认、真实试运行、每日问题收口、验收结论	不新增 P2 能力
ORG8	issues/2026-05-13_18-23-51-org8-master-data-permission.csv	已收口：本地代表性角色验收通过	组织、账号、直属主管、停用、角色、企业微信绑定、权限边界	不做审批流程增强；不替代 R7E 真实人工试运行
WF8	issues/2026-05-13_18-23-52-wf8-approval-notification.csv	当前执行：待移动审批历史方案批准	转审、通知、催办、邮件通道决策、三渠道验收	不做复杂 BPM 或审批设计器
BIZ8	issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv	当前执行：采购项目关联加性迁移已随最新部署应用，待移动入口和权限回归收口	OCR、票据、财务、费用提示、项目关联	不做 ERP 实时集成或重预算
QAOPS8	issues/2026-05-13_17-30-00-qaops8-test-release-ops.csv	当前执行：贯穿治理	回归稳定、测试覆盖、上线门禁、备份恢复、SLO	不改业务需求

旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 Notes 或本索引说明 supersedes，旧文件保留历史审计语义。

按开发阶段阅读

阶段	必读入口	目的
需求阶段	最新同类型连续 Issue CSV、海音达OA-MVP需求规格说明书、对应 需求-*.md、产品口径	判断做什么、不做什么、验收什么
设计阶段	最新设计治理合同、产品设计规则、架构概览、集成边界、docs/ops/*.md、必要 ADR	判断页面、权限、状态流、集成和非功能边界
开发阶段	当前连续 Issue CSV、开发交付与变更管理规约、AGENTS.md	判断文件范围、依赖、方案批准和交接物
测试阶段	测试规约与回归门禁、试运行与自动化验证手册、当前 Issue 的 Test_Method	判断怎么测、何时可回填 DONE
发布阶段	发布试运行准备清单、公网 Live Smoke 准备清单、OPS7 运维交接 Runbook	判断公网、企业微信、真实 OCR 和回滚条件
审计阶段	文档事实源状态矩阵、人工试运行报告、当前连续 Issue CSV、git 历史	判断当前事实、历史证据和冲突处理
历史追溯	历史功能状态矩阵、旧 Issue CSV、git 历史	只追溯，不直接派工

当前事实源

文档	用途
海音达OA-MVP需求规格说明书	PRD 主事实源
文档事实源状态矩阵	文档分类、删除恢复和冲突规则
产品设计规则	PC、移动、企业微信 WebView 设计事实源；DG8 后飞书工作台/飞书审批为唯一主 UI/布局参考；DG9 后按页面分层和样板选型
产品口径	已拍板产品边界和业务规则
需求 - 统一审批中心规约	审批、催办、超时提醒、审批效率
报销发票附件规则	报销、发票、OCR、附件细则
需求 - 报销发票 OCR 规约	报销发票 OCR 模块规约
需求 - 企业微信基础设施规约	企业微信入口、身份、消息、deeplink
需求 - 请假考勤修正规约	请假、补卡、考勤修正
需求 - 采购费用审批规约	采购、费用、附件、审批规则
需求 - 合同附件归档规约	合同台账和附件归档边界
需求 - 项目轻管理规约	项目轻管理边界
测试规约与回归门禁	自动化、视觉、真机、状态回填
开发交付与变更管理规约	Issue CSV、review、提交和交付
Agent开发交付实践	Agent 协作和交付实践
AGENTS 项目规则	执行硬约束

当前操作手册

文档	用途
管理员手册	管理员上线、权限、试运行配置
员工快速上手	员工侧使用说明
试运行与自动化验证手册	本地、公网、企业微信和真实 OCR 验证
发布试运行准备清单	发布候选、权限审计、部署预检和试运行门禁
公网 Live Smoke 准备清单	公网、真实 OCR、企业微信入口复核条件
真机公网测试清单	真实手机、企业微信、移动浏览器人工验收

草案和准备材料

文档	边界
R7 扩大试运行草案	只做 R7 准备；真实 R7 未启动
OPS7 运维交接 Runbook	不代表已执行生产配置变更、恢复演练或回滚
R7 用户手册与 FAQ	只描述已实现能力，不承诺预算、ERP、AI、完整差旅或复杂 BPM

历史证据入口

文档	用途
历史功能状态矩阵	轻量历史功能索引；旧大表从 git 历史恢复
人工试运行报告	R6 后当前状态和关键证据索引
试运行覆盖矩阵	轻量覆盖摘要
项目级流程覆盖矩阵	check-flow-coverage 使用的最小流程矩阵
权限直连审计记录	权限直连审计证据
移动信息架构视觉流程审查	MIA7 审查结论，整改收口以 MIF7/MIF7T 和最新 Issue CSV 为准

技术参考

文档	说明
架构概览	当前架构和运行时边界
集成边界	ERP、IM、AI、MCP、PWA 集成边界；不扩大当前 MVP 范围
领域事件清单	领域事件名和对外事件边界
MCP Tools	脚本和 AGENTS 强引用，保留英文文件名
非功能基线	安全、性能、回滚、上线最低要求
SLO 错误预算	SLO 和错误预算
测试策略	自动化测试和门禁策略
CI 回归报告归档	CI 回归报告归档
DORA 指标	CFR 等 DORA 指标
链路追踪策略	OpenTelemetry 追踪策略
ADR: 移动端路线决策	PWA、RN、小程序路线历史决策
ADR: 企业卡/虚拟卡管控预研	企业卡能力预研

已从当前树移除

这些文档不再作为当前资料维护；需要时从 git 历史恢复，例如 git show 5da05eb:<旧路径>。

旧路径	恢复说明
docs/implementation_plan.md	早期实施计划
docs/tech_stack_report.md	早期技术栈报告
docs/invoice-pool-refactor-plan.md	invoicePool 一次性拆分方案
docs/migration-mapping.md	旧迁移映射
docs/MVP主线代码差距盘点.md	A1 旧盘点
docs/todo-reconciliation.md	旧 TODO 清账
docs/mobile/pwa-regression-checklist.md	旧 PWA 回归清单
docs/trialrun/domestic-oa-best-practices.md	旧外部调研快照
docs/trialrun/async-ux-audit.csv	旧异步体验审计 CSV
docs/trialrun/deployment-preflight-2026-05-10.md	旧部署预检记录
docs/requirements-specification.md	旧 PRD 跳转入口

阅读顺序

1. 新需求：PRD + 对应模块规约 + 最新 Issue CSV。
2. 页面体验：产品设计规则；DG8 后先按主 UI/布局参考层级判断。
3. 报销/发票：报销发票附件规则 + 报销 OCR 规约。
4. 试运行/部署/真机：试运行手册 + 发布清单 + 真机清单。
5. 历史追溯：历史功能状态矩阵 + git 历史 + 相关 Issue CSV。