Offline-Modus

Die Worker-App funktioniert auch ohne Internetverbindung -- perfekt für Baustellen mit schlechtem Empfang.

Was funktioniert offline?

Funktion	Offline?
Heutige Einsätze ansehen	Ja (wenn vorher geladen)
Dokumentation erstellen	Ja
Fotos aufnehmen	Ja (mehrere gleichzeitig)
Sprachnotizen aufnehmen	Nein (benötigt Serververbindung für Transkription)
Unterschrift	Ja
Material und Maschinen hinzufügen	Ja
Chat-Nachrichten	Nein (benötigt Internetverbindung)
Neue Aufgaben abrufen	Nein
Dokumente herunterladen	Nein

So funktioniert es

1. Automatische Synchronisation

Wenn Sie Internet haben, lädt die App automatisch:

• Ihre Einsätze für die aktuelle Woche
• Projektinformationen
• Materialstammdaten und Maschinenkatalog

Diese Daten sind dann offline verfügbar.

2. Offline-Indikator

Wenn Sie offline sind, zeigt die App einen Hinweis an. Auch der Status Ihrer wartenden Einträge wird angezeigt (z. B. "Wartet auf Upload").

3. Lokale Speicherung

Alles, was Sie offline eingeben, wird lokal gespeichert:

• Arbeitszeiten
• Fotos (mehrere gleichzeitig)
• Textberichte
• Materialeinträge
• Unterschriften (als Bild)

Technischer Hintergrund

Die App nutzt IndexedDB (fortuna_offline_uploads) zur Speicherung von Offline-Daten. Ein Service Worker sorgt für Background Sync -- Ihre Daten werden automatisch hochgeladen, sobald wieder eine Verbindung besteht.

4. Automatischer Upload

Sobald Sie wieder Internet haben:

1. Die App erkennt die Verbindung
2. Alle lokalen Daten werden hochgeladen
3. Sie sehen einen Fortschrittsindikator
4. Erfolgreich synchronisierte Einträge erscheinen im Archiv

---

Multi-Foto Offline-Synchronisation

Die App unterstützt das gleichzeitige Hochladen mehrerer Fotos auch im Offline-Modus.

So funktioniert es

Foto 1 aufgenommen (offline)
        |
Foto 2 aufgenommen (offline)
        |
Foto 3 aufgenommen (offline)
        |
Eintrag unterschrieben und abgesendet
        |
Alle Fotos + Eintrag werden als Bundle gespeichert
        |
Bei Verbindung: Atomare Synchronisation

Atomare Synchronisation

Wichtig

Fotos und der zugehörige Eintrag werden zusammen hochgeladen (atomar). Es kann nicht passieren, dass der Eintrag ohne Fotos oder Fotos ohne Eintrag ankommen.

Der Upload-Prozess:

1. Fotos zuerst: Alle Fotos werden zum Bildspeicher hochgeladen
2. URLs sammeln: Die App sammelt die URLs der hochgeladenen Fotos
3. Eintrag mit Fotos: Der Bautagebucheintrag wird mit allen Foto-URLs eingereicht
4. Unterschriften: Gespeicherte Signaturbilder werden mit hochgeladen
5. Bestätigung: Erst wenn alles erfolgreich ist, wird der lokale Eintrag gelöscht

Tipps für viele Fotos

Anzahl Fotos	Geschätzte Upload-Zeit (4G)	Empfehlung
1-5	10-30 Sekunden	Normal
5-10	30-60 Sekunden	OK, etwas Geduld
10+	1-3 Minuten	Stabiles WLAN empfohlen

Große Uploads

Bei vielen Fotos (10+) empfehlen wir, vor dem Verlassen der App auf die vollständige Synchronisation zu warten. Der Fortschrittsbalken zeigt den Status an.

---

Sitzungsverwaltung bei Offline-Nutzung

Falls die Serversitzung abläuft, während Sie offline arbeiten:

1. Ihre offline erstellten Einträge bleiben sicher gespeichert (in IndexedDB)
2. Beim nächsten Öffnen der App werden Sie zur Anmeldung weitergeleitet
3. Nach erfolgreicher Anmeldung werden die gespeicherten Einträge automatisch hochgeladen
4. Es gehen keine Daten verloren

Sitzungsablauf

Die App erkennt automatisch, wenn eine Sitzung abgelaufen ist, und versucht die Synchronisation nach der erneuten Anmeldung fortzusetzen. Wartende Einträge werden dabei mit dem Status "Wartet auf Upload" angezeigt.

---

Entwürfe (Drafts)

Falls Sie den Wizard nicht abschließen (z. B. App geschlossen, Akku leer):

• Ihr bisheriger Fortschritt wird als Entwurf gespeichert
• Beim nächsten Öffnen des Archivs sehen Sie eine gelbe Karte: "Unvollständiger Entwurf"
• Tippen Sie auf Fortsetzen, um dort weiterzumachen, wo Sie aufgehört haben
• Oder löschen Sie den Entwurf mit dem Papierkorb-Symbol

---

Tipps für den Offline-Modus

Vor der Baustelle

• Öffnen Sie die App, während Sie noch Internet haben
• Warten Sie, bis alle Einsätze geladen sind
• Prüfen Sie, ob alle Informationen sichtbar sind

Auf der Baustelle

• Arbeiten Sie normal mit der App
• Fotos werden lokal gespeichert
• Die App funktioniert ohne Einschränkung

Nach der Baustelle

• Stellen Sie sicher, dass Sie Internet haben
• Öffnen Sie die App
• Warten Sie, bis die Synchronisation abgeschlossen ist

Wichtig

Schließen Sie die App nicht, während der Upload läuft! Warten Sie, bis der Fortschrittsbalken verschwunden ist.

