DOCG7 治理文档事实源口径

2026-05-12 22:24:35 +08:00
@@ -1,5 +1,7 @@
 # hyb-oa 管理员手册（10 人以下团队版）

+**当前状态（2026-05-12 / DOCG7）**：R6 已通过，PC6、PA6、FL6、AP6、RI6、LP6、ME6 自动化、QG6、DG7/MRF7 和 MIA7 已完成相应收口；`ME6-3` 代表性企业微信真机门禁仍待确认。R7 未真实启动，R7/OPS7/DOC7 只是准备材料，不代表已启动或已上线。下一批移动体验整改合同为 MIF7，尚未完成。
+
 ## 1. 适用范围
 - 适用于 `small_team_internal` 工作区模式。
 - 适用于单公司、少部门、全员账号密码登录的小团队。
@@ -94,6 +94,13 @@ AGENTS.md 只放硬约束和入口，不复制长规则。

 截至 R7P，RI6 报销票据体验、LP6 请假采购体验、ME6 自动化/部署收口、QG6 QA 治理以及 R7/OPS7/DOC7 草案材料均已完成；`ME6-3` 代表性企业微信真机抽查因设备不便继续待确认。后续默认进入等待门禁状态：不得关闭 `ME6-3`，不得把 QG6 或公网移动视觉矩阵当成真机替代，也不得从文档草案直接启动真实 R7。R7 真实执行必须保持 `R7E-*` 为 TODO，直到用户确认最终人员、角色、窗口、回滚联系人、问题登记负责人和每日收口节奏，并补足真机门禁或明确接受风险。

+文档治理采用 DOCG7 后的索引归档策略：
+
+- 先读 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md` 判断文档用途。
+- 不删除、不移动历史证据，不回写旧 Issue CSV；用索引和顶部状态说明标注历史口径。
+- 历史矩阵、旧 runbook 或旧 trialrun 记录若与最新 Issue CSV、当前 PRD 或模块规约冲突，以最新 Issue CSV 和当前模块规约为准。
+- R7/OPS7/DOC7 草案不代表真实 R7 已启动；MIF7 TODO 不代表移动整改已完成。
+
 ### 7. 提交要小批次、中文、可回滚

 一次需求可以有多个 commit，但每个 commit 应该能说明一个清晰主题：
@@ -1,5 +1,7 @@
 # hyb-oa 员工快速上手（10 人以下团队版）

+**当前状态（2026-05-12 / DOCG7）**：R6 已通过，当前公网试运行地址为 `https://oa.hyinda.com`。R7 未真实启动，R7 用户材料只是草案；`ME6-3` 代表性企业微信真机门禁仍待确认。MIF7 是下一批移动信息架构整改合同，尚未完成，因此移动端首页、进度、通知和详情返回仍会继续优化。
+
 ## 1. 你每周主要会用到什么
 - `Portal`：看公告、我的待办、我的资产、本周周报入口。
 - `审批`：处理分配给你的报销、请假、采购、差旅等审批。
@@ -7,13 +7,15 @@
 **当前用途**：判断功能是否做过、证据在哪、历史路线如何演进。
 **不得误读**：新增需求和优先级以 [海音达OA-MVP需求规格说明书](./海音达OA-MVP需求规格说明书.md)、[产品口径文档](./product-decisions.md) 和最新 `issues/*.csv` 为准。

+**DOCG7 当前说明（2026-05-12）**：本表是历史主表和 QA 参考，不代表 2026-05-12 当前状态。R6、PC6、PA6、FL6、AP6、RI6、LP6、ME6/QG6、DG7/MRF7、MIA7/MIF7 之后的事实应以最新 Issue CSV、[`docs/文档索引.md`](./文档索引.md)、[`docs/文档事实源状态矩阵.md`](./文档事实源状态矩阵.md) 和 [`docs/trialrun/manual-trialrun-report.md`](./trialrun/manual-trialrun-report.md) 为准。
+
 ## R70-R90 试运行与外部环境补充（2026-04-28 至 2026-05-05）

 - **本地核心链路**：员工/经理/管理员的本地 trialrun 主链路已在 R70/R71 通过；R73-R78 进一步补齐了真实 PDF OCR、深层业务辅助回归和财务支付尾链 focused regression。
 - **当前公网部署基线**：`oa.hyinda.com` 已接到 `caddy -> 127.0.0.1:3000`，远端目录为 `/opt/hyb-oa-trialrun`，部署由本地 `rsync` 驱动，远端不是 git 工作树。
- **当前企微状态**：R80 已启用公网 `WECOM_ENABLED / WECOM_ENTRY_ENABLED / WECOM_OAUTH_ENABLED`，`wecom_entry_v1` 已由 `force_off` 调整为 `inherit`；R82-R88 已收口真实企微 UserId 兼容、首次绑定、会话提示与设备指纹，用户手机企业微信已验证可进入系统。
- **当前移动状态**：R89 已在本地完成登录极简化、移动默认 `/mobile`、底部导航、移动审批、票据上传与小屏菜单抽屉自动化；公网仍需部署最新 R89/R90 后再做一次真实企业微信移动落点复核。
- **当前剩余外部事项**：公网 live smoke、独立 smoke 账号核对、备份恢复演练、HTTPS cookie 行为与多用户并发证据仍需按 R90/R91 收口；历史 R79 中 “WECOM=false / wecom_entry_v1=force_off” 只作为过期诊断记录，不再代表当前状态。
+- **历史企微状态**：R80 当时已启用公网 `WECOM_ENABLED / WECOM_ENTRY_ENABLED / WECOM_OAUTH_ENABLED`，`wecom_entry_v1` 已由 `force_off` 调整为 `inherit`；R82-R88 已收口真实企微 UserId 兼容、首次绑定、会话提示与设备指纹，用户手机企业微信已验证可进入系统。
+- **历史移动状态**：R89 当时已在本地完成登录极简化、移动默认 `/mobile`、底部导航、移动审批、票据上传与小屏菜单抽屉自动化；“公网仍需部署最新 R89/R90”是 2026-05-05 历史缺口，不代表当前公网状态。
+- **历史剩余外部事项**：公网 live smoke、独立 smoke 账号核对、备份恢复演练、HTTPS cookie 行为与多用户并发证据在 R90/R91 当时仍待收口；历史 R79 中 “WECOM=false / wecom_entry_v1=force_off” 只作为过期诊断记录，不再代表当前状态。
 - **阅读方式**：本文件的主表仍保留历史主线；与 trialrun、覆盖率、外部环境有关的现状判断，应结合 `docs/trialrun/coverage-matrix.csv` 与 `docs/trialrun/manual-trialrun-report.md` 一起看。

 ## R12 增量能力（2026-03-21）
