hyb-oa/issues/2026-05-05_22-48-01-r93-live-ocr-mobile-polish.csv

ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes
A1,R93 执行合同冻结,"把公网真实腾讯 OCR 已通后的剩余问题收敛为本轮范围：live OCR 自动化假失败、手机票据中心显示挤压、试运行 OCR 配置留痕。","Issue CSV 字段完整并通过校验；本轮不扩展到新业务模块、不调整 OCR 业务状态机。","命令：`python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-05_22-48-01-r93-live-ocr-mobile-polish.csv`。业务：确认本轮只处理真实 OCR 验证稳定性、手机票据中心可读可操作、部署运行手册。",manual,DONE,DONE,DONE,issues/2026-05-05_22-48-01-r93-live-ocr-mobile-polish.csv,[],2026-05-05：CSV 已创建并通过校验；不涉及运行时代码；回滚路径：删除本 CSV。
A6,核查公网前端部署一致性,"针对视觉审计发现的源码/公网差异，核查本地源码、构建产物、远端 Caddy 静态目录和缓存策略，优先用重新构建/部署解决公网仍显示旧 UI 的问题。","1) 明确公网静态目录与当前构建产物来源；2) 公网 390px 下票据中心 `invoice-pool-mobile-list` 可见或记录阻塞原因；3) 公网移动上传 input 的 `multiple` 与源码一致或记录企业微信浏览器限制；4) 不泄露远端环境变量和密钥。","命令：本地 `cd client && npm run build`；远端只读核查 Caddy/静态目录；部署后 Playwright 检查 `/invoice-pool`、`/reimbursements`、`/mobile/capture` 的 DOM 指标。业务：手机端看到的是最新前端构建，票据/报销移动入口和多文件上传能力与源码一致。",ssh|playwright|vite,DONE,DONE,DONE,client/dist|deploy|remote:118.89.77.218,["A1"],2026-05-05：已确认 Caddy 反代到 Docker，远端源码已更新但旧镜像仍使用旧前端 dist；重建并重启 server 后公网 asset hash 更新，`post-deploy-visual-check-2026-05-05.json` 显示票据/报销移动列表和上传 multiple 生效；回滚路径：恢复部署前镜像或重建上一版。
A2,修复 live OCR 自动化假失败,"调整真实 OCR Playwright 辅助用例与 helper，避免后端已完成 available 但用例因总 timeout 或占位字段断言报假失败；失败时输出 API/页面状态证据。","1) 用真实 PDF 上传后能稳定等待 available；2) 断言字段时不因页面已刷新但测试总超时误报；3) 失败时报告包含票据ID、状态、OCR provider、金额或错误摘要。","命令：`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=https://oa.hyinda.com npx playwright test tests/e2e/manual/live-invoice-ocr.spec.ts --workers=1 --reporter=list --timeout=360000`。业务：公网登录员工账号->上传真实发票->腾讯 OCR->票据中心详情 available 且金额可见。",playwright|typescript,DONE,DONE,DONE,client/tests/e2e/manual/live-invoice-ocr.spec.ts|client/tests/e2e/helpers/liveInvoiceOcr.ts,["A1"],2026-05-05：复现假失败为 helper 在 pending_ocr/占位字段时提前返回；已改为等待 available/ocr_failed 明确终态；真实 OCR 用例通过；不新增真实密钥；回滚路径：恢复原 helper 与 spec。
A3,优化手机票据中心列表与详情布局,"修复公网手机视口仍显示桌面表格/字段挤压的问题，改为移动端优先的票据卡片与详情字段分行展示。","1) 390px 手机视口不显示桌面票据表格，`invoice-pool-mobile-list` 可见；2) 发票号码、销售方、购买方、金额不被裁切或横向溢出；3) 详情操作按钮可点击且不重叠；4) 视觉自动化指标满足：`tableVisible=false`、`mobileListVisible=true`、`offscreenButtons=[]`、截图无明显遮挡；5) 桌面表格视图保持可用。","命令：`cd client && npm run typecheck && npm run build && npx playwright test tests/e2e/r92-mobile-invoice-usability.spec.ts --workers=1 --reporter=list --timeout=90000`；补充公网手机/桌面视觉脚本检查 `https://oa.hyinda.com/invoice-pool`，保存截图到 `output/playwright/r93-*invoice-pool.png`，并输出 viewport、table/mobile-list display、offscreenButtons、字段可见性。业务：员工在手机票据中心查看真实 OCR 票据，可读字段并可进入详情/人工修正/归档。",playwright|typescript,DONE,DONE,DONE,client/src/pages/invoice-pool/InvoiceListCard.tsx|client/src/pages/invoice-pool/InvoiceDetailPanel.tsx|client/tests/e2e/r92-mobile-invoice-usability.spec.ts,"[""A1"",""A6""]",2026-05-05：源码已有移动卡片，公网问题由旧镜像导致；重建部署后 `post-deploy-visual-check-2026-05-05.json` 显示 mobile390 `tableVisible=false`、`invoiceMobileListVisible=true`、`offscreenButtons=[]`；R92 本地用例未跑通因本地 127.0.0.1:3000 未启动，已由公网视觉复测覆盖；回滚路径：恢复 R92 票据组件或上一版镜像。
A4,补齐试运行 OCR 配置运行手册,"把公网 OCR provider 从 mock 切到 tencent 的操作事实、验证命令、回滚方式写入 trialrun runbook/checklist，避免后续发布又回到 mock 或空密钥。","1) runbook 明确 `.env` 为事实源且不提交密钥；2) 写清 `OCR_PROVIDER=tencent`、Tencent key 长度检查、external deps smoke、runtime smoke、回滚到 mock 的步骤；3) 不暴露任何真实密钥。","命令：`git diff --check`；业务：按 runbook 可复现远端 OCR 配置检查与 smoke，不需要查看密钥明文。",manual,DONE,DONE,DONE,deploy/trialrun/runbook.md|deploy/trialrun/checklist.md,["A1"],2026-05-05：runbook/checklist 已补充腾讯 OCR 脱敏核查、真实 OCR 辅助复核、前端部署一致性排障和 OCR mock 应急回滚；不含真实密钥；回滚路径：恢复文档改动。
A5,R93 回归与中文提交,"执行前端构建、移动端 Playwright、live OCR 辅助复核和公网视觉自动化复核，确认后按中文分批提交。","1) A2-A4/A6 Test_Method 通过或明确记录外部阻塞；2) 视觉自动化保留手机/桌面截图与 DOM 指标摘要；3) `git status --short` 仅剩预期未跟踪/ignored 产物；4) commit message 使用中文并引用 R93。","命令：`cd client && npm run typecheck && npm run build`；`cd client && npx playwright test tests/e2e/r92-mobile-invoice-usability.spec.ts --workers=1 --reporter=list --timeout=90000`；live OCR 命令见 A2；视觉复核：公网 390x844 与 1440x900 截图 + DOM 指标，检查 no offscreen buttons、手机列表/详情字段可见。业务：公网票据中心真实 OCR 票据在手机端可读可操作。",playwright|git|manual,DONE,DONE,DONE,N/A,"[""A2"",""A3"",""A4"",""A6""]",2026-05-05：`npm run typecheck` 通过，`npm run build` 通过，远端 external/runtime smoke 通过，真实 live OCR 用例通过，公网 post-deploy 视觉复测通过；R92 本地用例因本地 127.0.0.1:3000 未启动未作为门禁；提交前不纳入密钥、截图和 test-results；回滚路径：按分批 commit revert。