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 & Incident-Playbooks" title: "Troubleshooting & FAQ"
locale: de locale: de
slug: admin-issue-resolution slug: admin-issue-resolution
audience: admin audience: admin
summary: "Leitfäden für typische Admin-Vorfälle von hängenden Uploads bis zu Billing-Sperren." summary: "Kurze Antworten auf die häufigsten Admin-Probleme."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: reliability@fotospiel.app owner: reliability@fotospiel.app
related: related:
- slug: live-ops-control - slug: live-ops-control
- slug: privacy-and-support - slug: event-prep-checklist
--- ---
## Upload-Vorfälle ## FAQ
| Symptom | Diagnose | Lösung | **Fotos erscheinen nicht. Was tun?**
| --- | --- | --- | - Prüfe, ob das Event **veröffentlicht** ist.
| Warteschlange >10Min fest | Live-Ops-Health-Widget prüfen | `php artisan media:backfill-thumbnails --tenant=XYZ` ausführen, Event neu öffnen | - Stelle sicher, dass der richtige Join-Link oder QR genutzt wurde.
| Einzelner Gast blockiert | Geräte-Limit erreicht | Limit unter Event → Upload-Regeln erhöhen oder Gast bittet Entwürfe zu löschen | - Wenn Moderation aktiv ist, Uploads in Live Ops freigeben.
| Fotos ohne EXIF | Gast importiert Screenshots | Kein Fehler; Hinweis geben, dass EXIF optional ist |
## Zugriffsprobleme **Gäste können nicht beitreten.**
- **Admin kommt nicht rein**: Prüfen, ob Einladung akzeptiert wurde; über *Team → Einladung erneut senden* resetten. Bei SSO Pflicht Zuordnung kontrollieren. - Event-Status muss **veröffentlicht** sein.
- **Gast kann nicht beitreten**: Event-Status muss *Published* sein; direkten Join-Link `https://app.fotospiel.com/join/<code>` teilen. - QR oder Join-Link erneut teilen.
- Gast-App neu laden oder neu starten lassen.
## Billing & Quoten **Uploads hängen in der Warteschlange.**
- Paddle-Webhook-Fehler sperrt Uploads: `storage/logs/paddle.log` prüfen, Webhook im Paddle-Dashboard erneut senden, anschließend Abo-Status toggeln. - In Live Ops freigeben oder ausblenden, um die Queue zu leeren.
- Speicher zu 90% voll: Archivierung vorziehen oder Add-on im Paddle-Kundenportal buchen. - Bei großem Rückstau strengere Moderation und weniger Effekte nutzen.
## Kommunikationsvorlagen **Live Show bleibt leer.**
Nutze die vorformulierten Antworten in `docs/content/fotospiel_howto_artikel_detailliert.md`, um Messaging konsistent zu halten. - Live Show aktivieren und sicherstellen, dass der korrekte Link offen ist.
- Prüfen, ob Fotos in der Live-Show-Queue warten.
**Moderation wirkt zu streng oder zu locker.**
- Sichtbarkeitsregeln in den Event-Einstellungen anpassen.
- Vertrauenswürdige Geräte als Ausnahme definieren.
### Weitere Hilfe ### Weitere Hilfe
Eskalation an reliability@fotospiel.app mit Event-ID, Kunde und Zeitstempel. Screenshots/Logs anhängen, wenn verfügbar. Kontaktiere reliability@fotospiel.app mit Eventname, Zeitpunkt und Screenshots.

View File