@@ -1,6 +1,6 @@
 # 产品设计规则基线

-本文件是 R100 之后 PC 网页和企业微信/手机网页统一优化的事实源。目标用户是 10 人以下的国内科技公司：使用频次高、角色重叠、审批链短，系统应当像工作台，不像宣传站，也不应像重型 ERP。
+本文件是 PC 网页和企业微信/手机网页统一优化的当前事实源。目标用户是 10 人以下的国内科技公司：使用频次高、角色重叠、审批链短，系统应当像工作台，不像宣传站，也不应像重型 ERP。

 ## 设计目标

@@ -153,15 +153,15 @@ MIA7 之后，移动 OA 的信息架构以“一级入口少、任务摘要轻

 ## 报销专项规则

-报销是下一批 R101 的主流程，不在 R100 直接改数据模型。R101 必须单独处理：
+RI6 之后，报销和票据体验以“员工从报销详情补材料、财务从台账复核、移动端轻任务”为当前事实源：

- 后端生成业务编号，例如 `BX20260506001`，前端不再用 UUID 作为主展示。
- 草稿允许删除；审批中使用撤回；已通过和已支付不提供删除。
- 报销明细存在且只有一条时，上传发票默认绑定该明细。
- 多条明细时优先按金额匹配；无法匹配时自动生成新明细，不向普通用户暴露“绑定整单”。
- 发票上传支持批量 PDF，OCR 显示明确状态和可重试入口，不长期停留在“上传中/处理中”。
- PC 端适合完整明细和对账；手机端适合上传 PDF 发票、补充说明、继续编辑草稿和查状态。
- 报销详情等深层页的底部主操作在 iPhone 11 等小屏上仍保持同行双按钮，不因适配降级为单列。
+- 后端业务编号是用户主展示，例如 `BX20260506001`；UUID 不作为普通用户主编号。
+- 草稿允许编辑和删除；审批中按审批状态提供可解释下一步；已通过、已支付不提供删除。
+- 普通员工发票入口仍在报销详情“添加发票”，不恢复员工侧“票据中心/发票池”主导航。
+- 发票状态文案使用“识别中、识别失败、可添加、已添加、重复票据、已归档/已报销”等用户可理解表达，不暴露 OCR provider、发票池、绑定整单、不绑定明细等内部术语。
+- 报销详情按摘要、明细、发票、附件、审批流、付款状态和下一步动作分区；PC 保持高密度，移动保持轻任务。
+- PC 端适合完整明细、对账和财务复核；手机端适合上传 PDF 发票、补充说明、继续编辑草稿和查状态。
+- 报销详情等深层页使用统一移动详情壳和吸底操作，不把底部 Tab 留在深层事实页。

 ## 请假、票据、采购、差旅规则

@@ -170,48 +170,26 @@ MIA7 之后，移动 OA 的信息架构以“一级入口少、任务摘要轻
 - 采购和差旅页使用和报销一致的列表、状态、操作区和移动卡片规则。
 - 所有上传控件都使用中文按钮和文件名回显。

-## R99 WIP 处置
+LP6 之后，请假和采购体验以“状态清楚、审批历史一致、缺配置不 500”为当前事实源：

-当前工作区存在 R99 企业微信移动端整改 WIP，涉及：
+- 请假详情展示日期、天数、假别、原因、当前状态、当前节点、审批历史和退回/驳回说明；从已批准记录返回时不得落到新建表单语境。
+- 采购详情展示业务编号或标题、金额、状态、附件说明、审批历史和预算 warning。缺预算池时使用用户可理解提示，不暴露后端技术结果或返回 500。
+- 报销、请假、采购三类单据的详情页和卡片遵循同一主标识、状态、关键指标、审批流和下一步动作槽位。
+- 差旅仍不进入当前主线扩展；如恢复差旅能力，必须先新建独立 Issue CSV。

- `client/src/pages/MobilePortalPage.tsx`
- `client/src/pages/MobileMePage.tsx`
- `client/src/components/mobile/MobileBottomNav.tsx`
- `client/src/layouts/AppShellLayout.tsx`
- `client/src/pages/MobileReimbursementsPage.tsx`
- `client/src/pages/MobileLeavePage.tsx`
- `client/src/router/index.tsx`
- `client/src/router/lazy/index.ts`
+## 当前后续批次

-这些改动方向与本设计基线基本一致，但仍需要在 R103 中统一吸收或经批准清理。本 R100 批次不把这些 WIP 当作完成项提交，避免和设计规则、报销重构混在一起。
+已完成的当前事实链为：R6、PC6、PA6、FL6、AP6、RI6、LP6、ME6 自动化、QG6、DG7/MRF7、MIA7。`ME6-3` 代表性企业微信真机门禁仍待确认，MIF7 是下一批移动信息架构整改合同。

-## 后续批次
+MIF7 移动整改默认包含：

-R6 小范围试运行准备：
+- 首页去重：常用入口改成不重复底部 Tab 的快捷动作，待处理摘要压缩为一张轻摘要。
+- 进度页分标签：员工按草稿、审批中、已通过、退回驳回分组；审批人按待我审批、已处理分组。
+- 通知中心事件化：通知不展示审批动作按钮，点击直达目标详情。
+- 详情页统一壳：返回位置、标题、状态、内容顺序和底部动作一致。
+- 返回语义统一：优先回来源页或来源标签；无来源时回业务列表或进度标签。

