Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,55 @@
# 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