diff --git a/docker-compose.dokploy.yml b/docker-compose.dokploy.yml index 1aa789f..ef602ca 100644 --- a/docker-compose.dokploy.yml +++ b/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: diff --git a/docs/help/de/guest/achievements-and-badges.md b/docs/help/de/guest/achievements-and-badges.md new file mode 100644 index 0000000..d8e8e05 --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/gallery-and-sharing.md b/docs/help/de/guest/gallery-and-sharing.md new file mode 100644 index 0000000..9376cbd --- /dev/null +++ b/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/`). Die Galerie kann ebenfalls zeitlich begrenzt sein. + +### Weitere Hilfe +Siehe `uploading-photos` für neue Uploads oder `achievements-and-badges` für Like-Auswertung. diff --git a/docs/help/de/guest/getting-started.md b/docs/help/de/guest/getting-started.md index 3355860..ec1dacd 100644 --- a/docs/help/de/guest/getting-started.md +++ b/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. -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. -3. **Event-Code eingeben.** Sechs Zeichen, Groß-/Kleinschreibung egal. Nach QR-Scan wird das Feld automatisch befüllt. -4. **Anzeigenamen wählen.** Dieser erscheint in der Event-Ansicht neben deinen Uploads. Kein Konto oder E-Mail nötig. -5. **Kamera- & Speicherzugriff erlauben.** Wähle „Einmal erlauben“ oder „Beim Verwenden der App“, damit Fotospiel Fotos speichern kann. -6. **Startpaket synchronisieren.** Die App lädt Alben, Achievements und Upload-Regeln herunter. Ein Fortschrittsbalken zeigt den Abschluss für den Offline-Modus. -7. **Gesten entdecken.** Nach oben wischen öffnet die Kamera, links/rechts wechselt das Album, Langdruck auf einem Foto ermöglicht Like oder Meldung. +1. **Einladungslink öffnen oder QR scannen.** Die Landingpage erkennt den Event-Code automatisch. +2. **Event-Code oder Link einfügen.** Falls nötig, kannst du Link oder Code manuell einfügen. +3. **Anzeigenamen wählen.** Dieser erscheint bei deinen Uploads. Kein Konto und keine 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. **Optional installieren.** *Zum Home-Bildschirm* (iOS) oder *App installieren* (Android) für schnellen Zugriff. +6. **Berechtigungen erlauben.** Kamera-/Fotozugriff bestätigen. Push kannst du später in der Glocke aktivieren. ## Tipps -- Lege die App vor dem Event in die Dock/App-Leiste, damit du sie schnell wiederfindest. -- Teilen sich mehrere Gäste ein Gerät, setze den Anzeigenamen unter Einstellungen → Profil zwischen den Sessions zurück. -- Screenshots verlassen dein Gerät nur, wenn du sie aktiv hochlädst. +- Wenn ihr ein Gerät teilt: Einstellungen → Profil, Namen zwischen den Sessions ändern. +- Bei „Event abgelaufen“ oder „nicht gefunden“: Event-Team oder Einladungs-Mail prüfen. +- 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. diff --git a/docs/help/de/guest/how-fotospiel-works.md b/docs/help/de/guest/how-fotospiel-works.md new file mode 100644 index 0000000..716c7fa --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/index.md b/docs/help/de/guest/index.md index 3066803..dccf6ee 100644 --- a/docs/help/de/guest/index.md +++ b/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. -- [Fotos hochladen](./uploading-photos) – Fotos aufnehmen, bearbeiten und mit Hintergrund-Sync hochladen. -- [Offline nutzen](./offline-sync) – Auch ohne Netz teilnehmen und sicherstellen, dass nichts verloren geht. -- [Datenschutz & Support](./privacy-and-support) – Welche Daten gespeichert werden und wie du Hilfe kontaktierst. +1) Link/QR öffnen → Event wird erkannt. +2) Namen wählen → Kamera starten. +3) Foto hochladen → In der Galerie teilen. + +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. -- **Sprache wechseln**: Über das Globus-Symbol in jedem Artikel kannst du zwischen Deutsch und Englisch umschalten. -- **Kontext-Links**: Viele UI-Elemente mit `?`-Symbol verlinken direkt auf den passenden Abschnitt. +- **Suche**: Nutze die Suche im Hilfebereich. Offline werden bereits geladene Artikel durchsucht. +- **Sprache**: Die App nutzt die Event- oder Gerätesprache. Alle Artikel sind in DE/EN verfügbar. +- **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. diff --git a/docs/help/de/guest/notifications-and-push.md b/docs/help/de/guest/notifications-and-push.md new file mode 100644 index 0000000..4b1f7eb --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/offline-sync.md b/docs/help/de/guest/offline-sync.md index b636088..0081058 100644 --- a/docs/help/de/guest/offline-sync.md +++ b/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? -- Event-Feed (die letzten 250 Fotos) und Albumstruktur. -- Upload-Regeln (Größenlimit, Moderationseinstellungen). -- Entwürfe für Achievements und Sticker. -- Auszug des Hilfecenters (Top‑10 Artikel pro Sprache), sofern du den Hilfebereich mindestens einmal online geöffnet hast. +## Was offline möglich ist +- **Hilfeartikel lesen:** Der Hilfebereich ist nach dem ersten Laden auch offline verfügbar. +- **Kamera nutzen:** Du kannst weiterhin fotografieren und Aufnahmen prüfen. +- **Bereits geladene Inhalte:** Ansichten bleiben sichtbar, solange die App geöffnet bleibt. -## Offline-Workflow -1. **Wie gewohnt aufnehmen.** Alles landet verschlüsselt in der lokalen Warteschlange. -2. **Ausstehende Uploads prüfen.** Achte auf das graue Label *In Warteschlange*. Tags/Notizen lassen sich auch offline ergänzen. -3. **Speicher überwachen.** Ein Banner warnt unter 500 MB freiem Speicher; lösche gesendete Inhalte oder nutze ein anderes Gerät. -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. +## Uploads nachholen +1. **Wieder online gehen.** Öffne die App und bleib kurz im Event. +2. **Upload erneut starten.** Falls der Upload fehlgeschlagen ist, tippe erneut auf *Upload*. +3. **Status prüfen.** Die Glocke zeigt, ob Uploads in Prüfung sind oder ob eine lokale Warteschlange aktiv ist. -## Troubleshooting -- **Bleibt trotz Netz auf „In Warteschlange“?** Flugmodus kurz aktivieren/deaktivieren und App neu öffnen, um den Service Worker zurückzusetzen. -- **Gerätewechsel?** Offline-Warteschlangen verbleiben auf dem ursprünglichen Gerät; kein Abgleich zwischen Geräten. -- **Energiesparmodus** kann Hintergrundsync pausieren. Für große Mengen die App im Vordergrund lassen. +## Grenzen & Hinweise +- **Ohne Netz keine Live-Updates.** Galerie und Aufgaben aktualisieren erst wieder online. +- **App-Neustart offline:** Ohne Verbindung können Inhalte fehlen, weil die App nichts nachladen kann. +- **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. diff --git a/docs/help/de/guest/privacy-and-support.md b/docs/help/de/guest/privacy-and-support.md index ec02163..949e316 100644 --- a/docs/help/de/guest/privacy-and-support.md +++ b/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. -- **Session-ID**: Anonymer Token vom Gerät zur Upload-Nachverfolgung; wird zurückgesetzt, wenn du die App-Daten löscht. -- **Geräte-Metadaten**: Nur Modell + Betriebssystem-Version für Crash-Analysen. Keine Standort-, Kontakt- oder Werbe-IDs. +- **Fotos & Metadaten:** Deine Uploads liegen im Event-Speicher des Veranstalters. +- **Anzeigename:** Wird zusammen mit deinen Uploads angezeigt. +- **Geräte-ID:** Anonymer Token für Upload- und Like-Zuordnung. +- **Push-Abos (optional):** Nur wenn du Benachrichtigungen aktivierst. -## Deine Kontrollmöglichkeiten -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. +Wir speichern **keine** Standortdaten, Kontakte oder Werbe-IDs. -## Support-Kanäle -- **In-App**: Einstellungen → Hilfe → *Support kontaktieren*. Optional Screenshot + Diagnosepaket anhängen. -- **E-Mail**: guests@fotospiel.app (Event-Code + Gerät nennen). -- **Vor Ort**: Event-Personal ansprechen; sie eskalieren über die Admin-App. +## Deine Optionen +- **Anzeigenamen ändern:** Einstellungen → Profil. +- **Lokale Daten löschen:** Einstellungen → Cache leeren (löscht Offline-Kopien und ggf. wartende Uploads). +- **Datenlöschung anfragen:** Über das Event-Team oder die in der Einladung angegebene Kontaktadresse. -## Antwortzeiten -- Kritische Probleme (Uploads für gesamtes Event gestört): <15 Minuten. -- Individuelle Lösch- oder Datenschutzanfragen: innerhalb von 48 Stunden. +## Support +- **Vor Ort:** Event-Team ansprechen. +- **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. diff --git a/docs/help/de/guest/settings-and-cache.md b/docs/help/de/guest/settings-and-cache.md new file mode 100644 index 0000000..4e9abc5 --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/tasks-and-missions.md b/docs/help/de/guest/tasks-and-missions.md new file mode 100644 index 0000000..e7d64bb --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/upload-troubleshooting.md b/docs/help/de/guest/upload-troubleshooting.md new file mode 100644 index 0000000..17eaf4b --- /dev/null +++ b/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. diff --git a/docs/help/de/guest/uploading-photos.md b/docs/help/de/guest/uploading-photos.md index 1dbdea7..96b6e86 100644 --- a/docs/help/de/guest/uploading-photos.md +++ b/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. -2. **Aufnahmemodus wählen.** - - *Einzelfoto*: Standardmodus mit HDR-Anpassung. - - *Serie*: Auslöser halten, bis zu 5 Bilder; die App wählt automatisch das schärfste. - - *Import*: Miniatur antippen, um vorhandene Fotos/Screenshots zu laden. -3. **Anpassungen vornehmen.** Zuschneiden, drehen oder optionalen Text-Sticker hinzufügen. Alles passiert lokal. Mit *Speichern* bestätigen. -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. -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. +1. **Kamera öffnen.** Tippe auf die große Kamera in der unteren Navigation oder starte direkt aus einer Aufgabe. +2. **Task/Emotion übernehmen (optional).** Wenn du aus dem Aufgabenbereich kommst, sind Aufgabe und Stimmung bereits gesetzt. +3. **Kamera-Tools nutzen.** Raster (Grid), Countdown, Kamera wechseln und Spiegelung der Frontkamera stehen als Schnellschalter bereit. +4. **Foto aufnehmen & prüfen.** Du kannst erneut aufnehmen oder mit der aktuellen Aufnahme fortfahren. +5. **Upload starten.** Fotospiel optimiert dein Bild automatisch und zeigt den Fortschritt an. +6. **Nach dem Upload.** Bei direkter Freigabe landet dein Foto sofort in der Galerie. Bei moderierten Events erscheint es zuerst in „In Prüfung“. +7. **Fehler beheben.** Wenn etwas schiefgeht, erscheint ein Hinweis mit einer klaren Handlung (erneut versuchen, Berechtigungen prüfen, später hochladen). ## Tipps -- Fotos übernehmen die Gerätezeit. Unter "Event-Zeit verwenden" kannst du die Metadaten angleichen. -- Markiere bis zu 10 wartende Uploads gleichzeitig zum Löschen oder erneuten Senden. -- Likes und Kommentare synchronisieren getrennt und blockieren den Foto-Upload nicht. +- **Vorhandene Bilder importieren:** Tippe im Kameramodus auf das Galerie-Symbol. +- **Große Dateien:** Die App komprimiert automatisch. Lass die App während des Uploads kurz geöffnet. +- **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. diff --git a/docs/help/en/guest/achievements-and-badges.md b/docs/help/en/guest/achievements-and-badges.md new file mode 100644 index 0000000..52386e3 --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/gallery-and-sharing.md b/docs/help/en/guest/gallery-and-sharing.md new file mode 100644 index 0000000..7025457 --- /dev/null +++ b/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/`). Access is time-limited and may expire. + +### Need more help? +See `uploading-photos` for new uploads or `achievements-and-badges` for like impact. diff --git a/docs/help/en/guest/getting-started.md b/docs/help/en/guest/getting-started.md index eb88059..1310059 100644 --- a/docs/help/en/guest/getting-started.md +++ b/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. -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. -3. **Enter the event code.** Six characters, case-insensitive. If you scanned the QR, the field auto-fills. -4. **Choose a display name.** This appears next to your uploads within the event feed. No account or email needed. -5. **Grant camera & storage permissions.** Select “Allow once” or “Allow while using the app” so Fotospiel can capture and store photos locally. -6. **Sync starter pack.** The app downloads current albums, achievements, and upload rules. A progress bar ensures everything is cached offline. -7. **Explore gestures.** Swipe up to open the camera, left/right to switch album tabs, long-press a photo to like or report. +1. **Open the invite link or scan the QR.** The landing page detects the event automatically. +2. **Paste the code or link if needed.** You can enter a link or code manually. +3. **Choose a display name.** This appears next to your uploads. No account or email required. +4. **Get oriented.** Bottom navigation includes Home, Tasks (if enabled), Achievements, and Gallery. The center camera button starts capture. +5. **Install if you want.** Tap *Add to Home Screen* (iOS) or *Install app* (Android) for quick access. +6. **Grant permissions.** Allow camera/photo access. You can enable push later from the bell menu. ## Tips -- Pin the app to your dock/home row before the event so you can reopen it instantly. -- If several guests share one device, clear the display name in Settings → Profile between sessions. -- Screenshots never leave your device unless you upload them manually. +- Sharing a device? Change your name in Settings → Profile between sessions. +- “Event expired” or “not found” usually means the invite link is outdated—ask the event team. +- 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. diff --git a/docs/help/en/guest/how-fotospiel-works.md b/docs/help/en/guest/how-fotospiel-works.md new file mode 100644 index 0000000..fcbcf7e --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/index.md b/docs/help/en/guest/index.md index 3b0ea91..38896e4 100644 --- a/docs/help/en/guest/index.md +++ b/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. -- [Upload Workflow](./uploading-photos) – Capture, edit, and upload photos with background sync. -- [Offline Mode & Sync](./offline-sync) – Keep contributing when connectivity drops and ensure nothing gets lost. -- [Privacy & Support](./privacy-and-support) – Understand what data is stored and how to reach support. +1) Open the invite link/QR → event is detected. +2) Pick a name → open the camera. +3) Upload a photo → share it in the gallery. + +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. -- **Language toggle**: Switch between EN/DE via the globe icon embedded in every article. -- **Contextual links**: Many UI screens provide a `?` icon that deep-links to the relevant section here. +- **Search**: Use the Help Center search. Offline, previously loaded articles are searchable. +- **Language**: The app follows the event or device language; all articles exist in EN/DE. +- **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. diff --git a/docs/help/en/guest/notifications-and-push.md b/docs/help/en/guest/notifications-and-push.md new file mode 100644 index 0000000..13f3e10 --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/offline-sync.md b/docs/help/en/guest/offline-sync.md index 2e6078f..d549804 100644 --- a/docs/help/en/guest/offline-sync.md +++ b/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 -- Event feed (latest 250 photos) and album structure. -- Upload rules (size limits, moderation settings). -- Draft achievements and stickers. -- Help center excerpt (top 10 articles per locale) if you opened Help at least once online. +## What works offline +- **Read help articles:** The Help Center stays available once it has loaded at least once. +- **Use the camera:** You can still capture and review photos. +- **Already loaded views:** Screens you opened remain visible while the app stays open. -## Offline workflow -1. **Capture as usual.** Everything stores in the encrypted local queue. -2. **Review pending uploads.** Look for the grey *Queued* label. Add tags/notes even while offline. -3. **Monitor storage.** The banner warns if device storage drops below 500 MB; delete sent items or transfer to another device. -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. +## Resume uploads +1. **Reconnect.** Open the app and stay in the event briefly. +2. **Retry the upload.** If an upload failed, tap *Upload* again. +3. **Check status.** The bell menu shows pending review counts or local queue activity. -## Troubleshooting -- **Stuck in “Queued” despite coverage?** Toggle airplane mode off/on, then reopen the app to reset the service worker. -- **Different devices?** Offline queues stay on the original device; there’s no cross-device merge. -- **Battery saver** might pause background sync. Keep the app in the foreground for large batches. +## Limits & notes +- **No live refresh offline.** Gallery and tasks update only once you’re back online. +- **Offline restart:** If you reload while offline, some content may not be available. +- **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. diff --git a/docs/help/en/guest/privacy-and-support.md b/docs/help/en/guest/privacy-and-support.md index f0a24dd..ff1c32b 100644 --- a/docs/help/en/guest/privacy-and-support.md +++ b/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. -- **Session ID**: Anonymous token generated on your device for upload tracking; resets if you clear app storage. -- **Device metadata**: Only model + OS version, used for crash insights. No location, contacts, or advertising IDs. +- **Photos & metadata:** Your uploads live in the event organizer’s storage. +- **Display name:** Shown next to your uploads. +- **Device ID:** Anonymous token used for upload and like attribution. +- **Push subscriptions (optional):** Only if you enable notifications. -## Your controls -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. +We **do not** store location data, contacts, or advertising IDs. -## Support channels -- **In-app**: Settings → Help → *Contact support*. Includes optional screenshot + diagnostics bundle. -- **Email**: guests@fotospiel.app (mention event code + device model). -- **On-site**: Ask the event staff to escalate via the customer admin app. +## Your options +- **Change display name:** Settings → Profile. +- **Clear local data:** Settings → Clear cache (removes offline copies and queued uploads). +- **Request deletion:** Contact the event team or use the contact address in the invite. -## Response times -- Critical issues (uploads failing for entire event): <15 minutes. -- Individual deletion or privacy questions: within 48 hours. +## Support +- **On-site:** Ask the event staff. +- **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. diff --git a/docs/help/en/guest/settings-and-cache.md b/docs/help/en/guest/settings-and-cache.md new file mode 100644 index 0000000..43eb156 --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/tasks-and-missions.md b/docs/help/en/guest/tasks-and-missions.md new file mode 100644 index 0000000..525f33e --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/upload-troubleshooting.md b/docs/help/en/guest/upload-troubleshooting.md new file mode 100644 index 0000000..2d619db --- /dev/null +++ b/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. diff --git a/docs/help/en/guest/uploading-photos.md b/docs/help/en/guest/uploading-photos.md index d908c99..acd8938 100644 --- a/docs/help/en/guest/uploading-photos.md +++ b/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. -2. **Pick a capture mode.** - - *Single shot*: default mode with HDR tuning. - - *Burst*: hold the shutter to capture up to 5 frames; the app picks the sharpest by default. - - *Import*: tap the gallery thumbnail to select existing photos/screenshots. -3. **Apply adjustments.** Crop, rotate, or add the optional text sticker. All edits happen on-device. Tap *Save* to confirm. -4. **Choose the album & tags.** Assign to the correct chapter (e.g., Ceremony) and optionally add mood tags. Albums are cached offline. -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. +1. **Open the camera.** Tap the large camera button in the bottom nav, or start from a task. +2. **Keep task/emotion (optional).** If you came from Tasks, the assignment stays attached. +3. **Use camera tools.** Grid overlay, countdown timer, camera switch, and front-camera mirror are available. +4. **Review the photo.** Retake if needed or continue with the current shot. +5. **Upload.** Fotospiel auto-optimizes your image and shows progress. +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. +7. **Fix errors.** You’ll get clear guidance (retry, check permissions, or try again later). ## Tips -- Photos inherit the device timestamp; if clocks differ from event time, toggling “Use event time” adjusts metadata. -- Batch-select up to 10 pending uploads to delete or retry at once. -- Likes and comments sync separately and don’t block photo uploads. +- **Import existing images:** Tap the gallery icon in camera view. +- **Large files:** Auto-compression helps. Keep the app open while uploading. +- **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. diff --git a/resources/js/guest/components/Header.tsx b/resources/js/guest/components/Header.tsx index 2dbd8a0..e5aea56 100644 --- a/resources/js/guest/components/Header.tsx +++ b/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 && ( + + + + )} diff --git a/resources/js/guest/i18n/messages.ts b/resources/js/guest/i18n/messages.ts index b48854f..8ee0e9d 100644 --- a/resources/js/guest/i18n/messages.ts +++ b/resources/js/guest/i18n/messages.ts @@ -33,6 +33,10 @@ export const messages: Record = { 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 = { 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 = { }, 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 = { online: 'online', tasksSolved: 'tasks solved', }, + helpGallery: 'Help: Gallery & sharing', + notifications: { + tabStatus: 'Upload status', + }, }, eventAccess: { loading: { @@ -1339,10 +1347,10 @@ export const messages: Record = { 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 = { }, 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',