Umbau broekr auf client-id

This commit is contained in:
concierge committed 2026-11-01 21:59:11 +01:00
1 parent 268e150f2b
commit a95204b8d6
17 files changed
+649 -388

No files matched your search

+21 -16
View File
@@ -48,29 +48,34 @@ Clients den Header nicht selbst setzen können.
## WebSocket-Synchronisierung
Jeder Browser-Tab erzeugt eine Sitzungs-ID, die in `sessionStorage` gespeichert
wird und ein Neuladen übersteht. Nicht zustellbare Nachrichten mit Code >= 100
werden beim Broker pro `(Mandant, Account, Sitzungs-ID)` gepuffert und bei der
nächsten WebSocket-Verbindung mit derselben ID ausgeliefert.
Jede Webview erzeugt beim Laden einmalig eine Client-ID. Sie wird bewusst nicht
in `sessionStorage` gespeichert: Ein Seiten-Reload erzeugt eine neue Client-ID
und damit eine neue Broker-Verbindung. Nicht zustellbare Nachrichten mit
Code >= 100 werden beim Broker pro `(Mandant, Client-ID)` gepuffert und bei der
nächsten WebSocket-Verbindung mit derselben Client-ID ausgeliefert. Mehrere
Clients desselben Accounts werden getrennt verwaltet und alle beliefert.
Die beiden Zeitfenster lassen sich über Umgebungsvariablen konfigurieren:
Die Zeitfenster lassen sich über Umgebungsvariablen konfigurieren:
- `CMBNET_WS_QUEUE_MAX_AGE_MINUTES` (Default `15`): Maximales Alter einer
Sitzungs-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect wird
stattdessen eine Code-99-Nachricht mit Hinweis auf die zu lange Unterbrechung
zugestellt.
Client-Queue. Ältere Queues werden verworfen; beim nächsten Reconnect mit
derselben Client-ID wird stattdessen eine Code-99-Nachricht mit Hinweis auf
die zu lange Unterbrechung zugestellt.
- `CMBNET_WS_CLIENT_RETENTION_MINUTES` (Default `60`): Wie lange eine nicht mehr
verbundene Webview samt Queue registriert bleibt, bevor der Broker sie
endgültig aufräumt.
- `CMBNET_WS_GROUP_ONLINE_TIMEOUT_SECONDS` (Default `120`): Zeit ohne Code-2-
Lebenszeichen, nach der eine Gruppe von `online` auf `unterwegs` wechselt.
- `CMBNET_WS_DEBUG_MESSAGES` (Default `1`): schreibt jede beim Broker
eingehende Nachricht inklusive Absender, Code und ermitteltem Empfängerkreis
nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die Ausgabe
abschalten.
eingehende Nachricht inklusive Absender, Client-ID, Code und ermitteltem
Empfängerkreis nach `logs/cmbnet-ws-YYYY-MM-DD.log`. Mit `0` lässt sich die
Ausgabe abschalten.
Die Sitzungs-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
überstehen damit WebSocket-Unterbrechungen und Seiten-Reloads, nicht aber einen
Neustart des Servers. Der mobile Client puffert zusätzlich ausgehende
fachliche Nachrichten kurzzeitig lokal und sendet sie nach erfolgreicher
Authentifizierung automatisch nach.
Die Client-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
überstehen damit kurze WebSocket-Unterbrechungen, nicht aber einen
Seiten-Reload mit neuer Client-ID oder einen Neustart des Servers. Der mobile
Client puffert zusätzlich ausgehende fachliche Nachrichten kurzzeitig im
Speicher und sendet sie nach erfolgreicher Authentifizierung automatisch nach.
Eine ausführliche Beschreibung des Protokolls, der Brokerlogik, der
Nebenläufigkeit und der aktuellen Abweichungen steht in