added a help system, replaced the words "tenant" and "Pwa" with better alternatives. corrected and implemented cron jobs. prepared going live on a coolify-powered system.

This commit is contained in:
Codex Agent
2025-11-10 16:23:09 +01:00
parent ba9e64dfcb
commit 447a90a742
123 changed files with 6398 additions and 153 deletions

View File

@@ -0,0 +1,36 @@
---
title: "Schnellstart: Event betreten"
locale: de
slug: getting-started
audience: guest
summary: "Fotospiel-App installieren, Event beitreten und die Grundgesten in unter zwei Minuten lernen."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: guest-success@fotospiel.app
related:
- slug: uploading-photos
- 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.
## 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.
## 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.
### Weitere Hilfe
Siehe `uploading-photos` für Bearbeitungs- und Batch-Uploads oder `privacy-and-support` für Fragen zum Datenschutz.

View File

@@ -0,0 +1,36 @@
---
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."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: guest-success@fotospiel.app
related:
- slug: uploading-photos
- 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.
## 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.
## 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.
### Need more help?
See `uploading-photos` for editing and batch upload tips, or `privacy-and-support` if you have questions about data retention.

View File

@@ -0,0 +1,29 @@
---
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."
version_introduced: 2025.4
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: product-support@fotospiel.app
related: []
---
Willkommen im Hilfebereich für Gäste. Starte mit dem Schnellstart, wenn du Fotospiel zum ersten Mal nutzt. Die Tabelle verlinkt auf alle Leitfäden (jeder Artikel liegt auf Deutsch und Englisch vor).
| Thema | Zweck | Artikel-Slug |
| --- | --- | --- |
| Schnellstart | App installieren, Event-Code eingeben und die wichtigsten Gesten lernen. | `getting-started` |
| Upload-Workflow | Fotos aufnehmen, bearbeiten und mit Hintergrund-Sync hochladen. | `uploading-photos` |
| Offline-Modus & Sync | Teilnehmen auch ohne Netz und sicherstellen, dass nichts verloren geht. | `offline-sync` |
| Datenschutz & Support | Welche Daten gespeichert werden und wie du Hilfe kontaktierst. | `privacy-and-support` |
### So nutzt du die Hilfe
- **Suche**: Verwende die Suche im Hilfebereich oder die Offline-Suche in den App-Einstellungen. Begriffe wie „Upload-Limit“ oder „Link teilen“ funktionieren.
- **Sprache umschalten**: Klick auf das Globus-Symbol innerhalb jedes Artikels, um zwischen DE/EN zu wechseln.
- **Kontext-Links**: Zahlreiche UI-Elemente mit `?`-Symbol führen direkt zum passenden Abschnitt.
Mehr Unterstützung? Tippe in der Gäste-App auf *Kontakt zum Support* (Einstellungen → Hilfe) und nenne deine Event-ID.

View File

@@ -0,0 +1,29 @@
---
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."
version_introduced: 2025.4
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: product-support@fotospiel.app
related: []
---
Welcome to the guest-focused documentation hub. Start with the Quick Start article if this is your first time using Fotospiel. Use the table below to jump to individual guides (each article has both English and German versions).
| Topic | Purpose | Article Slug |
| --- | --- | --- |
| Quick Start | Install the app, join an event, and learn the basic gestures. | `getting-started` |
| Upload Workflow | Capture, edit, and upload photos with background sync. | `uploading-photos` |
| Offline Mode & Sync | Keep participating when connectivity drops and ensure nothing is lost. | `offline-sync` |
| Privacy & Support | Understand what data is stored and how to reach support. | `privacy-and-support` |
### How to use these docs
- **Search**: Use the in-app search bar or offline search in the app settings screen. Keywords like “upload limit” or “share link” are supported.
- **Language toggle**: Switch between EN/DE with the globe icon inside every article.
- **Contextual links**: Many UI screens offer a `?` icon that deep-links directly to the relevant section here.
Need more help? Tap *Contact Support* inside the guest app → Settings → Help. Provide the event ID so we can assist faster.

View File

@@ -0,0 +1,40 @@
---
title: "Offline-Modus & Synchronisierung"
locale: de
slug: offline-sync
audience: guest
summary: "Auch ohne Netz teilnehmen, Uploads sicher zwischenspeichern und den Status prüfen."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: reliability@fotospiel.app
related:
- slug: uploading-photos
- slug: privacy-and-support
---
## 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.
## 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 (Top10 Artikel pro Sprache), sofern du den Hilfebereich mindestens einmal online geöffnet hast.
## 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 500MB 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.
## 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.
### Weitere Hilfe
Unter Einstellungen → Hilfe → *Diagnosedaten senden* kannst du (sobald du online bist) anonymisierte Logs plus deine Event-ID an den Support schicken.

View File

@@ -0,0 +1,40 @@
---
title: "Offline Mode & Sync"
locale: en
slug: offline-sync
audience: guest
summary: "Participate without coverage, queue uploads safely, and know when everything is delivered."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: reliability@fotospiel.app
related:
- slug: uploading-photos
- slug: privacy-and-support
---
## 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.
## 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.
## 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 500MB; 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.
## 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; theres no cross-device merge.
- **Battery saver** might pause background sync. Keep the app in the foreground for large batches.
### Need more help?
Use Settings → Help → *Send diagnostics* once you are online; support receives anonymized logs plus your event ID.

View File

@@ -0,0 +1,38 @@
---
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."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: legal@fotospiel.app
related:
- slug: getting-started
- slug: offline-sync
---
## 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.
## 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.
## 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.
## Antwortzeiten
- Kritische Probleme (Uploads für gesamtes Event gestört): <15 Minuten.
- Individuelle Lösch- oder Datenschutzanfragen: innerhalb von 48 Stunden.
### Weitere Hilfe
Rechtsseiten (Impressum, Datenschutz, AGB) findest du unter Einstellungen → Rechtliches. Für kundenspezifische Regelungen kontaktiere den Veranstalter direkt.

View File

@@ -0,0 +1,38 @@
---
title: "Privacy & Getting Help"
locale: en
slug: privacy-and-support
audience: guest
summary: "Understand what data is stored, how to request deletions, and how to contact support."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: legal@fotospiel.app
related:
- slug: getting-started
- slug: offline-sync
---
## Data we store
- **Photos & captions**: Stored on the customer accounts 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.
## 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.
## 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.
## Response times
- Critical issues (uploads failing for entire event): <15 minutes.
- Individual deletion or privacy questions: within 48 hours.
### Need more help?
Review the public legal pages (Impressum, Privacy, AGB) under Settings → Legal, or contact the event organizer directly for customer-specific policies.

View File

@@ -0,0 +1,39 @@
---
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."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: guest-success@fotospiel.app
related:
- slug: getting-started
- 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.
## 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. 30Sekunden (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.
- Markiere bis zu 10 wartende Uploads gleichzeitig zum Löschen oder erneuten Senden.
- Likes und Kommentare synchronisieren getrennt und blockieren den Foto-Upload nicht.
### Weitere Hilfe
Siehe `offline-sync` für längere Offline-Phasen oder kontaktiere den Support unter Einstellungen → Hilfe.

View File

@@ -0,0 +1,39 @@
---
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."
version_introduced: 2025.4
requires_app_version: "^3.2.0"
status: draft
translation_state: aligned
last_reviewed_at: 2025-02-22
owner: guest-success@fotospiel.app
related:
- slug: getting-started
- 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.
## 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.
## 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 dont block photo uploads.
### Need more help?
Read `offline-sync` for long offline stretches or contact support from Settings → Help.