55 lines
4.1 KiB
Markdown
55 lines
4.1 KiB
Markdown
# 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
|