@@ -1,38 +1,41 @@
--- ---
title: "Checkliste Event-Vorbereitung" title: "Event-Vorbereitung: Checkliste"
locale: de locale: de
slug: event-prep-checklist slug: event-prep-checklist
audience: admin audience: admin
summary: "48-Stunden-Countdown, damit Geräte, Gäste und Automationen ready sind, bevor es losgeht." summary: "Die wichtigsten Schritte zur Event-Vorbereitung vor dem Start."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: tenant-dashboard-overview
- slug: live-ops-control - slug: live-ops-control
- slug: post-event-wrapup - slug: live-show-setup
--- ---
## 4824 Stunden vorher ## 4824 Stunden vorher
- [ ] Event in der Admin-App mit korrekter Zeitzone + Aufbewahrungsfrist anlegen. - [ ] **Event anlegen** mit korrektem Datum, Zeitzone und Aufbewahrung.
- [ ] Titelbild (1200×630) hochladen und Übersetzungen für Titel/Beschreibung prüfen. - [ ] **Branding hochladen** (Cover, Logo, Begrüßungstext) in allen Sprachen.
- [ ] Gästelisten importieren oder QR-Badges erzeugen. - [ ] **Aufgaben definieren**: Paket wählen, Aufgaben anpassen, Emotionen/Sammlungen setzen.
- [ ] Push-Vorlagen testen (Reminder, Achievement-Freischaltung). - [ ] **Gästezugang vorbereiten**: QR-Code, Join-Link oder Einladungen.
## 242 Stunden vorher ## 242 Stunden vorher
- [ ] `tenant:attach-demo-event` im Staging ausführen, um den Ablauf mit dem Team zu proben. - [ ] **Event veröffentlichen**, sobald alles freigegeben ist.
- [ ] Join-QR nahe Eingang und Fotoboxen ausdrucken oder anzeigen. - [ ] **Uploads testen** mit einem Gerät (Kamera-Freigabe + erster Upload).
- [ ] WLAN-SSID/Passwort-Beschilderung vorbereiten. - [ ] **Moderation prüfen** (Sichtbarkeit, Freigabe-Regeln).
- [ ] Moderationsregeln mit Kundenvertrag abgleichen (z.B. explizite Inhalte blocken, Freigabe nötig). - [ ] **Live-Show einstellen**, falls eine Leinwand genutzt wird.
- [ ] Paddle/RevenueCat-Status prüfen (alle Ampeln auf Grün).
## Letzte 2 Stunden ## Letzte 2 Stunden
- [ ] Demodaten aus dem Live-Event entfernen. - [ ] **QR aushängen** an Eingängen und Fotobooth-Punkten.
- [ ] Gäste-App auf Testgeräten öffnen und den Schnellstart durchspielen. - [ ] **Live Ops öffnen** auf einem Team-Gerät für Moderation.
- [ ] Live-Ops-Ansicht auf Tablet/Laptop in Bühnennähe starten. - [ ] **Team briefen** für sensible Inhalte oder Support-Anfragen.
- [ ] Team zu Eskalationswegen briefen (Supportkontakte, Ersatzgeräte, Foto-Guidelines).
### Tipps
- Das Event bleibt bis zur Freigabe im Entwurf.
- Mit einem Testgast den Ablauf einmal komplett durchspielen.
### Weitere Hilfe ### Weitere Hilfe
Siehe `live-ops-control` für Echtzeit-Monitoring oder melde dich bei ops@fotospiel.app. `live-ops-control` für Moderation oder `live-show-setup` für die Leinwand.

View File

@@ -1,26 +1,25 @@
--- ---
title: "Hilfecenter für Event-Admins" title: "Help Center für Event-Admins"
locale: de locale: de
slug: admin-help-index slug: admin-help-index
audience: admin audience: admin
summary: "Betriebsleitfäden für Event-Verantwortliche: Onboarding, Setup, Live-Steuerung und Nachbereitung." summary: "Guides für Setup, Live-Betrieb und Troubleshooting in der Event-Admin-App."
version_introduced: 2025.4 version_introduced: 2025.4
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: cx-team@fotospiel.app owner: cx-team@fotospiel.app
related: [] related: []
--- ---
Hier findest du alle Informationen, die du als Event-Admin für einen reibungslosen Ablauf brauchst. Die Artikel sind entlang des Event-Lebenszyklus sortiert: Dieses Portal sammelt alles, was Event-Admins für Vorbereitung, Live-Betrieb und schnelle Lösungen brauchen.
| Phase | Leitfragen | Artikel-Slug | | Bereich | Kernfrage | Artikel-Slug |
| --- | --- | --- | | --- | --- | --- |
| Konto & Team | Wie lade ich Mitarbeitende ein und setze Branding auf? | `tenant-dashboard-overview` | | Dashboard | Wo sehe ich Status, KPIs und Schnellaktionen? | `tenant-dashboard-overview` |
| Event-Vorbereitung | Welche Checkliste erledige ich vor Einlass? | `event-prep-checklist` | | Event-Vorbereitung | Was muss vor dem Start erledigt sein? | `event-prep-checklist` |
| Live-Betrieb | Wie überwache ich Uploads, moderiere Inhalte und sende Hinweise? | `live-ops-control` | | Live Ops | Wie moderiere ich Uploads und Queues? | `live-ops-control` |
| Live Show | Wie richte ich den Live-Show-Player ein und spiele ihn ab? | `live-show-setup` | | Live Show | Wie richte ich den Live-Show-Player ein? | `live-show-setup` |
| Abschluss & Compliance | Wie funktionieren Export, Archiv und Datenschutz? | `post-event-wrapup` | | FAQ & Troubleshooting | Welche Probleme treten häufig auf? | `admin-issue-resolution` |
| Troubleshooting | Was tun bei Upload-Problemen, Geräteverlust oder Billing-Fragen? | `admin-issue-resolution` |
Nutze die Navigationsleiste in der Admin-App für den Schnellzugriff oder öffne `/help/admin` im Desktop-Browser für die vollständige Ansicht mit Breadcrumbs und verwandten Artikeln. Nutze das Help Center in der App für mobilfreundliches Lesen oder öffne `/help/admin` am Desktop.

