Offline-Modus / WLAN-Ausfall

Zielgruppe: Kellner, Servicekraft
Typische Nutzung: Ungeplant — wenn WLAN ausfällt, der Kassaserver kurz nicht erreichbar ist oder das Gerät den Funkkontakt verliert
Aufruf: Keiner aktiv — die App reagiert automatisch auf Verbindungsverlust

Zweck

Die BonierApp braucht eine stabile WLAN-Verbindung zur Hauptkassa (oder zum Kassaserver), weil alle Bestellungen, Tischzustände und Zahlungen dort zentral gespeichert werden. Fällt das WLAN aus, soll der Service trotzdem so lange wie möglich weiterlaufen und nichts verloren gehen. Der Kellner muss wissen, was in dieser Situation noch geht, was nicht geht und wie die App nach dem Reconnect alles nachholt.

Ablauf

So verhält sich die App typischerweise bei WLAN-Ausfall:

1. Verbindungsverlust erkannt — Die App zeigt in der Statusleiste einen Offline-Hinweis (z.B. rotes Symbol, Warnmeldung oder „Kein Server erreichbar").
2. Bestehende Anmeldung bleibt aktiv — Der Kellner muss sich nicht neu anmelden.
3. Schon geladene Stammdaten bleiben nutzbar — Tischmaske und Artikelmaske, die beim App-Start geladen wurden, sind weiterhin verfügbar.
4. Versuch zu bonieren/abrechnen — Je nach Aktion:

• Einzelne Bonierungen auf offene Tische werden in der App gepuffert und an die Hauptkassa nachgereicht, sobald die Verbindung wieder steht.
• Aktionen, die zwingend mit der Kassa sprechen müssen (Abrechnen mit Signatur, Kellner-Z, neue Rechnung drucken), schlagen fehl oder warten auf Verbindung.

5. Kellner informiert sich über Status — Symbol/Meldung in der App zeigt an, ob gerade Online oder Offline.
6. WLAN wieder da — Die App baut die Verbindung automatisch wieder auf.
7. Nachholsync — Offene Bonierungen werden übertragen, Rückmeldungen aus der Kassa (Fehler, Bestätigungen) kommen zurück.
8. Kontrolle — Der Kellner öffnet den betroffenen Tisch und prüft, ob alle Positionen drauf sind.

Einstellungen

Was den Offline-Betrieb und Reconnect beeinflusst:

• Server-IP und Port — In den BonierApp-Einstellungen hinterlegt (IP des Kassaservers, standardmäßig Port 9090). Stimmt die Adresse nicht mehr (z.B. nach Router-Tausch), wird die App dauerhaft offline sein.
• WLAN-Stabilität — Geräte-Einstellungen → WLAN. Bei Geräten im Service lohnt sich ein fixer Access-Point und SSID-Roaming-Ausschluss, damit die App nicht zwischen Netzen springt.
• Services auf der Hauptkassa — BaseData-, Order-, Billing- und Logging-Service müssen laufen. Wenn der ServiceManager auf der Server-Kasse hängt, sieht es am Mobilgerät wie ein Verbindungsabbruch aus.
• Lizenz-Allokation — Mobil-Lizenzen werden dynamisch zugewiesen. Beim Reconnect wird die Lizenz neu geprüft. Wenn mehr Geräte als Lizenzen vorhanden sind, kann ein Gerät nach Reconnect ohne Lizenz dastehen.
• Timeout-Verhalten — Die App wartet beim Senden kurz, bevor sie in den Offline-Buffer schaltet. Ein längerer Ausfall fühlt sich für den Kellner zunächst wie „Ladekreis dreht" an.

Berechtigungen

Varianten

• Kurzer WLAN-Knick (Sekunden) — Die App merkt meist nichts — der Request geht beim zweiten Versuch durch.
• Längerer Ausfall (Minuten) — Offene Aktionen hängen. Nach Reconnect laufen sie automatisch weiter.
• Hauptkassa neu gestartet — Während des Neustarts meldet die App Offline. Nach 1–2 Minuten ist der Server wieder erreichbar.
• Kompletter Netzwerk-Ausfall — Kellner können in der App Tische ansehen und nach Betriebseinstellung auch weiter bonieren, aber keine Zahlung abschließen und keinen Bon drucken. In diesem Fall kurz die Bestellung handschriftlich notieren und nach Reconnect in die App übertragen.
• WLAN-Roaming-Problem (Sunmi/Samsung Tab) — Gerät wechselt zwischen zwei Access Points und verliert kurz die Verbindung. Kommt bei schlechter AP-Abdeckung vor.
• Geräte-Sleep — Bei inaktivem Display fallen manche Geräte aus dem WLAN. Wenn der Kellner das Gerät wieder aufweckt, dauert der Reconnect ein paar Sekunden.

Problembehebung

• „App steht, Ladekreis dreht" → Kurz warten (10–20 Sek.). Wenn nichts kommt: WLAN-Symbol prüfen, ggf. App schließen und neu öffnen.
• „Rotes Offline-Symbol, WLAN ist aber aktiv" → Der Kassaserver ist nicht erreichbar. Auf der Hauptkassa den ServiceManager neu starten. Alternativ Server-IP in den App-Einstellungen prüfen.
• „Nach Reconnect fehlen Positionen am Tisch" → App neu starten und Stammdaten neu laden. Wenn eine Bonierung nicht durchkam, sollte die App das in einem Fehlerdialog gemeldet haben — Positionen ggf. neu bonieren.
• „Abrechnen geht nicht, obwohl App online ist" → Signatur-Service (RKSV/TSE) ggf. offline. Zuerst Fiskalisierungs-Status auf der Hauptkassa prüfen (siehe ../uebergreifend/fiskalisierung-ausfall-beheben.md).
• „Kellner wurde offline-bonierte Position doppelt buchen" → Nach Reconnect prüft die App intern, ob der Bon schon bei der Kassa angekommen ist. Doppelbuchungen treten sehr selten auf — wenn doch, eine der beiden Positionen stornieren.
• „Gerät springt ständig offline/online" → WLAN-Abdeckung am Servicebereich messen lassen. Oft hilft ein zusätzlicher Access Point. Nicht in der App reparierbar.
• „Abschluss auf Gürteldrucker geht im Offline nicht" → Korrekt; der Abschluss muss mit der Kassa sprechen. Nach Reconnect erneut auslösen.

Siehe auch

• bonieren.md — Grundablauf der Bonierung mobil
• bonierapp-login.md — Anmeldung (setzt Verbindung zum Server voraus)
• abrechnen-bonierapp.md — Warum Abrechnen zwingend online sein muss
• ../uebergreifend/sync-status-fehler.md — Sync-Fehler übergreifend analysieren
• ../uebergreifend/sync-kasse-myapro.md — Synchronisation Kasse ↔ my.apro
• ../uebergreifend/fiskalisierung-ausfall-beheben.md — Fiskalisierung bei Ausfall nachsignieren