Offline-Betrieb

Warum offline?

An Einlässen ist das Mobilfunknetz oft überlastet. Der Scanner ist deshalb so gebaut, dass er auch ohne Internetverbindung zuverlässig weiterläuft. Voraussetzung ist die Installation als PWA.

Pre-Sync: Tickets vorab laden

Sobald ein Gerät gelockt ist, lädt die App alle Tickets des Events herunter und speichert sie lokal in der IndexedDB des Geräts. Diese Liste ist die Grundlage für die sofortige Prüfung jedes Scans – ganz ohne Server-Anfrage.

Der Pre-Sync wird beim Start ausgeführt und danach automatisch in Abständen wiederholt (solange online), um Nachverkäufe zu berücksichtigen. Manuell lösen Sie ihn über das Aktualisieren-Symbol aus.

Lokale Prüfung und Warteschlange

• Jeder Scan wird sofort lokal gegen den Cache geprüft und ergibt VALID, DUPLICATE, WRONG_EVENT, INVALID oder REFUNDED.
• Ein gültiger Scan wird lokal sofort als „eingelassen" vermerkt, sodass ein zweiter Scan am selben Gerät sofort als Duplikat erkannt wird.
• Alle Scans landen in einer lokalen Warteschlange und werden hochgeladen, sobald wieder Verbindung besteht.

Eine Banner-Anzeige informiert über den Zustand: „Offline — N Scans in Warteschlange" bzw. „N Scans warten auf Upload". Mit „Jetzt hochladen" kann der Upload manuell angestossen werden.

Automatischer Upload und Serverkorrektur

Die App prüft die Verbindung regelmässig (Ping). Sobald sie wieder online ist, lädt sie die Warteschlange automatisch hoch. Der Server revalidiert jeden Scan und kann das lokale Ergebnis korrigieren – ein offline als „ungültig" gewertetes Ticket kann so nachträglich bestätigt werden, oder ein Ticket wird zum Duplikat, wenn es an einem anderen Gerät zuerst eingelassen wurde.

Multi-Device-Abgleich (Diff)

Solange online, gleicht jedes Gerät in kurzen Abständen die Scans der anderen Geräte ab (Diff). Dadurch:

• erkennen alle Eingänge Tickets, die anderswo bereits eingelassen wurden, als Duplikat,
• werden zwischenzeitlich stornierte/erstattete Tickets im lokalen Cache als „storniert" markiert.

Grenzen des Offline-Betriebs

• Ein Ticket, das offline verkauft und noch nicht im Pre-Sync ist, gilt zunächst als „ungültig"; die Server-Revalidierung beim Upload kann das korrigieren.
• Duplikate über mehrere Geräte werden erst nach dem nächsten Abgleich sichtbar – am selben Gerät jedoch sofort.

Empfehlung: Führen Sie vor Türöffnung mit stabiler Verbindung einen frischen Pre-Sync aus. So sind alle bis dahin verkauften Tickets lokal vorhanden und der Einlass läuft auch bei Netzausfall flüssig.