View File

@@ -1,14 +1,14 @@
--- ---
title: "Live-Ops-Steuerung" title: "Live Ops: Kontrolle & Moderation"
locale: de locale: de
slug: live-ops-control slug: live-ops-control
audience: admin audience: admin
summary: "Uploads überwachen, Inhalte moderieren und Durchsagen versenden, während das Event läuft." summary: "Uploads moderieren, Warteschlangen steuern und den Event stabil halten."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: event-prep-checklist - slug: event-prep-checklist
@@ -16,25 +16,27 @@ related:
- slug: live-show-setup - slug: live-show-setup
--- ---
## Dashboard-Widgets ## Wofür diese Seite da ist
- **Upload-Durchsatz** Fotos/Minute, farblich markiert bei Rückständen >25. Live Ops ist die Schaltzentrale während des Events. Hier moderierst du Uploads, verwaltest die Live-Show-Warteschlange und hältst die Qualität hoch.
- **Gerätegesundheit** Top-Geräte mit Fehlern (Berechtigung verweigert, Speicher voll).
- **Moderationswarteschlange** gemeldete Fotos zur Freigabe; Moderator:innen zuweisen.
- **Ankündigungen** Push/Banner erstellen; Sprachversionen möglich.
## Typischer Ablauf ## Moderation-Tab
1. Live-Ops-Seite auf Tablet anheften. Auto-Refresh auf 15Sekunden stellen. - **Freigeben** veröffentlicht ein Foto für Gäste.
2. Durchsatz beobachten, sobald Gäste eintreffen; direkt nach Zeremonien sind >40/min üblich. - **Ausblenden** entfernt es sofort aus der Galerie.
3. Wächst der Rückstau, Banner senden („Bitte kurz online bleiben“ oder „Serienaufnahme reduzieren“). - **Highlight** markiert es als Featured-Inhalt.
4. Gemeldete Inhalte zügig bearbeiten; Policy verlangt Aktion innerhalb von 10Minuten. - **Filter** fokussieren auf offene oder markierte Inhalte.
5. *Achievement-Trigger* nutzen, um Badges manuell zu vergeben, falls Automationen ausfallen.
## Eskalationsmatrix ## Live-Show-Tab
| Problem | Erste Aktion | Eskalation an | - **Queue** zeigt, was als Nächstes auf die Leinwand kommt.
| --- | --- | --- | - **Freigeben + Live** veröffentlicht in Galerie und Live Show.
| Upload-Warteschlange fest | Health Check ausführen → Event erneut synchronisieren | Reliability Rufbereitschaft | - **Von Live entfernen** nimmt es von der Anzeige, ohne es zu löschen.
| Anstößiger Inhalt | Foto ausblenden → Beweis herunterladen → Veranstalter informieren | Legal Duty Officer |
| Billing-Lock | Paddle-Dashboard prüfen → Zahlungsstatus bestätigen | Finance | ## Automatisierung
- Auto-Freigaben nur nutzen, wenn schneller Durchsatz erwartet wird.
- Vertrauenswürdige Geräte überspringen die Prüfung, markierte bleiben in der Warteschlange.
### Tipps
- Live Ops während des Events auf einem Team-Gerät geöffnet lassen.
- Bei hohen Queues: strengere Moderation oder weniger Effekte.
### Weitere Hilfe ### Weitere Hilfe
Siehe `admin-issue-resolution` für detailliertes Troubleshooting oder melde dich im Slack-Channel #ops-help. `admin-issue-resolution` für Troubleshooting oder `live-show-setup` für die Player-Einstellungen.

View File

