Betrieb¶

Updates¶

Neue Versionen erscheinen im Kundenportal; die Release-Notes stehen dort bei jedem Release. Update einspielen:

Neues Jar im Portal herunterladen (Ihre Lizenz ist wieder eingebettet).
table-plan-plugin.jar im Plugin-Ordner der Kasse austauschen (<POS-Datenverzeichnis>/POSPlugins/AP/).
Kasse neu starten.

Layout, Sicherungen und Plugin-Einstellungen bleiben beim Update erhalten. Layout-Änderungen selbst brauchen dagegen keinen Neustart — nur ein Jar-Wechsel.

Lizenz¶

Das Plugin nutzt das Lizenzmodell des Kundenportals:

Ihr persönlicher Lizenz-Key steckt bereits im heruntergeladenen Jar; alternativ zählt eine Datei license-table-plan-plugin.key neben dem Jar (sie übersteuert die eingebettete Lizenz — der Austauschweg für den Support, ohne Neu-Download).
Wartungsgebundene Lizenzen werden gegen das Build-Datum der installierten Version geprüft, nie gegen die Uhr: Ein Ende des Wartungszeitraums stoppt keine laufende Installation. Nur Versionen, die nach dem Wartungsende erschienen sind, verlangen eine verlängerte Wartung.
Ohne gültige Lizenz deaktiviert sich das Plugin laut: Logeintrag plus deutlicher Hinweis an der Kasse statt des Tischplan-Tabs. Es blockiert nie den Kassenstart und nie andere Plugins.

Sicherungen der Layoutdatei¶

Jede Speicherung des Plans — an der Kasse, per Hub oder Editor — schreibt die tableplan.json atomar und legt vorher eine Sicherung an: tableplan.json.1 (jüngste) bis tableplan.json.5 (älteste), im selben Ordner. Zum Wiederherstellen eine Sicherung als tableplan.json zurückkopieren.

Ist ein Tischplan-Hub im Einsatz, hält er zusätzlich eine unbegrenzte Historie aller gespeicherten Fassungen.

Verhalten auf FP21 und Cloud Edition¶

CCO 2.0 FP21 (on-premise) ist die primäre Zielversion. Der Plan aktualisiert sich dort passiv und live über die normalen Table-Service-Updates der Kasse.
Auf der Cloud Edition 3.x installiert und funktioniert das Plugin ebenfalls; die Cloud Edition aktualisiert ihren Tischdatenbestand jedoch nicht passiv — der Plan ist dort beim Öffnen des Tabs und nach eigenen Aktionen aktuell.

Troubleshooting¶

Symptom	Ursache und Abhilfe
Tab TISCHPLAN fehlt	Kasse läuft nicht im Modus Table Service, das Jar liegt nicht in `POSPlugins/AP/`, oder die Lizenzprüfung ist fehlgeschlagen (dann steht ein Hinweis an der Kasse und im Log).
Tab zeigt einen Installationshinweis	Es ist noch kein Layout hinterlegt — Plan an der Kasse zeichnen oder `tableplan.json` ablegen (siehe Installation).
„Plan bearbeiten" fehlt	Der angemeldete Benutzer hat die Berechtigung `SETTINGS_SCREEN` nicht — so gewollt: Servicekräfte sehen den Knopf nicht.
Speichern scheitert mit HTTP 403	Die Kassen-Oberfläche wird unter einem fremden Namen aufgerufen (DNS-Alias, Reverse Proxy) — siehe „Zugriff über Rechnernamen oder Reverse Proxy" in der Konfiguration.
Kein Stockwerk-Dropdown links unten	Das Dropdown ist Standardverhalten der Kasse und erscheint erst ab zwei sichtbaren Table Areas — Zuweisung am Manager prüfen.
Speichern meldet „Hub nicht erreichbar"	Der konfigurierte Hub läuft nicht oder ist nicht erreichbar. Die Kasse speichert bewusst nicht lokal, solange ein Hub konfiguriert ist. Entweder den Hub wieder verfügbar machen oder `hubUrl` leeren.
Speicherung wird abgelehnt („veralteter Stand")	Jemand anderes hat inzwischen gespeichert. „Verwerfen" holt den aktuellen Stand, danach die eigene Änderung erneut vornehmen — so wird keine fremde Arbeit überschrieben.
Ein belegter Tisch fehlt im Plan	Er hat keine Position im Layout — er erscheint als Chip „Nicht im Plan" unter dem Plan und bleibt dort anklickbar.

Meldungen des Plugins finden sich im normalen Kassen-Log; sie beginnen mit tableplan.