- 先新建独立 R6 合同，固定 2-3 个内部用户、角色、时间窗口、回滚联系人、问题登记表和每日收口节奏。
- R6 范围限定为报销、请假、采购、审批、企业微信入口/通知、财务付款/导出。
- R6 不扩预算、ERP、AI、完整差旅、复杂 BPM；发现需求只登记为新 Issue。
- 试运行反馈按“阻断、严重、一般、体验建议”分级，不能现场扩大实现范围。
-
-R101 报销主流程重构：
-
- 后端业务编号、权限和删除规则。
- 报销列表、明细页、发票绑定和草稿编辑体验。
- PC 与手机报销流程的自动化回归。
- 需要 reviewer 检查权限、状态机和回滚策略。
-
-R102 跨页面一致性：
-
- 票据、请假、采购、差旅页面统一列表、表单、上传和状态文案。
- 清理路径式标题、原生上传控件和 UUID 主展示。
- 补齐页面级 Playwright 视觉诊断。
-
-R103 企业微信/手机端统一清理：
-
- 吸收或清理 R99 WIP。
- 固定移动首页、我的、报销、请假、审批、票据上传的移动页面。
- 手机端不再复用桌面表格作为主要体验。
+历史阶段说明：早期文档中的 R99、R100、R101、R102、R103 是移动与页面治理的历史批次代号，不再作为 2026-05-12 之后的当前排期或待办事实源。需要追溯当时决策时，可阅读历史 Issue CSV 和 `docs/文档事实源状态矩阵.md`。

 ## 验收规则

@@ -2,6 +2,8 @@

 **文档状态**：当前操作手册，用于本地、公网、企业微信和真实 OCR 试运行验证。

+**当前状态（2026-05-12 / DOCG7）**：R6 已通过；R7 未真实启动，R7/OPS7/DOC7 只是准备材料，不代表已启动或已上线；`ME6-3` 代表性企业微信真机门禁仍待确认；MIF7 是下一批移动信息架构整改合同，尚未完成。自动化、QG6 和公网视觉矩阵不能替代代表性真机验收。
+
 本文用于 hyb-oa 本地、企业微信和公网试运行。默认策略是：能自动化的先自动化，自动化无法覆盖的才请求人工配合。

 测试分层、视觉验证、SKIP、状态回填和回归门禁的制度口径，以 [`docs/测试规约与回归门禁.md`](测试规约与回归门禁.md) 为准；本文只保留本地、公网、企业微信和真实 OCR 的操作步骤。
@@ -1,4 +1,5 @@
 "Domain","Tier","Routes","Primary_Roles","Env_Gates","Feature_Flags","Coverage_Status","Evidence","Validated_Flows","Gaps","Next_Action"
+"__DOC_STATUS__","meta","N/A","N/A","N/A","N/A","historical_reference","docs/文档索引.md|docs/文档事实源状态矩阵.md|docs/trialrun/manual-trialrun-report.md","本 CSV 是历史证据 / QA 参考，不代表 2026-05-12 当前状态。R6/PC6/PA6/FL6/AP6/RI6/LP6/ME6/QG6/DG7/MIA7 后的当前状态以最新 Issue CSV 和文档索引为准。","历史条目中的公网仍需、待执行、缺口等表述需按当时日期理解。","不要单独使用本 CSV 决定当前门禁或新需求；先读最新 Issue CSV。"
 "认证与 Portal 导航","must_cover","/login|/portal|主/管/备导航","employee|manager|admin","APP_ORIGIN|COOKIE_SECURE|PORTAL_HOME_ENABLED|WECOM_ENTRY_ENABLED","portal_home_v1|wecom_entry_v1","done","artifacts/r69/acceptance-report.md|docs/trialrun/manual-trialrun-report.md|client/tests/e2e/login-portal-ux.spec.ts|client/tests/e2e/wecom-entry.spec.ts|client/tests/e2e/manual/r70-trialrun-assist.spec.ts","登录、Portal 首屏、员工/经理/管理员导航分组、普通浏览器与企微 WebView CTA 提示均有自动化或人工证据。","真实企微 OAuth 绑定与回跳未做端到端；HTTPS 部署态 cookie 行为未在本轮验证。","保持主链路 done；真实企微与 HTTPS 转 A5 外部专项。"
 "请假与审批","must_cover","/leave-requests|/workflow/tasks","employee|manager|admin","none","leave_holiday_calendar","done","artifacts/r69/acceptance-report.md|docs/trialrun/manual-trialrun-report.md|client/tests/e2e/leave-flow.spec.ts|client/tests/e2e/workflow-quick-approve.spec.ts|client/tests/e2e/leave-team-calendar.spec.ts","请假草稿、提交、撤回、经理快捷审批、团队日历权限边界与经理部门视角已自动化并在 R70 人工复测通过。","多审批人链路、代理审批、真实并发多人协同未在 trialrun 轮次验证。","维持 done；多人协同与代理审批并入 A5 或后续专项。"
 "报销、票据中心与 OCR","must_cover","/reimbursements|/reimbursements/:id|/invoice-pool","employee|manager|finance|admin","OCR_PROVIDER|TENCENT_SECRET_ID|TENCENT_SECRET_KEY|PAYMENT_BATCH_ENABLED|ERP_SYNC_ENABLED","invoice_verification|payment_batch_v1|erp_sync","done","docs/trialrun/manual-trialrun-report.md|artifacts/r70/live-ocr-batch-report.md|issues/2026-04-29_08-39-22-r76-external-trialrun-closeout.csv|issues/2026-04-29_09-19-07-r77-ocr-pdf-first.csv|issues/2026-04-29_10-14-27-r78-reimbursement-payment-tail.csv|client/tests/e2e/reimbursement-workflow-progress.spec.ts|client/tests/e2e/invoice-ocr-flow.spec.ts|client/tests/e2e/reimbursement-payment-batch-flow.spec.ts|client/tests/e2e/manual/live-invoice-ocr.spec.ts|client/tests/e2e/manual/live-invoice-ocr-batch.spec.ts|server/scripts/regression-payment-batches.sh","报销提交后审批进度、票据中心缺字段修正、上传后自动 OCR 进入可绑定、绑定后提交已自动化；R70 人工链路也通过。R77 已在干净本地 trialrun DB 上用真实 PDF 发票跑通 `上传 -> OCR -> available`。R78 已补 employee->manager->finance->finance_mgr->payment batch->execute->reimbursement paid->invoice archived->ERP preview pending outbox focused regression。","真实 ERP 投递回执、高风险两轮复核、大额或混合付款批次仍未进入本轮本地试运行；腾讯 OCR 凭证仍依赖旧项目运行时注入。","维持 done；真实 ERP 与高风险付款转外部/专项回归，PDF 转图片 fallback 仅在新增票样兼容性问题出现时再评估。"
