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

This commit is contained in:
Codex Agent
2025-12-24 16:23:55 +01:00
parent 3ef2fc5dc1
commit efc173cf5d
27 changed files with 840 additions and 173 deletions

View File

@@ -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 youll 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.

View File

@@ -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; youll 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.

View File

@@ -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.

View File

@@ -0,0 +1,40 @@
---
title: "How Fotospiel Works"
locale: en
slug: how-fotospiel-works
audience: guest
summary: "The 60second 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 dont 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.

View File

@@ -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. Heres 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 60second 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.

View File

@@ -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 youre 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.

View File

@@ -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 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.
## 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; theres 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 youre 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.

View File

@@ -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 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.
- **Photos & metadata:** Your uploads live in the event organizers 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): &lt;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.

View File

@@ -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. Youll find profile, legal pages, help, and cache tools.
## Language
- **Choose a language:** Switch between German and English in Settings.
- **Event default:** The events 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.

View File

@@ -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.

View File

@@ -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 wont start
- **Check permissions:** Allow camera access in browser or system settings.
- **Blocked:** If the browser blocks access, reset the permission there.
- **Unsupported:** Some browsers dont allow live camera preview—use gallery import instead.
## Upload fails
- **Check connection:** Try WiFi/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 cant 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, youll 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.

View File

@@ -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:** Youll 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.** Youll 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 dont 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.