Offline-Modus

Der Offline-Modus ist der empfohlene Betriebsmodus für die TikFlow Scanner App. Er bietet maximale Stabilität und schnellste Scan-Geschwindigkeit – vollkommen unabhängig von der Netzwerkqualität vor Ort.

Warum Offline-Modus?

💡 Unsere Empfehlung: Nutze den Offline-Modus als Standard-Betriebsmodus. Er ist stabiler, schneller und macht dich unabhängig von der Netzwerkverbindung am Veranstaltungsort.

Online vs. Offline im Vergleich

Typische Probleme im Online-Modus

An vielen Veranstaltungsorten ist das Netzwerk unzuverlässig:

• ❌ WLAN-Überlastung bei großem Besucherandrang
• ❌ Schlechter Mobilfunk in Hallen, Kellern, Industriegebieten
• ❌ Timeout-Fehler bei langsamer Verbindung
• ❌ Scan-Stau am Eingang durch Netzwerk-Wartezeiten

Im Offline-Modus vermieden

• ✅ Scans werden lokal in Millisekunden validiert
• ✅ Kein Warten auf Server-Antworten
• ✅ Keine Netzwerkfehler am Eingang
• ✅ Kein Scan geht verloren – alles wird später synchronisiert

So funktioniert's

Das Grundprinzip

Der Offline-Modus basiert auf drei einfachen Schritten:

Grafische Darstellung

┌─────────────────────────────────────────────────────────────┐
│  VORBEREITUNG                                               │
│  ────────────                                               │
│  Offline-Pack herunterladen (alle gültigen Tickets)         │
│  → Empfehlung: Am Vortag bei stabilem WLAN                  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  EINLASSKONTROLLE                                           │
│  ────────────────                                           │
│  1. Ticket scannen                                          │
│  2. Lokale Validierung (sofort, ohne Netzwerk)              │
│  3. Ergebnis anzeigen (grün/orange/rot)                     │
│  4. Erfolgreiche Scans → Warteschlange                      │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  SYNCHRONISATION (automatisch im Hintergrund)               │
│  ────────────────                                           │
│  • Upload: Warteschlange → Server (alle 3 Min)              │
│  • Download: Änderungen → Offline-Pack (alle 10 Min)        │
│  → Läuft automatisch, sobald Netzwerk verfügbar             │
└─────────────────────────────────────────────────────────────┘

Das Offline-Pack

Was enthält das Offline-Pack?

ℹ️ Das Offline-Pack enthält keine Klartext-Ticket-Codes – alle Daten sind kryptografisch gesichert und können nicht ausgelesen werden.

Wann herunterladen?

So lädst du das Offline-Pack

1. Öffne die TikFlow Scanner App
2. Im Dashboard: Tippe auf „Pack aktualisieren"
3. Warte auf „X Tickets geladen"

💡 Die Desktop Scanner App (Windows/Linux) lädt das Offline-Pack automatisch beim Start und hält es im Hintergrund aktuell.

Die Warteschlange (Queue)

Die Warteschlange ist das Herzstück des Offline-Modus. Sie garantiert: Kein Scan geht verloren.

Wie funktioniert die Warteschlange?

Scan erfolgreich → Eintrag in Warteschlange → Automatischer Upload zum Server

Warteschlange einsehen

Im Dashboard der App siehst du:

• Anzahl ausstehender Scans – z.B. „12 ausstehend"
• Status jedes Scans – Zeitpunkt, Ticket-ID
• Manueller Sync-Button – Falls du nicht auf den automatischen Sync warten willst

Was passiert bei der Synchronisation?

Wenn die Warteschlange mit dem Server synchronisiert wird, erhält jeder Scan einen Status:

ℹ️ Wichtig: Ein „duplicate" oder „rejected" bei der Synchronisation ändert nichts am bereits gewährten Einlass. Der Gast war zu diesem Zeitpunkt bereits durch die Kontrolle. Die Sync-Ergebnisse dienen der vollständigen Protokollierung im Dashboard.