@@ -13,4 +14,4 @@
 "预算、支付批次与 AP 运营","optional","/budgets|/payment-batches|/ap-operations","finance|admin","BUDGET_PRECHECK_ENABLED|PAYMENT_BATCH_ENABLED|ERP_SYNC_ENABLED","budget_precheck_v1|payment_batch_v1|erp_sync","partial_done","issues/2026-03-29_08-07-14-p25-lite-budget-ap.csv|issues/2026-04-06_r52-ap-operations.csv|issues/2026-04-29_10-14-27-r78-reimbursement-payment-tail.csv|client/tests/e2e/reimbursement-payment-batch-flow.spec.ts|server/scripts/regression-payment-batches.sh","支付批次 maker-checker、AP 待付款快捷复核、finance 执行报销付款批次，以及 reimbursement paid 后 ERP preview pending outbox 已在本地 focused regression 跑通；历史 budget/AP 视图与 review 证据仍保留。","预算预检页面级联动、高风险两轮复核、大额批次与非报销实体付款未在本轮 focused local 回归中重跑。","若财务域继续扩大试运行，再补 budget precheck 与高风险二次复核专项；当前 payment batch/AP happy path 已具备本地回归证据。"
 "ERP 集成与切换控制台","external","/system/integrations/erp|/system/cutover","integration admin|system.settings","ERP_SYNC_ENABLED|CUTOVER_CONSOLE_ENABLED","erp_sync|cutover_console_v1","partial_external","issues/2026-03-08_14-10-53-p19-erp-1-l5-masterdata-journal-bridge.csv|issues/2026-03-21_11-10-00-p29-replacement-readiness-refresh.csv|client/tests/e2e/live-smoke.spec.ts","ERP 管理页、mock/http 回归和只读 live smoke 有历史证据。","当前本地 trialrun 没有真实 ERP 出入站或 cutover 操作验证。","仅在外部环境专项下执行，不进入默认 trialrun gate。"
 "系统治理、功能开关与审计","enabled_admin","/system/workspace|/system/settings|/system/feature-flags|/system/workflow-definitions|/audit-logs|/system/notification-channels","admin","WORKFLOW_DEFINITION_ADMIN_ENABLED","workflow_definition_admin_v1","partial_done","docs/trialrun/manual-trialrun-report.md|client/tests/e2e/settings-governance.spec.ts|client/tests/e2e/live-smoke.spec.ts|server/src/scripts/smoke-trialrun-runtime.js|client/tests/e2e/r75-automation-gap-fill.spec.ts|issues/2026-05-05_20-01-18-r90-r91-trialrun-closeout.csv","工作区设置、系统设置、功能开关、审计日志打开与导航边界有自动化和人工证据；R74 本地门禁已检查 workspace/flag/navigation 基线，R75 已补功能开关备注保存并恢复写路径。R80 已把 `wecom_entry_v1` 从 `force_off` 调整为 `inherit`，R90 已把旧公网诊断从当前事实中剥离。","流程定义、通知渠道、工作区其他写操作和审计留痕写入效果仍未在当前 trialrun 做完整专项；公网 `announcements_v1` / `global_search_v1` 仍需在 live smoke 中重新核对。","保留 partial_done；R90/R91 先收口公网 feature flag 与 live smoke，再补通知渠道与流程定义写路径。"
