fotospiel-app/docs/ops/admin-issue-resolution.md

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 Paddle / 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.