@@ -1,82 +1,44 @@
--- ---
title: "Live Show einrichten & abspielen" title: "Live Show einrichten"
locale: de locale: de
slug: live-show-setup slug: live-show-setup
audience: admin audience: admin
summary: "Schritt-für-Schritt-Anleitung für Live Show, Moderation, Effekte und Hardware-Setup am Beamer." summary: "Live-Show-Player, Moderationsmodus und Abspieltempo konfigurieren."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: live-ops-control - slug: live-ops-control
- slug: admin-issue-resolution - slug: admin-issue-resolution
--- ---
> Diese Anleitung ist für Event-Admins, die eine Live Show auf einem Bildschirm oder Beamer abspielen möchten. ## Wann ist das relevant?
- Du willst neue Uploads live auf einer Leinwand zeigen.
- Du brauchst einen stabilen Ablauf mit Moderation und Effekten.
## Wann ist dieser Artikel relevant? ## Live Show konfigurieren (Admin-App)
- Du willst neue Uploads live auf einer großen Leinwand zeigen. 1. Event öffnen und **Live Show Einstellungen** aufrufen.
- Du brauchst einen stabilen Ablauf mit Moderation, Effekten und klarer Hardware-Empfehlung. 2. **Moderationsmodus** wählen:
- **Aus**: alle Fotos erscheinen sofort.
- **Manuell**: Fotos warten in der Warteschlange.
- **Nur vertrauenswürdige Quellen**: nur freigegebene Geräte publizieren automatisch.
3. **Tempo**, **Layout** und **Effekte** passend zum Anlass einstellen.
4. Einstellungen speichern.
## Live Show vorbereiten (Admin-App) ## Live-Show-Link öffnen
1. Öffne das Event und gehe zu **Live Show Einstellungen**. - Live-Show-URL im Format `/show/<token>` nutzen.
2. Wähle den **Moderationsmodus**: - Der Player ist nur lesend und braucht keinen Login.
- **Aus**: jedes Foto erscheint sofort.
- **Manuell**: Fotos landen in der Live-Show-Warteschlange.
- **Trusted only**: nur freigegebene Quellen werden automatisch übernommen.
3. Lege **Tempo** (Auto oder feste Sekunden), **Layout** (Single/Split/Grid) und **Effekt-Preset** fest.
4. Speichere die Einstellungen.
## Live Show Link öffnen ## Während des Events
- Öffne den Live-Show-Link im Format `/show/<token>` im Browser des Abspielgeräts. - Fotos in Live Ops freigeben, wenn Moderation aktiv ist.
- Teile den Link nur mit Personen, die die Show steuern dürfen. - Bei Rucklern Effekte reduzieren oder auf Single-Layout wechseln.
> Tipp: Der Live-Show-Player läuft ohne Login und ist read-only. ## Empfohlene Hardware
- Laptop oder Mini-PC mit Chrome/Edge sowie stabilem WLAN oder Ethernet.
## Moderation im Live-Betrieb - Projektor mit mindestens 3000 ANSI Lumen (4500+ für große Locations).
- Öffne die **Live Show Queue** im Admin und bestätige neue Fotos.
- Nutze **„Approve + Live“**, um Galerie und Live Show in einem Schritt freizugeben.
- Reagiere schnell bei sensiblen Inhalten (Policy: ≤10 Minuten).
## Effekte & Layouts (empfohlene Defaults)
- **Film Cut** + **Blur last**: ruhiger, professioneller Look.
- **Shutter Flash**: mehr Dynamik für Party- und Gala-Events.
- **Grid Burst**: ideal bei vielen Uploads und großen Leinwänden.
## Empfohlenes Setup für Beamer
**Minimal (funktioniert):**
- Laptop mit Chrome/Edge, 8GB RAM
- HDMI-Kabel (510m)
- Beamer ≥3000 ANSI Lumen, 1080p
**Empfohlen (stabil):**
- Mini-PC oder Laptop mit dedizierter Grafikeinheit
- Ethernet-Verbindung (USBC → Ethernet Adapter)
- Beamer ≥4500 ANSI Lumen, 1080p/4K, 16:9
- HDMI 2.0 + aktiver HDMI-Verlängerer (ab 10m)
**Optional:**
- HDMI-Splitter (zusätzliche Displays)
- Präsentationsklicker für schnellen Fokuswechsel
## Beamer & Bildschirm richtig einstellen
1. Auflösung auf **16:9** setzen, Skalierung 100%.
2. Vollbild aktivieren (Taste **F** im Player oder Browser-F11).
3. Energiesparmodus und Bildschirmsperre deaktivieren.
4. Benachrichtigungen im Betriebssystem ausschalten.
## Netzwerk & Stabilität
- Nutze 5GHz-WLAN oder (besser) Ethernet.
- Vermeide offene Gäste-WLANs für den Player.
- Stelle sicher, dass das Abspielgerät **dauerhaft online** bleibt.
## Häufige Probleme
- **Fotos erscheinen nicht:** Moderationsmodus prüfen, Queue leeren, Live-Show-Link neu laden.
- **Ruckler:** Effekt-Intensität reduzieren, Layout auf Single wechseln, WLAN prüfen.
- **Schwarzer Bildschirm:** HDMI-Eingang am Beamer prüfen, Browser-Fullscreen deaktivieren/neu aktivieren.
### Weitere Hilfe ### Weitere Hilfe
Siehe `admin-issue-resolution` für Troubleshooting oder kontaktiere den Support. `live-ops-control` für den Moderationsfluss oder `admin-issue-resolution` für Troubleshooting.

