Refresh admin help articles for event PWA
Some checks failed
linter / quality (push) Has been cancelled
tests / ci (push) Has been cancelled
tests / ui (push) Has been cancelled

This commit is contained in:
Codex Agent
2026-01-23 09:35:26 +01:00
parent 4706b21d22
commit b267ae2c15
12 changed files with 239 additions and 289 deletions

View File

@@ -1,37 +1,42 @@
---
title: "Troubleshooting & Issue Resolution"
title: "Troubleshooting & FAQ"
locale: en
slug: admin-issue-resolution
audience: admin
summary: "Playbooks for the most common admin-side incidents, from stuck uploads to billing locks."
summary: "Quick answers for the most common admin-side issues."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: reliability@fotospiel.app
related:
- slug: live-ops-control
- slug: privacy-and-support
- slug: event-prep-checklist
---
## Upload incidents
| Symptom | Diagnosis | Fix |
| --- | --- | --- |
| Queue stuck >10 min | Check Live Ops health widget | Run `php artisan media:backfill-thumbnails --tenant=XYZ` then reopen event |
| Specific guest blocked | Guest reached per-device limit | Increase limit under Event → Upload rules or ask them to clear drafts |
| Photos missing EXIF | Guest imported screenshots | No action; remind them that EXIF is optional |
## FAQ
**Photos are not showing up. What now?**
- Check whether the event is **Published**.
- Verify the guest used the correct join link or QR.
- If moderation is enabled, approve the upload in Live Ops.
## Access issues
- **Admin cannot log in**: verify invite accepted; reset via *Team → Resend invite*. Check SSO mapping if enforced.
- **Guest cannot join**: confirm event status is *Published* and share direct join URL `https://app.fotospiel.com/join/<code>`.
**Guests cannot join the event.**
- Confirm the event status is **Published**.
- Re-share the QR or join link from the dashboard.
- Ask the guest to refresh or reopen the app.
## Billing & quotas
- Paddle webhook failure locks uploads: check `storage/logs/paddle.log`, re-send webhook via Paddle dashboard, then toggle the subscription status.
- Storage 90% full: run archive early or purchase add-on via Paddle customer portal.
**Uploads are stuck in the queue.**
- Use Live Ops to approve or hide items and clear backlog.
- If the queue keeps growing, tighten moderation and reduce Live Show effects.
## Communication templates
Reuse the canned responses under `docs/content/fotospiel_howto_artikel_detailliert.md` to keep messaging consistent.
**Live Show is empty.**
- Ensure Live Show is enabled and the correct show link is open.
- Check if photos are waiting in the Live Show queue.
**Moderation feels too strict or too loose.**
- Adjust upload visibility rules in Event Settings.
- Use trusted uploader rules if staff devices should skip review.
### Need more help?
Escalate to reliability@fotospiel.app with the event ID, customer account, and timestamp. Attach screenshots/logs when possible.
Escalate to reliability@fotospiel.app with event name, timestamp, and screenshots.