-"企微、HTTPS、部署态与并发","external","/login(企微入口)|部署运行时|多账号并发","all roles","APP_ORIGIN|COOKIE_SECURE|WECOM_*|PUBLIC_SECURITY_HARDENING_ENABLED","wecom_entry_v1|public_security_hardening_v1","partial_done","deploy/trialrun/runbook.md|client/tests/e2e/wecom-entry.spec.ts|client/tests/e2e/live-smoke.spec.ts|client/tests/e2e/r89-mobile-login-navigation.spec.ts|server/src/scripts/smoke-trialrun-runtime.js|issues/2026-05-04_16-47-46-r80-live-wecom-enablement.csv|issues/2026-05-04_20-53-39-r82-wecom-userid-compatibility.csv|issues/2026-05-04_23-36-10-r83-r86-user-onboarding-simplify.csv|issues/2026-05-05_14-01-13-r87-wecom-session-hint.csv|issues/2026-05-05_14-12-50-r88-wecom-device-fingerprint.csv|issues/2026-05-05_17-35-00-r89-mobile-login-ux.csv|issues/2026-05-05_20-01-18-r90-r91-trialrun-closeout.csv","本地/只读 smoke、env contract、导航/入口提示与 local runtime gate 已就绪；`https://oa.hyinda.com/ready` 已通过只读探活。R80 已启用公网企微 env 与 `wecom_entry_v1=inherit`；R82-R88 已修复真实 UserId 兼容、首次绑定、会话提示与设备指纹；R89 已完成本地移动登录与导航自动化。","公网仍需部署最新 R89/R90 并用真实手机企业微信复核 `/mobile` 落点；HTTPS cookie secure、独立 smoke 账号 live smoke 和多用户并发协同仍缺最终证据。","企微不再按外部阻塞处理；R90/R91 继续推进公网最新版本部署、`returnTo=/mobile`、live smoke、备份恢复和并发专项。"
+"企微、HTTPS、部署态与并发","external","/login(企微入口)|部署运行时|多账号并发","all roles","APP_ORIGIN|COOKIE_SECURE|WECOM_*|PUBLIC_SECURITY_HARDENING_ENABLED","wecom_entry_v1|public_security_hardening_v1","partial_done","deploy/trialrun/runbook.md|client/tests/e2e/wecom-entry.spec.ts|client/tests/e2e/live-smoke.spec.ts|client/tests/e2e/r89-mobile-login-navigation.spec.ts|server/src/scripts/smoke-trialrun-runtime.js|issues/2026-05-04_16-47-46-r80-live-wecom-enablement.csv|issues/2026-05-04_20-53-39-r82-wecom-userid-compatibility.csv|issues/2026-05-04_23-36-10-r83-r86-user-onboarding-simplify.csv|issues/2026-05-05_14-01-13-r87-wecom-session-hint.csv|issues/2026-05-05_14-12-50-r88-wecom-device-fingerprint.csv|issues/2026-05-05_17-35-00-r89-mobile-login-ux.csv|issues/2026-05-05_20-01-18-r90-r91-trialrun-closeout.csv","本地/只读 smoke、env contract、导航/入口提示与 local runtime gate 已就绪；`https://oa.hyinda.com/ready` 已通过只读探活。R80 已启用公网企微 env 与 `wecom_entry_v1=inherit`；R82-R88 已修复真实 UserId 兼容、首次绑定、会话提示与设备指纹；R89 已完成本地移动登录与导航自动化。","历史缺口：当时公网仍需部署最新 R89/R90 并用真实手机企业微信复核 `/mobile` 落点；该表述不代表当前公网状态。HTTPS cookie secure、独立 smoke 账号 live smoke 和多用户并发协同也需按最新 Issue CSV 判断。","企微不再按外部阻塞处理；R90/R91 当时继续推进公网最新版本部署、`returnTo=/mobile`、live smoke、备份恢复和并发专项。"
@@ -2,12 +2,16 @@

 **文档状态**：历史人工试运行快照，不代表当前公网部署状态。
 日期：2026-04-28
-**当前用途**：追溯 R70-R81 期间本地、公网、企微、OCR 等验证证据。
-**不得误读**：文中的 `force_off`、公网 `.env`、企微启用状态和开放问题均为当时记录；当前状态应以最新 Issue CSV、部署报告和 live smoke 结果为准。
+**当前用途**：追溯 R70-R81 期间本地、公网、企微、OCR 等验证证据，并保留 R6 之后批次的追加收口记录。
+**不得误读**：文中的 `force_off`、公网 `.env`、企微启用状态和开放问题均为当时记录；当前状态应以最新 Issue CSV、部署报告、live smoke 结果、[`docs/文档索引.md`](../文档索引.md) 和 [`docs/文档事实源状态矩阵.md`](../文档事实源状态矩阵.md) 为准。

-## R6 小范围试运行记录模板（待执行）
+## DOCG7 文档事实源治理（2026-05-12）

