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
slug: admin-issue-resolution
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
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-Vorfälle
| Symptom | Diagnose | Lösung |
| --- | --- | --- |
| Warteschlange >10Min fest | Live-Ops-Health-Widget prüfen | `php artisan media:backfill-thumbnails --tenant=XYZ` ausführen, Event neu öffnen |
| Einzelner Gast blockiert | Geräte-Limit erreicht | Limit unter Event → Upload-Regeln erhöhen oder Gast bittet Entwürfe zu löschen |
| Fotos ohne EXIF | Gast importiert Screenshots | Kein Fehler; Hinweis geben, dass EXIF optional ist |
## FAQ
**Fotos erscheinen nicht. Was tun?**
- Prüfe, ob das Event **veröffentlicht** ist.
- Stelle sicher, dass der richtige Join-Link oder QR genutzt wurde.
- Wenn Moderation aktiv ist, Uploads in Live Ops freigeben.
## Zugriffsprobleme
- **Admin kommt nicht rein**: Prüfen, ob Einladung akzeptiert wurde; über *Team → Einladung erneut senden* resetten. Bei SSO Pflicht Zuordnung kontrollieren.
- **Gast kann nicht beitreten**: Event-Status muss *Published* sein; direkten Join-Link `https://app.fotospiel.com/join/<code>` teilen.
**Gäste können nicht beitreten.**
- Event-Status muss **veröffentlicht** sein.
- QR oder Join-Link erneut teilen.
- Gast-App neu laden oder neu starten lassen.
## Billing & Quoten
- Paddle-Webhook-Fehler sperrt Uploads: `storage/logs/paddle.log` prüfen, Webhook im Paddle-Dashboard erneut senden, anschließend Abo-Status toggeln.
- Speicher zu 90% voll: Archivierung vorziehen oder Add-on im Paddle-Kundenportal buchen.
**Uploads hängen in der Warteschlange.**
- In Live Ops freigeben oder ausblenden, um die Queue zu leeren.
- Bei großem Rückstau strengere Moderation und weniger Effekte nutzen.
## Kommunikationsvorlagen
Nutze die vorformulierten Antworten in `docs/content/fotospiel_howto_artikel_detailliert.md`, um Messaging konsistent zu halten.
**Live Show bleibt leer.**
- 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
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
slug: event-prep-checklist
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: tenant-dashboard-overview
- slug: live-ops-control
- slug: post-event-wrapup
- slug: live-show-setup
---
## 4824 Stunden vorher
- [ ] Event in der Admin-App mit korrekter Zeitzone + Aufbewahrungsfrist anlegen.
- [ ] Titelbild (1200×630) hochladen und Übersetzungen für Titel/Beschreibung prüfen.
- [ ] Gästelisten importieren oder QR-Badges erzeugen.
- [ ] Push-Vorlagen testen (Reminder, Achievement-Freischaltung).
- [ ] **Event anlegen** mit korrektem Datum, Zeitzone und Aufbewahrung.
- [ ] **Branding hochladen** (Cover, Logo, Begrüßungstext) in allen Sprachen.
- [ ] **Aufgaben definieren**: Paket wählen, Aufgaben anpassen, Emotionen/Sammlungen setzen.
- [ ] **Gästezugang vorbereiten**: QR-Code, Join-Link oder Einladungen.
## 242 Stunden vorher
- [ ] `tenant:attach-demo-event` im Staging ausführen, um den Ablauf mit dem Team zu proben.
- [ ] Join-QR nahe Eingang und Fotoboxen ausdrucken oder anzeigen.
- [ ] WLAN-SSID/Passwort-Beschilderung vorbereiten.
- [ ] Moderationsregeln mit Kundenvertrag abgleichen (z.B. explizite Inhalte blocken, Freigabe nötig).
- [ ] Paddle/RevenueCat-Status prüfen (alle Ampeln auf Grün).
- [ ] **Event veröffentlichen**, sobald alles freigegeben ist.
- [ ] **Uploads testen** mit einem Gerät (Kamera-Freigabe + erster Upload).
- [ ] **Moderation prüfen** (Sichtbarkeit, Freigabe-Regeln).
- [ ] **Live-Show einstellen**, falls eine Leinwand genutzt wird.
## Letzte 2 Stunden
- [ ] Demodaten aus dem Live-Event entfernen.
- [ ] Gäste-App auf Testgeräten öffnen und den Schnellstart durchspielen.
- [ ] Live-Ops-Ansicht auf Tablet/Laptop in Bühnennähe starten.
- [ ] Team zu Eskalationswegen briefen (Supportkontakte, Ersatzgeräte, Foto-Guidelines).
- [ ] **QR aushängen** an Eingängen und Fotobooth-Punkten.
- [ ] **Live Ops öffnen** auf einem Team-Gerät für Moderation.
- [ ] **Team briefen** für sensible Inhalte oder Support-Anfragen.
### Tipps
- Das Event bleibt bis zur Freigabe im Entwurf.
- Mit einem Testgast den Ablauf einmal komplett durchspielen.
### 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
slug: admin-help-index
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
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: cx-team@fotospiel.app
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` |
| Event-Vorbereitung | Welche Checkliste erledige ich vor Einlass? | `event-prep-checklist` |
| Live-Betrieb | Wie überwache ich Uploads, moderiere Inhalte und sende Hinweise? | `live-ops-control` |
| Live Show | Wie richte ich den Live-Show-Player ein und spiele ihn ab? | `live-show-setup` |
| Abschluss & Compliance | Wie funktionieren Export, Archiv und Datenschutz? | `post-event-wrapup` |
| Troubleshooting | Was tun bei Upload-Problemen, Geräteverlust oder Billing-Fragen? | `admin-issue-resolution` |
| Dashboard | Wo sehe ich Status, KPIs und Schnellaktionen? | `tenant-dashboard-overview` |
| Event-Vorbereitung | Was muss vor dem Start erledigt sein? | `event-prep-checklist` |
| Live Ops | Wie moderiere ich Uploads und Queues? | `live-ops-control` |
| Live Show | Wie richte ich den Live-Show-Player ein? | `live-show-setup` |
| FAQ & Troubleshooting | Welche Probleme treten häufig auf? | `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
slug: live-ops-control
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: event-prep-checklist
@@ -16,25 +16,27 @@ related:
- slug: live-show-setup
---
## Dashboard-Widgets
- **Upload-Durchsatz** Fotos/Minute, farblich markiert bei Rückständen >25.
- **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.
## Wofür diese Seite da ist
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.
## Typischer Ablauf
1. Live-Ops-Seite auf Tablet anheften. Auto-Refresh auf 15Sekunden stellen.
2. Durchsatz beobachten, sobald Gäste eintreffen; direkt nach Zeremonien sind >40/min üblich.
3. Wächst der Rückstau, Banner senden („Bitte kurz online bleiben“ oder „Serienaufnahme reduzieren“).
4. Gemeldete Inhalte zügig bearbeiten; Policy verlangt Aktion innerhalb von 10Minuten.
5. *Achievement-Trigger* nutzen, um Badges manuell zu vergeben, falls Automationen ausfallen.
## Moderation-Tab
- **Freigeben** veröffentlicht ein Foto für Gäste.
- **Ausblenden** entfernt es sofort aus der Galerie.
- **Highlight** markiert es als Featured-Inhalt.
- **Filter** fokussieren auf offene oder markierte Inhalte.
## Eskalationsmatrix
| Problem | Erste Aktion | Eskalation an |
| --- | --- | --- |
| Upload-Warteschlange fest | Health Check ausführen → Event erneut synchronisieren | Reliability Rufbereitschaft |
| Anstößiger Inhalt | Foto ausblenden → Beweis herunterladen → Veranstalter informieren | Legal Duty Officer |
| Billing-Lock | Paddle-Dashboard prüfen → Zahlungsstatus bestätigen | Finance |
## Live-Show-Tab
- **Queue** zeigt, was als Nächstes auf die Leinwand kommt.
- **Freigeben + Live** veröffentlicht in Galerie und Live Show.
- **Von Live entfernen** nimmt es von der Anzeige, ohne es zu löschen.
## 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
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
slug: live-show-setup
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: live-ops-control
- 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?
- Du willst neue Uploads live auf einer großen Leinwand zeigen.
- Du brauchst einen stabilen Ablauf mit Moderation, Effekten und klarer Hardware-Empfehlung.
## Live Show konfigurieren (Admin-App)
1. Event öffnen und **Live Show Einstellungen** aufrufen.
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)
1. Öffne das Event und gehe zu **Live Show Einstellungen**.
2. Wähle den **Moderationsmodus**:
- **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
- Live-Show-URL im Format `/show/<token>` nutzen.
- Der Player ist nur lesend und braucht keinen Login.
## Live Show Link öffnen
- Öffne den Live-Show-Link im Format `/show/<token>` im Browser des Abspielgeräts.
- Teile den Link nur mit Personen, die die Show steuern dürfen.
## Während des Events
- Fotos in Live Ops freigeben, wenn Moderation aktiv ist.
- Bei Rucklern Effekte reduzieren oder auf Single-Layout wechseln.
> Tipp: Der Live-Show-Player läuft ohne Login und ist read-only.
## Moderation im Live-Betrieb
- Ö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.
## Empfohlene Hardware
- Laptop oder Mini-PC mit Chrome/Edge sowie stabilem WLAN oder Ethernet.
- Projektor mit mindestens 3000 ANSI Lumen (4500+ für große Locations).
### 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
slug: tenant-dashboard-overview
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: onboarding@fotospiel.app
related:
- slug: event-prep-checklist
- slug: admin-issue-resolution
- slug: live-ops-control
---
## 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
1. **Home** Überblick über laufende Events, Speicherauslastung und offene Meldungen.
2. **Team** Admins per E-Mail einladen, Rollen vergeben (Owner, Manager, Moderator). SSO via Azure AD/Google möglich, falls im Kundenkonto aktiviert.
3. **Branding** Logos hochladen, Akzentfarben wählen, lokalisierten Begrüßungstext für die Gäste-App setzen.
4. **Rechtliches** Impressum/Datenschutz/AGB über die Legal-Ressource pflegen; Änderungen greifen sofort.
5. **Integrationen** Paddle-Keys, RevenueCat-App-IDs, Webhooks und Zapier-Tokens verwalten. Keine Secrets in Dokumente kopieren.
## Was das Dashboard zeigt
- **Event-Status** (Entwurf / Veröffentlicht), damit klar ist, was Gäste sehen.
- **KPIs** zu Gästen, Uploads und Engagement für einen schnellen Puls-Check.
- **Setup-Checkliste** mit den wichtigsten Restschritten bis zum Start.
- **Schnellaktionen** zu Aufgaben, Live Show, Branding und QR-Tools.
## Best Practices
- Mindestens zwei Owner-Rollen für Redundanz halten.
- Branding oder Automationen zuerst im Staging-Kundenkonto testen.
- Einladungen als bd-Issue dokumentieren.
## So nutzt du es
1. **Status prüfen** und das Event bis zur Freigabe im Entwurf lassen.
2. **Checkliste abarbeiten** sie bildet den typischen Vorbereitungsweg ab.
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
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
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.

