MQTT-Topic-Schema

Der MQTT-Broker laeuft auf dem Standort-Server (Mosquitto). Alle Topics folgen dem Muster:

profipos/{mandant_kurz}/{standort_kurz}/{bereich}/{entity_kurz}/{action}

• *_kurz = erste 8 Hex-Zeichen der UUID ohne Bindestrich
• bereich = anzeige | bon | tisch | tse | mdb | display | zvt | update | wartung

QoS / Retention

• QoS 1 ist Default — at-least-once.
• Retained fuer Zustandstopics (/state, /status, /config) damit neue Subscribers den aktuellen Stand sehen.
• Nicht retained fuer Events (/transaction, /ota).

Beispiele

LED-Modul

Topic	QoS	retained	Inhalt
anzeige/{kurz}/state	1	ja	{pattern, color_hex, helligkeit, geschwindigkeit_ms}
anzeige/{kurz}/relay/{n}	1	ja	{an: true/false}
anzeige/{kurz}/config	1	ja	{anzahl_leds, pin_daten, pins_relay[], pins_input[]}
anzeige/{kurz}/heartbeat	1	ja	{fw, uptime, ip, rssi, pattern}
anzeige/{kurz}/ota	1	nein	{firmware_url}
anzeige/{kurz}/status	1	ja	"online" / "offline" (LWT)

ZVT-Terminal

Topic	QoS	retained
zvt/{kurz}/status	1	ja
zvt/{kurz}/transaction	1	nein

Bondrucker

Topic	QoS	retained
bon/{kurz}/print	1	nein
bon/{kurz}/status	1	ja

Last-Will-Testament

Jeder Client publiziert offline auf */status als LWT mit retained=true, damit das Backoffice ausgefallene Geraete sieht.