FINPROD ACCTH 启用付款批次并收口代账交接
这个提交包含在：
@@ -29,6 +29,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
|
||||
- 2026-05-17 PRELAUNCH 已按“系统尚未正式使用”的新前提完成正式启用前公网预回归：公网 `/ready`、public bundle、live smoke、PDF live OCR、远端 Caddy/compose/migration 只读基线、隔离核心业务流、付款批次公网 PRELAUNCH 窗口、公网移动矩阵和企业微信 UA/渲染矩阵均形成证据；公网测试数据均带 `PRELAUNCH` marker。最终 `payment_batch_v1=flag_force_off`，未部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR。浏览器全链路 `all` 中报销 PDF 因样票重复记可解释 `SKIP`，采购分流程功能报告通过但手工 live spec 存在长等待/退出码稳定性缺口，后续作为 QA 自动化维护项。
|
||||
- 2026-05-17 CASHIER-VOUCHER-V1 已按“无 ERP/独立财务系统、只有代账”的新业务前提完成正式启用前财务闭环补强：新增付款批次银行回单附件、复核后补凭证、银行渠道执行前回单阻断和 PC 付款批次详情操作区；业务口径为 `wangzhiling` 出纳执行、`wangshunli` 管理员复核，后续正式流程是 OA 内审批/台账/付款批次 + 银行对公付款回单 + 月度代账交接。CASHV 代码已由 `LAUNCH-DEPLOY-FINANCE` 部署到公网，不接真实支付、不写 ERP、不开放图片 OCR、不导入银行流水；下一步需另建或延续 `FIN-PROD-ENABLE` 和 `ACCOUNTING-HANDOFF-V1` 合同。
|
||||
- 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 包。
|
||||
|
||||
## 关键证据索引
|
||||
|
||||
@@ -65,6 +67,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
|
||||
| PRELAUNCH | 已收口：正式启用前公网预回归完成；公网 readiness/PDF live OCR、远端只读基线、隔离核心业务流、PRELAUNCH 付款批次窗口、公网移动和企业微信渲染矩阵通过；最终 `payment_batch_v1=flag_force_off` | `issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv`、`artifacts/qa-flow/p2-fin-live-20260517-014144/live-result.json`、`artifacts/qa-flow/p2-safe-regression-20260517-014436/summary.json`、`artifacts/prelaunch/browser-business/report.md`、`artifacts/prelaunch/browser-business-purchase-rerun/report.md` |
|
||||
| CASHIER-VOUCHER-V1 | 已收口：正式启用前财务闭环与银行回单附件完成；后端 focused 回归 12 tests passed，前端 typecheck/build 通过，本地隔离 reimbursement 业务域 10 passed/1 skipped，governance 业务域 9 passed；已由 LDF 部署 | `issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv`、`artifacts/qa-flow/business-flow-20260517-091904/summary.txt`、`artifacts/qa-flow/business-flow-20260517-092824/summary.txt` |
|
||||
| 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` |
|
||||
|
||||
## 当前门禁
|
||||
|
||||
@@ -91,6 +95,8 @@ DCL7 已删除本文件中 R70-R91 的长流水历史，避免旧环境、旧开
|
||||
| PRELAUNCH 正式启用前预回归 | 通过，含 QA 稳定性观察项，未部署 | 公网 live readiness PASS，远端 Caddy active、compose db/server Up、Prisma migration up to date；脱敏数据清点 activeEmployees=12、activeWecomBindings=5、pendingWorkflowTasks=7；`run-p2-fin-live-window.sh` PRELAUNCH PASS，测试报销 `BX-20260517-0024` 付款闭环 paid、票据 archived、AP 台账 paid；`run-p2-safe-regression.sh` PASS。浏览器 `all` 长链路中 PDF 样票重复和采购超时按证据分流：采购分流程报告 PASS，本地隔离 procurement PASS，记录为手工 live spec 稳定性维护项，不作为业务 P0/P1 阻断。 |
|
||||
| CASHIER-VOUCHER-V1 财务闭环与银行回单附件 | 通过，已部署 | 新增付款批次回单附件模型/API/PC 操作区，银行渠道执行付款前必须上传回单，复核后仍可补凭证号/付款日期/付款渠道；`prisma validate`、`node --check`、后端 focused 单测、前端 typecheck/build、隔离 reimbursement 业务流和 governance 权限直连业务流均通过；已由 LDF 部署并完成公网 CASHV 短窗口复检。正式启用前仍需设置 `payment_batch_v1=force_on` 并完成代账交接 SOP。 |
|
||||
| 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。 |
|
||||
|
||||
## R7EP / OPS8 / QAF8 / UX8 / P2T 预检推进
|
||||
|
||||
|
||||
+5
-3
@@ -50,6 +50,8 @@
|
||||
| `PRELAUNCH` | `issues/2026-05-17_00-46-49-prelaunch-production-readiness.csv` | `EVIDENCE` | 正式启用前公网预回归已收口；公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信矩阵和 Go/No-Go 摘要完成；最终 `payment_batch_v1=flag_force_off`，未部署 |
|
||||
| `CASHIER-VOUCHER-V1` | `issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv` | `EVIDENCE` | 正式启用前财务闭环与银行回单附件已收口；新增付款批次银行回单附件、复核后补凭证和银行渠道执行前回单阻断；已由 `LAUNCH-DEPLOY-FINANCE` 部署到公网 |
|
||||
| `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 |
|
||||
|
||||
旧 Issue CSV 保留为历史审计证据：不删除、不批量回写、不移动到 `docs/archive/` 或其他归档目录。新连续合同如替代旧合同，只在新合同 `Notes` 或文档索引中说明 supersedes。
|
||||
|
||||
@@ -57,8 +59,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` | `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` | `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` | `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 | 判断文档权威性 |
|
||||
| `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 后按页面分层和样板选型 |
|
||||
@@ -163,4 +165,4 @@
|
||||
|
||||
- `ME6-3` 代表性企业微信真机门禁已关闭。
|
||||
- MIF7-1..7 与 MIF7T 已完成本地整改、公网部署、公网匿名复检和带凭据 live smoke/OCR 复检。
|
||||
- R7E 真实扩大试运行阶段验收、P2 排序、R7E 收口、QAOPS8 上线硬化阶段收口、QAOPS9 上线硬化连续合同、PRELAUNCH 正式启用前公网预回归、CASHIER-VOUCHER-V1 财务闭环与银行回单附件以及 LAUNCH-DEPLOY-FINANCE 部署复检均已完成，当前 P0/P1 阻断为 0；P2D 已完成决策分流，P2-ORG 只读巡检已完成且无需写修复合同；P2-FIN-LIVE、PRELAUNCH 和 LDF 均验证付款批次公网短窗口并回到 `payment_batch_v1=flag_force_off`；后续正式常开付款批次和代账交接 SOP 必须另建或延续对应连续合同。
|
||||
- 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 和银行流水导入继续冻结。
|
||||
|
||||
+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。
|
||||
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 自动化、公网视觉矩阵和 `ME6-3` 代表性企业微信真机门禁已完成。
|
||||
@@ -44,6 +44,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
|
||||
- PRELAUNCH 是未正式使用前的正式启用准备合同：公网作为准生产预启用环境承载带 `PRELAUNCH` marker 的测试数据和自动化回归；公网 readiness、远端只读基线、隔离核心业务流、付款批次 PRELAUNCH 窗口、移动/企业微信自动化和 Go/No-Go 摘要已完成。最终 `payment_batch_v1=flag_force_off`，未部署、不接真实支付、不写 ERP 实时凭证、不开放图片 OCR；采购公网手工 live spec 长等待/退出码问题作为 QA 自动化稳定性维护项。
|
||||
- CASHIER-VOUCHER-V1 是正式启用前财务闭环与代账交接第一轮实现合同：基于“无 ERP/独立财务系统、只有代账”的业务事实，将付款闭环固定为 OA 内审批/台账/付款批次 + 银行对公付款回单附件 + 月度代账交接；已新增批次级银行回单附件模型/API/PC 操作区、复核后补凭证和银行渠道执行前回单阻断，代码已由 `LAUNCH-DEPLOY-FINANCE` 部署到公网，不接真实支付、不写 ERP、不开放图片 OCR、不导入银行流水。
|
||||
- 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 包。
|
||||
|
||||
## 当前活跃治理流
|
||||
|
||||
@@ -74,6 +76,8 @@ R6 -> PC6 -> PA6 -> FL6 -> AP6 -> RI6 -> LP6 -> ME6/QG6 -> DG7/MRF7 -> MIA7 -> M
|
||||
| `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 |
|
||||
| `CASHIER-VOUCHER-V1` | `issues/2026-05-17_09-04-37-cashier-payment-voucher-v1.csv` | 已收口：正式启用前财务闭环与银行回单附件完成，已由 LDF 部署 | 付款批次银行回单附件、复核后补凭证、银行渠道执行前回单阻断、管理员复核审计、出纳执行、代账交接前置 | 不接真实支付、不接 ERP、不开放图片 OCR、不导入银行流水 |
|
||||
| `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 包、不保存真实银行资料到仓库 |
|
||||
|
||||
旧 Issue CSV 不删除、不批量回写、不移动到归档目录。若新治理流替代旧合同，只在新 CSV 的 `Notes` 或本索引说明 supersedes，旧文件保留历史审计语义。
|
||||
|
||||
|
||||
+43
-8
@@ -1,6 +1,6 @@
|
||||
# hyb-oa 管理员手册（10 人以下团队版）
|
||||
|
||||
**当前状态（2026-05-13 / DCL8）**：R6 已通过，PC6、PA6、FL6、AP6、RI6、LP6、ME6、QG6、DG7/MRF7、MIA7、MIF7/MIF7T 和 MIF7TD 已完成相应收口；`ME6-3` 代表性企业微信真机门禁已关闭。R7 未真实启动，R7/OPS7/DOC7 仍只是准备材料，不代表已启动或已上线；下一步先做 R7E 自动门禁和参与人/窗口确认。
|
||||
**当前状态（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 内审批、台账、付款批次、银行对公付款回单和月度代账交接为准。
|
||||
|
||||
## 1. 适用范围
|
||||
- 适用于 `small_team_internal` 工作区模式。
|
||||
@@ -15,16 +15,16 @@
|
||||
## 3. 首次上线最小配置
|
||||
1. 进入 `工作区设置`，确认产品模式为 `small_team_internal`。
|
||||
2. 首批主路径优先保留：`Portal`、`审批待办`、`报销`、`票据/OCR`、`请假`、`项目`、`采购/费用`、`合同/附件`。
|
||||
3. `团队状态`、`周报`、`待办`、`公告`、`人员`、`资产` 可按真实试运行需要开启；`预算`、`支付批次`、`AP 运营`、`ERP`、`AI`、完整差旅能力默认作为管理员备用或历史能力，不作为当前 MVP 首批主线。
|
||||
3. `团队状态`、`周报`、`待办`、`公告`、`人员`、`资产` 可按真实试运行需要开启；`支付批次` 和 `AP 运营` 已作为财务闭环正式能力面向出纳、财务和管理员开放，普通员工不显示该入口；`预算`、`ERP`、`AI`、完整差旅能力仍作为备用或历史能力。
|
||||
4. 在 `用户管理` 中按推荐预设配置：老板 / 管理员 / 主管 / 员工。
|
||||
- 正式审批组织口径：`majianyong` 配置为员工可见直属主管和 `manager`；`wangshunli` 配置为后台公司负责人 `ceo + admin`，不配置为普通 `manager`。
|
||||
- 普通员工和专用测试员工的直属主管配置为 `majianyong`；`majianyong` 的直属领导配置为 `wangshunli`。
|
||||
- `admin` 只代表系统管理权限，不代表业务审批权；需要业务审批时必须配置 `manager`、`ceo`、`finance`、`hr` 等正式业务角色。
|
||||
- 缺直属主管、主管停用、主管链断裂或审批节点解析到申请人本人时，应先修正组织或审批规则，不要用管理员账号代批。
|
||||
5. 检查功能开关：
|
||||
- 建议开启：`portal_home_v1`、企业微信入口相关开关、报销/OCR、审批待办、请假和项目基础能力。
|
||||
- 建议开启：`portal_home_v1`、企业微信入口相关开关、报销/OCR、审批待办、请假、项目基础能力和 `payment_batch_v1`。
|
||||
- 按需开启：`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`。
|
||||
- 建议保留备用：`payment_batch_v1`、`cutover_console_v1`、预算/AP/ERP/AI 相关开关。
|
||||
- 建议保留备用：`cutover_console_v1`、预算、ERP、AI 和完整差旅相关开关。
|
||||
|
||||
### 3.1 ORG8 组织账号与角色边界
|
||||
|
||||
@@ -163,6 +163,38 @@ WHERE e.status = 'active'
|
||||
ORDER BY e.employee_no;
|
||||
```
|
||||
|
||||
### 3.2 正式财务闭环与代账交接
|
||||
|
||||
公司当前没有 ERP 或独立财务系统，OA 不生成 ERP 实时凭证，也不接真实支付接口。正式财务闭环如下：
|
||||
|
||||
1. 员工在 OA 提交报销，发票/OCR 正式入口保持 PDF-only，图片只作为普通附件。
|
||||
2. 直属主管、财务或负责人按审批规则在 OA 内完成审批。
|
||||
3. `wangzhiling` 作为出纳，在付款批次中创建待付款批次，按批次准备对公银行付款。
|
||||
4. `wangshunli` 以管理员身份复核付款批次；管理员复核是当前明确业务选择，系统保留 maker-checker 和审计记录。
|
||||
5. 出纳在 OA 外通过网银或银行渠道付款，然后在付款批次详情上传银行回单附件，补齐凭证号、付款日期和付款渠道。
|
||||
6. 出纳执行 OA 已付款标记；系统将报销单置为 `paid`，票据归档为 `archived`，AP 台账变为已付款状态。
|
||||
|
||||
银行渠道付款必须至少有一份银行回单附件后才能在 OA 内执行付款标记。回单附件支持 PDF、JPG、PNG、WEBP，作为批次级付款证据保存；导出和报告中不复制回单原件内容。
|
||||
|
||||
月度代账交接按以下清单执行：
|
||||
|
||||
| 资料 | 来源 | 负责人 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| AP 台账导出 | OA `AP 运营` | 出纳/财务 | 用于核对已付款、待付款和异常项；AP 台账不是银行流水 |
|
||||
| 报销导出 | OA 报销导出 | 出纳/财务 | 按月导出，必要时筛选已通过或已付款状态 |
|
||||
| 票据中心导出 | OA 票据/OCR | 出纳/财务 | 用于核对 PDF 发票识别、绑定和归档状态 |
|
||||
| 付款批次清单 | OA `付款批次` | 出纳/财务 | 记录批次、复核、执行和对应报销单 |
|
||||
| 银行回单附件清单 | OA 付款批次详情 | 出纳 | 只交接清单和必要回单原件，不把真实回单提交到代码仓库 |
|
||||
| 审计日志导出 | OA 审计日志 | 管理员 | 覆盖导出、付款批次创建、复核、回单上传和执行动作 |
|
||||
| 银行流水和回单原件 | 网银或银行渠道 | 出纳 | 由出纳从银行侧导出，交给代账人工核对；不导入 OA |
|
||||
|
||||
交接建议：
|
||||
|
||||
- 每月固定一个交接目录或压缩包，由出纳线下维护，命名建议为 `YYYY-MM-海音达-代账交接`。
|
||||
- OA 导出文件、银行流水、银行回单原件和异常说明分目录保存；仓库只记录流程和脱敏证据，不保存正式财务资料。
|
||||
- 代账如发现金额、收款方、日期或票据状态不一致，先回查 OA 报销单、付款批次、银行回单和审计日志，再决定是否由出纳补充说明。
|
||||
- 若代账方后续要求一键交接包，再另建开发合同，明确包内文件、权限、脱敏、审计和下载回滚规则。
|
||||
|
||||
## 4. 人员生命周期管理
|
||||
### 4.1 入职
|
||||
1. 在 `人员管理` 创建员工账号。
|
||||
@@ -205,20 +237,23 @@ ORDER BY e.employee_no;
|
||||
|
||||
## 8. 备用模块治理
|
||||
- 采购/费用、合同/附件和项目轻管理属于 P1 轻量能力，可在 P0 审批、报销/OCR、请假和企业微信入口稳定后逐步开放。
|
||||
- 预算、支付批次、AP 运营、ERP、AI、完整差旅、资产深度管理等保留代码和历史数据，但不作为当前 MVP 首批主路径。
|
||||
- 支付批次和 AP 运营已作为正式财务闭环开放给出纳、财务和管理员；普通员工仍不显示财务运营入口。
|
||||
- 预算、ERP、AI、完整差旅、资产深度管理等保留代码和历史数据，但不作为当前 MVP 首批主路径。
|
||||
- 若短期完全不用，保持管理员可见即可，不必删除。
|
||||
- 只有出现真实场景时，再恢复到主导航或单独扩展。
|
||||
|
||||
## 9. 推荐上线顺序
|
||||
1. 先完成账号、角色、部门、企业微信自建应用入口和账号密码回退路径。
|
||||
2. 再启用 `OA 统一审批中心 + 报销/发票/OCR/附件`，跑通提交、审批、退回、查重、付款和导出闭环。
|
||||
3. 同步启用 `请假/补卡/外出/加班`，明确企业微信打卡只是原始采集，正式考勤解释回到 OA 审批结果。
|
||||
4. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
|
||||
5. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、支付、ERP、AI 和完整差旅。
|
||||
3. 同步启用付款批次、AP 台账和银行回单附件，付款动作仍由出纳在 OA 外通过银行渠道完成。
|
||||
4. 同步启用 `请假/补卡/外出/加班`，明确企业微信打卡只是原始采集，正式考勤解释回到 OA 审批结果。
|
||||
5. 在 P0 稳定后开放 P1：`采购/费用审批`、`合同/附件归档`、`项目轻管理`。
|
||||
6. 最后按真实需要评估周报、团队状态、公告、人员生命周期、资产、预算、ERP、AI 和完整差旅。
|
||||
|
||||
## 10. 试点验收口径
|
||||
- 全员都能账号密码登录；已绑定员工能从企业微信 `海音达工作台` 进入移动工作台。
|
||||
- 至少 1 笔报销完成：上传发票或附件 -> OCR/查重 -> 提交 -> OA 审批 -> 财务复核/付款标记 -> 导出。
|
||||
- 至少 1 个付款批次完成：出纳创建 -> 管理员复核 -> 出纳上传银行回单 -> 执行 OA 已付款标记 -> AP 台账和审计可查。
|
||||
- 至少 1 条请假或补卡完成：员工提交 -> OA 审批 -> 团队状态或考勤解释口径不破坏。
|
||||
- 至少 1 个审批待办从企业微信提醒 deeplink 回到 OA 页面处理。
|
||||
- P1 试点时，至少 1 条采购/费用申请、1 条合同台账、1 个项目关联事项可创建、审批或归档。
|
||||
|
||||
在新工单中引用
屏蔽一个用户