Automatische Hintergrund-Synchronisation

Die Scanner App synchronisiert vollautomatisch im Hintergrund – du musst dich um nichts kümmern.

Upload: Warteschlange → Server

Download: Server → Offline-Pack (Smart Refresh)

💡 Smart Refresh: Die App lädt nicht das komplette Pack neu, sondern nur die Änderungen seit dem letzten Sync. Bei 5.000 Tickets und 10 Änderungen werden nur 10 Tickets übertragen – nicht 5.000.

Warum funktioniert das so zuverlässig?

Die TikFlow Scanner App wurde für den professionellen Einsatz entwickelt:

• Warteschlange ist persistent – Scans überleben App-Neustarts und Geräte-Neustarts
• Automatische Retry-Logik – Fehlgeschlagene Uploads werden automatisch wiederholt
• Duplikat-Erkennung – Verhindert doppelte Einträge in der Queue
• Intelligente Intervalle – Sync-Zeiten sind leicht versetzt, um Server-Last zu verteilen

Lokale Validierung

Was wird offline geprüft?

Cooldown-Tracking

Der Cooldown (Wartezeit zwischen Scans) wird lokal auf dem Gerät verfolgt:

• Beim Scan wird der Zeitpunkt gespeichert
• Nächster Scan prüft: Ist die Wartezeit abgelaufen?
• Funktioniert auch komplett ohne Netzwerk

💡 Beispiel: Ein Schwimmbad-Ticket hat 30 Minuten Cooldown. Die App merkt sich den letzten Scan und lehnt erneute Scans innerhalb der 30 Minuten ab – auch wenn das Gerät die ganze Zeit offline ist.

Duplikat-Erkennung

Die App erkennt Duplikate auf zwei Ebenen:

Verfügbarkeit

Der Offline-Modus mit allen beschriebenen Features ist verfügbar für:

Alle Funktionen – Offline-Pack, Warteschlange, Smart Refresh, Cooldown-Tracking – sind auf allen Plattformen identisch implementiert.

Best Practices

Vor dem Event

• ✅ Offline-Pack herunterladen (am Vortag oder vor Einlass-Beginn)
• ✅ Offline-Modus manuell aktivieren
• ✅ Test-Scan offline durchführen
• ✅ Akku-Stand prüfen / Stromversorgung sicherstellen

Während des Events

• ✅ Im Offline-Modus bleiben – das ist der stabilste Betrieb
• ✅ Warteschlange gelegentlich prüfen (optional)
• ✅ Bei stabilem Netz: Hintergrund-Sync läuft automatisch
• ✅ Bei Bedarf: Manueller Sync über Warteschlange-Button

Nach dem Event

• ✅ Sicherstellen, dass Warteschlange vollständig synchronisiert ist
• ✅ Sync-Ergebnisse im Dashboard prüfen
• ✅ Bei „rejected" Scans: Ursache im Scan-Log nachvollziehen

Technische Details

Wie aktuell sind die Daten?

Cross-Device-Verhalten

Im Offline-Modus kennen Geräte die Scans anderer Geräte nicht in Echtzeit. Das bedeutet:

• Gerät A scannt Ticket #123 offline
• Gerät B scannt Ticket #123 offline (wenige Sekunden später)
• Beide zeigen „Gültig" an

Nach der Synchronisation:

• Gerät A: Scan wird als „applied" bestätigt
• Gerät B: Scan wird als „duplicate" protokolliert

ℹ️ In der Praxis ist dieses Szenario selten und unkritisch – der Gast hatte ein gültiges Ticket und wurde einmal eingelassen. Die Protokollierung zeigt den Sachverhalt korrekt an.

Zusammenfassung

💡 Fazit: Der Offline-Modus ist nicht nur ein Backup für Netzwerkprobleme – er ist der zuverlässigste und schnellste Betriebsmodus für die Einlasskontrolle. Nutze ihn als Standard.

Nächste Schritte

1. Tickets scannen – Scan-Vorgang im Detail
2. Einstellungen – App optimal konfigurieren