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。

当前活跃治理流

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

治理流	当前合同	当前状态	范围	不做
`GOV8`	`issues/2026-05-13_16-31-09-gov8-system-governance.csv`	已收口	文档分类、台账、流程模板、审计脚本、需求冻结、变更控制	不改业务代码、不部署
`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`	已建档：待方案批准	组织、账号、直属主管、停用、角色、企业微信绑定、权限边界	不做审批流程增强
`WF8`	`issues/2026-05-13_18-23-52-wf8-approval-notification.csv`	已建档：待 ORG8 角色边界和方案批准	转审、通知、催办、邮件通道决策、三渠道验收	不做复杂 BPM 或审批设计器
`BIZ8`	`issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv`	已建档：待 R7E/P2 排序和方案批准	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 设计事实源
产品口径	已拍板产品边界和业务规则
需求 - 统一审批中心规约	审批、催办、超时提醒、审批效率
报销发票附件规则	报销、发票、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 跳转入口

阅读顺序

新需求：PRD + 对应模块规约 + 最新 Issue CSV。
页面体验：产品设计规则。
报销/发票：报销发票附件规则 + 报销 OCR 规约。
试运行/部署/真机：试运行手册 + 发布清单 + 真机清单。
历史追溯：历史功能状态矩阵 + git 历史 + 相关 Issue CSV。

11 KiB 原始文件 Blame 文件历史 Unescape Escape