120 行
8.2 KiB
Markdown
120 行
8.2 KiB
Markdown
# R70 人工业务试运行报告
|
||
|
||
日期：2026-04-28
|
||
|
||
## 结论
|
||
|
||
R70 初次试运行暂停项已在 2026-04-28 的 R71 定向修复后关闭。基于本地环境复测，经理团队日历与员工报销缺票提示/发票上传绑定提交链路均已通过，可恢复下一轮本地人工试运行。
|
||
|
||
## 执行环境
|
||
|
||
- 环境 URL：`http://192.168.123.7:3000`
|
||
- 分支/提交：`2bce9c9 + local R71 working tree`
|
||
- 浏览器：`Firefox (Playwright CLI)`
|
||
- 执行人：`Codex Playwright 辅助复核`
|
||
- 执行时间：`2026-04-28 17:22 - 19:11 CST`
|
||
- 数据库：`hyb_oa_manual_trialrun_20260428172231`
|
||
|
||
## 角色结果
|
||
|
||
员工路径：
|
||
|
||
- 执行人：`Codex Playwright 辅助复核`
|
||
- 结论：Portal、请假、周报、待办、搜索、公告、移动入口主路径可达；R71 后报销缺票提示清晰，上传/绑定发票后可提交进入审批中。
|
||
- 阻断问题：无。
|
||
- 备注：员工请假提交成功，经理已审批通过；周报转待办并完成闭环通过；报销复测使用单据 `4931211b-34b4-43b8-9e9f-917569d47c33` 和发票 `北京悦海堂餐饮管理有限公司_发票金额1683.00元.pdf`，提交后单号为 `BX-20260428-0001`。
|
||
|
||
经理路径：
|
||
|
||
- 执行人：`Codex Playwright 辅助复核`
|
||
- 结论：Portal 管理视角、待我处理快捷审批、团队状态、项目入口与请假团队日历均可用。
|
||
- 阻断问题：无。
|
||
- 备注：经理已对员工请假单完成一次“通过”审批，审批后待办列表刷新正常；R71 复测中团队日历成功显示 `2026-04-27 ~ 2026-05-03` 窗口及员工 `2026-04-29` 年假记录。
|
||
|
||
管理员路径：
|
||
|
||
- 执行人：`Codex Playwright 辅助复核`
|
||
- 结论：主要管理入口可见且页面可达，未发现阻断问题。
|
||
- 阻断问题：无。
|
||
- 备注：人员管理、组织架构、系统设置、功能开关、审计日志均可打开并加载；审计日志可看到最近登录留痕。
|
||
|
||
## 问题汇总
|
||
|
||
- 当前开放问题：P0/P1/P2/P3 均为 0。
|
||
- 已闭环问题：`R70-001`、`R70-002` 已通过 R71 定向修复与人工复测关闭。
|
||
|
||
详细问题见 `artifacts/r70/issue-log.csv`。
|
||
|
||
## R71 处理结果
|
||
|
||
- P1 修复：server manager 角色已补齐 `leave.view_all`，reviewer 复核确认未扩成 `leave.manage`，经理团队日历路径复测通过。
|
||
- P2 修复：前端已在提交前提示“需先绑定至少 1 张发票”，并为 `bound_invoice_required` 增加可理解中文文案。
|
||
- 联动修复：人工复核中补修 `/api/invoice-pool/upload` 的 multipart 文件流挂起问题，上传 -> 绑定 -> 提交报销链路已通过。
|
||
- 技术遗留：client build 仍有 chunk 循环与大 chunk 警告，建议独立进入 R72 技术优化项，不阻断本地人工试运行。
|
||
|
||
## 风险
|
||
|
||
- 人工试运行依赖参与者真实操作，自动化通过不等于业务体验通过。
|
||
- 当前结论基于本地临时库、HTTP 本地地址和 Firefox 浏览器复核，不代表企业微信接入、HTTPS 和多用户并发场景都已验证。
|
||
- 若发现 workflow、权限、状态机、审批规则、迁移相关问题，必须单独 review 后再修复。
|
||
|
||
## R73 本地辅助复核补充
|
||
|
||
- 真实腾讯 OCR：已通过 `client/tests/e2e/manual/live-invoice-ocr.spec.ts` 本地辅助复核，测试票据为 `/home/shunli/Projects/hyb-oa/artifacts/北京悦海堂餐饮管理有限公司_发票金额1683.00元.pdf`。
|
||
- 运行方式：server 进程在本地 `3001` 端口以运行时注入方式加载旧项目本地腾讯配置；密钥未写入本仓库 `server/.env`。
|
||
- 自动巡检：`client/tests/e2e/manual/r70-trialrun-assist.spec.ts` 在补齐本地运行时开关后，员工 / 经理 / 管理员 10 个辅助步骤全部通过。
|
||
- 环境结论：本地试运行如果出现 Portal、周报、公告、团队、人员管理等入口缺失，先检查 server 运行时 `*_ENABLED` 开关是否齐全；本次已确认数据库开关与工作区配置本身无异常。
|
||
|
||
## R74 自动化压榨补充
|
||
|
||
- 本地门禁：`server/src/scripts/smoke-trialrun-runtime.js` 已支持 `TRIALRUN_RUNTIME_MODE=local`，并在本地 HTTP 口径下校验 env、feature flag、workspace setting 与导航基线，通过。
|
||
- 深层真实业务辅助回归：`client/tests/e2e/manual/r70-trialrun-deep-assist.spec.ts` 已通过，覆盖：
|
||
- 周报保存 -> 生成待办 -> 提交 -> 完成待办
|
||
- 公告发布 -> 员工可见 -> 团队状态更新 -> Portal 汇总可见
|
||
- 真实全局搜索命中公告并跳转
|
||
- 批量真实腾讯 OCR 辅助回归：`client/tests/e2e/manual/live-invoice-ocr-batch.spec.ts` 已落地并在干净本地 trialrun DB `hyb_oa_manual_trialrun_20260429093000` 上完成真实 PDF 发票成功识别，结果已回填到 `artifacts/r70/live-ocr-batch-report.md`。
|
||
- 当前 OCR 环境结论：旧项目 `/home/shunli/shenzhou-business-suite/.env` 中一组腾讯凭证已在当前应用链路验证可用；R77 已补齐 PDF 模式下的 `IsPdf=true` / `PdfPageNumber=1` 调用与返回字段归一化，OCR 识别主链路已闭环，不再存在先前的鉴权/解码失败阻塞。
|
||
|
||
## R77 OCR 收口补充
|
||
|
||
- 复测时间：`2026-04-29 09:51 - 09:54 CST`
|
||
- 自动化环境：`http://127.0.0.1:3001`
|
||
- 自动化数据库：`hyb_oa_manual_trialrun_20260429093000`
|
||
- 腾讯配置来源：旧项目 `/home/shunli/shenzhou-business-suite/.env`，仅运行时注入，未写回本仓库。
|
||
- 复测命令：
|
||
- `cd client && PLAYWRIGHT_MANUAL=1 PLAYWRIGHT_OCR_LIVE=1 PLAYWRIGHT_OCR_LIVE_FILE=/home/shunli/Projects/hyb-oa/artifacts/北京悦海堂餐饮管理有限公司_发票金额1683.00元.pdf E2E_BASE_URL=http://127.0.0.1:3001 npx playwright test tests/e2e/manual/live-invoice-ocr.spec.ts --workers=1 --reporter=list`
|
||
- `cd client && PLAYWRIGHT_MANUAL=1 PLAYWRIGHT_OCR_LIVE=1 PLAYWRIGHT_OCR_LIVE_BATCH=1 PLAYWRIGHT_OCR_LIVE_FILE=/home/shunli/Projects/hyb-oa/artifacts/北京悦海堂餐饮管理有限公司_发票金额1683.00元.pdf E2E_BASE_URL=http://127.0.0.1:3001 npx playwright test tests/e2e/manual/live-invoice-ocr-batch.spec.ts --workers=1 --reporter=list`
|
||
- 结果：
|
||
- 单张 live OCR：`1 passed (26.2s)`。
|
||
- batch live OCR：`1 passed (14.1s)`，runner 正常退出。
|
||
- 最新 batch 票据结果：`fb29cdd8-0c10-4254-8feb-d3c3c1be86c3`，销售方 `北京悦海堂餐饮管理有限公司`，总金额 `1683.00`，状态 `available`。
|
||
- 试运行结论：
|
||
- 员工侧报销 / 票据中心 / OCR 主链路 `上传 -> OCR -> available -> 绑定 -> 提交报销` 已具备本地试运行条件。
|
||
- 本轮仍未覆盖真实企微 OAuth、HTTPS cookie secure、多角色并发协同、真实 ERP 外发回执，以及高风险二次复核；这些项继续保留在外部或后续 focused regression。
|
||
|
||
## R78 财务支付尾链 focused regression
|
||
|
||
- 回归时间：`2026-04-29 10:37 - 10:52 CST`
|
||
- 自动化环境：`http://127.0.0.1:3002`
|
||
- 自动化数据库：`hyb_oa_manual_trialrun_20260429093000`
|
||
- 本地 focused 开关：
|
||
- 运行时 env：`PAYMENT_BATCH_ENABLED=true`、`ERP_SYNC_ENABLED=true`
|
||
- DB feature flag：通过 `TRIALRUN_EXTRA_FORCE_ON_FLAGS='payment_batch_v1 erp_sync'` 重复执行 `seed:trialrun` 显式打开，仅用于本地 focused 财务回归，不改变默认 trialrun 上线建议。
|
||
- 回归命令：
|
||
- `cd server && ./scripts/regression-payment-batches.sh`
|
||
- `cd client && E2E_BASE_URL=http://127.0.0.1:3002 npx playwright test tests/e2e/reimbursement-payment-batch-flow.spec.ts --workers=1 --reporter=list`
|
||
- 结果：
|
||
- server focused regression：`3 passed`
|
||
- Playwright focused E2E：`1 passed (58.0s)`
|
||
- 已验证链路：
|
||
- employee：创建空白报销 -> 上传 mock 票据 -> 绑定 -> 提交
|
||
- manager / finance：完成两级审批
|
||
- finance：创建 reimbursement payment batch，并在复核后执行
|
||
- finance_mgr：在 AP 工作台完成快捷复核
|
||
- execute 后：`payment batch = executed`、`reimbursement = paid`、`invoice = archived`
|
||
- ERP preview：可见最新 `pending` outbox
|
||
- reviewer 结论：
|
||
- `paymentBatches` 复核路由仍拦截 maker 自审；低风险批次维持 `finance_mgr` 复核、`finance` 执行的边界。
|
||
- 失败路径单测确认不会错误归档已绑定发票，也不会误入 ERP / 通知 follow-up。
|
||
- `PaymentBatchesPage` 与 `ApOperationsPage` 没有新增越权入口，按钮仍按 `payment.batch.manage` 与 `risk.review.manage` 分离。
|