# Trial-Run Reference

Primary fact source: `docs/试运行与自动化验证手册.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.