-本节用于 `issues/2026-05-11_10-23-41-r6-small-trialrun-prep.csv`。R6 未固定名单、窗口和回滚联系人前，不得把主 R6 标为 `DOING`。
+DOCG7 用于治理文档口径，不改业务代码、不部署公网、不关闭 `ME6-3`。本轮明确：R6 已通过；PC6、PA6、FL6、AP6、RI6、LP6、ME6 自动化、QG6、DG7/MRF7 和 MIA7 已完成相应收口；MIF7 是下一批移动整改合同但仍为 TODO；R7/OPS7/DOC7 是准备材料，不代表真实 R7 已启动或已上线。后续读取历史矩阵、旧 runbook 或旧 trialrun 记录时，应优先按 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md` 判断是否仍能指导当前开发。
+
+## R6 小范围试运行记录（历史模板 + 已执行记录）
+
+本节源自 `issues/2026-05-11_10-23-41-r6-small-trialrun-prep.csv` 的执行模板，后续已追加 R6、PS6 和 R6 后批次的真实收口记录。阅读时以表内最新“当前门禁/当前代码基线”和后续收口段落为准，不要把早期模板措辞当作当前未启动状态。

 ### R6 基线

@@ -1,4 +1,5 @@
 Domain,Tier,Primary_Roles,PC_Routes,Mobile_WeCom_Routes,Server_Routes,Main_Flow,Exception_Flow,Permission_Flow,Current_Coverage,Known_Gaps,Best_Practice_Delta,Next_Action
+"__DOC_STATUS__","meta","N/A","N/A","N/A","N/A","本 CSV 是历史证据 / QA 参考，不代表 2026-05-12 当前状态。R6/PC6/PA6/FL6/AP6/RI6/LP6/ME6/QG6/DG7/MIA7 后的当前流程以最新 Issue CSV、文档索引和手工试运行报告为准。","历史缺口按当时日期理解，不自动生成当前需求。","当前权限和状态以服务端实现与最新 PA6/后续 Issue 为准。","historical_reference","可能包含已过期的公网仍需、待执行或真机缺口描述。","用于追溯流程覆盖，不替代当前 PRD 或门禁。","先读最新 Issue CSV 再决定下一步。"
 "认证与企业微信入口","P0","employee|manager|admin","/login|/portal|/settings/profile","/mobile|/mobile/me|/mobile/profile","server/src/routes/auth.js|server/src/routes/wecomAuth.js|server/src/routes/me.js","账号登录或企微 OAuth 进入工作台，按设备落到 PC Portal 或移动工作台。","未绑定、会话过期、OAuth 回跳失败、密码错误、首次登录改密。","普通员工仅看个人入口；管理员看系统入口；企业微信回跳只允许安全 returnTo。","login-portal-ux.spec.ts|wecom-entry.spec.ts|wecom-first-bind.spec.ts|r89-mobile-login-navigation.spec.ts|live-smoke.spec.ts","真实企业微信 OAuth 和真机回跳仍需 live smoke；HTTPS cookie 行为缺最终证据。","国内企业微信应用最佳实践要求工作台直达 H5 移动体验，不能露出 PC 壳。","B3/B5：视觉巡检防 PC 壳；live readiness 检查真实账号。"
 "报销与票据 OCR","P0","employee|manager|finance|finance_mgr|admin","/reimbursements|/reimbursements/:id|/invoice-pool|/payment-batches|/ap-operations","/mobile/reimbursements|/mobile/reimbursements/:id|/mobile/capture","server/src/routes/reimbursements.js|server/src/routes/invoicePool.js|server/src/routes/paymentBatches.js|server/src/routes/apOperations.js","员工建草稿、加明细、上传发票、OCR 识别、添加到报销、提交审批、财务付款归档。","OCR 超时/失败、重复发票、已绑定/已报销、删除后重传、缺金额无法自动明细、付款失败。","员工只看自己的报销和业务文案；经理审批；财务复核付款；管理员配置。","reimbursement-workflow-progress.spec.ts|invoice-ocr-flow.spec.ts|reimbursement-payment-batch-flow.spec.ts|r111-invoice-reimbursement-guard.spec.ts|r125-invoice-reupload-after-delete.spec.ts|regression-dedup.sh","真实腾讯 OCR 耗时和公网文件上传链路需要样本；移动 PDF 选择需真机证据。","合思/分贝通/每刻均强调票据识别、验真、查重、电子档案和状态可追溯。","B3/B5/B7：视觉和文案门禁、真实 OCR readiness、发布门禁。"
 "审批中心","P0","manager|finance|finance_mgr|admin","/workflow/tasks|/workflow/tasks/:taskId","/mobile/approvals","server/src/routes/workflow.js|server/src/routes/workflowDefinitions.js","审批人查看待办，审批/驳回/退回/转交，申请人查看进度。","任务已处理、权限不足、并发审批、离线审批重放冲突。","只有当前审批人可处理；管理员可治理流程定义；普通员工只看相关单据进度。","workflow-quick-approve.spec.ts|mobile-approvals-offline.spec.ts|r111-invoice-reimbursement-guard.spec.ts","代理审批、多人并发、真实企业微信 deep link 证据不足。","同类系统强调审批全程留痕、风险提示和移动处理效率。","B4/B5：业务流门禁聚合；live smoke 覆盖移动 deep link。"
@@ -2,6 +2,8 @@

 **文档状态**：当前操作手册，用于真实手机、企业微信和移动浏览器人工验收。

+**当前状态（2026-05-12 / DOCG7）**：R6 已通过；`ME6-3` 代表性企业微信真机门禁仍待确认，不能用自动化或公网视觉矩阵替代。R7 未真实启动；R7 草案、OPS7 Runbook 和 DOC7 用户材料不代表已启动或已上线。MIF7 是下一批移动信息架构整改合同，完成后仍需要按本清单复测。
+
 适用范围：使用真实手机访问 `https://oa.hyinda.com`，重点验证企业微信工作台、手机浏览器、PDF 发票上传、真实 OCR 状态反馈和移动核心流程。

 ## 测试前信息
@@ -3,6 +3,8 @@
 **文档状态**：当前操作手册，用于首轮主线发布候选、live smoke 和小范围试运行准备。
 **适用范围**：`hyb-oa` MVP 首轮主线 A1-A8 之后，部署前和部署后试运行前。

+**当前状态（2026-05-12 / DOCG7）**：本清单保留 A1-A8、R5 和 R6 的历史证据，但当前事实已经推进到 R6 已通过，PC6/PA6/FL6/AP6/RI6/LP6/ME6 自动化/QG6/DG7/MIA7 已完成相应收口。R7 未真实启动，R7/OPS7/DOC7 只是准备材料，不代表已启动或已上线；`ME6-3` 代表性企业微信真机门禁仍待确认；MIF7 是下一批移动信息架构整改合同。
+
 本文不替代 PRD、模块规约或 Issue CSV；它只回答“当前是否可以从本地可回归进入公网/企业微信/真实 OCR 验收”。

 ## 1. 当前结论
