Offline-Modus

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

Was funktioniert offline?

Funktion	Offline?
Heutige Aufgaben ansehen	✅ Ja
Dokumentation erstellen	✅ Ja
Fotos aufnehmen	✅ Ja
Sprachnotizen aufnehmen	✅ Ja
Unterschrift	✅ 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 heutigen Aufgaben
• Projektinformationen
• Materialstammdaten

Diese Daten sind dann offline verfügbar.

2. Offline-Indikator

Wenn Sie offline sind, zeigt die App einen Hinweis:

☁️ Offline – Daten werden später synchronisiert

3. Lokale Speicherung

Alles, was Sie offline eingeben, wird lokal gespeichert:

• Arbeitszeiten
• Fotos (mehrere gleichzeitig)
• Notizen
• Unterschriften

Technischer Hintergrund

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

---

Multi-Foto Offline-Synchronisation

Die App unterstuetzt 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 zugehoerige 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 zu MinIO (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. Bestaetigung: Erst wenn alles erfolgreich ist, wird der lokale Eintrag geloescht

Speicherpfad der Fotos

Fotos werden im folgenden Format gespeichert:

projects/{projektId}/photos/diary_photo/{benutzerId}_{zeitstempel}_{dateiname}

Tipps fuer viele Fotos

Anzahl Fotos	Geschaetzte 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

Grosse Uploads

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

Probleme mit Multi-Foto-Uploads

Einige Fotos fehlen nach dem Upload

1. Pruefen Sie, ob die Synchronisation vollstaendig abgeschlossen war
2. Oeffnen Sie den Eintrag in der Genehmigungszentrale
3. Falls Fotos fehlen: Kontaktieren Sie den Support mit der Eintrag-ID
4. Technisch: Pruefen Sie die MinIO-Konsole auf fehlgeschlagene Uploads

Upload haengt bei vielen Fotos

1. Stellen Sie sicher, dass Sie eine stabile Internetverbindung haben
2. Bevorzugen Sie WLAN statt mobiler Daten
3. Schliessen Sie die App nicht, waehrend der Upload laeuft
4. Bei anhaltendem Problem: App neu starten, Upload wird fortgesetzt

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

Tipps für den Offline-Modus

Vor der Baustelle

• Öffnen Sie die App, während Sie noch Internet haben
• Warten Sie, bis alle Aufgaben 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.

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.