View File

@@ -1,34 +1,38 @@
--- ---
title: "Überblick: Kunden-Dashboard" title: "Event-Dashboard im Überblick"
locale: de locale: de
slug: tenant-dashboard-overview slug: tenant-dashboard-overview
audience: admin audience: admin
summary: "Mitarbeitende einladen, Branding konfigurieren und globale Kundeneinstellungen verstehen." summary: "Status, KPIs und Setup-Checkliste deines Events auf einen Blick."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: onboarding@fotospiel.app owner: onboarding@fotospiel.app
related: related:
- slug: event-prep-checklist - slug: event-prep-checklist
- slug: admin-issue-resolution - slug: live-ops-control
--- ---
## Wann lesen? ## Wann lesen?
Direkt nach dem Zugriff auf einen neuen Kunden oder wenn neue Mitarbeitende eingearbeitet werden. Das Kunden-Dashboard befindet sich in der Admin-App (Filament) und bietet auf Desktop dieselben Optionen. Direkt nach dem Anlegen eines Events oder als schneller Gesundheitscheck vor dem Start.
## Hauptbereiche ## Was das Dashboard zeigt
1. **Home** Überblick über laufende Events, Speicherauslastung und offene Meldungen. - **Event-Status** (Entwurf / Veröffentlicht), damit klar ist, was Gäste sehen.
2. **Team** Admins per E-Mail einladen, Rollen vergeben (Owner, Manager, Moderator). SSO via Azure AD/Google möglich, falls im Kundenkonto aktiviert. - **KPIs** zu Gästen, Uploads und Engagement für einen schnellen Puls-Check.
3. **Branding** Logos hochladen, Akzentfarben wählen, lokalisierten Begrüßungstext für die Gäste-App setzen. - **Setup-Checkliste** mit den wichtigsten Restschritten bis zum Start.
4. **Rechtliches** Impressum/Datenschutz/AGB über die Legal-Ressource pflegen; Änderungen greifen sofort. - **Schnellaktionen** zu Aufgaben, Live Show, Branding und QR-Tools.
5. **Integrationen** Paddle-Keys, RevenueCat-App-IDs, Webhooks und Zapier-Tokens verwalten. Keine Secrets in Dokumente kopieren.
## Best Practices ## So nutzt du es
- Mindestens zwei Owner-Rollen für Redundanz halten. 1. **Status prüfen** und das Event bis zur Freigabe im Entwurf lassen.
- Branding oder Automationen zuerst im Staging-Kundenkonto testen. 2. **Checkliste abarbeiten** sie bildet den typischen Vorbereitungsweg ab.
- Einladungen als bd-Issue dokumentieren. 3. **KPIs beobachten**, um Einladungen und Uploads zu verifizieren.
4. **Details öffnen** (Aufgaben, QR, Live Show) über die Schnellaktionen.
### Tipps
- Erst veröffentlichen, wenn Branding, Aufgaben und QR-Sharing erledigt sind.
- Wenn Uploads fehlen, prüfe Sichtbarkeit von QR-Code oder Join-Link.
### Weitere Hilfe ### Weitere Hilfe
Siehe `event-prep-checklist` für Event-Vorbereitung oder kontaktiere cx-team@fotospiel.app für Onboarding-Support. Siehe `event-prep-checklist` für den kompletten Ablauf oder `live-ops-control` während des Events.

View File

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

View File

