komplette überarbeitung des Gäste-Hilfebereichs und Ergänzung eines One-Time-Containers zum Aktualisieren der Hilfedokumente

docker-compose.dokploy.yml

@@ -106,6 +106,25 @@ services:
         condition: service_healthy
     restart: "no"
 
+  help-sync:
+    image: ${APP_IMAGE_REPO:-fotospiel-app}:${APP_IMAGE_TAG:-latest}
+    env_file:
+      - path: .env
+    command: php artisan help:sync
+    environment:
+      <<: *app-env
+      SKIP_CODE_SYNC: "1"
+    volumes:
+      - app-code:/var/www/html
+      - app-storage:/var/www/html/storage
+      - app-bootstrap-cache:/var/www/html/bootstrap/cache
+    depends_on:
+      app:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    restart: "no"
+
   web:
     image: nginx:1.27-alpine
     depends_on:

docs/help/de/guest/achievements-and-badges.md

@@ -0,0 +1,38 @@
+---
+title: "Erfolge & Badges"
+locale: de
+slug: achievements-and-badges
+audience: guest
+summary: "Badges verdienen, Highlights sehen und deinen Fortschritt verfolgen."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: tasks-and-missions
+  - slug: gallery-and-sharing
+  - slug: notifications-and-push
+---
+
+## Wann lesen?
+Wenn du wissen möchtest, welche Erfolge es gibt, wie Badges funktionieren und wo du deinen Fortschritt siehst.
+
+## Was du im Erfolge-Bereich findest
+- **Persönliche Statistiken:** Anzahl deiner Fotos, erledigten Aufgaben und Likes.
+- **Badges:** Fortschrittsbalken zeigt, wie nah du an der nächsten Stufe bist.
+- **Highlights:** Top-Foto des Events und trendende Emotionen.
+- **Ranglisten:** Wer aktuell die meisten Uploads und Likes gesammelt hat.
+
+## So verdienst du Badges
+- **Mehr Fotos hochladen:** Jede Aufnahme zählt in deine Statistik.
+- **Aufgaben lösen:** Aufgaben erhöhen deinen Fortschritt besonders schnell.
+- **Likes sammeln:** Beliebte Fotos pushen dein Ranking.
+
+## Tipps
+- Manche Events deaktivieren Aufgaben; dann konzentrieren sich Erfolge auf Uploads und Likes.
+- Updates können ein paar Sekunden brauchen – die Zahlen aktualisieren sich laufend.
+
+### Weitere Hilfe
+Siehe `tasks-and-missions` für Aufgaben oder `gallery-and-sharing` für Likes und Shares.

docs/help/de/guest/gallery-and-sharing.md

@@ -0,0 +1,46 @@
+---
+title: "Galerie & Teilen"
+locale: de
+slug: gallery-and-sharing
+audience: guest
+summary: "Galerie öffnen, filtern, liken, teilen und Fotos herunterladen."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: tasks-and-missions
+---
+
+## Wann lesen?
+Wenn du Fotos entdecken, liken oder teilen willst – oder wissen möchtest, was die Filter bedeuten.
+
+## Galerie öffnen
+Tippe unten auf **Galerie**, um alle Eventfotos zu sehen.
+
+## Filter verstehen
+- **Neueste:** Chronologisch aktuellste Uploads.
+- **Beliebt:** Fotos mit vielen Likes.
+- **Meine:** Uploads von deinem Gerät.
+- **Fotobox:** Nur sichtbar, wenn das Event eine Fotobox aktiviert hat.
+
+## Foto ansehen
+In der Detailansicht kannst du:
+- **Liken** (Herz)
+- **Teilen** (Share-Symbol)
+- **Herunterladen** (Download-Symbol)
+
+## Teilen von Fotos
+- **System-Share:** Teile per WhatsApp, Nachrichten oder anderen Apps.
+- **Link kopieren:** Erzeugt einen Share-Link zum Foto.
+- **Ablauf beachten:** Share-Links können ablaufen; in dem Fall erscheint eine Meldung.
+
+## Öffentliche Galerie
+Einige Events teilen eine öffentliche Galerie. Diese erreichst du über einen separaten Link (z. B. `/g/<token>`). Die Galerie kann ebenfalls zeitlich begrenzt sein.
+
+### Weitere Hilfe
+Siehe `uploading-photos` für neue Uploads oder `achievements-and-badges` für Like-Auswertung.

docs/help/de/guest/getting-started.md

@@ -1,36 +1,43 @@
 ---
-title: "Schnellstart: Event betreten"
+title: "Schnellstart: Event beitreten"
 locale: de
 slug: getting-started
 audience: guest
-summary: "Fotospiel-App installieren, Event beitreten und die Grundgesten in unter zwei Minuten lernen."
+summary: "Link öffnen, Namen wählen und sofort mit der Fotospiel-Gäste-PWA starten."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: guest-success@fotospiel.app
 related:
   - slug: uploading-photos
+  - slug: how-fotospiel-works
+  - slug: tasks-and-missions
+  - slug: gallery-and-sharing
   - slug: offline-sync
 ---
 
 ## Wann lesen?
-Du hast einen Event-Code oder QR-Link erhalten und möchtest sofort loslegen. Voraussetzung: aktueller mobiler Browser (Safari, Chrome, Edge, Samsung Internet) und einmalige Online-Verbindung für den Erstabgleich.
+Du hast einen Event-Link oder QR-Code erhalten und möchtest sofort loslegen. Voraussetzung: aktueller mobiler Browser (Safari, Chrome, Edge, Samsung Internet) und einmalige Online-Verbindung für den Start.
+
+## Das Wichtigste zuerst
+- **Kein Konto nötig:** Du brauchst nur den Link oder QR-Code.
+- **Kamera ist zentral:** Die große Kamera unten ist der schnellste Einstieg.
+- **Galerie & Aufgaben:** Nach dem Upload kannst du Fotos teilen oder Aufgaben lösen (falls aktiv).
 
 ## Schritte
-1. **Einladungslink öffnen oder QR scannen.** Der Browser zeigt die Startseite der Fotospiel-Gäste-App.
+1. **Einladungslink öffnen oder QR scannen.** Die Landingpage erkennt den Event-Code automatisch.
-2. **Installation für Vollbild aktivieren.** Tippe auf *Zum Home-Bildschirm* (iOS) bzw. *App installieren* (Android). Optional, aber empfohlen für Offline-Modus und schnellere Uploads.
+2. **Event-Code oder Link einfügen.** Falls nötig, kannst du Link oder Code manuell einfügen.
-3. **Event-Code eingeben.** Sechs Zeichen, Groß-/Kleinschreibung egal. Nach QR-Scan wird das Feld automatisch befüllt.
+3. **Anzeigenamen wählen.** Dieser erscheint bei deinen Uploads. Kein Konto und keine E-Mail nötig.
-4. **Anzeigenamen wählen.** Dieser erscheint in der Event-Ansicht neben deinen Uploads. Kein Konto oder E-Mail nötig.
+4. **Navigation verstehen.** Unten findest du Home, Aufgaben (falls aktiv), Erfolge und Galerie. Die große Kamera in der Mitte startet die Aufnahme.
-5. **Kamera- & Speicherzugriff erlauben.** Wähle „Einmal erlauben“ oder „Beim Verwenden der App“, damit Fotospiel Fotos speichern kann.
+5. **Optional installieren.** *Zum Home-Bildschirm* (iOS) oder *App installieren* (Android) für schnellen Zugriff.
-6. **Startpaket synchronisieren.** Die App lädt Alben, Achievements und Upload-Regeln herunter. Ein Fortschrittsbalken zeigt den Abschluss für den Offline-Modus.
+6. **Berechtigungen erlauben.** Kamera-/Fotozugriff bestätigen. Push kannst du später in der Glocke aktivieren.
-7. **Gesten entdecken.** Nach oben wischen öffnet die Kamera, links/rechts wechselt das Album, Langdruck auf einem Foto ermöglicht Like oder Meldung.
 
 ## Tipps
-- Lege die App vor dem Event in die Dock/App-Leiste, damit du sie schnell wiederfindest.
+- Wenn ihr ein Gerät teilt: Einstellungen → Profil, Namen zwischen den Sessions ändern.
-- Teilen sich mehrere Gäste ein Gerät, setze den Anzeigenamen unter Einstellungen → Profil zwischen den Sessions zurück.
+- Bei „Event abgelaufen“ oder „nicht gefunden“: Event-Team oder Einladungs-Mail prüfen.
-- Screenshots verlassen dein Gerät nur, wenn du sie aktiv hochlädst.
+- Hilfe findest du jederzeit unter Einstellungen → Hilfe.
 
 ### Weitere Hilfe
-Siehe `uploading-photos` für Bearbeitungs- und Batch-Uploads oder `privacy-and-support` für Fragen zum Datenschutz.
+Siehe `uploading-photos` für den Aufnahme-Workflow oder `tasks-and-missions`, wenn du mit Aufgaben starten möchtest.

docs/help/de/guest/how-fotospiel-works.md

@@ -0,0 +1,40 @@
+---
+title: "So funktioniert Fotospiel"
+locale: de
+slug: how-fotospiel-works
+audience: guest
+summary: "Der 60‑Sekunden‑Überblick: Event betreten, fotografieren, teilen."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: getting-started
+  - slug: uploading-photos
+  - slug: gallery-and-sharing
+---
+
+## Kurz erklärt
+Fotospiel ist eine Gäste‑PWA für Events. Du brauchst keinen Account – nur den Link oder QR‑Code. Danach kannst du sofort Fotos machen und in der Event‑Galerie teilen.
+
+## Der Kernflow
+1. **Event öffnen** → Link/QR scannen, Name wählen.
+2. **Foto aufnehmen** → Kamera öffnen, aufnehmen, bestätigen.
+3. **Foto teilen** → Upload abschließen, Galerie öffnen, Likes sammeln.
+
+## Wichtige App‑Bereiche
+- **Start/Home:** Missionen und Highlights.
+- **Aufgaben:** Fotoaufgaben (falls aktiviert).
+- **Galerie:** Alle Fotos, Likes und Sharing.
+- **Erfolge:** Fortschritt, Badges und Ranglisten.
+- **Glocke:** Benachrichtigungen & Upload‑Status.
+
+## Gut zu wissen
+- **Moderation:** Manche Events prüfen Uploads vor der Freigabe.
+- **Offline:** Ohne Netz kannst du fotografieren, Inhalte aktualisieren sich später.
+- **Push:** Benachrichtigungen sind optional und können in der Glocke aktiviert werden.
+
+### Weitere Hilfe
+Siehe `getting-started` für den Einstieg oder `gallery-and-sharing` fürs Teilen.

docs/help/de/guest/index.md

@@ -3,25 +3,38 @@ title: "Hilfecenter für Gäste"
 locale: de
 slug: guest-help-index
 audience: guest
-summary: "Alle Infos für Teilnehmer:innen, um die Fotospiel-Gäste-App zu installieren, einem Event beizutreten und Erinnerungen zu teilen."
+summary: "Alle Infos für Teilnehmer:innen, um der Fotospiel-Gäste-App beizutreten, Aufgaben zu lösen und Fotos zu teilen."
 version_introduced: 2025.4
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: product-support@fotospiel.app
 related: []
 ---
 
-Willkommen im Hilfebereich für Gäste. Die folgenden Leitfäden decken alle Grundlagen ab und stehen jeweils auf Deutsch und Englisch bereit:
+Willkommen im Hilfebereich für Gäste. Hier die wichtigsten Dinge vorab:
 
-- [Schnellstart](./getting-started) – App installieren, Event-Code eingeben und die wichtigsten Gesten lernen.
+1) Link/QR öffnen → Event wird erkannt.
-- [Fotos hochladen](./uploading-photos) – Fotos aufnehmen, bearbeiten und mit Hintergrund-Sync hochladen.
+2) Namen wählen → Kamera starten.
-- [Offline nutzen](./offline-sync) – Auch ohne Netz teilnehmen und sicherstellen, dass nichts verloren geht.
+3) Foto hochladen → In der Galerie teilen.
-- [Datenschutz & Support](./privacy-and-support) – Welche Daten gespeichert werden und wie du Hilfe kontaktierst.
+
+Die folgenden Leitfäden decken alle Grundlagen ab und stehen jeweils auf Deutsch und Englisch bereit:
+
+- [So funktioniert Fotospiel](./how-fotospiel-works) – Der schnelle Überblick in 60 Sekunden.
+- [Schnellstart](./getting-started) – Event beitreten, Namen wählen und loslegen.
+- [Aufgaben & Missionen](./tasks-and-missions) – Aufgaben ziehen, Stimmung filtern, Mission starten.
+- [Fotos aufnehmen & hochladen](./uploading-photos) – Kamera öffnen, prüfen, hochladen.
+- [Galerie & Teilen](./gallery-and-sharing) – Fotos entdecken, liken, teilen und herunterladen.
+- [Erfolge & Badges](./achievements-and-badges) – Fortschritt, Highlights und Ranglisten.
+- [Benachrichtigungen & Push](./notifications-and-push) – Hinweise, Upload-Status und Push aktivieren.
+- [Offline & Verbindung](./offline-sync) – Was ohne Netz funktioniert und wie du Uploads nachholst.
+- [Upload-Probleme lösen](./upload-troubleshooting) – Häufige Fehler & schnelle Fixes.
+- [Einstellungen & Cache](./settings-and-cache) – Profil, Rechtliches, Cache löschen.
+- [Datenschutz & Support](./privacy-and-support) – Daten, Rechte und Kontaktwege.
 
 ### So nutzt du die Hilfe
-- **Suche**: Nutze die Suche im Hilfebereich oder die Offline-Suche in der App. Begriffe wie „Upload-Limit“ oder „Link teilen“ funktionieren.
+- **Suche**: Nutze die Suche im Hilfebereich. Offline werden bereits geladene Artikel durchsucht.
-- **Sprache wechseln**: Über das Globus-Symbol in jedem Artikel kannst du zwischen Deutsch und Englisch umschalten.
+- **Sprache**: Die App nutzt die Event- oder Gerätesprache. Alle Artikel sind in DE/EN verfügbar.
-- **Kontext-Links**: Viele UI-Elemente mit `?`-Symbol verlinken direkt auf den passenden Abschnitt.
+- **Zugriff**: Einstellungen → Hilfe bringt dich jederzeit hierher.
 
-Mehr Unterstützung? Tippe in der Gäste-App auf *Kontakt zum Support* (Einstellungen → Hilfe) und nenne deine Event-ID.
+Mehr Unterstützung? Wende dich an das Event-Team oder antworte direkt auf die Einladung.

docs/help/de/guest/notifications-and-push.md

@@ -0,0 +1,41 @@
+---
+title: "Benachrichtigungen & Push"
+locale: de
+slug: notifications-and-push
+audience: guest
+summary: "Hinweise im Event, Upload-Status und Push-Benachrichtigungen steuern."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: upload-troubleshooting
+---
+
+## Wann lesen?
+Wenn du wissen willst, wo Statusmeldungen auftauchen, welche Uploads geprüft werden oder wie Push aktiviert wird.
+
+## Benachrichtigungs-Center nutzen
+- **Glocke im Header:** Öffnet alle Hinweise.
+- **Tabs:** *Neu*, *Uploads/Status* und *Alle* helfen beim Filtern.
+- **Kategorien:** Du kannst zwischen Tipps/Achievements und allgemeinen Meldungen wechseln.
+- **Als gelesen markieren:** Hinweise lassen sich als gelesen markieren oder ausblenden.
+
+## Upload-Status verstehen
+- **In Prüfung:** Wenn das Event Moderation nutzt, siehst du hier die Anzahl wartender Uploads.
+- **Offline-Warteschlange:** Zeigt, ob lokale Uploads warten, bis wieder Netz verfügbar ist.
+- **Offline-Indikator:** Wenn du ohne Netz bist, erscheint ein Offline-Badge.
+
+## Push aktivieren oder deaktivieren
+1. Öffne die Glocke.
+2. Im Statusbereich siehst du den Push-Status.
+3. Tippe *Aktivieren* oder *Deaktivieren*.
+
+Wenn der Browser Push blockiert, musst du die Berechtigung in den Browser-Einstellungen zurücksetzen.
+
+### Weitere Hilfe
+Siehe `uploading-photos` für den Upload-Flow oder `upload-troubleshooting` bei Problemen.

