hyb-oa/.agents/skills/hyb-oa-delivery/references/trialrun.md

Trial-Run Reference

Primary fact source: docs/trialrun-runbook.md.

Automatic First

Use automation before asking the user to manually reproduce:

• Backend unit/regression commands.
• Frontend typecheck/build.
• Playwright PC/mobile/WeCom UA.
• Visual screenshots under output/playwright/<issue-id>/.

Manual Stop Points

Ask the user to act or confirm for:

• Enterprise WeChat admin console changes.
• Phone Enterprise WeChat real login/authorization confirmation.
• Production Caddy/domain/systemd/database changes.
• Prisma migration drift resolution.

Common WeCom Checks

• App homepage URL and callback URL.
• Trusted domain verification file.
• Visible range includes the user.
• OAuth returns UserId.
• Local OA account is bound to WeCom userId.
• Cookies survive Caddy reverse proxy.

OCR Checks

When upload stays in "上传中" or "识别中", inspect:

1. Upload response.
2. Invoice DB status.
3. OCR provider mode.
4. OCR worker/job status.
5. Tencent credentials and network.
6. Dedup result.
7. Status polling endpoint.
8. Frontend cache invalidation.