Offline-Modus

Das Kiosk-Terminal funktioniert auch ohne Internetverbindung. Stempelvorgänge werden lokal gespeichert und automatisch synchronisiert, sobald das Gerät wieder online ist.

Wie der Offline-Modus funktioniert

Das Terminal nutzt eine vierstufige Offline-Architektur:

• API-Cache: Konfiguration und Mitarbeiterliste werden in einer lokalen IndexedDB-Datenbank zwischengespeichert. Bei einem GET-Request wird zuerst der Server gefragt. Ist dieser nicht erreichbar, werden die zwischengespeicherten Daten verwendet.
• PIN-Cache: Erfolgreich verifizierte PINs werden für 24 Stunden lokal gecacht. So können sich Mitarbeiter auch offline identifizieren.
• NFC-Cache: Erfolgreich gescannte NFC-Karten werden ebenfalls für 24 Stunden lokal gespeichert.
• Mutations-Warteschlange: Stempelvorgänge (Einstempeln, Ausstempeln, Pause starten/beenden) werden in einer Warteschlange in IndexedDB gespeichert, wenn der Server nicht erreichbar ist.

Offline-Anzeige

Wenn das Terminal offline ist, erscheint am oberen Bildschirmrand ein Badge:

• "Offline" — Das Gerät hat keine Internetverbindung. Falls Aktionen in der Warteschlange liegen, wird deren Anzahl angezeigt.
• "Synchronisiere..." — Das Gerät ist wieder online und spielt die wartenden Aktionen ab.

Automatische Synchronisierung

Sobald die Internetverbindung wiederhergestellt ist, werden die wartenden Stempelvorgänge automatisch in der Reihenfolge ihres Eingangs (FIFO) an den Server gesendet:

• Erfolgreiche Aktionen und bereits bekannte Konflikte (409) werden aus der Warteschlange entfernt
• Client-Fehler (4xx) werden verworfen, um Endlosschleifen zu vermeiden
• Server-Fehler (5xx) werden bis zu 5 Mal wiederholt
• Wird das Gerät während der Synchronisierung wieder offline, stoppt der Vorgang und wird beim nächsten Online-Wechsel fortgesetzt

Einschränkungen im Offline-Modus

• Foto-Erfassung ist offline deaktiviert — Stempelvorgänge werden ohne Foto durchgeführt
• Admin-PIN-Verifizierung ist offline nicht verfügbar
• PINs und NFC-Karten, die noch nie online verifiziert wurden, funktionieren offline nicht (kein Cache vorhanden)
• Gespeicherte PINs und NFC-Zuordnungen laufen nach 24 Stunden ab