docs/help/de/guest/offline-sync.md

@@ -1,40 +1,39 @@
 ---
-title: "Offline-Modus & Synchronisierung"
+title: "Offline & Verbindung"
 locale: de
 slug: offline-sync
 audience: guest
-summary: "Auch ohne Netz teilnehmen, Uploads sicher zwischenspeichern und den Status prüfen."
+summary: "Was offline möglich ist, wie du Uploads nachholst und worauf du achten solltest."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: reliability@fotospiel.app
 related:
   - slug: uploading-photos
-  - slug: privacy-and-support
+  - slug: upload-troubleshooting
+  - slug: notifications-and-push
+  - slug: settings-and-cache
 ---
 
 ## Wann lesen?
-Du rechnest mit schwacher oder fehlender Verbindung (Gebirge, Keller, Roaming). Sobald die Erst-Synchronisierung abgeschlossen ist, funktioniert die Gäste-App vollständig offline weiter.
+Du rechnest mit schwacher oder fehlender Verbindung (Keller, Roaming, Eventhallen) und willst wissen, was trotzdem klappt.
 
-## Was bleibt offline verfügbar?
+## Was offline möglich ist
-- Event-Feed (die letzten 250 Fotos) und Albumstruktur.
+- **Hilfeartikel lesen:** Der Hilfebereich ist nach dem ersten Laden auch offline verfügbar.
-- Upload-Regeln (Größenlimit, Moderationseinstellungen).
+- **Kamera nutzen:** Du kannst weiterhin fotografieren und Aufnahmen prüfen.
-- Entwürfe für Achievements und Sticker.
+- **Bereits geladene Inhalte:** Ansichten bleiben sichtbar, solange die App geöffnet bleibt.
-- Auszug des Hilfecenters (Top‑10 Artikel pro Sprache), sofern du den Hilfebereich mindestens einmal online geöffnet hast.
 
-## Offline-Workflow
+## Uploads nachholen
-1. **Wie gewohnt aufnehmen.** Alles landet verschlüsselt in der lokalen Warteschlange.
+1. **Wieder online gehen.** Öffne die App und bleib kurz im Event.
-2. **Ausstehende Uploads prüfen.** Achte auf das graue Label *In Warteschlange*. Tags/Notizen lassen sich auch offline ergänzen.
+2. **Upload erneut starten.** Falls der Upload fehlgeschlagen ist, tippe erneut auf *Upload*.
-3. **Speicher überwachen.** Ein Banner warnt unter 500 MB freiem Speicher; lösche gesendete Inhalte oder nutze ein anderes Gerät.
+3. **Status prüfen.** Die Glocke zeigt, ob Uploads in Prüfung sind oder ob eine lokale Warteschlange aktiv ist.
-4. **Kurz online gehen.** Sobald irgendein Netz verfügbar ist, Fotospiel öffnen. Die Sync startet automatisch und priorisiert die ältesten Elemente.
-5. **Abschluss bestätigen.** Ein grüner Hinweis „Alle Uploads übertragen“ erscheint und der Warteschlangen-Zähler springt auf Null.
 
-## Troubleshooting
+## Grenzen & Hinweise
-- **Bleibt trotz Netz auf „In Warteschlange“?** Flugmodus kurz aktivieren/deaktivieren und App neu öffnen, um den Service Worker zurückzusetzen.
+- **Ohne Netz keine Live-Updates.** Galerie und Aufgaben aktualisieren erst wieder online.
-- **Gerätewechsel?** Offline-Warteschlangen verbleiben auf dem ursprünglichen Gerät; kein Abgleich zwischen Geräten.
+- **App-Neustart offline:** Ohne Verbindung können Inhalte fehlen, weil die App nichts nachladen kann.
-- **Energiesparmodus** kann Hintergrundsync pausieren. Für große Mengen die App im Vordergrund lassen.
+- **Cache löschen = Offline-Daten weg.** Wenn du den Cache leerst, gehen lokale Kopien und wartende Uploads verloren.
 
 ### Weitere Hilfe
-Unter Einstellungen → Hilfe → *Diagnosedaten senden* kannst du (sobald du online bist) anonymisierte Logs plus deine Event-ID an den Support schicken.
+Siehe `upload-troubleshooting` für konkrete Fehlermeldungen oder `settings-and-cache` für Cache-Themen.

docs/help/de/guest/privacy-and-support.md

@@ -3,36 +3,36 @@ title: "Datenschutz & Support"
 locale: de
 slug: privacy-and-support
 audience: guest
-summary: "Welche Daten gespeichert werden, wie du Löschungen anstößt und wie du Hilfe erreichst."
+summary: "Welche Daten gespeichert werden und wie du Hilfe bekommst."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: legal@fotospiel.app
 related:
   - slug: getting-started
-  - slug: offline-sync
+  - slug: settings-and-cache
+  - slug: notifications-and-push
 ---
 
 ## Welche Daten speichern wir?
-- **Fotos & Bildunterschriften**: Liegen verschlüsselt im Speicher des Kundenkontos für den vom Veranstalter definierten Zeitraum.
+- **Fotos & Metadaten:** Deine Uploads liegen im Event-Speicher des Veranstalters.
-- **Session-ID**: Anonymer Token vom Gerät zur Upload-Nachverfolgung; wird zurückgesetzt, wenn du die App-Daten löscht.
+- **Anzeigename:** Wird zusammen mit deinen Uploads angezeigt.
-- **Geräte-Metadaten**: Nur Modell + Betriebssystem-Version für Crash-Analysen. Keine Standort-, Kontakt- oder Werbe-IDs.
+- **Geräte-ID:** Anonymer Token für Upload- und Like-Zuordnung.
+- **Push-Abos (optional):** Nur wenn du Benachrichtigungen aktivierst.
 
-## Deine Kontrollmöglichkeiten
+Wir speichern **keine** Standortdaten, Kontakte oder Werbe-IDs.
-1. **Einzelne Uploads löschen**: Foto öffnen → `…` → *Aus Event entfernen*. Du kannst nur eigene Inhalte löschen.
-2. **Lokalen Cache leeren**: Einstellungen → Speicher → *Gerätekopien löschen*. Entfernt Miniaturen und Entwürfe.
-3. **Komplette Löschung anfordern**: Einstellungen → Hilfe → *Datenlöschung anfragen*. E-Mail für Bestätigung angeben; wir leiten an den Event-Admin weiter.
 
-## Support-Kanäle
+## Deine Optionen
-- **In-App**: Einstellungen → Hilfe → *Support kontaktieren*. Optional Screenshot + Diagnosepaket anhängen.
+- **Anzeigenamen ändern:** Einstellungen → Profil.
-- **E-Mail**: guests@fotospiel.app (Event-Code + Gerät nennen).
+- **Lokale Daten löschen:** Einstellungen → Cache leeren (löscht Offline-Kopien und ggf. wartende Uploads).
-- **Vor Ort**: Event-Personal ansprechen; sie eskalieren über die Admin-App.
+- **Datenlöschung anfragen:** Über das Event-Team oder die in der Einladung angegebene Kontaktadresse.
 
-## Antwortzeiten
+## Support
-- Kritische Probleme (Uploads für gesamtes Event gestört): <15 Minuten.
+- **Vor Ort:** Event-Team ansprechen.
-- Individuelle Lösch- oder Datenschutzanfragen: innerhalb von 48 Stunden.
+- **Einladung:** Direkt auf die Einladungs-Mail antworten.
+- **E-Mail:** support@fotospiel.de (Event-Code + Gerät angeben).
 
 ### Weitere Hilfe
-Rechtsseiten (Impressum, Datenschutz, AGB) findest du unter Einstellungen → Rechtliches. Für kundenspezifische Regelungen kontaktiere den Veranstalter direkt.
+Siehe `settings-and-cache` für Geräteoptionen oder `notifications-and-push` für Hinweise und Statusmeldungen.

docs/help/de/guest/settings-and-cache.md

@@ -0,0 +1,42 @@
+---
+title: "Einstellungen & Cache"
+locale: de
+slug: settings-and-cache
+audience: guest
+summary: "Profil anpassen, Rechtliches lesen und lokale Daten verwalten."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: privacy-and-support
+  - slug: offline-sync
+---
+
+## Einstellungen öffnen
+Tippe oben auf das Zahnrad. Dort findest du Profil, Rechtliches, Hilfe und Cache.
+
+## Sprache
+- **Sprache wählen:** In den Einstellungen kannst du zwischen Deutsch und Englisch wechseln.
+- **Event-Sprache:** Standardmäßig gilt die Sprache, die vom Event vorgegeben ist.
+
+## Profil
+- **Anzeigenamen ändern:** Unter Profil kannst du den Namen anpassen oder zurücksetzen.
+- **Geteilte Geräte:** Ändere den Namen zwischen den Sessions.
+
+## Rechtliches & Hilfe
+- **Rechtliches:** Impressum, Datenschutz und AGB sind im Settings-Bereich verfügbar.
+- **Hilfe:** Öffnet das Gäste-Hilfecenter.
+
+## Cache löschen
+- **Was passiert:** Lokale Kopien (z. B. Help-Artikel) werden gelöscht.
+- **Wichtig:** Wenn noch Uploads warten, können sie verloren gehen.
+- **Tipp:** Cache erst löschen, wenn alle Uploads abgeschlossen sind.
+
+## Design
+Mit dem Mond-/Sonnen-Icon im Header kannst du zwischen Hell und Dunkel wechseln.
+
+### Weitere Hilfe
+Siehe `privacy-and-support` für Datenschutzfragen oder `offline-sync` für Offline-Themen.

docs/help/de/guest/tasks-and-missions.md

@@ -0,0 +1,43 @@
+---
+title: "Aufgaben & Missionen"
+locale: de
+slug: tasks-and-missions
+audience: guest
+summary: "Aufgaben ziehen, nach Stimmung filtern und direkt in die Kamera springen."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: gallery-and-sharing
+---
+
+## Wann lesen?
+Wenn du Fotoaufgaben nutzen möchtest oder wissen willst, wie Missionen und Stimmungen funktionieren. Hinweis: Aufgaben können pro Event deaktiviert sein.
+
+## Aufgaben finden
+- **Aufgaben-Tab öffnen:** Tippe unten auf *Aufgaben*.
+- **Missionen auf der Startseite:** Auf Home erscheinen ebenfalls Aufgaben-Karten.
+- **Stimmungsfilter nutzen:** Falls verfügbar, kannst du nach Emotionen filtern (z. B. Romantik, Party).
+
+## Aufgabe starten
+1. **Aufgabe auswählen.**
+2. **Details lesen.** Titel, Kurzbeschreibung, Dauer und Schwierigkeit helfen bei der Einschätzung.
+3. **Foto aufnehmen.** Mit dem CTA öffnet sich die Kamera; Aufgabe/Emotion sind bereits gesetzt.
+4. **Upload abschließen.** Nach dem Upload zählt die Aufgabe automatisch als erledigt.
+
+## Inspiration & Fortschritt
+- **Neue Aufgabe ziehen:** Wische zur nächsten Aufgabe oder tippe auf die Aktualisieren-Aktion.
+- **Inspiration ansehen:** Zu manchen Aufgaben gibt es Beispielbilder.
+- **Fortschritt sehen:** Der Erfolge-Bereich zeigt, wie viele Aufgaben du gelöst hast.
+
+## Tipps
+- Wenn keine Aufgaben erscheinen, hat das Event sie eventuell deaktiviert.
+- Aufgaben sind optional – du kannst jederzeit frei fotografieren.
+
+### Weitere Hilfe
+Siehe `uploading-photos` für die Kamera oder `achievements-and-badges` für deinen Fortschritt.

docs/help/de/guest/upload-troubleshooting.md

@@ -0,0 +1,39 @@
+---
+title: "Upload-Probleme lösen"
+locale: de
+slug: upload-troubleshooting
+audience: guest
+summary: "Häufige Upload-Fehler, Berechtigungen und schnelle Fixes."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: offline-sync
+  - slug: notifications-and-push
+---
+
+## Kamera startet nicht
+- **Berechtigung prüfen:** Browser- oder Systemsettings öffnen und Kamera erlauben.
+- **Kamera blockiert:** Wenn der Browser blockiert, musst du die Berechtigung dort zurücksetzen.
+- **Nicht unterstützt:** Manche Browser unterstützen keine Live-Kamera – nutze dann den Galerie-Import.
+
+## Upload schlägt fehl
+- **Verbindung prüfen:** WLAN/Mobilfunk testen, App offen lassen.
+- **Erneut versuchen:** Der Upload-Dialog bietet eine direkte Wiederholung.
+- **Große Dateien:** Die App komprimiert automatisch, bei sehr großen Fotos erneut aufnehmen.
+
+## Limit erreicht
+Manche Events haben Foto- oder Geräte-Limits. In diesem Fall ist kein weiterer Upload möglich – frag das Event-Team.
+
+## Uploads in Prüfung
+Bei moderierten Events werden Fotos geprüft. Im Benachrichtigungsbereich siehst du den Status.
+
+## Link oder Event abgelaufen
+Wenn Links abgelaufen sind, erscheint eine Meldung. Bitte das Event-Team um einen neuen Link.
+
+### Weitere Hilfe
+Siehe `offline-sync` für Verbindungsprobleme oder `notifications-and-push` für Statusanzeigen.

docs/help/de/guest/uploading-photos.md

@@ -3,37 +3,41 @@ title: "Fotos aufnehmen & hochladen"
 locale: de
 slug: uploading-photos
 audience: guest
-summary: "Integrierte Kamera nutzen, Aufnahmen bearbeiten und bei Funklöchern auf Hintergrund-Sync setzen."
+summary: "Kamera öffnen, Aufnahme prüfen, Upload starten und Freigabe-Status verstehen."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: guest-success@fotospiel.app
 related:
-  - slug: getting-started
+  - slug: tasks-and-missions
+  - slug: upload-troubleshooting
+  - slug: notifications-and-push
   - slug: offline-sync
 ---
 
 ## Wann lesen?
-Du bist bereits einem Event beigetreten und möchtest verstehen, wie der Aufnahme-Workflow funktioniert, welche Qualitätsgrenzen gelten und was bei Verbindungsproblemen passiert.
+Du bist bereits im Event und möchtest den Aufnahme-Workflow kennen – inklusive Freigaben und Fehlerbehandlung.
+
+## Das Wichtigste zuerst
+- **Auto-Optimierung:** Die App verkleinert Fotos automatisch für schnellere Uploads.
+- **Status nach dem Upload:** Je nach Event landet das Foto sofort in der Galerie oder zuerst in der Prüfung.
+- **Fehler?** Es gibt klare Hinweise mit Retry-Optionen.
 
 ## Schritt für Schritt
