wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 7 软件包 项目 发布 百科 活动

SCG LOPS 收口系统开发完成门禁

浏览代码
这个提交包含在：
wangsli
2026-05-17 13:06:43 +08:00
父节点 a3a4a861c7
当前提交 22a2bcd205
共修改 8 个文件，包含 107 行新增和 8 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
docs/trialrun/人工试运行报告.md
+6
查看文件
@@ -31,6 +31,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
- 2026-05-17 LAUNCH-DEPLOY-FINANCE 已按用户要求完成“本地全流程/页面门禁 -> 部署 -> 公网复检”：本地基础代码门禁、业务流、PC/移动/企业微信页面矩阵均通过；部署 commit `ab5ab4d` 到 `https://oa.hyinda.com`，`SYNC_ENV=0` 未覆盖远端 env，新增回单附件 migration 已应用；公网 readiness、PDF live OCR、移动/企业微信矩阵和 CASHV 短窗口均通过。CASHV 公网测试报销 `BX-20260517-0025` 完成无回单执行阻断、上传/下载回单、付款执行、AP 导出和审计核验；最终 `payment_batch_v1=flag_force_off`，正式常开仍需 `FIN-PROD-ENABLE`。
- 2026-05-17 FIN-PROD-ENABLE 已完成公网付款批次正式常开：未重新部署业务代码；新增 QA-only 正式启用 runner 后，公网测试报销 `BX-20260517-0026` 完成审批、付款批次创建/复核、无回单执行阻断、回单上传/下载、付款执行、报销 `paid`、票据 `archived`、AP 台账 `paid`、AP 导出和审计核验；公网移动矩阵 6 passed、企业微信渲染矩阵 8 passed。最终 `payment_batch_v1=force_on`，`erp_sync=force_off`；不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水。
- 2026-05-17 ACCOUNTING-HANDOFF-V1 已固化月度代账交接 SOP：OA 侧导出 AP 台账、报销、票据中心、付款批次/回单附件清单和审计日志；银行流水和银行回单原件由 `wangzhiling` 从银行渠道导出，交给代账人工核对。公网只读/导出核对显示付款批次清单、回单附件列表/下载、AP 导出、报销导出、票据导出和审计日志导出均返回 200；不开发银行流水导入或一键 zip 包。
- 2026-05-17 SYSTEM-COMPLETE-GATE 已完成系统开发完成门禁：公网 `/ready`、public bundle、live smoke `3 passed`、PDF live OCR `1 passed`，只读 flag 核验显示 `payment_batch_v1=force_on`、`erp_sync=force_off`；公网移动/企业微信 UA 矩阵 `14 passed`；结论 `GO_TO_USE`。当前首批正式能力为员工报销、PDF OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接。
- 2026-05-17 LAUNCH-OPS-V1 已固定首周正式使用运营口径：`wangshunli` 为上线拍板、管理员复核和回滚决策人，`wangzhiling` 为出纳/付款执行和代账资料准备人；首周问题登记、每日巡检、暂停条件、代账交接节奏和 UX8/可选功能冻结口径已回写现有手册。后续新增功能只按真实反馈和业务频次另建 Issue CSV。
## 关键证据索引
@@ -69,6 +71,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
| LAUNCH-DEPLOY-FINANCE | 已收口：CASHV 部署和公网复检完成；本地全流程/页面门禁通过，公网 readiness/PDF live OCR、移动/企业微信矩阵和 CASHV 短窗口通过；最终 `payment_batch_v1=flag_force_off` | `issues/2026-05-17_09-38-55-launch-deploy-finance.csv`、`artifacts/qa-flow/business-flow-20260517-094407/summary.txt`、`artifacts/qa-flow/live-smoke-readiness-20260517-102904/summary.json`、`artifacts/qa-flow/p2-fin-live-20260517-103450/live-result.json` |
| FIN-PROD-ENABLE | 已收口：公网付款批次正式启用完成；测试报销 `BX-20260517-0026` 付款闭环到 paid，票据 archived，AP 台账 paid，导出和审计核验通过；公网移动矩阵 6 passed，企业微信渲染矩阵 8 passed；最终 `payment_batch_v1=force_on`、`erp_sync=force_off` | `issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv`、`artifacts/qa-flow/fin-prod-enable-20260517-114731/summary.json`、`artifacts/qa-flow/fin-prod-enable-20260517-114731/live-result.json` |
| ACCOUNTING-HANDOFF-V1 | 已收口：月度代账交接 SOP 固化；OA 侧 AP/报销/票据/付款批次/回单附件/审计资料清单可用，公网导出和回单下载状态核对 200；银行流水和回单原件由出纳线下导出给代账 | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv`、`docs/管理员手册.md` |
| SYSTEM-COMPLETE-GATE | 已收口：系统开发完成门禁通过，结论 `GO_TO_USE`；live smoke 3 passed、PDF live OCR 1 passed、public bundle findings=0、pending OCR 非阻断 SKIP、正式 flag 状态正确、公网移动/企微矩阵 14 passed | `issues/2026-05-17_12-55-49-system-complete-gate.csv`、`artifacts/qa-flow/live-smoke-readiness-20260517-125805/summary.json` |
| LAUNCH-OPS-V1 | 已收口：首周运营保障口径固定；支持人、问题登记、每日巡检、暂停条件、代账交接节奏和可选功能冻结口径已回写手册 | `issues/2026-05-17_12-55-50-launch-ops-v1.csv`、`docs/管理员手册.md`、`docs/员工快速上手.md`、`docs/试运行与自动化验证手册.md` |
## 当前门禁
@@ -97,6 +101,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
| LAUNCH-DEPLOY-FINANCE 部署与公网复检 | 通过，最终关闭付款批次 | 本地业务流 auth/reimbursement/approval/leave/procurement/governance 通过，本地 PC/移动/企业微信矩阵通过；部署 commit `ab5ab4d`，`SYNC_ENV=0`，新增 migration `20260517090437_cashier_payment_receipts` 已应用，公网 readiness/PDF live OCR 通过，公网移动/企微矩阵通过；CASHV 短窗口验证无回单执行 409、回单上传/下载、付款 executed、报销 paid、票据 archived、AP 台账 paid、AP 导出 200 和审计可查；最终 `payment_batch_v1=flag_force_off`。 |
| FIN-PROD-ENABLE 付款批次正式常开 | 通过，未重新部署，最终开启付款批次 | 新增 QA-only `run-fin-prod-enable-window.sh` 和 Playwright force-on 模式；`client` typecheck/build 通过；公网 pre flag-off PASS 后完成 FINPROD 付款闭环，`BX-20260517-0026` paid、票据 archived、AP 台账 paid、无回单执行 409、回单下载 200、AP 导出 200、关键审计可查；公网移动矩阵 6 passed、企业微信渲染矩阵 8 passed；最终 `payment_batch_v1=force_on`、`erp_sync=force_off`。 |
| ACCOUNTING-HANDOFF-V1 代账交接 | 通过，无需开发一键包 | 现有能力核对：付款批次清单 200，回单附件列表 200，回单下载 200，AP 导出 200，报销导出 200，票据中心导出 200，审计日志导出 200；`docs/管理员手册.md` 已补月度交接 SOP。AP 台账不是银行流水，银行流水和回单原件由出纳从银行侧导出，不导入 OA。 |
| SYSTEM-COMPLETE-GATE 系统完成门禁 | 通过，结论 `GO_TO_USE` | `check-live-smoke-env --strict` PASS；`run-live-smoke-readiness.sh` PASS，报告 `artifacts/qa-flow/live-smoke-readiness-20260517-125805/`；只读 flag 核验 `payment_batch_v1=force_on`、`erp_sync=force_off`；公网移动/企业微信矩阵 14 passed。 |
| LAUNCH-OPS-V1 首周运营保障 | 通过，无新增业务功能 | 管理员手册、员工快速上手和试运行手册已更新正式启用口径；首周问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和 UX8/冻结项处理方式已固定。 |
## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
docs/员工快速上手.md
+4 -1
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 员工快速上手（10 人以下团队版）
**当前状态（2026-05-13 / DCL8）**：R6 已通过，当前公网试运行地址为 `https://oa.hyinda.com`。`ME6-3` 代表性企业微信真机门禁已关闭，MIF7/MIF7T 移动信息架构和真机反馈整改已部署并复检。R7 未真实启动，R7 用户材料仍只是草案；后续真实试运行需要先完成 R7E 自动门禁，并由用户确认参与人、窗口和问题收口节奏。
**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：公网正式地址为 `https://oa.hyinda.com`。系统开发完成门禁结论为 `GO_TO_USE`，当前首批正式能力包括报销、PDF 发票 OCR、审批、请假、采购、通知、移动/企业微信入口、财务台账、付款批次、银行回单附件和代账交接。
## 1. 你每周主要会用到什么
- `Portal`：看公告、我的待办、我的资产、本周周报入口。
@@ -40,6 +40,8 @@
- 请假、补卡、外出、加班、报销、采购、差旅等申请都按 OA 页面提交。
- 批准后的请假会自动反映到团队状态。
- 报销状态仍可在系统内查看，不需要额外问行政。
- 发票/OCR 正式入口保持 PDF-only；图片发票不作为当前正式 OCR 能力，图片只按普通附件处理。
- 如果报销已付款，系统会显示付款状态；银行实际付款由出纳在线下银行渠道完成。
## 7. 入职 / 离职时你会看到什么
- 入职时会有账号初始化、资产发放、制度确认等事项。
@@ -51,6 +53,7 @@
- 状态有变化时及时更新 `团队`
- 有通知先看站内消息，IM 只是补充提醒
- 收到企业微信审批提醒时，点开后回到 OA 页面处理。
- 首周遇到问题时，记录角色、页面、操作步骤和影响，不要在截图或文字里包含密码、完整票面、银行回单或敏感报价。
## 9. 从企业微信进入
- 如果公司启用了企业微信工作台入口，优先从企业微信打开海音达工作台。
docs/文档事实源状态矩阵.md
+5 -3
查看文件
@@ -52,6 +52,8 @@
| `LAUNCH-DEPLOY-FINANCE` | `issues/2026-05-17_09-38-55-launch-deploy-finance.csv` | `EVIDENCE` | CASHV 部署与公网复检已收口；本地全流程/页面门禁、受控部署、migration 应用、公网 readiness、PDF live OCR、移动/企微矩阵和 CASHV 短窗口均通过；最终 `payment_batch_v1=flag_force_off` |
| `FIN-PROD-ENABLE` | `issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv` | `EVIDENCE` | 公网付款批次正式常开已收口；测试报销 `BX-20260517-0026` 完成付款闭环、AP 导出、审计和移动/企微矩阵，最终 `payment_batch_v1=force_on`、`erp_sync=force_off` |
| `ACCOUNTING-HANDOFF-V1` | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv` | `EVIDENCE` | 月度代账交接 SOP 已收口；OA 侧导出和回单附件清单可用，银行流水和回单原件由出纳从银行侧导出，不导入 OA |
| `SYSTEM-COMPLETE-GATE` | `issues/2026-05-17_12-55-49-system-complete-gate.csv` | `EVIDENCE` | 系统开发完成门禁已收口；公网 readiness、live smoke、PDF live OCR、flag 状态、移动/企微矩阵和事实源核对通过，结论 `GO_TO_USE` |
| `LAUNCH-OPS-V1` | `issues/2026-05-17_12-55-50-launch-ops-v1.csv` | `EVIDENCE` | 首周正式使用运营保障已收口；支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账交接节奏和冻结项口径已固定 |
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
@@ -59,8 +61,8 @@
| Doc_ID | Path | Category | Authority | Status | Owner | Related_Issues | Evidence | Supersedes | Last_Audited | Audit_Method | Risk | Notes |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1` | `rg` | none | 2026-05-17 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1` | `audit-docs` | none | 2026-05-17 | `audit-docs --check-registry` | medium | 判断文档权威性 |
| `IDX` | `docs/文档索引.md` | 入口索引 | 最高文档入口 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1` | `rg` | none | 2026-05-17 | `node scripts/qa/audit-docs.mjs --check-registry` | medium | 判断当前该读什么 |
| `REG` | `docs/文档事实源状态矩阵.md` | 文档台账 | 文档分类和状态事实源 | `CURRENT` | product/dev | `GOV8,QAOPS9,P2D,P2-ORG,P2-FIN-DECISION,P2-FIN-V1,P2-OCR-SAMPLE,P2Q,P2AUTO,P2AF,P2-FIN-LIVE-DECISION,P2-FIN-LIVE,PRELAUNCH,CASHIER-VOUCHER-V1,LAUNCH-DEPLOY-FINANCE,FIN-PROD-ENABLE,ACCOUNTING-HANDOFF-V1,SYSTEM-COMPLETE-GATE,LAUNCH-OPS-V1` | `audit-docs` | none | 2026-05-17 | `audit-docs --check-registry` | medium | 判断文档权威性 |
| `PRD-MVP` | `docs/海音达OA-MVP需求规格说明书.md` | 需求事实源 | PRD 主事实源 | `CURRENT` | product | `REQ8,P2T,GOV8` | Issue CSV | `docs/requirements-specification.md` | 2026-05-13 | `rg` | high | 定义做什么、不做什么和验收口径 |
| `PRODUCT-SCOPE` | `docs/产品口径.md` | 需求事实源 | 产品边界事实源 | `CURRENT` | product | `REQ8,P2T` | `rg` | none | 2026-05-13 | `rg` | high | 记录已拍板产品边界 |
| `DESIGN-UI` | `docs/产品设计规则.md` | 设计事实源 | PC/移动/企业微信设计事实源 | `CURRENT` | design/frontend | `MIA7,MIF7,GOV8,DG8,DG9` | Playwright/视觉审查/DG8/DG9 | none | 2026-05-13 | `rg` | high | 页面改动必须读取；DG8 后飞书为主 UI/布局参考；DG9 后按页面分层和样板选型 |
@@ -165,4 +167,4 @@
- `ME6-3` 代表性企业微信真机门禁已关闭。
- MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开和 ACCOUNTING-HANDOFF-V1 代账交接 SOP 均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；当前公网 `payment_batch_v1=force_on`，`erp_sync=force_off`，正式支付接口、ERP、图片 OCR 和银行流水导入继续冻结。
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件、LAUNCH-DEPLOY-FINANCE 部署复检、FIN-PROD-ENABLE 正式常开、ACCOUNTING-HANDOFF-V1 代账交接 SOP、SYSTEM-COMPLETE-GATE 系统完成门禁和 LAUNCH-OPS-V1 首周运营保障均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；当前公网 `payment_batch_v1=force_on`，`erp_sync=force_off`，正式支付接口、ERP、图片 OCR 和银行流水导入继续冻结。
docs/文档索引.md
+5 -1
查看文件
@@ -20,7 +20,7 @@
## 最近事实源链
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 -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1。
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 -> CASHIER-VOUCHER-V1 -> LAUNCH-DEPLOY-FINANCE -> FIN-PROD-ENABLE -> ACCOUNTING-HANDOFF-V1 -> SYSTEM-COMPLETE-GATE -> LAUNCH-OPS-V1。
- R6、PC6、PA6、FL6、AP6、RI6、LP6 已完成并部署。
- ME6 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
@@ -46,6 +46,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
- LAUNCH-DEPLOY-FINANCE 是 CASHIER-VOUCHER-V1 后的部署与公网复检合同：先完成本地基础门禁、业务流、PC/移动/企业微信页面矩阵，再以 `SYNC_ENV=0` 部署到 `https://oa.hyinda.com`；新增银行回单附件 migration 已应用，公网 readiness、PDF live OCR、移动/企业微信矩阵和 CASHV 短窗口均通过，最终 `payment_batch_v1=flag_force_off`，正式常开仍需 `FIN-PROD-ENABLE`。
- FIN-PROD-ENABLE 是公网付款批次正式常开合同：未重新部署业务代码；新增 QA-only 正式启用 runner 后完成公网正式验收，测试报销 `BX-20260517-0026` 完成审批、付款批次创建/复核、无回单执行阻断、回单上传/下载、付款执行、AP 导出和审计核验；公网移动矩阵 6 passed、企业微信渲染矩阵 8 passed；最终 `payment_batch_v1=force_on`，`erp_sync=force_off`。
- ACCOUNTING-HANDOFF-V1 是月度代账交接 SOP 合同：公司无 ERP/独立财务系统，OA 侧交接资料固定为 AP 台账、报销导出、票据中心导出、付款批次/回单附件清单和审计日志；银行侧流水和回单原件由出纳从银行渠道导出交给代账人工核对，不导入 OA，不开发一键 zip 包。
- SYSTEM-COMPLETE-GATE 是系统开发完成收口合同：公网 readiness、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企业微信矩阵和文档事实源均通过；结论 `GO_TO_USE`，系统按首批正式能力可交付使用。
- LAUNCH-OPS-V1 是正式使用首周运营保障合同：固定 `wangshunli` 为上线拍板、管理员复核和回滚决策人，`wangzhiling` 为出纳/付款执行和代账资料准备人；首周问题登记、每日巡检、暂停条件、代账交接节奏和可选功能冻结口径已回写现有手册。
## 当前活跃治理流
@@ -78,6 +80,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
| `LAUNCH-DEPLOY-FINANCE` | `issues/2026-05-17_09-38-55-launch-deploy-finance.csv` | 已收口：CASHV 部署与公网复检完成，最终 `payment_batch_v1=flag_force_off` | 本地全流程/页面门禁、受控部署、migration 应用、公网 readiness、PDF live OCR、移动/企微矩阵、CASHV 公网短窗口 | 不正式常开付款批次、不接真实支付、不接 ERP、不开放图片 OCR、不重置数据库 |
| `FIN-PROD-ENABLE` | `issues/2026-05-17_11-40-47-fin-prod-enable-payment-batch.csv` | 已收口：公网付款批次正式启用完成，最终 `payment_batch_v1=force_on` | 公网正式启用 runner、测试报销 `BX-20260517-0026`、银行回单附件、AP 导出、审计、移动/企微矩阵、最终 flag-on 证据 | 不重新部署、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水 |
| `ACCOUNTING-HANDOFF-V1` | `issues/2026-05-17_11-40-48-accounting-handoff-v1.csv` | 已收口：月度代账交接 SOP 固化 | OA 侧 AP/报销/票据/付款批次/回单附件/审计资料清单，银行侧流水和回单原件由出纳线下导出，代账人工核对 | 不开发银行流水导入、不开发一键 zip 包、不保存真实银行资料到仓库 |
| `SYSTEM-COMPLETE-GATE` | `issues/2026-05-17_12-55-49-system-complete-gate.csv` | 已收口：系统开发完成门禁通过，结论 `GO_TO_USE` | 公网 `/ready`、public bundle、live smoke、PDF live OCR、正式 flag 状态、FINPROD/ACCTH 证据、移动/企微矩阵和文档事实源 | 不新增业务功能、不部署、不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水 |
| `LAUNCH-OPS-V1` | `issues/2026-05-17_12-55-50-launch-ops-v1.csv` | 已收口：首周运营保障口径固定 | 首周支持人、问题登记、每日巡检、暂停条件、回滚联系人、代账月度交接节奏、UX8 真实反馈池和冻结项 | 不做真实恢复演练、不重置数据库、不主动开发可选功能 |
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
docs/管理员手册.md
+45 -2
查看文件
@@ -1,6 +1,6 @@
# hyb-oa 管理员手册（10 人以下团队版）
**当前状态（2026-05-17 / FINPROD）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1 和 LAUNCH-DEPLOY-FINANCE 均已收口；银行回单附件能力已部署到公网。FIN-PROD-ENABLE 已完成公网正式启用验收，`payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：R7E、PRELAUNCH、CASHIER-VOUCHER-V1、LAUNCH-DEPLOY-FINANCE、FIN-PROD-ENABLE 和 ACCOUNTING-HANDOFF-V1 均已收口；SYSTEM-COMPLETE-GATE 结论为 `GO_TO_USE`。公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。公司当前无 ERP/独立财务系统，财务闭环以 OA 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
## 1. 适用范围
- 适用于 `small_team_internal` 工作区模式。
@@ -195,6 +195,49 @@ ORDER BY e.employee_no;
- 代账如发现金额、收款方、日期或票据状态不一致，先回查 OA 报销单、付款批次、银行回单和审计日志，再决定是否由出纳补充说明。
- 若代账方后续要求一键交接包，再另建开发合同，明确包内文件、权限、脱敏、审计和下载回滚规则。
### 3.3 首周正式使用运营
首周支持分工：
| 职责 | 负责人 | 处理范围 |
| --- | --- | --- |
| 上线拍板和回滚决策 | `wangshunli` | 判断继续、暂停、回滚或另建修复合同 |
| 管理员复核 | `wangshunli` | 付款批次复核、权限和审计核查 |
| 出纳/付款执行 | `wangzhiling` | 银行对公付款、回单上传、付款标记和代账资料准备 |
| 问题登记 | `wangshunli` | 汇总问题、分级、每日收口和结论回写 |
首周每日巡检：
1. 访问 `https://oa.hyinda.com/ready`，确认公网健康。
2. 用管理员和普通员工各登录一次，确认 PC 和移动入口可达。
3. 抽查审批待办、报销/PDF OCR、请假、采购、通知和企业微信入口。
4. 抽查 `payment_batch_v1` 仍为开启、`erp_sync` 仍为关闭。
5. 出纳查看待付款、付款批次、银行回单附件和 AP 台账导出。
6. 管理员查看审计日志中是否有异常导出、权限拒绝或付款动作。
7. 记录当天新增问题、影响等级、处理人、结论和是否需要暂停。
问题登记最小字段：
| 字段 | 说明 |
| --- | --- |
| 时间 | 发现时间，精确到日内即可 |
| 角色/账号 | 员工、审批人、财务、管理员或企业微信入口 |
| 页面/入口 | PC、移动、企业微信、付款批次、报销、审批等 |
| 复现步骤 | 只写必要步骤，不记录密码、token、银行回单原件或完整票面 |
| 影响等级 | 阻断、高、中、低 |
| 处理结论 | 已解释、已修复、待修复、暂停、另建 Issue |
暂停条件：
- 无法登录、无法进入企业微信工作台或公网 `/ready` 异常。
- 无法提交或审批报销、请假、采购任一主流程。
- 付款批次状态错误、回单附件丢失、AP 导出异常或审计缺失。
- 员工、审批人、出纳、管理员出现越权访问。
- `payment_batch_v1` 意外关闭，或 `erp_sync`、图片 OCR、真实支付、银行流水导入被误开启。
- 同一天出现多个高优先级问题且无法解释清楚。
首周不主动新增可选功能。UX8 只接真实反馈或自动化确定性失败；移动采购创建、通知扩展、合同/供应商/资产、图片 OCR、ERP、真实支付、银行流水导入、复杂 BPM、审批设计器和重预算都必须另建独立合同。
## 4. 人员生命周期管理
### 4.1 入职
1. 在 `人员管理` 创建员工账号。
@@ -257,7 +300,7 @@ ORDER BY e.employee_no;
- 至少 1 条请假或补卡完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。
- 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
- P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
- 上线前完成 1 次 DB + 文件存储备份和恢复演练，并记录恢复后的 `/ready` 结果
- 正式使用前至少完成一次备份可用性核对；真实恢复演练必须另建批准合同，并记录恢复后的 `/ready` 结果。
- 普通员工主导航不出现预算、AP、ERP、AI、完整差旅等当前首批不开放的备用模块。
## 11. 4 周观测操作法
docs/试运行与自动化验证手册.md
+26 -1
查看文件
@@ -2,7 +2,7 @@
**文档状态**：当前操作手册，用于本地、公网、企业微信和真实 OCR 试运行验证。
**当前状态（2026-05-13 / MIF7TD）**：R6 已通过；`ME6-3` 已由 iPhone 12、iPhone 14、Redmi K60 企业微信代表性真机主流程反馈关闭；MIF7/MIF7T 已完成本地整改、公网部署、公网匿名复检、真机反馈和带凭据 live smoke/OCR 复检。R7 未真实启动，R7/OPS7/DOC7 仍只是准备材料，不代表已启动或已上线。后续新增移动或企业微信门禁仍必须保留真机证据，自动化、公网视觉矩阵和 live smoke 不能替代未来新增真机验收。
**当前状态（2026-05-17 / SYSTEM-COMPLETE-GATE）**：R7E、PRELAUNCH、FIN-PROD-ENABLE、ACCOUNTING-HANDOFF-V1、SYSTEM-COMPLETE-GATE 和 LAUNCH-OPS-V1 均已收口；公网 `payment_batch_v1=force_on`，`erp_sync=force_off`。当前正式能力保持 PDF-only OCR，不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水。后续新增移动或企业微信门禁仍必须保留真机证据，自动化、公网视觉矩阵和 live smoke 不能替代未来新增真机验收。
本文用于 hyb-oa 本地、企业微信和公网试运行。默认策略是：能自动化的先自动化，自动化无法覆盖的才请求人工配合。
@@ -120,6 +120,31 @@ node scripts/qa/check-live-smoke-env.mjs
LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
```
### SYSTEM-COMPLETE-GATE 完成门禁
系统开发完成收口采用以下最小门禁：
```bash
set -a && source ~/.hyb-oa/live-smoke.env && set +a
LIVE_SMOKE_BASE_URL=https://oa.hyinda.com node scripts/qa/check-live-smoke-env.mjs --strict
QA_ISSUE_ID=SCG LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readiness.sh
cd client && E2E_BASE_URL=https://oa.hyinda.com npx playwright test tests/e2e/dg7-mobile-information-dedupe.spec.ts tests/e2e/r124-mobile-entry-matrix.spec.ts tests/e2e/r6-wecom-mobile-rendering-hardening.spec.ts --workers=1 --reporter=list
```
完成门禁只核验系统可正式使用，不扩展功能边界。`payment_batch_v1` 应保持 `force_on`，`erp_sync` 应保持 `force_off`。图片发票 OCR、真实支付接口、ERP 实时凭证、银行流水导入、复杂 BPM、审批设计器和重预算控制继续冻结。
### LAUNCH-OPS-V1 首周运营检查
正式使用首周每日检查：
- 公网 `/ready`、PC 登录、移动/企业微信入口。
- 报销/PDF OCR、审批、请假、采购、通知、付款批次、AP 导出和审计日志。
- `payment_batch_v1` 未意外关闭，`erp_sync` 未意外开启。
- 出纳上传银行回单后再执行 OA 已付款标记；银行流水和回单原件由出纳从银行侧导出给代账，不导入 OA。
- 当天问题按时间、角色、页面、步骤、影响等级和处理结论登记。
无法登录、无法审批、无法提交核心单据、付款状态错误、权限越权、`/ready` 异常或冻结项被误开启时，结论应为 Pause，并另建最小修复 Issue；不得用重置数据库或生产恢复临时绕过。
发布候选进入公网或小范围试运行前，先按 [`docs/trialrun/发布试运行准备清单.md`](trialrun/发布试运行准备清单.md) 完成证据整理、权限直连审计、部署预检、live smoke 和试运行分级。
系统应避免让已绑定用户反复登录。若手机企业微信能进入但仍要求登录，优先检查：