From b267ae2c157e9e2c9812ada44ad589d9f76206ad Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Fri, 23 Jan 2026 09:35:26 +0100 Subject: [PATCH] Refresh admin help articles for event PWA --- docs/help/de/admin/admin-issue-resolution.md | 43 ++++++---- docs/help/de/admin/event-prep-checklist.md | 39 +++++---- docs/help/de/admin/index.md | 23 +++-- docs/help/de/admin/live-ops-control.md | 44 +++++----- docs/help/de/admin/live-show-setup.md | 86 ++++++------------- .../de/admin/tenant-dashboard-overview.md | 36 ++++---- docs/help/en/admin/admin-issue-resolution.md | 43 ++++++---- docs/help/en/admin/event-prep-checklist.md | 37 ++++---- docs/help/en/admin/index.md | 23 +++-- docs/help/en/admin/live-ops-control.md | 42 ++++----- docs/help/en/admin/live-show-setup.md | 76 ++++------------ .../en/admin/tenant-dashboard-overview.md | 36 ++++---- 12 files changed, 239 insertions(+), 289 deletions(-) diff --git a/docs/help/de/admin/admin-issue-resolution.md b/docs/help/de/admin/admin-issue-resolution.md index b15d06c..c95ae97 100644 --- a/docs/help/de/admin/admin-issue-resolution.md +++ b/docs/help/de/admin/admin-issue-resolution.md @@ -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 >10 Min 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/` 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. diff --git a/docs/help/de/admin/event-prep-checklist.md b/docs/help/de/admin/event-prep-checklist.md index 3fd992d..34d3321 100644 --- a/docs/help/de/admin/event-prep-checklist.md +++ b/docs/help/de/admin/event-prep-checklist.md @@ -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 --- ## 48–24 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. ## 24–2 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. diff --git a/docs/help/de/admin/index.md b/docs/help/de/admin/index.md index ae51724..46babc1 100644 --- a/docs/help/de/admin/index.md +++ b/docs/help/de/admin/index.md @@ -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. diff --git a/docs/help/de/admin/live-ops-control.md b/docs/help/de/admin/live-ops-control.md index f0a70b5..2d4820b 100644 --- a/docs/help/de/admin/live-ops-control.md +++ b/docs/help/de/admin/live-ops-control.md @@ -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 15 Sekunden 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 10 Minuten. -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. diff --git a/docs/help/de/admin/live-show-setup.md b/docs/help/de/admin/live-show-setup.md index 393592a..591294c 100644 --- a/docs/help/de/admin/live-show-setup.md +++ b/docs/help/de/admin/live-show-setup.md @@ -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/` nutzen. +- Der Player ist nur lesend und braucht keinen Login. -## Live Show Link öffnen -- Öffne den Live-Show-Link im Format `/show/` 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, 8 GB RAM -- HDMI-Kabel (5–10 m) -- Beamer ≥3000 ANSI Lumen, 1080p - -**Empfohlen (stabil):** -- Mini-PC oder Laptop mit dedizierter Grafikeinheit -- Ethernet-Verbindung (USB‑C → Ethernet Adapter) -- Beamer ≥4500 ANSI Lumen, 1080p/4K, 16:9 -- HDMI 2.0 + aktiver HDMI-Verlängerer (ab 10 m) - -**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 5 GHz-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. diff --git a/docs/help/de/admin/tenant-dashboard-overview.md b/docs/help/de/admin/tenant-dashboard-overview.md index 98e897a..10a38c3 100644 --- a/docs/help/de/admin/tenant-dashboard-overview.md +++ b/docs/help/de/admin/tenant-dashboard-overview.md @@ -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. diff --git a/docs/help/en/admin/admin-issue-resolution.md b/docs/help/en/admin/admin-issue-resolution.md index eb9ffbe..9ed28ae 100644 --- a/docs/help/en/admin/admin-issue-resolution.md +++ b/docs/help/en/admin/admin-issue-resolution.md @@ -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/`. +**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. diff --git a/docs/help/en/admin/event-prep-checklist.md b/docs/help/en/admin/event-prep-checklist.md index a6bb72e..5aee0ef 100644 --- a/docs/help/en/admin/event-prep-checklist.md +++ b/docs/help/en/admin/event-prep-checklist.md @@ -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 --- ## 48–24 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. ## 24–2 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. diff --git a/docs/help/en/admin/index.md b/docs/help/en/admin/index.md index d81da00..e4a2ff9 100644 --- a/docs/help/en/admin/index.md +++ b/docs/help/en/admin/index.md @@ -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. diff --git a/docs/help/en/admin/live-ops-control.md b/docs/help/en/admin/live-ops-control.md index 1fbf16c..93d5d3f 100644 --- a/docs/help/en/admin/live-ops-control.md +++ b/docs/help/en/admin/live-ops-control.md @@ -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. diff --git a/docs/help/en/admin/live-show-setup.md b/docs/help/en/admin/live-show-setup.md index 341a760..5a2c6f8 100644 --- a/docs/help/en/admin/live-show-setup.md +++ b/docs/help/en/admin/live-show-setup.md @@ -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/` on the playback device. -- Share the link only with staff who should control the show. +- Use the Live Show URL in the format `/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 -- 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 (5–10 m) -- Projector ≥3000 ANSI lumens, 1080p - -**Recommended (stable):** -- Mini PC or laptop with dedicated GPU -- Ethernet connection (USB‑C → 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 Wi‑Fi or (better) Ethernet. -- Avoid guest Wi‑Fi 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 Wi‑Fi. -- **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. diff --git a/docs/help/en/admin/tenant-dashboard-overview.md b/docs/help/en/admin/tenant-dashboard-overview.md index e93cbf8..cb0670e 100644 --- a/docs/help/en/admin/tenant-dashboard-overview.md +++ b/docs/help/en/admin/tenant-dashboard-overview.md @@ -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.