huge documentaton restructure for docusaurus

docs/help/de/admin/admin-issue-resolution.md

@@ -0,0 +1,37 @@
+---
+title: "Troubleshooting & Incident-Playbooks"
+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."
+version_introduced: 2025.4
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+owner: reliability@fotospiel.app
+related:
+  - slug: live-ops-control
+  - slug: privacy-and-support
+---
+
+## 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 |
+
+## 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.
+
+## 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.
+
+## Kommunikationsvorlagen
+Nutze die vorformulierten Antworten in `docs/content/fotospiel_howto_artikel_detailliert.md`, um Messaging konsistent zu halten.
+
+### Weitere Hilfe
+Eskalation an reliability@fotospiel.app mit Event-ID, Kunde und Zeitstempel. Screenshots/Logs anhängen, wenn verfügbar.

docs/help/de/admin/event-prep-checklist.md

@@ -0,0 +1,38 @@
+---
+title: "Checkliste Event-Vorbereitung"
+locale: de
+slug: event-prep-checklist
+audience: admin
+summary: "48-Stunden-Countdown, damit Geräte, Gäste und Automationen ready sind, bevor es losgeht."
+version_introduced: 2025.4
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+owner: ops@fotospiel.app
+related:
+  - slug: live-ops-control
+  - slug: post-event-wrapup
+---
+
+## 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).
+
+## 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).
+
+## 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).
+
+### Weitere Hilfe
+Siehe `live-ops-control` für Echtzeit-Monitoring oder melde dich bei ops@fotospiel.app.

docs/help/de/admin/index.md

@@ -0,0 +1,25 @@
+---
+title: "Hilfecenter 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."
+version_introduced: 2025.4
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+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:
+
+| Phase | Leitfragen | 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` |
+| 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` |
+
+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.

docs/help/de/admin/live-ops-control.md

@@ -0,0 +1,39 @@
+---
+title: "Live-Ops-Steuerung"
+locale: de
+slug: live-ops-control
+audience: admin
+summary: "Uploads überwachen, Inhalte moderieren und Durchsagen versenden, während das Event läuft."
+version_introduced: 2025.4
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+owner: ops@fotospiel.app
+related:
+  - slug: event-prep-checklist
+  - slug: admin-issue-resolution
+---
+
+## 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.
+
+## 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.
+
+## 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 |
+
+### Weitere Hilfe
+Siehe `admin-issue-resolution` für detailliertes Troubleshooting oder melde dich im Slack-Channel #ops-help.

docs/help/de/admin/post-event-wrapup.md

@@ -0,0 +1,33 @@
+---
+title: "Nachbereitung & Abschluss"
+locale: de
+slug: post-event-wrapup
+audience: admin
+summary: "Highlights exportieren, Daten archivieren und Datenschutzpflichten binnen 72 Stunden erfüllen."
+version_introduced: 2025.4
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+owner: success@fotospiel.app
+related:
+  - slug: event-prep-checklist
+  - slug: privacy-and-support
+---
+
+## Erste 24 Stunden
+- Dankes-Push/E-Mail mit kuratierten Highlights senden (bis zu 40 Fotos auswählen → *Link teilen*).
+- Admin-CSV exportieren (Uploads, Likes, Meldungen) für die eigene Ablage.
+- Moderationswarteschlange prüfen, damit keine Meldung offen bleibt.
+
+## Innerhalb von 72 Stunden
+- Aktion *Archivieren & Bereinigen* starten (Einstellungen → Datenlebenszyklus). Kopiert Medien in Cold Storage und löscht temporäre Caches.
+- Gästen Download-Links bereitstellen, falls vertraglich zugesagt.
+- Bei eingegangenen DSGVO-Löschanfragen Abschluss bestätigen und Ticket-ID dokumentieren.
+
+## Optionaler Follow-up
+- Event als Vorlage duplizieren für zukünftige Produktionen.
+- Erkenntnisse oder Verbesserungswünsche in `docs/process/todo/` festhalten.
+
+### Weitere Hilfe
+Wende dich an success@fotospiel.app oder konsultiere die Legal-Pages-Ressource für Compliance-Formulierungen.

docs/help/de/admin/tenant-dashboard-overview.md

@@ -0,0 +1,34 @@
+---
+title: "Überblick: Kunden-Dashboard"
+locale: de
+slug: tenant-dashboard-overview
+audience: admin
+summary: "Mitarbeitende einladen, Branding konfigurieren und globale Kundeneinstellungen verstehen."
+version_introduced: 2025.4
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-02-22
+owner: onboarding@fotospiel.app
+related:
+  - slug: event-prep-checklist
+  - slug: admin-issue-resolution
+---
+
+## 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.
+
+## 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.
+
+## Best Practices
+- Mindestens zwei Owner-Rollen für Redundanz halten.
+- Branding oder Automationen zuerst im Staging-Kundenkonto testen.
+- Einladungen im Änderungslog (`docs/process/changes/`) dokumentieren.
+
+### Weitere Hilfe
+Siehe `event-prep-checklist` für Event-Vorbereitung oder kontaktiere cx-team@fotospiel.app für Onboarding-Support.