-1. **Fotospiel-Kamera öffnen.** Vom Feed nach oben wischen oder auf das Auslösersymbol tippen.
+1. **Kamera öffnen.** Tippe auf die große Kamera in der unteren Navigation oder starte direkt aus einer Aufgabe.
-2. **Aufnahmemodus wählen.**
+2. **Task/Emotion übernehmen (optional).** Wenn du aus dem Aufgabenbereich kommst, sind Aufgabe und Stimmung bereits gesetzt.
-   - *Einzelfoto*: Standardmodus mit HDR-Anpassung.
+3. **Kamera-Tools nutzen.** Raster (Grid), Countdown, Kamera wechseln und Spiegelung der Frontkamera stehen als Schnellschalter bereit.
-   - *Serie*: Auslöser halten, bis zu 5 Bilder; die App wählt automatisch das schärfste.
+4. **Foto aufnehmen & prüfen.** Du kannst erneut aufnehmen oder mit der aktuellen Aufnahme fortfahren.
-   - *Import*: Miniatur antippen, um vorhandene Fotos/Screenshots zu laden.
+5. **Upload starten.** Fotospiel optimiert dein Bild automatisch und zeigt den Fortschritt an.
-3. **Anpassungen vornehmen.** Zuschneiden, drehen oder optionalen Text-Sticker hinzufügen. Alles passiert lokal. Mit *Speichern* bestätigen.
+6. **Nach dem Upload.** Bei direkter Freigabe landet dein Foto sofort in der Galerie. Bei moderierten Events erscheint es zuerst in „In Prüfung“.
-4. **Album & Tags setzen.** Ordne das Foto dem passenden Kapitel (z. B. Trauung) zu und füge bei Bedarf Stimmungstags an. Alben sind offline vorhanden.
+7. **Fehler beheben.** Wenn etwas schiefgeht, erscheint ein Hinweis mit einer klaren Handlung (erneut versuchen, Berechtigungen prüfen, später hochladen).
-5. **Upload-Warteschlange prüfen.** Offene Elemente erscheinen im Tab `Uploads` mit Status-Badge: *In Warteschlange*, *Sendet* oder *Erfordert Aktion*.
-6. **Hintergrund-Sync abwarten.** Beim Schließen sendet die App noch ca. 30 Sekunden (Systemlimit). Später öffnen setzt den Upload automatisch fort.
-7. **Fehler beheben.** Warnsymbol tippen → *Jetzt erneut versuchen* oder *Löschen*. Häufige Ursachen: Flugmodus, entzogene Berechtigungen, Speicher voll.
 
 ## Tipps
-- Fotos übernehmen die Gerätezeit. Unter "Event-Zeit verwenden" kannst du die Metadaten angleichen.
+- **Vorhandene Bilder importieren:** Tippe im Kameramodus auf das Galerie-Symbol.
-- Markiere bis zu 10 wartende Uploads gleichzeitig zum Löschen oder erneuten Senden.
+- **Große Dateien:** Die App komprimiert automatisch. Lass die App während des Uploads kurz geöffnet.
-- Likes und Kommentare synchronisieren getrennt und blockieren den Foto-Upload nicht.
+- **Freigabe prüfen:** Im Benachrichtigungsbereich siehst du, ob Fotos noch in Prüfung sind.
 
 ### Weitere Hilfe
-Siehe `offline-sync` für längere Offline-Phasen oder kontaktiere den Support unter Einstellungen → Hilfe.
+Siehe `upload-troubleshooting` für typische Fehler oder `notifications-and-push` für Statusmeldungen.

docs/help/en/guest/achievements-and-badges.md

@@ -0,0 +1,38 @@
+---
+title: "Achievements & Badges"
+locale: en
+slug: achievements-and-badges
+audience: guest
+summary: "Earn badges, see highlights, and track your progress."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: tasks-and-missions
+  - slug: gallery-and-sharing
+  - slug: notifications-and-push
+---
+
+## When to read this
+Use this if you want to understand badges, event highlights, and how progress is tracked.
+
+## What you’ll see in Achievements
+- **Personal stats:** Your photo count, tasks completed, and likes.
+- **Badges:** Progress bars show how close you are to the next milestone.
+- **Highlights:** Top photo and trending emotions for the event.
+- **Leaderboards:** Who has the most uploads and likes right now.
+
+## How to earn badges
+- **Upload more photos:** Every upload counts.
+- **Complete tasks:** Missions boost progress faster.
+- **Collect likes:** Popular photos move you up the rankings.
+
+## Tips
+- Some events disable tasks; then achievements focus on uploads and likes.
+- Updates can take a moment—stats refresh continuously.
+
+### Need more help?
+See `tasks-and-missions` for missions or `gallery-and-sharing` for likes and shares.

docs/help/en/guest/gallery-and-sharing.md

@@ -0,0 +1,46 @@
+---
+title: "Gallery & Sharing"
+locale: en
+slug: gallery-and-sharing
+audience: guest
+summary: "Open the gallery, filter, like, share, and download photos."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: tasks-and-missions
+---
+
+## When to read this
+Use this if you want to explore photos, like them, or share them—and understand the filters.
+
+## Open the gallery
+Tap **Gallery** in the bottom navigation to see all event photos.
+
+## Understand filters
+- **Latest:** Most recent uploads.
+- **Popular:** Photos with the most likes.
+- **Mine:** Uploads from your device.
+- **Photo booth:** Visible only when the event enabled photo booth uploads.
+
+## View a photo
+In the photo detail view you can:
+- **Like** (heart)
+- **Share** (share icon)
+- **Download** (download icon)
+
+## Sharing photos
+- **System share:** Send via WhatsApp, Messages, or other apps.
+- **Copy link:** Generates a share link for the photo.
+- **Expiry:** Share links can expire; you’ll see an expiration message if that happens.
+
+## Public gallery
+Some events provide a public gallery link (e.g., `/g/<token>`). Access is time-limited and may expire.
+
+### Need more help?
+See `uploading-photos` for new uploads or `achievements-and-badges` for like impact.

docs/help/en/guest/getting-started.md

@@ -3,34 +3,41 @@ title: "Quick Start: Join an Event"
 locale: en
 slug: getting-started
 audience: guest
-summary: "Install the Fotospiel app, join an event, and learn the core gestures in under two minutes."
+summary: "Open the invite, pick a name, and start sharing in the Fotospiel guest PWA."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: guest-success@fotospiel.app
 related:
   - slug: uploading-photos
+  - slug: how-fotospiel-works
+  - slug: tasks-and-missions
+  - slug: gallery-and-sharing
   - slug: offline-sync
 ---
 
 ## When to read this
-You just received an event code or QR and want to start sharing photos. This guide assumes you have a modern mobile browser (Safari, Chrome, Edge, Samsung Internet) and basic connectivity once for the initial sync.
+You received an event link or QR and want to start right away. This assumes a modern mobile browser (Safari, Chrome, Edge, Samsung Internet) and one initial online session.
+
+## The essentials
+- **No account needed:** You only need the invite link or QR.
+- **Camera first:** The large camera button is the fastest way to start.
+- **Gallery & tasks:** After uploading you can share photos or complete tasks (if enabled).
 
 ## Steps
-1. **Open the invite link or scan the QR.** The browser launches the Fotospiel guest app landing page.
+1. **Open the invite link or scan the QR.** The landing page detects the event automatically.
-2. **Install for full-screen mode.** Tap *Add to Home Screen* (iOS) or *Install app* (Android). Installation is optional but unlocks offline mode and faster uploads.
+2. **Paste the code or link if needed.** You can enter a link or code manually.
-3. **Enter the event code.** Six characters, case-insensitive. If you scanned the QR, the field auto-fills.
+3. **Choose a display name.** This appears next to your uploads. No account or email required.
-4. **Choose a display name.** This appears next to your uploads within the event feed. No account or email needed.
+4. **Get oriented.** Bottom navigation includes Home, Tasks (if enabled), Achievements, and Gallery. The center camera button starts capture.
-5. **Grant camera & storage permissions.** Select “Allow once” or “Allow while using the app” so Fotospiel can capture and store photos locally.
+5. **Install if you want.** Tap *Add to Home Screen* (iOS) or *Install app* (Android) for quick access.
-6. **Sync starter pack.** The app downloads current albums, achievements, and upload rules. A progress bar ensures everything is cached offline.
+6. **Grant permissions.** Allow camera/photo access. You can enable push later from the bell menu.
-7. **Explore gestures.** Swipe up to open the camera, left/right to switch album tabs, long-press a photo to like or report.
 
 ## Tips