@@ -3,36 +3,39 @@ title: "Event Preparation Checklist"
locale: en locale: en
slug: event-prep-checklist slug: event-prep-checklist
audience: admin audience: admin
summary: "A 48-hour countdown to ensure devices, guests, and automations are ready before doors open." summary: "The essential steps to prepare an event before guests arrive."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: tenant-dashboard-overview
- slug: live-ops-control - slug: live-ops-control
- slug: post-event-wrapup - slug: live-show-setup
--- ---
## 4824 hours before ## 4824 hours before
- [ ] Create the event in the Admin app with correct timezone + retention policy. - [ ] **Create the event** with correct date, timezone, and retention policy.
- [ ] Upload cover artwork (1200×630) and ensure translations exist for titles/descriptions. - [ ] **Upload branding** (cover image, logo, welcome text) in all required languages.
- [ ] Import guest lists or generate QR badges if needed. - [ ] **Define tasks**: pick a task package, adjust tasks, add emotions/collections.
- [ ] Test push notification templates (reminders, achievement unlocks). - [ ] **Prepare guest entry**: QR code, join link, or invitations.
## 242 hours before ## 242 hours before
- [ ] Run `tenant:attach-demo-event` in staging to rehearse workflow with staff. - [ ] **Publish the event** once everything is approved.
- [ ] Print or display the join QR near entrance and photobooth areas. - [ ] **Verify uploads** using a test device (camera permission + first upload).
- [ ] Prepare onsite Wi-Fi SSID/password signage. - [ ] **Review moderation** settings (guest visibility, approval rules).
- [ ] Confirm that automatic moderation rules match the client contract (e.g., block explicit content, require approval). - [ ] **Check Live Show settings** if you plan a big screen display.
- [ ] Verify Paddle/RevenueCat status dashboards show green.
## Final 2 hours ## Final 2 hours
- [ ] Clear demo data from the live event. - [ ] **Share the QR** at entrances and photobooth areas.
- [ ] Open the guest app on test devices and complete the getting-started flow. - [ ] **Open Live Ops** on a staff device for moderation.
- [ ] Start the Live Ops screen on a tablet/laptop near the stage. - [ ] **Brief staff** on what to do for flagged content or support requests.
- [ ] Brief staff on escalation paths (support contacts, backup devices, photo guidelines).
### Tips
- Keep the event in Draft until tasks and branding are final.
- Use a test guest to verify the full flow end-to-end.
### Need more help? ### Need more help?
Open `live-ops-control` for real-time monitoring tips or reach out to ops@fotospiel.app. Open `live-ops-control` for real-time moderation or `live-show-setup` for the display setup.

View File

@@ -1,26 +1,25 @@
--- ---
title: "Customer Admin Help Center" title: "Event Admin Help Center"
locale: en locale: en
slug: admin-help-index slug: admin-help-index
audience: admin audience: admin
summary: "Operational playbooks for event owners: onboarding, event setup, live control, and post-event delivery." summary: "Guides for setup, live operations, and troubleshooting in the Event Admin app."
version_introduced: 2025.4 version_introduced: 2025.4
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: cx-team@fotospiel.app owner: cx-team@fotospiel.app
related: [] related: []
--- ---
This portal collects everything event admins need to configure customer accounts, run events smoothly, and resolve issues quickly. Articles are grouped by lifecycle: This portal collects everything event admins need to configure events, run live operations, and resolve issues quickly.
| Phase | Key Questions | Article Slug | | Section | Key Questions | Article Slug |
| --- | --- | --- | | --- | --- | --- |
| Account Setup | How do I invite staff and configure branding? | `tenant-dashboard-overview` | | Dashboard | Where do I see status, KPIs, and quick actions? | `tenant-dashboard-overview` |
| Event Preparation | What checklists should I complete before doors open? | `event-prep-checklist` | | Event Preparation | What do I need before guests arrive? | `event-prep-checklist` |
| Live Operations | How do I monitor uploads, moderate content, and trigger announcements? | `live-ops-control` | | Live Operations | How do I moderate uploads and manage queues? | `live-ops-control` |
| Live Show | How do I set up and run the Live Show player? | `live-show-setup` | | Live Show | How do I configure the Live Show player? | `live-show-setup` |
| Wrap-up & Compliance | How are exports, archives, and privacy handled? | `post-event-wrapup` | | FAQ & Troubleshooting | What are the most common issues? | `admin-issue-resolution` |
| Troubleshooting | How to handle upload issues, device loss, billing, etc. | `admin-issue-resolution` |
Use the navigation sidebar inside the admin app for faster access, or open `/help/admin` in a desktop browser for the full layout with breadcrumbs and related links. Use the in-app help center for mobile-friendly reading, or open `/help/admin` on desktop for the full layout.

View File

