22 KiB
22 KiB
hyb-oa 文档索引
文档状态：当前唯一文档入口。
分类：入口索引。
适用时间：DCL7 之后。
关联 Issue：GOV8。
最近审计：2026-05-17。
不得误读：本文只指示当前事实源和读取顺序；历史 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；只有现有文档无法承载、需要独立审计证据或用户明确要求时，才新建文档并登记本索引和事实源矩阵。
最近事实源链
R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> MIF7/MIF7T(公网部署与带凭据公网复检已收口) -> DG8 -> DG9 -> R7E -> FBA -> QAOPS9/P2D -> P2-ORG -> P2-FIN-DECISION -> P2-FIN-V1 -> P2-OCR-SAMPLE -> P2Q -> P2AUTO -> P2AF -> P2-FIN-LIVE-DECISION -> P2-FIN-LIVE -> PRELAUNCH。
- 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 业务验收。
- R7E 阶段验收、P2 排序和 QAOPS8 上线硬化阶段收口已完成，当前 P0/P1 阻断为 0；后续 P2 功能开发必须另建或延续对应连续合同。
- FBA 是 R7E 后全端功能边界审计，只提供证据和 Issue 草案，不启动 P2 功能开发。
- QAOPS9 是 R7E 后上线硬化连续合同，优先处理公网业务流测试数据、live smoke 账号链路、恢复演练 dry-run 和 SLO/Go-No-Go 自动化增强；隔离本地业务流可使用临时库和测试开关，公网证据必须保持 flag-off 或 SKIP 可解释；不部署、不执行生产恢复、不重置数据库、不打印远端 env。
- P2D 是 P2 功能决策合同，只决定组织主数据、付款批次、图片 OCR、UX8、审批通知和轻业务增强是否进入独立开发合同；统一使用
GO_TO_CONTRACT、HOLD_FOR_PREREQ、FREEZE三类结论，不新增 API/schema、feature flag 或前端功能。 - P2-ORG 是 P2D 后第一个执行合同，已完成组织账号主数据只读巡检；当前连接数据源下高/中风险为 0，低风险观察项为 CEO/root 无直属主管 1 和 active 员工无企业微信绑定 8；本轮不需要写修复合同。
- P2-FIN-DECISION 已完成付款批次启用决策准备，结论为
GO_TO_IMPLEMENT：可进入单独P2-FIN-V1实现合同；当前仍不启用payment_batch_v1、不写付款批次业务数据、不部署。 - P2-FIN-V1 已完成付款批次启用前本地/隔离硬化：后端 focused 回归、前端 typecheck/build、隔离付款批次闭环、权限直连审计和公网 readiness 均通过；本轮只硬化 E2E 断言，不新增 API/schema/feature flag/UI，不部署，公网
payment_batch_v1继续关闭。 - P2-OCR-SAMPLE 已完成图片 OCR 样票治理和实现前置确认；P2AF 纠偏后当前口径为图片发票 OCR
FREEZE_BY_DEFAULT，正式能力只维护 PDF-only OCR，图片仍按普通附件处理。 - P2Q 是 P2OCRS 后续任务队列合同：只锁定
UX8、P2-FIN-LIVE、审批通知、轻业务增强和持续上线门禁等启动条件；图片 OCR 不进入默认主线，只有用户明确重启评估才另建 provider 回归或实现合同。 - P2AUTO 是 P2Q 后自动化优先回归合同：后端 focused、前端构建、高风险确认、隔离核心业务流、隔离付款批次闭环、公网 readiness/PDF live OCR、公网移动矩阵和企业微信 UA/渲染自动化均已完成；PDF 样票和 live smoke 凭据可用，图片 OCR 默认冻结。
- P2AF 是 P2AUTO 后可自动实施收口合同：纠正图片 OCR 默认冻结口径，补 QA-only provider 决策语义、安全回归聚合、付款批次公网关闭态只读门禁和 UX8 自动矩阵扫尾；不部署、不启用公网付款批次、不开放图片 OCR。
- P2-FIN-LIVE-DECISION 是 P2AF 后付款批次公网启用窗口决策合同：公网 readiness 和 flag-off 只读门禁通过，初始结论为
HOLD_FOR_WINDOW；随后用户批准立即短窗口、现有 live smoke 测试账号和新建测试报销，已进入并完成P2-FIN-LIVE。 - P2-FIN-LIVE 已按用户批准完成公网付款批次短窗口受控测试：使用 live smoke 测试账号新建专用测试报销，临时打开
payment_batch_v1，完成创建/复核/执行、AP 导出和审计核验后强制回到flag_force_off；不部署、不接真实支付、不写 ERP 实时凭证，不开放图片 OCR。 - PRELAUNCH 是未正式使用前的正式启用准备合同：公网作为准生产预启用环境承载带
PRELAUNCHmarker 的测试数据和自动化回归；公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信自动化和 Go/No-Go 摘要已完成。最终payment_batch_v1=flag_force_off，未部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR；采购公网手工 live spec 长等待/退出码问题作为 QA 自动化稳定性维护项。
当前活跃治理流
后续不再为每次聊天、小反馈或单点修正单独创建 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 排序与 R7E 收口完成 | 人工确认、真实试运行、每日问题收口、验收结论 | 不新增 P2 能力；付款批次延期到 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 |
已收口：deeplink 修复已部署并经代表设备真机点击回 OA 验证 | 转审、通知、催办、邮件通道决策、三渠道验收 | 不做复杂 BPM 或审批设计器；通知模板和偏好设置延期到 P2 |
BIZ8 |
issues/2026-05-13_18-23-53-biz8-finance-ocr-project.csv |
已收口：财务移动入口真机通过，财务/项目权限回归完成 | OCR、票据、财务、费用提示、项目关联 | 不做 ERP 实时集成或重预算；付款批次延期到 P2 |
QAOPS8 |
issues/2026-05-13_17-30-00-qaops8-test-release-ops.csv |
已收口：Go/No-Go 与上线硬化阶段分流完成 | 回归稳定、测试覆盖、上线门禁、备份恢复、SLO | 不改业务需求；后续硬化另起 QAOPS9 或等价连续合同 |
FBA |
issues/2026-05-15_23-45-41-r7e-post-function-boundary-audit.csv |
已收口：R7E 后全端功能边界审计和后续 Issue 草案 | PC、移动/企业微信、后端 API/作业、管理/运维边界审计 | 不改业务代码、不改 API/schema、不部署、不启动 P2 |
QAOPS9 |
issues/2026-05-16_00-19-20-qaops9-release-hardening.csv |
已收口：上线硬化证据完成 | 公网业务流测试数据稳定化、live smoke 账号链路、恢复演练 dry-run、SLO/Go-No-Go 自动化增强；隔离业务流与公网 flag-off 证据分离 | 不改业务需求、不部署、不执行生产恢复、不重置数据库、不打印远端 env |
P2D |
issues/2026-05-16_00-19-21-p2-decision-followup.csv |
已收口：P2 决策分流完成 | P2-ORG 只读巡检进入独立合同；付款批次、图片 OCR、UX8、审批通知、轻业务增强均 HOLD_FOR_PREREQ；冻结 ERP/AI/完整差旅/复杂 BPM/审批设计器/重预算/企业微信原生审批 |
不新增 API/schema/feature flag/UI；不启用付款批次或图片 OCR |
P2-ORG |
issues/2026-05-16_02-04-27-p2-org-readonly-master-data-audit.csv |
已收口：组织主数据只读巡检完成 | 主管链、停用审批人、角色持有人、admin-only、财务/admin 混授、企业微信绑定漂移的脱敏只读审计 | 不写生产账号数据、不执行 P2-ORG-FIX、不改 API/schema/UI、不部署 |
P2-FIN-DECISION |
issues/2026-05-16_09-02-42-p2-fin-payment-batch-decision.csv |
已收口：付款批次决策准备完成，结论 GO_TO_IMPLEMENT |
付款批次代码/flag/空态、角色账号矩阵、导出字段、审计事件、公网验收窗口和 flag off 回滚口径 | 不启用 payment_batch_v1、不写付款批次、不接真实支付、不写 ERP 实时凭证、不部署 |
P2-FIN-V1 |
issues/2026-05-16_09-42-43-p2-fin-payment-batch-v1.csv |
已收口：付款批次启用前本地/隔离硬化完成 | 后端付款批次/AP/导出 focused 回归、前端构建、隔离闭环、权限审计、公网 readiness、flag off 回滚口径 | 不公网启用 payment_batch_v1、不部署、不接真实支付、不写 ERP 实时凭证 |
P2-OCR-SAMPLE |
issues/2026-05-16_10-15-21-p2-ocr-image-sample-governance.csv |
已收口：图片 OCR 样票治理前置完成；P2AF 后当前默认 FREEZE_BY_DEFAULT |
PDF-only 当前边界、SAMPLE-IMG-* 授权登记口径、脱敏证据规则、mock/PDF/真实图片 provider 分层、feature flag 和回滚设计 |
默认不支持图片发票 OCR；不新增入口或 feature flag、不调用真实图片 provider、不保存真实票据、不部署 |
P2Q |
issues/2026-05-16_10-35-22-p2-post-p2ocrs-followup-queue.csv |
已收口：P2OCRS 后续队列和启动门槛完成；图片 OCR 默认冻结 | UX8、付款批次公网启用、审批通知、轻业务增强和持续上线门禁的后续合同顺序；图片 OCR 仅在用户明确重启评估时另建合同 | 不直接启动 HOLD 项、不新建综合规划文档、不改业务代码、不部署 |
P2AUTO |
issues/2026-05-16_20-09-49-p2-automated-regression-sweep.csv |
已收口：自动化优先回归和样票 provider 门禁完成；P2AF 后 provider 默认结论为 FREEZE_BY_DEFAULT |
凭据/样票掩码核对、后端 focused、前端构建、高风险确认、隔离业务流、隔离付款批次、公网 readiness/PDF live OCR、移动/企业微信自动化、OCR provider-only 脚本 | 不部署、不开放图片 OCR、不打开公网 payment_batch_v1、不自动选择未登记图片样票 |
P2AF |
issues/2026-05-16_22-11-10-p2-automatable-followup.csv |
已收口：可自动实施收口完成 | 图片 OCR 默认冻结纠偏、QA 脚本语义、安全回归聚合、付款批次公网关闭态只读门禁、UX8 自动矩阵扫尾；报告 artifacts/qa-flow/p2-safe-regression-20260516-222222/ |
不部署、不开放图片 OCR、不启用公网 payment_batch_v1、不做业务实现 |
P2-FIN-LIVE-DECISION |
issues/2026-05-16_22-49-05-p2-fin-payment-batch-live-decision.csv |
已收口：公网启用窗口决策完成，初始结论 HOLD_FOR_WINDOW，后续用户批准并进入 P2-FIN-LIVE |
公网 readiness、付款批次 flag-off 只读门禁、窗口/参与人/回滚联系人/测试数据前置、后续 P2-FIN-LIVE 启动条件 | 不在决策合同中打开公网 payment_batch_v1、不写付款批次、不部署、不接真实支付、不写 ERP 实时凭证 |
P2-FIN-LIVE |
issues/2026-05-16_23-42-08-p2-fin-payment-batch-live-enable.csv |
已收口：公网短窗口付款批次受控测试通过，最终 payment_batch_v1=flag_force_off |
公网测试报销、PDF 样票绑定、审批到 approved、付款批次创建/复核/执行、AP 导出审计、权限边界、移动/企业微信自动化 | 不保持公网开启、不部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR |
PRELAUNCH |
issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv |
已收口：正式启用前公网预回归完成，最终 payment_batch_v1=flag_force_off |
公网环境基线、远端只读状态、PRELAUNCH 测试数据、核心业务自动化、付款批次公网窗口、移动/企业微信矩阵、启用范围和 Go/No-Go 摘要 | 不部署、不执行生产恢复、不重置数据库、不打印远端 env、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR |
旧 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 准备草案；真实执行看 R7E 连续合同 |
| OPS7 运维交接 Runbook | 不代表已执行生产配置变更、恢复演练或回滚 |
| R7 用户手册与 FAQ | 只描述已实现能力，不承诺预算、ERP、AI、完整差旅或复杂 BPM |
历史证据入口
| 文档 | 用途 |
|---|---|
| 历史功能状态矩阵 | 轻量历史功能索引；旧大表从 git 历史恢复 |
| 人工试运行报告 | R6 后当前状态和关键证据索引 |
| R7E 后功能边界审计 | R7E 后全端功能边界、P2 候选和后续 Issue 草案 |
| 试运行覆盖矩阵 | 轻量覆盖摘要 |
| 项目级流程覆盖矩阵 | 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。
- 页面体验：产品设计规则；DG8 后先按主 UI/布局参考层级判断。
- 报销/发票：报销发票附件规则 + 报销 OCR 规约。
- 试运行/部署/真机：试运行手册 + 发布清单 + 真机清单。
- 历史追溯：历史功能状态矩阵 + git 历史 + 相关 Issue CSV。