Verbindungen zu anderen Modulen

Offline-Daten und der Weg ins System

Offline erstellte Einträge durchlaufen nach der Synchronisation exakt denselben Verarbeitungsweg wie Online-Einträge. Es gibt in der Weiterverarbeitung keinen Unterschied -- das System behandelt synchronisierte Einträge identisch zu direkt online erstellten.

Zusammenhang: Atomare Synchronisation und Datenintegrität

Offline erstellte Einträge werden in IndexedDB (fortuna_offline_uploads) gespeichert. Bei Reconnect werden sie atomar synchronisiert: Ein kompletter Eintrag (mit allen Fotos, Materialeinträgen, Unterschrift) wird entweder KOMPLETT hochgeladen oder gar nicht. Das bedeutet: Ein Eintrag mit 5 Fotos wird niemals unvollständig im System landen. Wenn der Upload eines einzelnen Fotos fehlschlägt, wird der gesamte Eintrag zurückgehalten und beim nächsten Verbindungsversuch erneut komplett hochgeladen.

Was passiert nach der Synchronisation?

Offline-Eintrag in IndexedDB
        ↓  [Internetverbindung wiederhergestellt]
Fotos werden zum Tiered Storage hochgeladen
  (erst Hetzner S3 als primäre Quelle, dann MinIO Cache)
        ↓
Eintrag wird an den Server gesendet (mit Foto-URLs)
        ↓
Unterschrift-Bilder werden hochgeladen
        ↓
Eintrag erscheint im Bautagebuch (Management-Sicht)
        ↓
Eintrag erscheint in der Genehmigungszentrale
        ↓  [identisch wie Online-Eintrag ab hier]
Manager genehmigt → Kosten fließen ins Herzstück

Ab dem Moment der Synchronisation ist der Eintrag im System nicht mehr von einem Online-Eintrag zu unterscheiden. Er erscheint im Bautagebuch, in der Genehmigungszentrale und -- nach Genehmigung -- im Herzstück. Andere User (Manager, Projektleiter, Backoffice) sehen den Eintrag mit allen Details, Fotos und Unterschriften.

Zusammenhang: Fotos und Tiered Storage

Offline aufgenommene Fotos werden lokal komprimiert in IndexedDB gespeichert. Bei der Synchronisation werden sie in den Tiered Storage hochgeladen:

1. Hetzner Object Storage (S3) -- primäre Speicherquelle, langfristige Aufbewahrung
2. MinIO Cache -- lokaler Server-Cache für schnellen Zugriff

Andere User sehen die Fotos erst nach der Synchronisation. Die Fotos erscheinen dann in der Fototimeline des Projekts, im Bautagebuch-Eintrag und in der Genehmigungszentrale. Der Zeitstempel der Fotos bleibt der Aufnahmezeitpunkt (nicht der Sync-Zeitpunkt), sodass die chronologische Einordnung in der Fototimeline korrekt ist.

Zusammenhang: 24-Stunden-Fenster und Offline-Einträge

Wenn ein Worker offline einen Eintrag mit Selbst-Signatur erstellt, beginnt das 24-Stunden-Fenster für Nachträge erst nach der Synchronisation (wenn der Server den Eintrag empfängt). Das gibt dem Worker auf Baustellen ohne Internet mehr Zeit für Ergänzungen. Bei Externer Signatur gibt es auch bei Offline-Einträgen kein Nachtragsfenster -- der Eintrag ist nach Sync sofort genehmigt und gesperrt.

Speicherplatz

Offline-Daten (besonders Fotos) benötigen Speicherplatz:

Inhalt	Typische Größe
1 Foto	2-4 MB
10 Fotos	20-40 MB
Sprachnotiz (1 Min)	~1 MB
Textdaten	< 1 MB

Speicherplatz prüfen

Stellen Sie sicher, dass Ihr Smartphone mindestens 500 MB freien Speicher hat.

Probleme beheben

Daten wurden nicht synchronisiert

1. Prüfen Sie Ihre Internetverbindung (WLAN oder mobile Daten)
2. Öffnen Sie die App und warten Sie 1-2 Minuten
3. Prüfen Sie, ob der Offline-Indikator verschwunden ist
4. Falls das Problem bestehen bleibt: Kontaktieren Sie den Support

"Synchronisation fehlgeschlagen"

1. Prüfen Sie Ihre Internetverbindung
2. Schließen Sie die App vollständig
3. Öffnen Sie die App erneut
4. Die Synchronisation startet automatisch

Aufgaben werden offline nicht angezeigt

Die App muss mindestens einmal online gewesen sein, um Aufgaben zu laden. Stellen Sie eine Internetverbindung her und öffnen Sie die App.

Einige Fotos fehlen nach dem Upload

1. Prüfen Sie, ob die Synchronisation vollständig abgeschlossen war
2. Öffnen Sie den Eintrag im Archiv und prüfen Sie die Fotos
3. Falls Fotos fehlen: Kontaktieren Sie den Support mit der Eintrag-ID

Upload hängt bei vielen Fotos

1. Stellen Sie sicher, dass Sie eine stabile Internetverbindung haben
2. Bevorzugen Sie WLAN statt mobiler Daten
3. Schließen Sie die App nicht, während der Upload läuft
4. Bei anhaltendem Problem: App neu starten, Upload wird fortgesetzt

Sitzung abgelaufen, Einträge gehen nicht hoch

1. Melden Sie sich erneut an
2. Offline-Einträge bleiben gespeichert und werden nach der Anmeldung automatisch hochgeladen
3. Prüfen Sie im Archiv, ob die Einträge den Status "Wartet auf Upload" haben