# Admin Issue Resolution (Ops Playbook)

Internal troubleshooting guide for superadmins and on-call.

## Upload incidents
| Symptom | Likely cause | First action |
| --- | --- | --- |
| Queue stuck >10 min | Workers stalled or storage pressure | Check queue workers and storage health; see `docs/ops/queue-workers.md` and `docs/ops/dr-storage-issues.md` |
| Guests blocked | Per-device limits reached | Confirm limits and whether exceptions are allowed |
| Thumbnails missing | Backfill jobs stalled | Run `php artisan media:backfill-thumbnails --tenant=XYZ` |

## Access issues
- **Admin cannot log in**: verify invite acceptance, check SSO mapping if enforced, re-send invite.
- **Guest cannot join**: confirm event is published and the join link is current.

## Billing and quota blocks
- Check Lemon Squeezy / RevenueCat status dashboards.
- Confirm webhook freshness and retry failures if needed.

## Communications
- Use the support escalation guide at `docs/ops/support-escalation-guide.md` for customer comms.
- Log all actions and timestamps in a bd issue.
