patrickandClaude Sonnet 5
9c6426190e
Vergleich mit InvenTree, Snipe-IT, Grocy, Shelf.nu, Resgrid, KP Front, FleetMS, HiOrg-Server ergibt neue Kacheln (ASSET-010 Custody, FILE-008 Hash-Audit-Journal, FILE-009 Notizen, NOTIF-003, MAINT-007 Tankbuch, ZUST-003 Standort-Scoping, FOUND-007 Import/Export, FOUND-008 Fristen-Dienst, READY-006 Statistik-Dashboard, UI2-006..010) sowie Referenz-Ergänzungen bei bestehenden Lücken. Alle Design- Entscheidungen (Datenmodell, Sicherheitsanforderungen bei ASSET-010) geklärt. Neues Epic 23 (Flutter-Begleit-App, Sondierungs-Prototyp FLUT-001) inkl. geklärtem TLS-Blocker (Domain mabea.perlbach-edv.de mit Let's-Encrypt-Zertifikat statt selbstsigniertem Server-Zertifikat). Alle Kacheln bleiben offen/ungeplant, nur ausgearbeitet, keine Implementierung. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CVgbozhYmuEhiEJHffRXCV
141 lines
6.5 KiB
Markdown
141 lines
6.5 KiB
Markdown
# Epic 15 — Mobile
|
|
|
|
Details zu MOBILE-001 … MOBILE-005 (vollständig).
|
|
|
|
---
|
|
|
|
## MOBILE-001 — PWA-Grundgerüst
|
|
|
|
- **Ziel:** Mobile Nutzung ohne native App — PWA installierbar, Grundgerüst für spätere
|
|
Offline-Fähigkeit.
|
|
- **Beschreibung:** Web-App-Manifest, Service-Worker-Registrierung, Icons, responsives
|
|
Base-Layout.
|
|
- **Benutzerwert:** Helfer installieren die Anwendung wie eine App aufs Smartphone, ohne
|
|
App-Store.
|
|
- **Abhängigkeiten:** FOUND-005
|
|
- **Datenmodell:** keins
|
|
- **Backend:** keins zusätzlich
|
|
- **Frontend:** Manifest, Service-Worker-Grundgerüst
|
|
- **Mobile:** ist diese Kachel selbst
|
|
- **QR-Code/Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** nein
|
|
- **Rechte:** keine neuen
|
|
- **Audit:** nein
|
|
- **Akzeptanzkriterien:** App lässt sich auf dem Smartphone „zum Homescreen hinzufügen",
|
|
startet standalone.
|
|
- **Tests:** Manifest-Validierungstest.
|
|
- **DoD:** deckt sich mit MABEA (Vite-PWA-Plugin bereits eingerichtet, Manifest/Icons/
|
|
Service-Worker vorhanden).
|
|
|
|
## MOBILE-002 — QR-Scan-Workflow (Kernablauf)
|
|
|
|
- **Ziel:** Scan → Akte öffnen → Status/Prüfung/Mangel/Foto → Speichern mit möglichst
|
|
wenig Klicks.
|
|
- **Beschreibung:** Kamera-Zugriff, QR-Dekodierung, Routing zur Akte (IDENT-008), von
|
|
dort direkte Kurzwege zu häufigen Aktionen.
|
|
- **Benutzerwert:** Kernversprechen des ganzen Identity-Konzepts — ohne diesen Ablauf ist
|
|
QR nur Deko.
|
|
- **Abhängigkeiten:** MOBILE-001, IDENT-008
|
|
- **Datenmodell:** keins neu
|
|
- **Backend:** keins zusätzlich
|
|
- **Frontend:** Scanner-Komponente + Routing
|
|
- **Mobile:** ist diese Kachel selbst
|
|
- **QR-Code:** zentral
|
|
- **Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** Zielseite
|
|
- **Rechte:** wie Akte-Leserecht
|
|
- **Audit:** nein zusätzlich
|
|
- **Akzeptanzkriterien:** Scan bis Akte offen in wenigen Sekunden, Fehlerfall (kein QR
|
|
erkannt/ungültiger Code) klar kommuniziert.
|
|
- **Tests:** Scan-Erfolgs-/Fehlertest.
|
|
- **DoD:** deckt sich 1:1 mit MABEA — Scan routet seit 2026-09-06 zur Akte
|
|
(`/akte/objekt/{id}`), von dort Kurzweg-Button "Kontrolle starten".
|
|
|
|
## MOBILE-003 — Offline-Grundgerüst (P2)
|
|
|
|
- **Ziel:** Grundfunktionen auch ohne Netzverbindung nutzbar (z.B. im Keller/
|
|
Fahrzeughalle ohne Empfang).
|
|
- **Beschreibung:** Service-Worker-Caching-Strategie, Offline-Queue für Schreibaktionen,
|
|
Sync bei Wiederverbindung.
|
|
- **Benutzerwert:** Arbeiten in Funklöchern ohne Datenverlust.
|
|
- **Abhängigkeiten:** MOBILE-001
|
|
- **Datenmodell:** keins (clientseitig)
|
|
- **Backend:** keins zusätzlich (muss idempotente/nachträgliche Verarbeitung vertragen)
|
|
- **Frontend:** Offline-Queue, Sync-Logik, Konfliktbehandlung
|
|
- **Mobile:** ist diese Kachel selbst
|
|
- **QR-Code/Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** nein
|
|
- **Rechte:** keine neuen
|
|
- **Audit:** nachträglich synchronisierte Aktionen müssen korrekten Zeitstempel/Nutzer
|
|
behalten
|
|
- **Akzeptanzkriterien:** Aktion offline ausführen, nach Wiederverbindung korrekt
|
|
übernommen.
|
|
- **Tests:** Offline-Simulationstest.
|
|
- **DoD:** **HIGH RISK, P2 — komplexestes Mobile-Thema.** MABEA hat KEINE
|
|
Offline-Fähigkeit (nur PWA-Shell-Caching via Vite-PWA-Plugin, keine Offline-Queue für
|
|
Schreibvorgänge) — bei Netzausfall schlägt jede Aktion einfach fehl.
|
|
- **Referenz (Open-Source-Vergleich 2026-09-09):** KP Front (`feuerwehr-oberwil/kp-front`,
|
|
identischer Stack FastAPI/PostgreSQL/React-Vite-PWA, AGPL-3.0-or-later — nur Muster,
|
|
keine Codeübernahme) löst das nicht als globale Offline-Queue, sondern als
|
|
**Draft-first-Erfassung**: jede Eingabe (`captureDraft.ts`-Muster) wird sofort lokal als
|
|
Entwurf mit eigenem Sync-Status gespeichert (statt nur bei Verbindungsverlust in eine
|
|
Warteschlange zu fallen) — der Nutzer sieht pro Datensatz „lokal/synchronisiert" statt
|
|
nur eines globalen Online-Banners. Für MABEA relevant, weil Kontrollen/Mängelmeldungen
|
|
(MOBILE-004/005) so auch bei instabiler statt komplett fehlender Verbindung robust
|
|
bleiben, nicht nur im reinen Offline-Fall. Empfehlung: MOBILE-003 auf dieses Muster hin
|
|
konkretisieren statt generischer „Offline-Queue".
|
|
|
|
## MOBILE-004 — Mobile Mangelmeldung + Foto
|
|
|
|
- **Ziel:** Schaden direkt im Feld melden, mit Foto vom Kamera-Sensor.
|
|
- **Beschreibung:** Nutzt DEFECT-001 + DOC-001, mobil-optimiertes Formular (große
|
|
Buttons, wenig Tipparbeit).
|
|
- **Benutzerwert:** Zentrales Alltagswerkzeug für Helfer.
|
|
- **Abhängigkeiten:** MOBILE-002, DEFECT-001
|
|
- **Datenmodell:** keins neu
|
|
- **Backend:** keins zusätzlich
|
|
- **Frontend:** mobil-optimiertes Meldeformular
|
|
- **Mobile:** ist diese Kachel selbst
|
|
- **QR-Code:** Scan startet Meldung direkt am richtigen Asset
|
|
- **Seriennummer/Inventarnummer:** nein
|
|
- **Akte:** Mängelbereich
|
|
- **Rechte:** wie DEFECT-001
|
|
- **Audit:** wie DEFECT-001
|
|
- **Akzeptanzkriterien:** Meldung inkl. Foto in unter 30 Sekunden möglich.
|
|
- **Tests:** Bedienbarkeitstest (informell, kein reiner Unit-Test).
|
|
- **DoD:** deckt sich mit MABEA (`MangelListePage` + `DokumentePanel` bereits responsive
|
|
nutzbar) — direkter QR-Start der Meldung fehlt noch (Akte existiert jetzt, aber ohne
|
|
eingebetteten Melde-Kurzweg).
|
|
|
|
## MOBILE-005 — Mobile Beladungskontrolle
|
|
|
|
- **Ziel:** Kontroll-Ablauf (LOAD-004) mobil-optimiert.
|
|
- **Beschreibung:** Große Eingabefelder, Fach-Gruppierung, Signatur am Ende.
|
|
- **Benutzerwert:** Zentraler täglicher Arbeitsablauf für Helfer.
|
|
- **Abhängigkeiten:** MOBILE-002, LOAD-004
|
|
- **Datenmodell:** keins neu
|
|
- **Backend:** keins zusätzlich
|
|
- **Frontend:** mobile Kontroll-UI
|
|
- **Mobile:** ist diese Kachel selbst
|
|
- **QR-Code:** Scan startet Kontrolle direkt
|
|
- **Seriennummer/Inventarnummer:** Erfassung je Position
|
|
- **Akte:** Beladungsbereich
|
|
- **Rechte:** wie LOAD-004
|
|
- **Audit:** wie LOAD-004
|
|
- **Akzeptanzkriterien:** kompletter Kontrollablauf mobil ohne Zoom-/Scroll-Frust
|
|
durchführbar.
|
|
- **Tests:** Bedienbarkeitstest.
|
|
- **DoD:** deckt sich 1:1 mit MABEA — explizit als gutes Muster festgehalten
|
|
(Fach-Gruppierung in der Kontroll-UI kam gut an, Präzedenz für weitere mobile Screens),
|
|
bereits produktiv und vom Nutzer geschätzt.
|
|
|
|
---
|
|
|
|
**MABEA-Ist-Stand-Abgleich (aktualisiert 2026-09-05):** MOBILE-001, 004, 005 sind solide
|
|
umgesetzt (PWA läuft, die Kontroll-UI gilt sogar als vorbildliches Muster für künftige
|
|
mobile Screens). **MOBILE-002 ist jetzt nur noch ein kleiner Nachzug** — die Akte existiert
|
|
seit dem Digital-File-Epic (`/akte/objekt/{id}`), der Scan routet aber weiterhin zur
|
|
Kontrolle statt zur Akte; Umstellung des Scan-Ziels ist kein Neubau mehr. **MOBILE-003
|
|
(Offline-Fähigkeit) fehlt weiterhin komplett** — bewusst P2/HIGH RISK, da technisch das
|
|
anspruchsvollste Thema im Mobile-Epic.
|