-- Pin the app to your dock/home row before the event so you can reopen it instantly.
+- Sharing a device? Change your name in Settings → Profile between sessions.
-- If several guests share one device, clear the display name in Settings → Profile between sessions.
+- “Event expired” or “not found” usually means the invite link is outdated—ask the event team.
-- Screenshots never leave your device unless you upload them manually.
+- Help is always available via Settings → Help.
 
 ### Need more help?
-See `uploading-photos` for editing and batch upload tips, or `privacy-and-support` if you have questions about data retention.
+See `uploading-photos` for the capture flow or `tasks-and-missions` if you want to start with tasks.

docs/help/en/guest/how-fotospiel-works.md

@@ -0,0 +1,40 @@
+---
+title: "How Fotospiel Works"
+locale: en
+slug: how-fotospiel-works
+audience: guest
+summary: "The 60‑second overview: join, capture, and share."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: getting-started
+  - slug: uploading-photos
+  - slug: gallery-and-sharing
+---
+
+## In short
+Fotospiel is a guest PWA for events. You don’t need an account—just the invite link or QR. After that, you can take photos and share them in the event gallery.
+
+## The core flow
+1. **Join the event** → open the link, choose a name.
+2. **Capture a photo** → open the camera, take the shot, confirm.
+3. **Share it** → finish the upload, open the gallery, collect likes.
+
+## Key areas in the app
+- **Home:** Missions and highlights.
+- **Tasks:** Photo missions (if enabled).
+- **Gallery:** All photos, likes, sharing.
+- **Achievements:** Progress, badges, leaderboards.
+- **Bell:** Notifications & upload status.
+
+## Good to know
+- **Moderation:** Some events review uploads before they appear.
+- **Offline:** You can still capture; content refreshes once online.
+- **Push:** Notifications are optional and can be enabled from the bell menu.
+
+### Need more help?
+See `getting-started` for onboarding or `gallery-and-sharing` for sharing details.

docs/help/en/guest/index.md

@@ -3,25 +3,38 @@ title: "Guest Help Center"
 locale: en
 slug: guest-help-index
 audience: guest
-summary: "Everything attendees need to install the Fotospiel guest app, join events, and share memories."
+summary: "Everything attendees need to join the guest app, complete tasks, and share photos."
 version_introduced: 2025.4
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: product-support@fotospiel.app
 related: []
 ---
 
-Welcome to the guest-focused documentation hub. Start with any of the guides below—each article is available in English and German:
+Welcome to the guest help hub. Here’s the quick start in 30 seconds:
 
-- [Quick Start](./getting-started) – Install the app, join an event, and learn the core gestures.
+1) Open the invite link/QR → event is detected.
-- [Upload Workflow](./uploading-photos) – Capture, edit, and upload photos with background sync.
+2) Pick a name → open the camera.
-- [Offline Mode & Sync](./offline-sync) – Keep contributing when connectivity drops and ensure nothing gets lost.
+3) Upload a photo → share it in the gallery.
-- [Privacy & Support](./privacy-and-support) – Understand what data is stored and how to reach support.
+
+Every guide is available in English and German:
+
+- [How Fotospiel works](./how-fotospiel-works) – The 60‑second overview.
+- [Quick Start](./getting-started) – Join the event, pick a name, and begin.
+- [Tasks & Missions](./tasks-and-missions) – Draw tasks, filter by mood, start a mission.
+- [Capture & Upload Photos](./uploading-photos) – Open the camera, review, upload.
+- [Gallery & Sharing](./gallery-and-sharing) – Explore, like, share, and download photos.
+- [Achievements & Badges](./achievements-and-badges) – Progress, highlights, and leaderboards.
+- [Notifications & Push](./notifications-and-push) – Alerts, upload status, and push settings.
+- [Offline & Connectivity](./offline-sync) – What works offline and how to resume uploads.
+- [Fixing Upload Issues](./upload-troubleshooting) – Common errors and quick fixes.
+- [Settings & Cache](./settings-and-cache) – Profile, legal pages, cache cleanup.
+- [Privacy & Support](./privacy-and-support) – Data handling and contact options.
 
 ### How to use these docs
-- **Search**: Use the in-app search bar or the offline search inside the app settings. Keywords such as “upload limit” or “share link” work well.
+- **Search**: Use the Help Center search. Offline, previously loaded articles are searchable.
-- **Language toggle**: Switch between EN/DE via the globe icon embedded in every article.
+- **Language**: The app follows the event or device language; all articles exist in EN/DE.
-- **Contextual links**: Many UI screens provide a `?` icon that deep-links to the relevant section here.
+- **Access**: Open Settings → Help any time.
 
-Need more help? Tap *Contact Support* inside the guest app → Settings → Help. Provide the event ID so we can assist faster.
+Need more help? Contact the event team or reply to the invitation email.

docs/help/en/guest/notifications-and-push.md

@@ -0,0 +1,41 @@
+---
+title: "Notifications & Push"
+locale: en
+slug: notifications-and-push
+audience: guest
+summary: "Use in-app alerts, check upload status, and manage push notifications."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: upload-troubleshooting
+---
+
+## When to read this
+Read this if you want to find event alerts, understand upload status, or enable push.
+
+## Use the notification center
+- **Bell icon in the header:** Opens all alerts.
+- **Tabs:** *Unread*, *Uploads/Status*, and *All* help you filter quickly.
+- **Scopes:** Switch between tips/achievements and general updates.
+- **Mark as read:** You can mark or dismiss items anytime.
+
+## Upload status at a glance
+- **In review:** Shows how many uploads are waiting for moderation.
+- **Offline queue:** Indicates pending local uploads when connectivity returns.
+- **Offline badge:** Appears when you’re not connected.
+
+## Enable or disable push
+1. Open the bell menu.
+2. Check the push status in the footer bar.
+3. Tap *Enable* or *Disable*.
+
+If the browser blocks push, reset the permission in your browser settings.
+
+### Need more help?
+See `uploading-photos` for the upload flow or `upload-troubleshooting` for errors.

docs/help/en/guest/offline-sync.md

@@ -1,40 +1,39 @@
 ---
-title: "Offline Mode & Sync"
+title: "Offline & Connectivity"
 locale: en
 slug: offline-sync
 audience: guest
-summary: "Participate without coverage, queue uploads safely, and know when everything is delivered."
+summary: "What works offline, how to resume uploads, and what to watch for."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: reliability@fotospiel.app
 related:
   - slug: uploading-photos
-  - slug: privacy-and-support
+  - slug: upload-troubleshooting
+  - slug: notifications-and-push
+  - slug: settings-and-cache
 ---
 
 ## When to read this
-You expect intermittent connectivity (mountains, cellars, roaming). The guest app is built to keep working offline as long as the initial sync completed.
+You expect weak or no connectivity (basements, roaming, crowded venues) and want to know what still works.
 
-## What stays available offline
+## What works offline
-- Event feed (latest 250 photos) and album structure.
+- **Read help articles:** The Help Center stays available once it has loaded at least once.
-- Upload rules (size limits, moderation settings).
+- **Use the camera:** You can still capture and review photos.
-- Draft achievements and stickers.
+- **Already loaded views:** Screens you opened remain visible while the app stays open.
-- Help center excerpt (top 10 articles per locale) if you opened Help at least once online.
 
-## Offline workflow
+## Resume uploads
-1. **Capture as usual.** Everything stores in the encrypted local queue.
+1. **Reconnect.** Open the app and stay in the event briefly.
-2. **Review pending uploads.** Look for the grey *Queued* label. Add tags/notes even while offline.
+2. **Retry the upload.** If an upload failed, tap *Upload* again.
-3. **Monitor storage.** The banner warns if device storage drops below 500 MB; delete sent items or transfer to another device.
+3. **Check status.** The bell menu shows pending review counts or local queue activity.
-4. **Reconnect briefly.** Once any network is available, open Fotospiel. Sync restarts automatically, prioritizing oldest items.
-5. **Confirm completion.** A green toast “All uploads delivered” appears and the queue counter returns to zero.
 
