58 lines
4.9 KiB
Markdown
58 lines
4.9 KiB
Markdown
# 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:
|