Admins, Support, and On-Call Ops

Common Errors and Fast Fixes

Triage the most frequent operational failures across access, scoring, scheduling, and uploads.

Prerequisites

- Access to affected user details and competition ID

Step-by-step workflow

1) Capture incident context

- Collect user role, route, competition/studio IDs, and timestamp.

- Classify as access, data integrity, billing, or infrastructure.

2) Run targeted diagnostics

- Access errors: verify role membership and assignment docs.

- Scoring issues: check judge assignment and schedule mapping.

- Upload failures: verify project/bucket/rules/CORS.

3) Close and prevent

- Document root cause and operator fix.

- Add checklist guardrail to prevent recurrence.

Validation checklist

- Issue reproduced or verified with concrete diagnostics.

- Fix validated by affected user path.

- Incident log includes prevention note.

Common failure modes and fixes

Permission denied despite correct UI path

- Check Firestore/Storage rule requirements against actual user claims and document ownership.

Works in local/dev but fails in prod

- Confirm environment variables, project targeting, and secrets differ between environments.