-## Troubleshooting
+## Limits & notes
-- **Stuck in “Queued” despite coverage?** Toggle airplane mode off/on, then reopen the app to reset the service worker.
+- **No live refresh offline.** Gallery and tasks update only once you’re back online.
-- **Different devices?** Offline queues stay on the original device; there’s no cross-device merge.
+- **Offline restart:** If you reload while offline, some content may not be available.
-- **Battery saver** might pause background sync. Keep the app in the foreground for large batches.
+- **Clearing cache removes offline data.** Local copies and queued uploads are deleted when you clear cache.
 
 ### Need more help?
-Use Settings → Help → *Send diagnostics* once you are online; support receives anonymized logs plus your event ID.
+See `upload-troubleshooting` for specific errors or `settings-and-cache` for cache details.

docs/help/en/guest/privacy-and-support.md

@@ -1,38 +1,38 @@
 ---
-title: "Privacy & Getting Help"
+title: "Privacy & Support"
 locale: en
 slug: privacy-and-support
 audience: guest
-summary: "Understand what data is stored, how to request deletions, and how to contact support."
+summary: "Understand what data is stored and how to get help."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: legal@fotospiel.app
 related:
   - slug: getting-started
-  - slug: offline-sync
+  - slug: settings-and-cache
+  - slug: notifications-and-push
 ---
 
 ## Data we store
-- **Photos & captions**: Stored on the customer account’s encrypted storage for the retention period defined by the event organizer.
+- **Photos & metadata:** Your uploads live in the event organizer’s storage.
-- **Session ID**: Anonymous token generated on your device for upload tracking; resets if you clear app storage.
+- **Display name:** Shown next to your uploads.
-- **Device metadata**: Only model + OS version, used for crash insights. No location, contacts, or advertising IDs.
+- **Device ID:** Anonymous token used for upload and like attribution.
+- **Push subscriptions (optional):** Only if you enable notifications.
 
-## Your controls
+We **do not** store location data, contacts, or advertising IDs.
-1. **Delete individual uploads**: Open the photo → tap `…` → *Remove from event*. You can delete only your own items.
-2. **Erase local cache**: Settings → Storage → *Clear device copies*. This removes cached thumbnails and drafts.
-3. **Request full erasure**: Use Settings → Help → *Request data deletion*. Provide email for confirmation; we forward the request to the event admin who controls the customer account.
 
-## Support channels
+## Your options
-- **In-app**: Settings → Help → *Contact support*. Includes optional screenshot + diagnostics bundle.
+- **Change display name:** Settings → Profile.
-- **Email**: guests@fotospiel.app (mention event code + device model).
+- **Clear local data:** Settings → Clear cache (removes offline copies and queued uploads).
-- **On-site**: Ask the event staff to escalate via the customer admin app.
+- **Request deletion:** Contact the event team or use the contact address in the invite.
 
-## Response times
+## Support
-- Critical issues (uploads failing for entire event): <15 minutes.
+- **On-site:** Ask the event staff.
-- Individual deletion or privacy questions: within 48 hours.
+- **Invite email:** Reply directly to the invitation.
+- **Email:** support@fotospiel.de (include event code + device info).
 
 ### Need more help?
-Review the public legal pages (Impressum, Privacy, AGB) under Settings → Legal, or contact the event organizer directly for customer-specific policies.
+See `settings-and-cache` for device options or `notifications-and-push` for alerts and status.

docs/help/en/guest/settings-and-cache.md

@@ -0,0 +1,42 @@
+---
+title: "Settings & Cache"
+locale: en
+slug: settings-and-cache
+audience: guest
+summary: "Update your profile, review legal pages, and manage local data."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: privacy-and-support
+  - slug: offline-sync
+---
+
+## Open settings
+Tap the gear icon in the header. You’ll find profile, legal pages, help, and cache tools.
+
+## Language
+- **Choose a language:** Switch between German and English in Settings.
+- **Event default:** The event’s preferred language is used by default.
+
+## Profile
+- **Change your display name:** Update or reset it under Profile.
+- **Shared devices:** Rename between sessions.
+
+## Legal & Help
+- **Legal pages:** Impressum, Privacy, and Terms are available in Settings.
+- **Help:** Opens the guest Help Center.
+
+## Clear cache
+- **What it does:** Removes local copies (including cached help articles).
+- **Important:** Pending uploads can be lost.
+- **Tip:** Clear cache only after uploads finish.
+
+## Appearance
+Use the sun/moon toggle in the header to switch light/dark mode.
+
+### Need more help?
+See `privacy-and-support` for data questions or `offline-sync` for offline behavior.

docs/help/en/guest/tasks-and-missions.md

@@ -0,0 +1,43 @@
+---
+title: "Tasks & Missions"
+locale: en
+slug: tasks-and-missions
+audience: guest
+summary: "Draw tasks, filter by mood, and jump straight into the camera."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: achievements-and-badges
+  - slug: gallery-and-sharing
+---
+
+## When to read this
+Use this when you want to try photo missions or understand how moods/emotions work. Note: tasks can be disabled per event.
+
+## Find tasks
+- **Open the Tasks tab:** Tap *Tasks* in the bottom navigation.
+- **Home highlights:** The Home screen also surfaces mission cards.
+- **Filter by mood:** If available, choose an emotion filter (e.g., Romance, Party).
+
+## Start a task
+1. **Pick a task.**
+2. **Read the details.** Title, short description, duration, and difficulty help you decide.
+3. **Capture the photo.** The CTA opens the camera with task/mood preselected.
+4. **Finish the upload.** The task counts as completed once the upload succeeds.
+
+## Inspiration & progress
+- **Draw a new task:** Swipe for the next task or use the refresh action.
+- **Check inspiration:** Some tasks show example photos.
+- **Track progress:** The Achievements area shows tasks completed.
+
+## Tips
+- If no tasks appear, the event might not use missions.
+- Tasks are optional—you can always upload freely.
+
+### Need more help?
+See `uploading-photos` for the camera flow or `achievements-and-badges` for progress details.

docs/help/en/guest/upload-troubleshooting.md

@@ -0,0 +1,39 @@
+---
+title: "Fixing Upload Issues"
+locale: en
+slug: upload-troubleshooting
+audience: guest
+summary: "Common upload errors, permissions, and quick fixes."
+version_introduced: 2025.12
+requires_app_version: "^3.2.0"
+status: draft
+translation_state: aligned
+last_reviewed_at: 2025-12-24
+owner: guest-success@fotospiel.app
+related:
+  - slug: uploading-photos
+  - slug: offline-sync
+  - slug: notifications-and-push
+---
+
+## Camera won’t start
+- **Check permissions:** Allow camera access in browser or system settings.
+- **Blocked:** If the browser blocks access, reset the permission there.
+- **Unsupported:** Some browsers don’t allow live camera preview—use gallery import instead.
+
+## Upload fails
+- **Check connection:** Try Wi‑Fi/mobile data and keep the app open.
+- **Retry:** The upload dialog offers a direct retry.
+- **Large files:** The app compresses automatically; retake if the file is still too large.
+
+## Limit reached
+Some events enforce photo or device limits. If you hit a limit, you can’t upload more—ask the event team.
+
+## Uploads in review
+If moderation is enabled, uploads are reviewed first. The notification center shows the status.
+
+## Link or event expired
+If links expire, you’ll see a message. Ask the event team for a fresh invite.
+
+### Need more help?
+See `offline-sync` for connectivity tips or `notifications-and-push` for status updates.

docs/help/en/guest/uploading-photos.md

@@ -3,37 +3,41 @@ title: "Capture & Upload Photos"
 locale: en
 slug: uploading-photos
 audience: guest
-summary: "Use the built-in camera, edit shots, and rely on background sync if connectivity drops."
+summary: "Open the camera, review your shot, upload it, and understand moderation status."
 version_introduced: 2025.4
 requires_app_version: "^3.2.0"
 status: draft
 translation_state: aligned