View File

@@ -3,36 +3,39 @@ title: "Event Preparation Checklist"
locale: en
slug: event-prep-checklist
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: tenant-dashboard-overview
- slug: live-ops-control
- slug: post-event-wrapup
- slug: live-show-setup
---
## 4824 hours before
- [ ] Create the event in the Admin app with correct timezone + retention policy.
- [ ] Upload cover artwork (1200×630) and ensure translations exist for titles/descriptions.
- [ ] Import guest lists or generate QR badges if needed.
- [ ] Test push notification templates (reminders, achievement unlocks).
- [ ] **Create the event** with correct date, timezone, and retention policy.
- [ ] **Upload branding** (cover image, logo, welcome text) in all required languages.
- [ ] **Define tasks**: pick a task package, adjust tasks, add emotions/collections.
- [ ] **Prepare guest entry**: QR code, join link, or invitations.
## 242 hours before
- [ ] Run `tenant:attach-demo-event` in staging to rehearse workflow with staff.
- [ ] Print or display the join QR near entrance and photobooth areas.
- [ ] Prepare onsite Wi-Fi SSID/password signage.
- [ ] Confirm that automatic moderation rules match the client contract (e.g., block explicit content, require approval).
- [ ] Verify Paddle/RevenueCat status dashboards show green.
- [ ] **Publish the event** once everything is approved.
- [ ] **Verify uploads** using a test device (camera permission + first upload).
- [ ] **Review moderation** settings (guest visibility, approval rules).
- [ ] **Check Live Show settings** if you plan a big screen display.
## Final 2 hours
- [ ] Clear demo data from the live event.
- [ ] Open the guest app on test devices and complete the getting-started flow.
- [ ] Start the Live Ops screen on a tablet/laptop near the stage.
- [ ] Brief staff on escalation paths (support contacts, backup devices, photo guidelines).
- [ ] **Share the QR** at entrances and photobooth areas.
- [ ] **Open Live Ops** on a staff device for moderation.
- [ ] **Brief staff** on what to do for flagged content or support requests.
### 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?
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
slug: admin-help-index
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
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: cx-team@fotospiel.app
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` |
| Event Preparation | What checklists should I complete before doors open? | `event-prep-checklist` |
| Live Operations | How do I monitor uploads, moderate content, and trigger announcements? | `live-ops-control` |
| Live Show | How do I set up and run the Live Show player? | `live-show-setup` |
| Wrap-up & Compliance | How are exports, archives, and privacy handled? | `post-event-wrapup` |
| Troubleshooting | How to handle upload issues, device loss, billing, etc. | `admin-issue-resolution` |
| Dashboard | Where do I see status, KPIs, and quick actions? | `tenant-dashboard-overview` |
| Event Preparation | What do I need before guests arrive? | `event-prep-checklist` |
| Live Operations | How do I moderate uploads and manage queues? | `live-ops-control` |
| Live Show | How do I configure the Live Show player? | `live-show-setup` |
| FAQ & Troubleshooting | What are the most common issues? | `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
slug: live-ops-control
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: event-prep-checklist
@@ -16,25 +16,27 @@ related:
- slug: live-show-setup
---
## Dashboard widgets
- **Upload throughput** photos/minute, highlighted when backlog >25.
- **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.
## What this page is for
Live Ops is the command center during an event. Use it to moderate uploads, manage the Live Show queue, and keep quality high.
## Typical workflow
1. Pin the Live Ops page on a tablet. Set auto-refresh to 15 seconds.
2. Watch the throughput graph as doors open; expect spike to 40+/min right after ceremonies.
3. If backlog grows, broadcast a banner reminding guests to stay online or reduce burst uploads.
4. Moderate flagged items quickly; policies require action within 10 minutes.
5. Use the *Achievement trigger* widget to award badges manually if automation criteria fail.
## Moderation tab
- **Approve** publishes a photo for guests.
- **Hide** removes it from the gallery immediately.
- **Highlight** adds it to featured content.
- **Filters** let you focus on pending or highlighted items.
## Escalation matrix
| Issue | First action | Escalate to |
| --- | --- | --- |
| Upload queue stuck | Run health check → re-sync event | Reliability on-call |
| Offensive content | Hide photo → download evidence → notify organizer | Legal duty officer |
| Billing lock | Check Paddle dashboard → confirm payment status | Finance |
## Live Show tab
- **Queue** shows what is waiting to appear on the big screen.
- **Approve + Live** pushes a photo to both the gallery and Live Show.
- **Remove from Live** takes an item off the screen without deleting it.
## 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?
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
slug: live-show-setup
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: ops@fotospiel.app
related:
- slug: live-ops-control
- 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?
- You want new uploads to appear live on a large display.
- You need a stable flow with moderation, effects, and hardware guidance.
- You want new uploads to appear live on a big screen.
- 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**.
2. Choose a **moderation mode**:
2. Pick a **moderation mode**:
- **Off**: every photo appears immediately.
- **Manual**: photos are held in the Live Show queue.
- **Trusted only**: only approved sources are auto-added.
3. Set the **pace** (auto or fixed seconds), **layout** (single/split/grid), and **effect preset**.
- **Manual**: photos wait in the queue.
- **Trusted only**: only approved devices publish automatically.
3. Set the **pace**, **layout**, and **effects** that fit the venue.
4. Save the settings.
## Open the Live Show link
- Open the Live Show URL in the format `/show/<token>` on the playback device.
- Share the link only with staff who should control the show.
- Use the Live Show URL in the format `/show/<token>`.
- 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
- Open the **Live Show queue** in the admin app and approve new photos.
- Use **"Approve + Live"** to publish to gallery and Live Show in one step.
- Act quickly on sensitive content (policy: ≤10 minutes).
## Recommended hardware
- Laptop or mini PC with Chrome/Edge and stable Wi-Fi or Ethernet.
- Projector at least 3000 ANSI lumens (4500+ recommended for large venues).
## Effects & layouts (recommended defaults)
- **Film Cut** + **Blur last**: calm, professional look.
- **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.
### Need more help?
See `live-ops-control` for moderation flow or `admin-issue-resolution` for troubleshooting.

