hyb-oa/.trellis/tasks/05-28-oa-test-coverage-gap-fill/implement.md

实施说明

Recommended Batch

先做“发票验真自动化测试补齐”这一批。理由是：

• 代码已存在，测试可以低风险补齐，不需要真实 provider。
• 它直接对应上一轮矩阵里的高缺口。
• 能提高后续付费 API POC 的安全边界：即使 provider 未配置、失败或被关闭，系统也能给出可解释结果。

Planned Changes After Approval

1. 后端测试

   • 新增 server/tests/unit/routes/invoicePool.verification.test.js，覆盖触发、禁用、pending、冷却和重试保护。
   • 新增或扩展 job/service 测试，覆盖 flag 关闭、非 pending、provider error 的降级写库。
   • 若发现重复/过宽断言，收紧现有 verification.*.test.js，不做无关重构。

2. 前端测试

   • 扩展 client/tests/e2e/pc-finance-admin-visual-wave4.spec.ts 或新增 focused spec。
   • 用 route mock 验证“发起辅助核验”“重新核验”和错误文案，不访问真实后端。

3. 质量门禁

   • 后端 focused Vitest + prisma:validate。
   • 前端 typecheck、build，以及 focused Playwright。
   • Trellis task validate、governance gate、git diff --check。

Boundaries

• 不新增真实验真 provider。
• 不读取或上传真实票据。
• 不部署、不写生产配置、不调用公网接口。
• 不改付款、企业微信、OCR provider、备份恢复和试运行主任务。

Rollback

本批主要是测试代码。若测试实现暴露夹具不稳定，优先收窄为后端 route/service focused tests；必要时回退前端 E2E 扩展，只保留后端自动化覆盖。