Reorganize repo structure and standards references
This commit is contained in:
1 parent
3cb93a81be
commit
be2054274d
5885 files changed
+2588
-195
No files matched your search
+52
@@ -0,0 +1,52 @@
|
||||
# Designer-Brief · P27 — Mobile-PWA-Ausbau
|
||||
|
||||
**Phase:** 27/34 · **Modul:** M36 · **Owner-Dev:** Akeshan (VA-P27a/b) · **Designer:** David (D-Mobile-PWA)
|
||||
**Quellen:** `ROADMAP-V2.md` §v2-P7 · `ROADMAP.md` §Phase 27 · `_bmad-output/specs/M36-mobile-app.md` (⚠ Recut → PWA-only; Capacitor/Expo verworfen)
|
||||
**Subframe:** Pflicht je Route. Mobile-first PWA-Shell, Touch-Paradigma.
|
||||
|
||||
> 🔴 **PWA-only-Sonderfall (AD-17):** **Kein nativer Client, kein Expo/Capacitor, kein App-Store, kein EAS-Build, keine Store-Compliance.** Native-App + Stores → frühestens v3. Dieser Brief beschreibt ausschließlich den **PWA-Ausbau** der bereits in v1 vorhandenen mobile-first Web-App: installierbare PWA (Web-App-Manifest, Add-to-Homescreen, Standalone-Display), Service-Worker-Offline-Härtung, Web-Push via VAPID, Kamera/Foto über Web-APIs, Force-Update über Service-Worker-Versionierung. ⚠ iOS-Safari-Grenze: Web-Push auf iOS nur ≥16.4 im installierten Standalone-Modus.
|
||||
|
||||
## Was dieses Modul tut (Kurzfassung)
|
||||
|
||||
Die mobile-first-PWA aus v1 wird zur vollwertigen installierbaren App für den Baustellen-Einsatz. Pre-Cache beim Login (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates) über Service-Worker + IndexedDB ermöglicht Offline-Lesen und eine Offline-Write-Queue (Foto/Note/Task-Status/Checklist/Acceptance/Chat). Bei Reconnect drainiert die Queue idempotent (lokale UUID als Key); Append-only ist konfliktfrei, Status-Updates laufen LWW mit Konflikt-Resolution. Installierbarkeit, Web-Push und Force-Update kommen über 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, 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 und touch-optimiert, baut sie nicht neu.)*
|
||||
|
||||
## Geplante 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
|
||||
- [ ] Kamera/Foto via Web-APIs mit lokalem Resize; 2FA bleibt; Account-Löschung erreichbar
|
||||
- [ ] Force-Update via Service-Worker-Versionierung; Deeplinks
|
||||
|
||||
## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
||||
|
||||
Touch-optimierte Navigations-Shell (Bottom-Nav/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).
|
||||
|
||||
## Davids Delta (David füllt aus)
|
||||
|
||||
- [ ] Überschriebene/geänderte Spec-Punkte:
|
||||
- [ ] Neue UI/UX-Entscheidungen:
|
||||
- [ ] Subframe-Screen-Link(s):
|
||||
- [ ] Offene Fragen an Dev:
|
||||
|
||||
## Dev-Nachzug (wir nach Davids Delta)
|
||||
|
||||
- [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen:
|
||||
- [ ] Plane-Ticket (VA-P27a/b) aktualisiert:
|
||||
Reference in new issue
Block a user