feat: implement tenant OAuth flow and guest achievements

docs/prp/07-guest-pwa-routes-components.md

@@ -1,4 +1,4 @@
-# 07a — Guest PWA Routes & Components
+# 07a — Guest PWA Routes & Components
 
 This scaffold describes recommended routes, guards, directories, and components for the Guest PWA. It is framework-leaning (React Router v6 + Vite), but adaptable.
 
@@ -8,25 +8,26 @@ Routing Principles
 - Prefer modal routes (photo detail) layered over the gallery.
 
 Route Map (proposed)
-- `/` — Landing (QR/PIN input; deep-link handler)
-- `/setup` — Profile Setup (name/avatar; skippable)
-- `/e/:slug` — Home/Feed (default gallery view + info bar)
-- `/e/:slug/tasks` — Task Picker (random/emotion)
-- `/e/:slug/tasks/:taskId` — Task Detail (card)
-- `/e/:slug/upload` — Upload Picker (camera/library + tagging)
-- `/e/:slug/queue` — Upload Queue (progress/retry)
-- `/e/:slug/gallery` — Gallery index (alias of Home or dedicated page)
-- `/e/:slug/photo/:photoId` — Photo Lightbox (modal over gallery)
-- `/e/:slug/achievements` — Achievements (optional)
-- `/e/:slug/slideshow` — Slideshow (optional, read-only)
-- `/settings` — Settings (language/theme/cache/legal)
-- `/legal/:page` — Legal pages (imprint/privacy/terms)
-- `*` — NotFound
+- `/` — Landing (QR/PIN input; deep-link handler)
+- `/setup` — Profile Setup (name/avatar; skippable)
+- `/e/:slug` — Home/Feed (default gallery view + info bar)
+- `/e/:slug/tasks` — Task Picker (random/emotion)
+- `/e/:slug/tasks/:taskId` — Task Detail (card)
+- `/e/:slug/upload` — Upload Picker (camera/library + tagging)
+- `/e/:slug/queue` — Upload Queue (progress/retry)
+- `/e/:slug/gallery` — Gallery index (alias of Home or dedicated page)
+- `/e/:slug/photo/:photoId` — Photo Lightbox (modal over gallery)
+- `/e/:slug/achievements` — Achievements (optional)
+- `/e/:slug/slideshow` — Slideshow (optional, read-only)
+- `/legal/:page` — Legal pages (imprint/privacy/terms)
+- `*` — NotFound
+
+Note: The settings experience is handled via the header sheet (no dedicated route; legal pages stay routable under /legal/:page).
 
 Guards & Loaders
-- `EventGuard` — verifies event token in storage; attempts refresh; otherwise redirects to `/`.
-- `PrefetchEvent` — loads event metadata/theme on `:slug` routes.
-- `OfflineFallback` — surfaces offline banner and queues mutations.
+- `EventGuard` — verifies event token in storage; attempts refresh; otherwise redirects to `/`.
+- `PrefetchEvent` — loads event metadata/theme on `:slug` routes.
+- `OfflineFallback` — surfaces offline banner and queues mutations.
 
 Suggested Directory Structure
 ```
@@ -46,7 +47,7 @@ apps/guest-pwa/
       PhotoLightbox.tsx        // modal route
       AchievementsPage.tsx
       SlideshowPage.tsx
-      SettingsPage.tsx
+      SettingsSheet.tsx
       LegalPage.tsx
       NotFoundPage.tsx
     components/
@@ -116,7 +117,7 @@ export const router = createBrowserRouter([
       { path: 'slideshow', element: <SlideshowPage /> },
     ],
   },
-  { path: '/settings', element: <SettingsPage /> },
+  // Settings sheet is rendered inside Header; no standalone route.
   { path: '/legal/:page', element: <LegalPage /> },
   { path: '*', element: <NotFoundPage /> },
 ]);
@@ -124,11 +125,13 @@ export const router = createBrowserRouter([
 
 Component Checklist
 - Layout
-  - `Header`, `InfoBar` (X Gäste online • Y Aufgaben gelöst), `BottomNav`, `Toast`.
+  - `Header`, `InfoBar` (X Gäste online • Y Aufgaben gelöst), `BottomNav`, `Toast`.
 - Entry
   - `QRPinForm` (QR deep link or PIN fallback), `ProfileForm` (name/avatar).
 - Home/Feed
-  - `CTAButtons` (Random Task, Emotion Picker, Quick Photo), `GalleryMasonry`, `FiltersBar`, `PhotoCard`.
+  - `HeroCard` (Willkommensgruess + Eventtitel) und `StatTiles` (online Gaeste, geloeste Aufgaben, letztes Upload).
+  - `CTAButtons` (Aufgabe ziehen, Direkt-Upload, Galerie) + `UploadQueueLink` fuer Warteschlange.
+  - `EmotionPickerGrid` und `GalleryPreview` als inhaltlicher Einstieg.
 - Tasks
   - `EmotionPickerGrid`, `TaskCard` (shows duration, group size, actions).
 - Capture/Upload (photos only)
@@ -136,7 +139,7 @@ Component Checklist
 - Photo View
   - `PhotoLightbox` (modal), like/share controls, emotion tags.
 - Settings & Legal
-  - `SettingsPage` sections, `LegalPage` renderer.
+  - `SettingsSheet` (Header-Overlay mit Namenseditor, eingebetteten Rechtsdokumenten, Cache-Leeren), `LegalPage` Renderer.
 
 State & Data
 - TanStack Query for server data (events, photos); optimistic updates for likes.