@@ -3,12 +3,12 @@ title: "Live Ops Control"
locale: en locale: en
slug: live-ops-control slug: live-ops-control
audience: admin audience: admin
summary: "Monitor uploads, moderate content, and push announcements while the event is live." summary: "Moderate uploads, manage queues, and keep the event running smoothly."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: event-prep-checklist - slug: event-prep-checklist
@@ -16,25 +16,27 @@ related:
- slug: live-show-setup - slug: live-show-setup
--- ---
## Dashboard widgets ## What this page is for
- **Upload throughput** photos/minute, highlighted when backlog >25. Live Ops is the command center during an event. Use it to moderate uploads, manage the Live Show queue, and keep quality high.
- **Device health** top devices experiencing errors (permission denied, storage full).
- **Moderation queue** flagged photos awaiting approval; assign to moderators.
- **Announcements** compose push/banner messages; supports locale-specific text.
## Typical workflow ## Moderation tab
1. Pin the Live Ops page on a tablet. Set auto-refresh to 15 seconds. - **Approve** publishes a photo for guests.
2. Watch the throughput graph as doors open; expect spike to 40+/min right after ceremonies. - **Hide** removes it from the gallery immediately.
3. If backlog grows, broadcast a banner reminding guests to stay online or reduce burst uploads. - **Highlight** adds it to featured content.
4. Moderate flagged items quickly; policies require action within 10 minutes. - **Filters** let you focus on pending or highlighted items.
5. Use the *Achievement trigger* widget to award badges manually if automation criteria fail.
## Escalation matrix ## Live Show tab
| Issue | First action | Escalate to | - **Queue** shows what is waiting to appear on the big screen.
| --- | --- | --- | - **Approve + Live** pushes a photo to both the gallery and Live Show.
| Upload queue stuck | Run health check → re-sync event | Reliability on-call | - **Remove from Live** takes an item off the screen without deleting it.
| Offensive content | Hide photo → download evidence → notify organizer | Legal duty officer |
| Billing lock | Check Paddle dashboard → confirm payment status | Finance | ## Automation switches
- Use auto-approval rules only if the client expects fast turnaround.
- Trusted uploaders can skip review, while flagged devices stay queued.
### Tips
- Keep Live Ops open on a staff device throughout the event.
- If the queue grows, switch to stricter moderation or reduce Live Show effects.
### Need more help? ### Need more help?
Open `admin-issue-resolution` for detailed troubleshooting or ping #ops-help in Slack. See `admin-issue-resolution` for troubleshooting or `live-show-setup` for player settings.

View File

@@ -3,80 +3,42 @@ title: "Set up & run Live Show"
locale: en locale: en
slug: live-show-setup slug: live-show-setup
audience: admin audience: admin
summary: "Step-by-step guide for Live Show, moderation, effects, and recommended projector hardware." summary: "Configure the Live Show player, moderation mode, and playback pace."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app owner: ops@fotospiel.app
related: related:
- slug: live-ops-control - slug: live-ops-control
- slug: admin-issue-resolution - slug: admin-issue-resolution
--- ---
> This guide is for event admins who want to run Live Show on a big screen or projector.
## When is this relevant? ## When is this relevant?
- You want new uploads to appear live on a large display. - You want new uploads to appear live on a big screen.
- You need a stable flow with moderation, effects, and hardware guidance. - You need a stable flow with moderation and effects.
## Prepare Live Show (Admin app) ## Configure Live Show (Admin app)
1. Open the event and go to **Live Show settings**. 1. Open the event and go to **Live Show settings**.
2. Choose a **moderation mode**: 2. Pick a **moderation mode**:
- **Off**: every photo appears immediately. - **Off**: every photo appears immediately.
- **Manual**: photos are held in the Live Show queue. - **Manual**: photos wait in the queue.
- **Trusted only**: only approved sources are auto-added. - **Trusted only**: only approved devices publish automatically.
3. Set the **pace** (auto or fixed seconds), **layout** (single/split/grid), and **effect preset**. 3. Set the **pace**, **layout**, and **effects** that fit the venue.
4. Save the settings. 4. Save the settings.
## Open the Live Show link ## Open the Live Show link
- Open the Live Show URL in the format `/show/<token>` on the playback device. - Use the Live Show URL in the format `/show/<token>`.
- Share the link only with staff who should control the show. - The player is read-only and works without login.
> Tip: The Live Show player is read-only and works without login. ## During the event
- Approve photos in Live Ops if moderation is enabled.
- If the show stutters, reduce effects or switch to single layout.
## Moderation during the event ## Recommended hardware
- Open the **Live Show queue** in the admin app and approve new photos. - Laptop or mini PC with Chrome/Edge and stable Wi-Fi or Ethernet.
- Use **"Approve + Live"** to publish to gallery and Live Show in one step. - Projector at least 3000 ANSI lumens (4500+ recommended for large venues).
- Act quickly on sensitive content (policy: ≤10 minutes).
## Effects & layouts (recommended defaults) ### Need more help?
- **Film Cut** + **Blur last**: calm, professional look. See `live-ops-control` for moderation flow or `admin-issue-resolution` for troubleshooting.
- **Shutter Flash**: more energy for party and gala moments.
- **Grid Burst**: best for high-volume uploads and big screens.
## Recommended projector setup
**Minimum (works):**
- Laptop with Chrome/Edge, 8 GB RAM
- HDMI cable (510 m)
- Projector ≥3000 ANSI lumens, 1080p
**Recommended (stable):**
- Mini PC or laptop with dedicated GPU
- Ethernet connection (USBC → Ethernet adapter)
- Projector ≥4500 ANSI lumens, 1080p/4K, 16:9
- HDMI 2.0 + active HDMI extender (10 m or more)
**Optional:**
- HDMI splitter (additional displays)
- Presentation clicker for quick focus switching
## Screen & projector tuning
1. Set resolution to **16:9**, scaling 100%.
2. Enable fullscreen (press **F** in the player or browser F11).
3. Disable sleep mode and screen lock.
4. Disable OS notifications.
## Network & stability
- Use 5 GHz WiFi or (better) Ethernet.
- Avoid guest WiFi for the player device.
- Keep the playback device **online at all times**.
## Common issues
- **Photos not showing:** check moderation mode, clear the queue, reload the Live Show link.
- **Stutter:** reduce effect intensity, switch to Single layout, check WiFi.
- **Black screen:** verify projector input, toggle browser fullscreen off/on.
### Further help
See `admin-issue-resolution` for troubleshooting or contact support.