@@ -0,0 +1,77 @@
+# hyb-oa 文档事实源状态矩阵
+
+**文档状态**：当前文档治理事实源。
+**适用时间**：2026-05-12 DOCG7 之后。
+**治理策略**：采用索引归档，不删除、不移动历史文档，不回写旧 Issue CSV。历史文档通过本文档和 `docs/文档索引.md` 标注用途。
+
+## 当前判断规则
+
+- 最新 Issue CSV 是执行合同事实源；当前 PRD、模块规约和设计规则是需求/验收事实源。
+- 当前操作手册用于执行试运行、部署、真机验收和用户培训；若与最新 Issue CSV 或模块规约冲突，以最新 Issue CSV 和当前模块规约为准。
+- 历史矩阵、旧 trialrun 报告和旧 CSV 用于追溯证据，不代表 2026-05-12 当前状态。
+- R7/OPS7/DOC7 是准备材料，不代表真实扩大试运行已经启动。
+- `ME6-3` 代表性企业微信真机门禁仍未关闭；MIF7 是下一批移动信息架构整改合同，当前仍为 TODO。
+
+## 状态矩阵
+
+| 文档 | 分类 | 当前用途 | 当前口径 |
+| --- | --- | --- | --- |
+| `docs/文档索引.md` | 当前事实源 | 文档入口、冲突优先级、归档策略 | 当前有效；先读它判断哪些文档可指导开发 |
+| `docs/文档事实源状态矩阵.md` | 当前事实源 | DOCG7 后文档状态分类 | 当前有效；不替代具体模块规约 |
+| `docs/海音达OA-MVP需求规格说明书.md` | 当前事实源 | PRD 主事实源 | 当前有效；范围变更先更新 PRD 或模块规约 |
+| `docs/product-design-rules.md` | 当前事实源 | PC、移动、企业微信 WebView 设计规则 | 当前有效；MIA7 移动标准为最新移动设计事实源 |
+| `docs/product-decisions.md` | 当前事实源 | 已拍板产品边界 | 当前有效；与最新 Issue CSV 冲突时以后者为准 |
+| `docs/需求-统一审批中心规约.md` | 当前事实源 | 审批、催办、超时提醒、审批效率 | 当前有效；AP6 v1 已是当前事实 |
+| `docs/reimbursement-invoice-rules.md` | 当前事实源 | 报销、发票、附件、OCR 规则 | 当前有效；RI6 后员工入口仍是报销详情添加发票 |
+| `docs/需求-报销发票OCR规约.md` | 当前事实源 | 报销发票 OCR 模块规约 | 当前有效；细节与 `reimbursement-invoice-rules.md` 配套 |
+| `docs/需求-企业微信基础设施规约.md` | 当前事实源 | 企业微信入口、身份、消息、deeplink | 当前有效；企业微信不替代 OA 正式审批 |
+| `docs/需求-请假考勤修正规约.md` | 当前事实源 | 请假、补卡、考勤修正 | 当前有效；LP6 已完成轻体验收口 |
+| `docs/需求-采购费用审批规约.md` | 当前事实源 | 采购、费用、附件、审批规则 | 当前有效；复杂预算、供应商准入和 ERP 不在当前批次扩展 |
+| `docs/需求-合同附件归档规约.md` | 当前事实源 | 合同台账和附件归档边界 | 当前有效；涉密正文不上传 |
+| `docs/需求-项目轻管理规约.md` | 当前事实源 | 项目轻管理边界 | 当前有效；不扩成重型项目管理 |
+| `docs/测试规约与回归门禁.md` | 当前事实源 | 自动化、视觉、真机、状态回填规则 | 当前有效；真机暂停只能标 PAUSED |
+| `docs/开发交付与变更管理规约.md` | 当前事实源 | Issue CSV、review、提交和交付流程 | 当前有效 |
+| `AGENTS.md` | 当前事实源 | Agent 执行硬约束 | 当前有效；执行开发前必须遵守 |
+| `.agents/skills/hyb-oa-delivery/SKILL.md` | 当前事实源 | 项目交付 Skill | 当前有效；需要随事实源同步 |
+| `docs/agent-development-practices.md` | 当前事实源 | Agent 协作与交付实践 | 当前有效；详细事实源在 docs 和 Issue CSV |
+| `docs/admin-handbook.md` | 当前操作手册 | 管理员上线、权限、试运行配置 | 当前有效；R7 未真实启动，ME6-3 未关闭 |
+| `docs/employee-quickstart.md` | 当前操作手册 | 员工使用说明 | 当前有效；移动体验下一批 MIF7 继续整改 |
+| `docs/trialrun-runbook.md` | 当前操作手册 | 本地、公网、企业微信、真实 OCR 验证步骤 | 当前有效；不替代真机清单 |
+| `docs/trialrun/real-device-public-checklist.md` | 当前操作手册 | 真实手机/企业微信人工验收 | 当前有效；`ME6-3` 仍待代表设备确认 |
+| `docs/trialrun/release-readiness-checklist.md` | 当前操作手册 | 发布试运行准备与门禁 | 当前有效但含早期证据；顶部当前状态优先 |
+| `docs/trialrun/live-smoke-readiness.md` | 当前操作手册 | 公网 live smoke 和真实 OCR readiness | 当前有效 |
+| `docs/trialrun/r7-expanded-trialrun-prep.md` | 草案/准备材料 | R7 扩大试运行草案 | 不代表真实 R7 已启动；`R7E-*` 仍需用户确认后执行 |
+| `docs/trialrun/ops7-runbook.md` | 草案/准备材料 | 运维交接 Runbook 草案 | 不代表生产配置变更或恢复演练已执行 |
+| `docs/trialrun/r7-user-guide-and-faq.md` | 草案/准备材料 | R7 用户手册和 FAQ 草案 | 只描述已实现能力，不承诺扩展能力 |
+| `docs/trialrun/mobile-ia-visual-flow-review.md` | 实现状态与证据 | MIA7 移动信息架构审查结论 | 当前审查证据；整改仍以 MIF7 合同为准 |
+| `docs/trialrun/manual-trialrun-report.md` | 实现状态与证据 | R70-R6 及后续批次收口记录 | 历史基底 + 最新追加记录；不要只读标题判断当前状态 |
+| `docs/feature-matrix.md` | 历史证据 | 2026-05-05 前后历史实现状态矩阵 | 历史主表；不代表 2026-05-12 当前状态 |
+| `docs/trialrun/coverage-matrix.csv` | 历史证据 | 试运行覆盖证据和 QA 参考 | 历史证据；不单独作为当前门禁 |
+| `docs/trialrun/project-wide-flow-matrix.csv` | 历史证据 / QA 参考 | 项目级流程和覆盖映射 | 历史 QA 参考；当前流程以最新 Issue CSV 为准 |
+| `docs/trialrun/permission-direct-access-audit.md` | 实现状态与证据 | 权限直连审计记录 | 当前可追溯证据；后续权限变更需重新审计 |
+| `docs/trialrun/deployment-preflight-2026-05-10.md` | 实现状态与证据 | 2026-05-10 部署预检证据 | 历史证据；不代表最新部署状态 |
+| `docs/trialrun/async-ux-audit.csv` | 历史证据 / QA 参考 | 异步体验审计记录 | 历史 QA 参考 |
+| `docs/requirements-specification.md` | 历史归档参考 | 旧规格入口或跳转 | 不作为当前 PRD 主入口 |
+| `docs/implementation_plan.md` | 历史归档参考 | 早期实施计划 | 不作为当前排期 |
+| `docs/tech_stack_report.md` | 技术参考 / 历史归档参考 | 技术栈和复用报告 | 技术栈有参考价值，范围口径需看当前 PRD |
+| `docs/architecture.md` | 技术参考 | 架构概览 | 当前参考；部署状态需结合最新部署报告 |
+| `docs/integration-boundaries.md` | 技术参考 | ERP、IM、AI、MCP、PWA 集成边界 | 当前参考；不因历史能力扩大 R6/R7 范围 |
+| `docs/domain-events.md` | 技术参考 | 领域事件清单 | 当前参考 |
+| `docs/mcp-tools.md` | 技术参考 | MCP 工具边界 | 当前参考；未启用工具不得假设可用 |
+| `docs/ops/*.md` | 技术参考 | SLO、 tracing、测试策略、CI 和 DORA | 当前参考；不替代 Issue CSV |
+| `docs/adr/*.md` | 技术参考 / 历史归档参考 | 重要路线决策记录 | 保留 ADR 历史结论 |
+| `docs/mobile/pwa-regression-checklist.md` | 历史证据 / QA 参考 | PWA 移动回归清单 | 历史 QA 参考；当前移动验收看 ME6/MIA7/MIF7 |
+| `docs/MVP主线代码差距盘点.md` | 历史证据 | MVP 主线差距盘点 | 历史证据；不作为新需求入口 |
+| `docs/todo-reconciliation.md` | 历史证据 | 旧 TODO 清账映射 | 历史追溯，不直接生成新需求 |
+| `docs/invoice-pool-refactor-plan.md` | 历史归档参考 | invoicePool 拆分方案 | 一次性方案归档 |
+| `docs/migration-mapping.md` | 历史归档参考 | 旧系统迁移映射 | 仅迁移专项使用 |
+| `docs/trialrun/domestic-oa-best-practices.md` | 历史归档参考 | 国内 OA 调研快照 | 仅作原则参考，不替代产品事实源 |
+
+## 最近事实链摘要
+
+- R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
+- ME6 自动化、部署和公网移动视觉矩阵已完成；`ME6-3` 代表性真机抽查仍待确认。
+- QG6 已完成 QA 治理升级。
+- DG7/MRF7 已完成移动信息去重和真机反馈第一轮修复。
+- MIA7 已完成移动信息架构、视觉和流程审查；MIF7 是下一批移动整改合同，尚未实施。
+- R7 只有草案和准备材料；真实扩大试运行尚未启动。
@@ -1,7 +1,7 @@
 # hyb-oa 文档索引

 **文档状态**：当前人工审查入口。
