77 行
6.0 KiB
Markdown
77 行
6.0 KiB
Markdown
# hyb-oa 文档索引
|
||
|
||
**文档状态**：当前人工审查入口。
|
||
**适用时间**：2026-05-09 之后。
|
||
|
||
本索引用来区分“当前事实源”和“历史证据”。查需求、排期、开发范围时，先读当前事实源；排查历史实现、回归证据或旧决策时，再读历史快照和证据文档。
|
||
|
||
## 当前事实源
|
||
|
||
| 文档 | 用途 | 注意 |
|
||
| --- | --- | --- |
|
||
| [海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md) | 当前 PRD 主事实源，回答做什么、先做什么、不做什么、如何验收 | 后续需求变更先改这里或对应规则文档，再拆 Issue CSV |
|
||
| [需求 - 统一审批中心规约](./需求-统一审批中心规约.md) | 统一审批中心模块级开发规约 | 审批相关开发拆 Issue CSV 前必须参考 |
|
||
| [需求 - 报销发票 OCR 规约](./需求-报销发票OCR规约.md) | 报销、发票、OCR、附件、付款和导出模块级开发规约 | 报销主链路开发拆 Issue CSV 前必须参考 |
|
||
| [产品口径文档](./product-decisions.md) | 已拍板的产品边界和业务规则 | 与 PRD 冲突时，以更新后的 PRD 和最新 Issue CSV 为准 |
|
||
| [报销、发票与附件规则](./reimbursement-invoice-rules.md) | 报销、发票、OCR、附件的细则 | 报销相关开发必须同时参考 |
|
||
| [产品设计规则基线](./product-design-rules.md) | PC、移动、企业微信 WebView 的视觉和交互规则 | 页面调整必须参考 |
|
||
| [AGENTS 项目规则](../AGENTS.md) | Agent 协作、Issue CSV、测试和提交规则 | 执行开发前必须遵守 |
|
||
|
||
## 当前操作手册
|
||
|
||
| 文档 | 用途 | 注意 |
|
||
| --- | --- | --- |
|
||
| [管理员手册](./admin-handbook.md) | 管理员上线、企业微信入口、权限、试点配置 | 适合小团队试运行 |
|
||
| [员工快速上手](./employee-quickstart.md) | 员工侧日常使用说明 | 面向普通员工 |
|
||
| [试运行与自动化验证 Runbook](./trialrun-runbook.md) | 本地、公网、企业微信试运行操作 | 涉及公网或企业微信真机时必须看 |
|
||
| [公网 live smoke 与真实 OCR 准备清单](./trialrun/live-smoke-readiness.md) | 公网、真实 OCR、企业微信入口复核准备 | 只有部署后才能给出真机验收结论 |
|
||
| [真机公网测试清单](./trialrun/real-device-public-checklist.md) | 手机、企业微信、拍照/PDF 上传人工验证 | 用于上线前人工验收 |
|
||
|
||
## 实现状态与证据
|
||
|
||
| 文档 | 用途 | 注意 |
|
||
| --- | --- | --- |
|
||
| [实现状态矩阵](./feature-matrix.md) | 历史实现状态、完成证据、回归覆盖追踪 | 不是 PRD，不作为新增需求来源 |
|
||
| [试运行覆盖矩阵](./trialrun/coverage-matrix.csv) | 试运行覆盖范围和缺口 | 读取时结合最新 Issue CSV |
|
||
| [项目级流程矩阵](./trialrun/project-wide-flow-matrix.csv) | 核心业务流、入口、测试覆盖映射 | 用于 QA 和回归规划 |
|
||
| [人工业务试运行报告](./trialrun/manual-trialrun-report.md) | R70 当时的人工试运行证据 | 是历史快照，不代表当前公网状态 |
|
||
| [历史 TODO 清账映射](./todo-reconciliation.md) | 旧 TODO 的 implemented / superseded / still-open 追溯 | 不用来生成新需求 |
|
||
|
||
## 架构、集成与运维参考
|
||
|
||
| 文档 | 用途 | 注意 |
|
||
| --- | --- | --- |
|
||
| [系统架构概览](./architecture.md) | 当前架构、部署视图和运行时边界 | 与部署现状有关时需结合最新部署报告 |
|
||
| [集成边界冻结](./integration-boundaries.md) | ERP、IM、AI、MCP、PWA 等集成边界 | 当前首批路线不接入飞书/钉钉 |
|
||
| [领域事件清单](./domain-events.md) | 领域事件名和对外事件边界 | 面向集成和异步处理 |
|
||
| [MCP Tools](./mcp-tools.md) | MCP 工具启用边界 | 未启用的 MCP 不得假设可用 |
|
||
| [非功能基线](./ops/non-functional-baseline.md) | 安全、性能、回滚、上线最低要求 | 上线和发布前参考 |
|
||
| [测试策略](./ops/testing-strategy.md) | 自动化测试和门禁策略 | QA 规划参考 |
|
||
|
||
## 历史快照与归档参考
|
||
|
||
| 文档 | 用途 | 注意 |
|
||
| --- | --- | --- |
|
||
| [实施计划](./implementation_plan.md) | 2026-02 Phase 1 引导计划和历史实施思路 | 不是当前执行计划 |
|
||
| [技术栈与复用报告](./tech_stack_report.md) | 早期技术选型定案和复用说明 | 技术栈仍有参考价值，范围说明已过时 |
|
||
| [invoicePool 路由拆分方案](./invoice-pool-refactor-plan.md) | 一次性拆分方案归档 | 完成后只作追溯 |
|
||
| [试点迁移映射清单](./migration-mapping.md) | 旧系统迁移和切换边界 | 仅在迁移/切换专项中使用 |
|
||
| [国内 OA 与费控系统最佳实践对照](./trialrun/domestic-oa-best-practices.md) | 外部最佳实践调研快照 | 不替代当前 PRD |
|
||
| [ADR: 移动端路线决策](./adr/adr-mobile-strategy.md) | PWA、RN、小程序路线决策记录 | 保留 ADR 历史结论 |
|
||
| [ADR: 企业卡/虚拟卡管控能力预研](./adr/adr-enterprise-card-control.md) | 企业卡能力预研记录 | 不进入当前 MVP 首批范围 |
|
||
|
||
## 阅读顺序
|
||
|
||
1. 要看“现在到底做什么”：读 [海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md)。
|
||
2. 要细化审批或报销开发任务：读对应模块规约，再拆 `issues/*.csv`。
|
||
3. 要看“某个业务规则为什么这么定”：读 [产品口径文档](./product-decisions.md) 和对应规则文档。
|
||
4. 要开新开发任务：先更新需求或规则文档，再新建 `issues/*.csv`。
|
||
5. 要判断功能是否已经做过：读 [实现状态矩阵](./feature-matrix.md) 和最新相关 Issue CSV。
|
||
6. 要上线或真机验收：读 [试运行与自动化验证 Runbook](./trialrun-runbook.md)、live smoke 清单和最新部署结果。
|
||
|
||
## 明确废弃或不进入首批
|
||
|
||
- 飞书路线已废弃，不接入登录、通知、审批、文档或项目管理。
|
||
- 企业微信原生审批不作为正式审批流；企业微信只做入口、免登/绑定、通讯录身份、消息通知和打卡原始采集。
|
||
- 钉钉、小程序、复杂 BPM、重型项目管理、CRM、完整 ERP 不进入当前 MVP 首批范围。
|