-last_reviewed_at: 2025-02-22
+last_reviewed_at: 2025-12-24
 owner: guest-success@fotospiel.app
 related:
-  - slug: getting-started
+  - slug: tasks-and-missions
+  - slug: upload-troubleshooting
+  - slug: notifications-and-push
   - slug: offline-sync
 ---
 
 ## When to read this
-You already joined an event and want to understand the capture workflow, quality limits, and what happens if uploads fail or the connection disappears.
+You already joined the event and want the full capture flow—including moderation and error handling.
+
+## The essentials
+- **Auto-optimization:** Photos are compressed automatically for faster uploads.
+- **After upload:** Photos go straight to the gallery or first into review, depending on the event.
+- **Errors:** You’ll get clear guidance and a retry option.
 
 ## Step-by-step
-1. **Open the Fotospiel camera.** Swipe up from the timeline or tap the shutter icon.
+1. **Open the camera.** Tap the large camera button in the bottom nav, or start from a task.
-2. **Pick a capture mode.**
+2. **Keep task/emotion (optional).** If you came from Tasks, the assignment stays attached.
-   - *Single shot*: default mode with HDR tuning.
+3. **Use camera tools.** Grid overlay, countdown timer, camera switch, and front-camera mirror are available.
-   - *Burst*: hold the shutter to capture up to 5 frames; the app picks the sharpest by default.
+4. **Review the photo.** Retake if needed or continue with the current shot.
-   - *Import*: tap the gallery thumbnail to select existing photos/screenshots.
+5. **Upload.** Fotospiel auto-optimizes your image and shows progress.
-3. **Apply adjustments.** Crop, rotate, or add the optional text sticker. All edits happen on-device. Tap *Save* to confirm.
+6. **After upload.** If the event allows instant approval, the photo shows up in the gallery right away. If moderation is enabled, it goes to “In review” first.
-4. **Choose the album & tags.** Assign to the correct chapter (e.g., Ceremony) and optionally add mood tags. Albums are cached offline.
+7. **Fix errors.** You’ll get clear guidance (retry, check permissions, or try again later).
-5. **Review upload queue.** Pending items appear in the `Uploads` tab with a status pill: *Queued*, *Sending*, or *Needs attention*.
-6. **Let background sync finish.** Closing the app keeps uploads going for ~30 seconds (platform limit). Reopen later to resume automatically.
-7. **Fix failed uploads.** Tap the warning icon → *Retry now* or *Delete*. Common issues: airplane mode, revoked permissions, storage full.
 
 ## Tips
-- Photos inherit the device timestamp; if clocks differ from event time, toggling “Use event time” adjusts metadata.
+- **Import existing images:** Tap the gallery icon in camera view.
-- Batch-select up to 10 pending uploads to delete or retry at once.
+- **Large files:** Auto-compression helps. Keep the app open while uploading.
-- Likes and comments sync separately and don’t block photo uploads.
+- **Review status:** The notification panel shows pending review counts.
 
 ### Need more help?
-Read `offline-sync` for long offline stretches or contact support from Settings → Help.
+See `upload-troubleshooting` for common issues or `notifications-and-push` for status updates.

resources/js/guest/components/Header.tsx

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createPortal } from 'react-dom';
-import { Link } from 'react-router-dom';
+import { Link, useLocation } from 'react-router-dom';
 import AppearanceToggleDropdown from '@/components/appearance-dropdown';
 import {
   User,
@@ -131,6 +131,7 @@ function renderEventAvatar(name: string, icon: unknown, accentColor: string, tex
 }
 
 export default function Header({ eventToken, title = '' }: { eventToken?: string; title?: string }) {
+  const location = useLocation();
   const statsContext = useOptionalEventStats();
   const identity = useOptionalGuestIdentity();
   const { t } = useTranslation();
@@ -189,6 +190,12 @@ export default function Header({ eventToken, title = '' }: { eventToken?: string
 
   const headerFont = branding.typography?.heading ?? branding.fontFamily ?? undefined;
   const bodyFont = branding.typography?.body ?? branding.fontFamily ?? undefined;
+  const basePath = eventToken ? `/e/${encodeURIComponent(eventToken)}` : '';
+  const showGalleryHelp = Boolean(
+    basePath
+    && (location.pathname.startsWith(`${basePath}/gallery`) || location.pathname.startsWith(`${basePath}/photo`))
+  );
+  const galleryHelpHref = basePath ? `${basePath}/help/gallery-and-sharing` : '/help/gallery-and-sharing';
 
   const headerStyle: React.CSSProperties = {
     background: `linear-gradient(135deg, ${branding.primaryColor}, ${branding.secondaryColor})`,
@@ -255,6 +262,15 @@ export default function Header({ eventToken, title = '' }: { eventToken?: string
             t={t}
           />
         )}
+        {showGalleryHelp && (
+          <Link
+            to={galleryHelpHref}
+            className="rounded-full bg-white/15 p-2 text-white transition hover:bg-white/30"
+            aria-label={t('header.helpGallery')}
+          >
+            <LifeBuoy className="h-5 w-5" aria-hidden />
+          </Link>
+        )}
         <AppearanceToggleDropdown />
         <SettingsSheet />
       </div>

resources/js/guest/i18n/messages.ts

@@ -33,6 +33,10 @@ export const messages: Record<LocaleCode, NestedMessages> = {
         online: 'online',
         tasksSolved: 'Aufgaben gelöst',
       },
+      helpGallery: 'Hilfe zu Galerie & Teilen',
+      notifications: {
+        tabStatus: 'Upload-Status',
+      },
     },
     eventAccess: {
       loading: {
@@ -659,10 +663,10 @@ export const messages: Record<LocaleCode, NestedMessages> = {
         clear: 'Cache leeren',
         clearing: 'Leere Cache...',
         cleared: 'Cache gelöscht.',
-        note: 'Dies betrifft nur diesen Browser und muss pro Gerät erneut ausgeführt werden.',
+        note: 'Dies betrifft nur diesen Browser. Wartende Uploads können verloren gehen.',
       },
       help: {
-        title: 'Hilfe & Support',
+        title: 'Hilfecenter',
         description: 'Öffne das Hilfecenter mit Schritt-für-Schritt-Anleitungen.',
         cta: 'Hilfecenter öffnen',
       },
@@ -677,7 +681,7 @@ export const messages: Record<LocaleCode, NestedMessages> = {
     },
     help: {
       center: {
-        title: 'Hilfe & Tipps',
+        title: 'Hilfecenter',
         subtitle: 'Antworten für Gäste – nach dem ersten Laden auch offline verfügbar.',
         searchPlaceholder: 'Suche nach Thema oder Stichwort',
         offlineBadge: 'Offline-Version',
@@ -716,6 +720,10 @@ export const messages: Record<LocaleCode, NestedMessages> = {
         online: 'online',
         tasksSolved: 'tasks solved',
       },
+      helpGallery: 'Help: Gallery & sharing',
+      notifications: {
+        tabStatus: 'Upload status',
+      },
     },
     eventAccess: {
       loading: {
@@ -1339,10 +1347,10 @@ export const messages: Record<LocaleCode, NestedMessages> = {
         clear: 'Clear cache',
         clearing: 'Clearing cache...',
         cleared: 'Cache cleared.',
-        note: 'This only affects this browser and must be repeated per device.',
+        note: 'This only affects this browser. Pending uploads may be lost.',
       },
       help: {
-        title: 'Help & support',
+        title: 'Help Center',
         description: 'Open the help center for guides and quick answers.',
         cta: 'Open help center',
       },
@@ -1357,7 +1365,7 @@ export const messages: Record<LocaleCode, NestedMessages> = {
     },
     help: {
       center: {
-        title: 'Help & tips',
+        title: 'Help Center',
         subtitle: 'Guides for guests – available offline after the first sync.',
         searchPlaceholder: 'Search by topic or keyword',
         offlineBadge: 'Offline copy',