WebSocket stabiler gemacht mit Puffern beim Broker

This commit is contained in:
concierge committed 2026-10-31 09:01:44 +01:00
1 parent 12523ddd0a
commit c793e8b16d
10 files changed
+533 -37

No files matched your search

+20
View File
@@ -46,6 +46,26 @@ in `Caddyfile.example`.
Wichtig: Der Flask-Port sollte nur für den Reverse-Proxy erreichbar sein, damit
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.
Die beiden 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.
- `CMBNET_WS_GROUP_ONLINE_TIMEOUT_SECONDS` (Default `120`): Zeit ohne Code-2-
Lebenszeichen, nach der eine Gruppe von `online` auf `unterwegs` wechselt.
Die Sitzungs-Queues liegen im Arbeitsspeicher des Broker-Prozesses. Sie
überstehen damit WebSocket-Unterbrechungen und Seiten-Reloads, nicht aber einen
Neustart des Servers.
## Erste Einrichtung
Nach der Initialisierung der Datenbank müssen noch Mandanten und ein Admin-Account angelegt werden.