Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P27a.md
T

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 ü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