View File

@@ -1,34 +1,38 @@
---
title: "Customer Control Center Overview"
title: "Event Dashboard Overview"
locale: en
slug: tenant-dashboard-overview
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
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
last_reviewed_at: 2026-01-23
owner: onboarding@fotospiel.app
related:
- slug: event-prep-checklist
- slug: admin-issue-resolution
- slug: live-ops-control
---
## 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
1. **Home** snapshot of live events, storage usage, unresolved reports.
2. **Team** invite admins via email, assign roles (Owner, Manager, Moderator). SSO via Azure AD/Google is available if enabled in customer settings.
3. **Branding** upload logos, choose accent colors, set localized welcome text shown in the guest app.
4. **Legal pages** edit Impressum/Privacy/AGB via the Legal resource; changes propagate instantly.
5. **Integrations** manage Paddle keys, RevenueCat app IDs, webhooks, and Zapier tokens. Never paste secrets into articles.
## What the dashboard shows
- **Event status** (Draft / Published) so you always know what guests can see.
- **KPIs** for guests, uploads, and engagement so you can spot momentum early.
- **Setup checklist** with the remaining steps before launch.
- **Quick actions** that jump to tasks, Live Show, branding, and QR tools.
## Best practices
- Keep at least two Owner-level accounts for redundancy.
- Use the staging customer account to test branding or automation before touching production.
- Document invitations in a bd issue note.
## How to use it
1. **Confirm the status** and keep the event in Draft until everything is ready.
2. **Work the checklist** from top to bottom; it mirrors the most common prep path.
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?
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.