# hyb-oa 文档索引

**文档状态**：当前唯一文档入口。
**适用时间**：DCL7 之后。
**治理口径**：中文优先，物理精简。已确认不用的历史文档不放 `docs/archive/`，直接从当前工作树移除；需要时从 git 历史恢复。

## 读取规则

- 判断当前需求、开发、验收：读最新 Issue CSV、当前 PRD、模块规约和本索引。
- 判断历史证据：读轻量历史索引，必要时用 `git show <commit>:<old-path>` 恢复旧文档。
- 判断冲突：最新 Issue CSV > 当前 PRD/模块规约 > 设计和产品规则 > 当前操作手册 > 技术参考 > 历史证据。
- 英文文件名只在技术生态或脚本强引用时保留，例如 `docs/mcp-tools.md`。

## 最近事实源链

R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7(TODO)。

- R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
- ME6 自动化和公网视觉矩阵已完成；`ME6-3` 代表性企业微信真机门禁仍待确认。
- QG6 已完成 QA 治理升级。
- MIA7 已完成移动信息架构、视觉和流程审查；MIF7 是下一批移动整改合同，尚未实施。
- R7/OPS7/DOC7 是准备材料，不代表已上线或已启动真实 R7。

## 当前事实源

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

## 当前操作手册

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

## 草案和准备材料

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

## 历史证据入口

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

## 技术参考

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

## 已从当前树移除

这些文档不再作为当前资料维护；需要时从 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. 页面体验：产品设计规则。
3. 报销/发票：报销发票附件规则 + 报销 OCR 规约。
4. 试运行/部署/真机：试运行手册 + 发布清单 + 真机清单。
5. 历史追溯：历史功能状态矩阵 + git 历史 + 相关 Issue CSV。