4.5 KiB
4.5 KiB
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 überNotificationDevice - 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()überNotificationDevice(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-Inputcapture) 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 2NotificationDevice(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-P27aaktualisiert