Eduard Wisch
7c0aefa793
All checks were successful
Deploy baustelle-pwa / deploy (push) Successful in 1s
Mobile Progressive Web App für Baustellen-Doku, spricht die REST-API des Dolibarr-Bericht-Moduls. MVP-Features: - Vanilla JavaScript, kein Build-Step nötig - Login mit Dolibarr-Credentials → JWT (7 Tage) - Auftragsliste mit Suche und Multi-User-Filter - Auftragsdetail mit Kunde, Adresse, Click-to-Call - Foto-Aufnahme via Kamera oder Galerie (multiple) - Clientseitige Bildverkleinerung (max 2000px, JPEG q=0.85) - Offline-Queue in IndexedDB für Uploads ohne Netz - Auto-Sync bei Online-Event mit Status-Badge - Service Worker für App-Shell-Cache - PWA-installierbar (Manifest, Icons, Theme-Color) Hosting: awl.data-it-solution.de/baustelle/ via Apache-Alias Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# Baustelle PWA
|
|
|
|
Mobile Progressive Web App für die Baustellen-Doku — Foto-Upload, Sprachnotizen, Skizzen, offline-fähig. Spricht die REST-API des Dolibarr-Bericht-Moduls.
|
|
|
|
## Stack
|
|
|
|
- **Vanilla JavaScript** — kein Build, keine Framework-Abhängigkeit
|
|
- **Service Worker** für App-Shell-Cache (Workbox-frei, eigene Implementierung)
|
|
- **IndexedDB** für JWT-Storage und Offline-Upload-Queue
|
|
- **REST API** des `bericht`-Dolibarr-Moduls unter `/custom/bericht/api/`
|
|
|
|
## Features (MVP)
|
|
|
|
- ✅ Login mit Dolibarr-Credentials → JWT (7 Tage gültig)
|
|
- ✅ Auftragsliste mit Suche, gefiltert auf eigene Aufträge (Multi-User)
|
|
- ✅ Auftragsdetail mit Kunde, Adresse, Telefon (Click-to-Call)
|
|
- ✅ Foto-Aufnahme direkt aus der Kamera oder aus Galerie
|
|
- ✅ Clientseitige Bild-Verkleinerung auf 2000px (JPEG q=0.85)
|
|
- ✅ Offline-Queue: bei fehlgeschlagenem Upload landet das Foto in IndexedDB
|
|
- ✅ Auto-Sync wenn wieder online (mit Status-Badge)
|
|
- ✅ Service Worker für Offline-Start
|
|
- ✅ Installierbar als PWA (Home-Screen-Icon)
|
|
|
|
## Geplant (Phase 4)
|
|
|
|
- Sprachnotizen via MediaRecorder
|
|
- Touch-Skizzen-Editor für Bilder
|
|
- Schnell-Bericht direkt in der PWA erstellen
|
|
- Touch-Unterschrift abnehmen
|
|
- PIN-Schutz / WebAuthn
|
|
- Push-Notifications für neue Aufträge
|
|
- Web Share Target API
|
|
|
|
## Hosting
|
|
|
|
Wird bei jedem Push nach `/srv/http/baustelle/` (lokal) bzw. `/mnt/appdata/firma/dolibarr-202509/baustelle/` (prod) deployt. Apache-Alias unter `https://awl.data-it-solution.de/baustelle/`.
|
|
|
|
## Verzeichnis-Struktur
|
|
|
|
```
|
|
baustelle-pwa/
|
|
├── index.html App-Shell
|
|
├── manifest.webmanifest PWA Manifest
|
|
├── sw.js Service Worker
|
|
├── app.js Hauptlogik (Routes, Views)
|
|
├── app.css Mobile-first Styling
|
|
├── lib/
|
|
│ ├── idb.js IndexedDB-Wrapper
|
|
│ ├── api.js REST-API-Client (JWT)
|
|
│ ├── offline.js Offline-Queue + Sync
|
|
│ └── router.js Hash-Router
|
|
└── icons/
|
|
├── icon-192.png
|
|
└── icon-512.png
|
|
```
|
|
|
|
## API
|
|
|
|
Die App spricht ausschließlich die Bericht-API:
|
|
- `POST /api/auth.php` — Login mit Dolibarr-Credentials
|
|
- `GET /api/orders.php` — Aufträge des Users
|
|
- `GET /api/orders.php?id=X` — Auftrag-Detail
|
|
- `GET /api/orders.php?id=X&action=photos` — Anhang-Liste
|
|
- `POST /api/orders.php?id=X&action=upload_photo` — Foto-Upload
|
|
- `GET /api/reports.php?id=X` — Bericht-Detail
|
|
|
|
## Lizenz
|
|
|
|
GPL v3+
|