Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P27.md
T

4.9 KiB
Raw Blame History

VD-P27 · Screens P27 — Mobile-PWA-Shell (Touch / Tab-Bar / Offline-Zustände)

Typ Screen (Design)
Owner David
Phase P27 — Mobile-PWA-Ausbau (v2-P7) · bedient VA-P27a/VA-P27b
Cycle/Fenster v2-W2 — KWP/Portal/Mobile-Start · 2026-07-20 → fällig 2026-07-22 (Dev zieht bis 27.07.)
Status geplant (NEU — Phasen-Ticket)

♻️ Löst Sammel-Ticket auf / erweitert: Dieses Phasen-Ticket ersetzt und erweitert das alte Sammel-Ticket VD-3 („Mobile-PWA-Shell: Touch, Tab-Bar, Offline-Zustände") um den vollen Screen-Satz. 🔴 PWA-only (AD-17): Kein nativer Client, kein Expo/Capacitor, kein App-Store, kein EAS-Build, keine Store-Compliance. Native + Stores → frühestens v3. Hier ausschließlich der PWA-Ausbau der bestehenden v1-mobile-first-Web-App. 🌐 Extern wahrnehmbar (Install/Touch-Erlebnis) → zusätzlicher Polish (fließt in VD-6).

Abhängigkeiten & Parallelität

  • Blocked by: D0-Baseline (D-D0a App-Shell, D-D0b Archetypen) — die fachlichen Screens (Projekte/Tasks/Abnahme/Chat/Foto) existieren aus v1; P27 macht sie offline-tauglich + touch-optimiert, baut sie NICHT neu
  • Bedient (Dev): VA-P27a (Installierbarkeit + Service-Worker, 23.–25.07.), VA-P27b (mobile Navigation + Offline-Queue, 25.–27.07.)
  • Läuft parallel zu: KWP-Screens (VD-P32); VD-P26 kann als separater, undatierter Design-Nachzug parallel laufen
  • Subframe: Pflicht je Route — Mobile-first PWA-Shell, Touch-Paradigma (Bottom-Nav/Tab-Bar)

Was wir bauen

Die Mobile-PWA-Shell für den Baustellen-Einsatz: installierbare PWA (Web-App-Manifest, Add-to-Homescreen, Standalone-Display), Touch-optimierte Navigation (Bottom-Nav/Tab-Bar, Modus-Umschaltung Baustelle/Büro), Offline-Zustände (Pre-Cache beim Login, Offline-Write-Queue mit Sync-on-Reconnect + Konflikt-Resolution), Web-Push via VAPID (Pre-Prompt), Force-Update über Service-Worker-Versionierung und Install-Hinweis (A2HS). Reine Web-Standards — kein Store dazwischen.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Mobile-Login + Setup [/login mobil] Email/Pwd + Magic-Link, 2FA bleibt, offline-Permissions-Snapshot, Erst-Setup nach Install A1/Setup
Mobile-Navigation (Baustelle/Büro) [/m] Touch-optimierte Haupt-Navigation (Bottom-Nav/Tab-Bar), Modus-Umschaltung Baustelle/Büro, Deeplinks A-Shell
Sync-Queue + Konflikt-Resolution [/m/sync] Liste ausstehender Offline-Writes (Foto/Note/Status/Checklist/Acceptance/Chat) mit Status, Konflikt-Resolution bei LWW-Status-Updates A2 + Konflikt-Ansicht
Mobile-Settings [/m/settings] Pre-Cache-Steuerung, Storage-Budget/Belegung, registrierte Geräte, Account-Löschung erreichbar A6
Web-Push-Pre-Prompt [Modal] Erklärungs-Pre-Prompt vor dem nativen Berechtigungs-Dialog (VAPID) A5
Force-Update-Modal [Modal] Hinweis auf neue Service-Worker-Version, Reload-Aufforderung A5
Install-Hinweis (A2HS) [Banner/Modal] Add-to-Homescreen-Hinweis, plattformspezifisch (iOS-Safari-Standalone vs. Android) Banner

(Die fachlichen Screens — Projekte/Tasks/Abnahme/Chat/Foto — existieren aus v1; P27 macht sie offline-tauglich + touch-optimiert, baut sie nicht neu.)

Features (muss abgedeckt sein)

  • Offline-Pflicht: Pre-Cache beim Login (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates) über Service-Worker + IndexedDB
  • Offline-Write-Queue (Foto/Note/Task-Status/Checklist/Acceptance/Chat); Sync-on-Reconnect drainiert idempotent (lokale UUID als Key)
  • Append-only konfliktfrei; Status-Updates LWW mit Konflikt-Resolution
  • Installierbar: Web-App-Manifest + Add-to-Homescreen + Standalone-Display
  • Web-Push (VAPID) aktiviert den in v1 ruhenden notify()-Push-Kanal über NotificationDevice; iOS-Safari nur ≥16.4 im Standalone
  • Kamera/Foto via Web-APIs mit lokalem Resize; 2FA bleibt; Account-Löschung erreichbar
  • Force-Update via Service-Worker-Versionierung; Deeplinks

UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Touch-optimierte Navigations-Shell (Bottom-Nav/Tab-Bar/Drawer); Modus-Umschalter (Baustelle/Büro); Sync-Status-Indikator (online/offline/pending count); Queue-Liste mit Pro-Eintrag-Status; Konflikt-Resolution-Ansicht (lokal vs. Server); Pre-Cache-Fortschritt/Storage-Belegung-Anzeige; Web-Push-Pre-Prompt-Dialog; A2HS-Install-Banner (plattformabhängig); Force-Update-Modal; Foto-Aufnahme-/Resize-Komponente; Offline-Banner; Empty-/Loading-/Permission-Denied-States (Klartext).

Quellen (granular)

  • designer-briefs/P27-mobile-pwa-ausbau.md (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
  • Plane-Snapshot: ersetzt/erweitert VD-3; bedient VA-P27a/VA-P27b (v2-W2, 23.–27.07.); Polish → VD-6

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: