# VA-P27a · P27 Mobile-PWA-Ausbau: Installierbarkeit + Service-Worker-Offline + Web-Push/Kamera | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P27 — Mobile-PWA-Ausbau · v2-P7 | | **Cycle/Fenster** | v2-W2 — KWP/Portal/Mobile-Start · fällig 2026-07-25 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `R-P9b` (OfflineSyncQueue + serverseitige Idempotency-Keys aus v1-P9), `AK-P21` (notify() → Web-Push/VAPID, NotificationDevice-Andockpunkt aus P21) - **Blocks:** `VA-P27b` (mobile Navigation + Offline-Sync + PWA-Härtung baut auf Service-Worker + Queue auf) - **Läuft parallel zu:** `VA-P26a/b` (Customer-Portal) im selben Fenster v2-W2 — disjunkte Domänen. Service-Worker/IndexedDB sind clientseitig; serverseitig nur additive Sync-Endpoints. - **Konflikt-Risiko:** gering — baut auf vorhandener mobile-first responsive Web-App auf, kein Kern-Umbau. ## Was wir bauen Den **PWA-Ausbau** der bereits in v1 vorhandenen mobile-first Web-App — **PWA-only (AD-17): kein nativer Client, kein Expo/Capacitor, kein App-Store, kein EAS-Build, keine Store-Compliance** (Native → frühestens v3). Konkret: **installierbare PWA** (Web-App-Manifest + Add-to-Homescreen + Standalone-Display), **Pre-Cache beim Login** + **Offline-Write-Queue** über Service-Worker + IndexedDB, **Web-Push via VAPID** und **Kamera/Foto über Web-APIs** (lokaler Resize). 2FA bleibt. ## Benötigte Screens (Backend bedient — Design liefert `D-P27`, mobile-first PWA-Shell) | Screen [Route] | Kern-Inhalt | |---|---| | Web-Push-Pre-Prompt [Modal] | Erklärungs-Pre-Prompt vor dem nativen VAPID-Berechtigungs-Dialog | | Install-Hinweis (A2HS) [Banner/Modal] | Add-to-Homescreen-Hinweis, plattformspezifisch (iOS-Safari-Standalone vs. Android) | | Mobile-Login + Setup [`/login` mobil] | Email/Pwd + Magic-Link, 2FA bleibt, offline-Permissions-Snapshot, Erst-Setup nach Install | *(Die fachlichen Screens — Projekte/Tasks/Abnahme/Chat/Foto — existieren aus v1; P27 macht sie offline-tauglich, baut sie nicht neu.)* ## Definition of Done - [ ] **Installierbare PWA:** Web-App-Manifest + Add-to-Homescreen + **Standalone-Display** - [ ] **Pre-Cache beim Login** (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates) + **Offline-Write-Queue** (Foto/Note/Task-Status/Checklist/Acceptance/Chat) über **Service-Worker + IndexedDB** - [ ] **Web-Push (VAPID)** aktiviert den in v1 ruhenden `notify()`-Push-Kanal über `NotificationDevice` - [ ] **Kamera/Foto via Web-APIs** mit lokalem Resize; **2FA bleibt** - [ ] **KEIN** Expo/EAS, **kein** nativer Client, **kein** Capacitor (AD-17) - [ ] Offline-Schreibvorgänge per **lokaler UUID** als Idempotency-Key vorbereitet (Drain in VA-P27b) ## Technische Bausteine - **Service-Worker + IndexedDB** (clientseitig, **kein** Capacitor/Expo, AD-17): Pre-Cache-Strategie beim Login (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates), Offline-Write-Queue (Append-only konfliktfrei; Status-Updates für LWW vorgemerkt). Lokale UUID als Idempotency-Key je Write. - **Web-App-Manifest:** Name/Icons/Display=standalone/Theme; A2HS-Trigger plattformspezifisch (iOS-Safari vs. Android `beforeinstallprompt`). - **Web-Push (VAPID):** aktiviert den in v1 ruhenden Push-Kanal von `notify()` über `NotificationDevice` (device_kind, push_token); Pre-Prompt vor nativem Permission-Dialog. ⚠ iOS-Safari: Web-Push nur ≥16.4 im installierten Standalone-Modus. - **Kamera/Foto:** Web-APIs (`getUserMedia`/File-Input `capture`) mit lokalem Resize vor Upload → v1-Files. - **Server:** additive Sync-Ingest-Endpoints (Idempotency über lokale UUID, R-P9b); keine eigene .prisma nötig (nutzt v1-OfflineSyncQueue + NotificationDevice). ## Quellen (granular) - `ROADMAP-V2.md` → **§v2-P7 Mobile-PWA-Ausbau** (Installierbarkeit/Offline/Web-Push = Hauptquelle; Recut PWA-only) - `ENTITY-MODEL.md` → **Domäne 2** `NotificationDevice` (Push-Kanal ruht in v1 → Web-Push) + v1-OfflineSyncQueue (P9) - `docs/ARCHITECTURE-DECISIONS.md` → **AD-17 PWA-only** (kein nativer Client/Store, das ist v3) - `ROADMAP.md` → Phase 27 · `PHASE-SOURCES.md` → Phase 27 (M167 PWA-Manifest/Installierbarkeit, M168 Web-Push/Kamera/Foto) - `designer-briefs/P27-mobile-pwa-ausbau.md` (PWA-only-Sonderfall, A2HS, Web-Push-Pre-Prompt, iOS-Grenze) - `_bmad-output/specs/M36-mobile-app.md` (⚠ Recut → PWA-only; Capacitor/Expo verworfen) ## Dev-Nachzug (nach Davids `D-P27`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `VA-P27a` aktualisiert