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.