View File

@@ -1,34 +1,38 @@
--- ---
title: "Customer Control Center Overview" title: "Event Dashboard Overview"
locale: en locale: en
slug: tenant-dashboard-overview slug: tenant-dashboard-overview
audience: admin audience: admin
summary: "Invite staff, configure branding, and understand how customer-wide settings affect every event." summary: "Understand event status, KPIs, and the setup checklist at a glance."
version_introduced: 2025.4 version_introduced: 2025.4
requires_app_version: "^3.2.0" requires_app_version: "^3.2.0"
status: draft status: draft
translation_state: aligned translation_state: aligned
last_reviewed_at: 2025-02-22 last_reviewed_at: 2026-01-23
owner: onboarding@fotospiel.app owner: onboarding@fotospiel.app
related: related:
- slug: event-prep-checklist - slug: event-prep-checklist
- slug: admin-issue-resolution - slug: live-ops-control
--- ---
## When to read this ## When to read this
Right after receiving access to a new customer account or when onboarding new staff. The Customer Control Center lives in the Admin app (Filament) and mirrors most options on desktop. Use this guide right after creating an event or whenever you need a quick health check before going live.
## Key areas ## What the dashboard shows
1. **Home** snapshot of live events, storage usage, unresolved reports. - **Event status** (Draft / Published) so you always know what guests can see.
2. **Team** invite admins via email, assign roles (Owner, Manager, Moderator). SSO via Azure AD/Google is available if enabled in customer settings. - **KPIs** for guests, uploads, and engagement so you can spot momentum early.
3. **Branding** upload logos, choose accent colors, set localized welcome text shown in the guest app. - **Setup checklist** with the remaining steps before launch.
4. **Legal pages** edit Impressum/Privacy/AGB via the Legal resource; changes propagate instantly. - **Quick actions** that jump to tasks, Live Show, branding, and QR tools.
5. **Integrations** manage Paddle keys, RevenueCat app IDs, webhooks, and Zapier tokens. Never paste secrets into articles.
## Best practices ## How to use it
- Keep at least two Owner-level accounts for redundancy. 1. **Confirm the status** and keep the event in Draft until everything is ready.
- Use the staging customer account to test branding or automation before touching production. 2. **Work the checklist** from top to bottom; it mirrors the most common prep path.
- Document invitations in a bd issue note. 3. **Check KPIs** to validate that invites and uploads are coming in.
4. **Jump into details** (tasks, QR, Live Show) using the quick actions.
### Tips
- Publish only after branding, task setup, and QR sharing are complete.
- If uploads look low, verify that the QR or join link is visible to guests.
### Need more help? ### Need more help?
See `event-prep-checklist` for event-level prep or contact cx-team@fotospiel.app for onboarding assistance. See `event-prep-checklist` for the full launch steps or open `live-ops-control` during the event.