-**适用时间**：2026-05-09 之后。
+**适用时间**：2026-05-12 DOCG7 之后。

 本索引用来区分“当前事实源”和“历史证据”。查需求、排期、开发范围时，先读当前事实源；排查历史实现、回归证据或旧决策时，再读历史快照和证据文档。

@@ -19,6 +19,19 @@

 判断冲突时，优先级固定为：最新 Issue CSV > 当前 PRD 和模块规约 > 产品口径文档 > 当前操作手册 > 技术参考 > 历史证据和归档参考。

+如果历史矩阵、旧计划、旧 runbook 或旧 trialrun 记录里出现“当前”“下一批”“公网仍需”“待执行”等旧阶段措辞，但该文档没有在 2026-05-12 之后刷新，应按历史证据读取，不得覆盖最新 Issue CSV 和当前模块规约。
+
+## 最近事实源更新链
+
+当前事实链为：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 治理升级。
+- DG7/MRF7 已完成移动信息去重和真机反馈第一轮修复。
+- MIA7 已完成移动信息架构、视觉和流程审查；MIF7 是下一批移动整改合同，尚未实施。
+- R7/OPS7/DOC7 是准备材料，不代表已上线、已启动真实 R7 或已经扩大试运行。
+
 ## 当前事实源

 | 文档 | 用途 | 注意 |
@@ -34,6 +47,7 @@
 | [产品口径文档](./product-decisions.md) | 已拍板的产品边界和业务规则 | 与 PRD 冲突时，以更新后的 PRD 和最新 Issue CSV 为准 |
 | [报销、发票与附件规则](./reimbursement-invoice-rules.md) | 报销、发票、OCR、附件的细则 | 报销相关开发必须同时参考 |
 | [产品设计规则基线](./product-design-rules.md) | PC、移动、企业微信 WebView 的视觉和交互规则 | 页面调整必须参考 |
+| [文档事实源状态矩阵](./文档事实源状态矩阵.md) | DOCG7 后的文档分类、当前口径和历史证据边界 | 判断文档是否能指导当前开发时先查这里 |
 | [测试规约与回归门禁](./测试规约与回归门禁.md) | 当前测试事实源，固定自动化、视觉验证、真机 smoke、SKIP 和状态回填规则 | A3-A8 开发和后续非微小改动必须参考 |
 | [开发交付与变更管理规约](./开发交付与变更管理规约.md) | 当前开发交付事实源，固定 Issue 生命周期、review、commit、工作区和完成输出规则 | 提交和交付前必须参考 |
 | [AGENTS 项目规则](../AGENTS.md) | Agent 协作、Issue CSV、测试和提交规则 | 执行开发前必须遵守 |
@@ -59,7 +73,7 @@
 | [实现状态矩阵](./feature-matrix.md) | 历史实现状态、完成证据、回归覆盖追踪 | 历史证据，不是 PRD，不作为新增需求来源 |
 | [试运行覆盖矩阵](./trialrun/coverage-matrix.csv) | 试运行覆盖范围和缺口 | 历史证据；读取时结合最新 Issue CSV，不单独决定当前范围 |
 | [项目级流程矩阵](./trialrun/project-wide-flow-matrix.csv) | 核心业务流、入口、测试覆盖映射 | 历史证据和 QA 参考，不作为当前需求来源 |
-| [人工业务试运行报告](./trialrun/manual-trialrun-report.md) | R70 当时的人工试运行证据 | 历史快照，不代表当前公网状态 |
+| [人工业务试运行报告](./trialrun/manual-trialrun-report.md) | R70 历史基底和 R6 之后批次收口追加记录 | 历史基底 + 当前追加证据；读取时看最新条目和最新 Issue CSV |
 | [历史 TODO 清账映射](./todo-reconciliation.md) | 旧 TODO 的 implemented / superseded / still-open 追溯 | 历史证据，不用来生成新需求 |

 ## 架构、集成与运维参考