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

4.1 KiB

VA-P27b · P27 Mobile-PWA-Ausbau: mobile Navigation + Offline-Sync + PWA-Härtung

Typ Dev (Code)
Owner Akeshan
Phase P27 — Mobile-PWA-Ausbau · v2-P7
Cycle/Fenster v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-27
Status geplant

Abhängigkeiten & Parallelität

  • Blocked by: VA-P27a (Service-Worker + Offline-Write-Queue + Installierbarkeit + Web-Push)
  • Blocks: —
  • Läuft parallel zu: VA-P29 / VA-P28b / VA-P30a/b (Akeshans W3-Tickets) — disjunkte Domänen, derselbe Sprint-Slot. Clientseitig (Service-Worker/Navigation); serverseitig nur Sync-Drain-Idempotenz.
  • Konflikt-Risiko: gering — additiv auf der PWA-Basis aus VA-P27a.

Was wir bauen

Den Abschluss des PWA-Ausbaus (PWA-only, AD-17): touch-optimierte mobile Navigation (Modus-Umschaltung Baustelle/Büro) + mobile Routes, Sync-on-Reconnect (idempotenter Queue-Drain mit lokaler UUID + Konflikt-Resolution) und die PWA-Härtung (Web-Checkout statt Pricing-Store-UI, erreichbare Account-Löschung, Force-Update via Service-Worker-Versionierung, Deeplinks). Keine App-Store-Compliance — reine Web-Standards.

Benötigte Screens (Backend bedient — Design liefert D-P27, mobile-first PWA-Shell)

Screen [Route] Kern-Inhalt
Mobile-Navigation (Baustelle/Büro) [/m] Touch-optimierte Haupt-Navigation, Modus-Umschaltung Baustelle/Büro, Deeplinks
Sync-Queue + Konflikt-Resolution [/m/sync] Liste ausstehender Offline-Writes (Foto/Note/Status/Checklist/Acceptance/Chat) mit Status, Konflikt-Resolution bei LWW-Status-Updates
Mobile-Settings [/m/settings] Pre-Cache-Steuerung, Storage-Budget/Belegung, registrierte Geräte, Account-Löschung erreichbar
Force-Update-Modal [Modal] Hinweis auf neue Service-Worker-Version, Reload-Aufforderung

Definition of Done

  • Mobile Navigation (Modus Baustelle/Büro) + mobile Routes
  • Sync-on-Reconnect idempotent (lokale UUID als Key) + Konflikt-Resolution (Append-only konfliktfrei; Status-Updates LWW)
  • PWA-Härtung: Web-Checkout (kein Pricing-Store-UI), Account-Löschung erreichbar, Force-Update via Service-Worker-Versionierung, Deeplinks
  • KEINE App-Store-Compliance (PWA-only, AD-17) — kein nativer Client, kein Store-Review-Risiko
  • Storage-Budget/Belegung sichtbar; registrierte Geräte (NotificationDevice) verwaltbar

Technische Bausteine

  • Sync-Drain (clientseitig SW → server): Queue-Drain bei Reconnect, idempotent über lokale UUID als Key (serverseitige Idempotency-Keys aus R-P9b); Append-only konfliktfrei; Status-Updates LWW mit Konflikt-Resolution-Ansicht (lokal vs. Server). Kein Capacitor/Expo (AD-17).
  • Mobile-Navigation: touch-optimierte Shell (Bottom-Nav/Drawer), Modus-Umschalter Baustelle/Büro, Deeplinks; nutzt vorhandene v1-Fachscreens.
  • Force-Update: Service-Worker-Versionierung → Force-Update-Modal mit Reload; sauberer Cache-Bust.
  • PWA-Härtung: Web-Checkout-Verweis (kein Pricing-Store-UI), Account-Löschung erreichbar, Storage-Budget-Anzeige; keine App-Store-Compliance erforderlich.
  • Server: nutzt v1-OfflineSyncQueue + NotificationDevice; keine eigene .prisma nötig (additive Sync-Endpoints).

Quellen (granular)

  • ROADMAP-V2.md → §v2-P7 (mobile Navigation/Sync-on-Reconnect/Force-Update = Hauptquelle)
  • ENTITY-MODEL.md → v1-OfflineSyncQueue (P9) + Domäne 2 NotificationDevice
  • docs/ARCHITECTURE-DECISIONS.md → AD-17 PWA-only
  • ROADMAP.md → Phase 27 · PHASE-SOURCES.md → Phase 27 (M169 mobile Navigation/Routes, M170 Service-Worker-Offline-Modus, M171 Force-Update/PWA-Härtung)
  • designer-briefs/P27-mobile-pwa-ausbau.md (Sync-Queue/Konflikt-Resolution, Force-Update-Modal)
  • _bmad-output/specs/M36-mobile-app.md (⚠ Recut → PWA-only; Offline/PWA-Teile)
  • Querverweis: ticket-docs/VA-P27a.md (PWA-Basis, auf der dies aufbaut)

Dev-Nachzug (nach Davids D-P27-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket VA-P27b aktualisiert