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

58 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: