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

Binary file not shown.
+138 -110
View File
@@ -1,6 +1,6 @@
# Broker und WebSocket-Protokoll
Stand: 31.10.2026
Stand: 01.11.2026
Dieses Dokument beschreibt das aktuelle WebSocket-Protokoll, die Aufgaben und
den Ablauf des Brokers sowie die Stellen, an denen die Implementierung von der
@@ -22,7 +22,7 @@ WebSocket-Clients eines Mandanten. Er
- ordnet Nachrichten anhand ihres Codes einem Empfängerkreis zu,
- wendet fachliche Zustandsänderungen für Straßen und Gruppen an,
- persistiert Chat-Nachrichten für die spätere Nachlieferung,
- puffert nicht zustellbare Nachrichten pro Client-Sitzung,
- puffert nicht zustellbare Nachrichten pro Client-ID,
- überwacht die Lebenszeichen der Gruppen.
Die Web-APIs liefern den Clients unabhängig vom Broker den aktuellen
@@ -30,7 +30,7 @@ Initialzustand. Der Broker ist damit nicht die einzige Quelle für den Zustand,
sondern verteilt Änderungen und gleicht kurzfristige Verbindungsunterbrechungen
aus.
## 2. Transport, Authentifizierung und Sitzung
## 2. Transport, Authentifizierung und Client-ID
### Endpoint
@@ -57,7 +57,7 @@ Nach dem Öffnen der WebSocket-Verbindung sendet der Client Code 0:
{
"code": 0,
"msg": "<einmaliges-token>",
"session_id": "<client-sitzungs-id>"
"client_id": "<client-id-der-webview>"
}
```
@@ -65,22 +65,29 @@ Das Token wird vorher über `GET /<tenant>/api/auth/ws-token` geholt. Es ist
mandanten- und accountgebunden, nur einmal verwendbar und standardmäßig eine
Stunde gültig.
Die `session_id` wird pro Browser-Tab in `sessionStorage` erzeugt und bleibt
über ein Neuladen der Seite erhalten. Sie ordnet die Verbindung einer
Nachrichten-Queue zu.
Die `client_id` wird in `templates/base.html` bei jedem Laden einer Webview
einmalig erzeugt. Sie wird bewusst **nicht** in `sessionStorage` gespeichert:
Ein Neuladen erzeugt eine neue Webview und damit eine neue Broker-Verbindung.
Die Client-ID ist an den Account gebunden, der den Code-0-Handshake ausführt.
Mehrere Clients desselben Accounts erhalten getrennte Verbindungen und Queues.
Der Broker akzeptiert aus Kompatibilitätsgründen auch die ältere Objektform:
Der Broker akzeptiert aus Kompatibilitätsgründen auch die ältere Objektform und
den alten Schlüssel `session_id`:
```json
{
"code": 0,
"msg": {
"token": "<token>",
"session_id": "<client-sitzungs-id>"
"session_id": "<alte-sitzungs-id>"
}
}
```
Fehlt eine gültige Client-ID vollständig, erzeugt der Broker eine eindeutige
Ersatz-ID (`legacy-<account>-<zufall>`). Ein solcher Altclient kann nach einem
Reconnect keine frühere Queue wiedererkennen.
Nach erfolgreicher Prüfung antwortet der Server mit einer Code-0-Bestätigung:
```json
@@ -155,10 +162,13 @@ fachliche Empfänger weitergeleitet. Der Broker prüft:
1. Existiert das Token für Mandant und Account?
2. Ist es noch nicht verwendet?
3. Ist es nicht abgelaufen?
4. Ist die Client-ID gültig und noch keinem anderen Account zugeordnet?
Danach wird das Token als verbraucht markiert, die Sitzungs-ID normalisiert und
der Account als authentifiziert registriert. Ohne gültigen Code 0 werden
fachliche Nachrichten nicht akzeptiert; die Verbindung wird geschlossen.
Danach wird das Token als verbraucht markiert, die Client-ID normalisiert und
die Verbindung als authentifiziert registriert. Ohne gültigen Code 0 werden
fachliche Nachrichten nicht akzeptiert; die Verbindung wird geschlossen. Da die
Registrierung erst mit Code 0 erfolgt, kennt der Broker vor dem Handshake noch
keine Client-ID.
### Code 1: Heartbeat
@@ -170,7 +180,7 @@ authentifizierten Verbindungen:
```
Die Heartbeat-Routine läuft in einem Daemon-Timer. Sie räumt zusätzlich
abgelaufene Chat-Nachrichten und Sitzungs-Queues auf.
abgelaufene Chat-Nachrichten und Client-Queues auf.
### Code 2: Pong / Lebenszeichen
@@ -211,13 +221,14 @@ Admin- und Dispatcher-Clients als mögliche Sender; diese lösen Code 99 aktuell
Queue-Verhalten:
- Ist ein Client nicht erreichbar, wird Code 99 in seiner Sitzungs-Queue
- Ist ein Client nicht erreichbar, wird Code 99 in seiner Client-Queue
gespeichert.
- Eine gespeicherte Code-99-Nachricht leert alle älteren Queue-Nachrichten.
- Danach werden keine weiteren Nachrichten in dieser Queue gepuffert
(`code99_only`).
- Beim nächsten Reconnect wird ausschließlich diese Code-99-Nachricht
zugestellt. Late Entries werden in diesem Fall unterdrückt.
- Beim nächsten Reconnect mit derselben Client-ID wird ausschließlich diese
Code-99-Nachricht zugestellt. Late Entries werden in diesem Fall
unterdrückt.
- Ist die Queue wegen Überschreitung der Maximalzeit abgelaufen, erzeugt der
Broker eine Code-99-Nachricht mit Hinweis auf die zu lange Unterbrechung.
@@ -298,19 +309,23 @@ die Nachricht als „Von -> An“ mit Zeitstempel und Text an.
### Code 1000: Broadcast
Soll-Sender: Dispatcher. Empfänger: alle Dispatcher, Beobachter und alle
Gruppen. Die aktuelle Implementierung prüft die Senderrolle nicht.
Gruppen. Der Broker akzeptiert Code 1000 nur von Accounts mit der Rolle
`Dispatcher`; andere Rollen werden mit einer Warnung und einem Debug-Eintrag
abgewiesen.
### Code 1100: Nachricht an eine Gruppe
Soll-Sender: Dispatcher. Empfänger: alle Dispatcher, Beobachter und die
adressierte Gruppe. Der Broker ermittelt die Gruppen-ID aus `group_id`,
`receiver_id` oder dem Absender. Die aktuelle Implementierung prüft die
Senderrolle nicht.
`receiver_id` oder dem Absender und akzeptiert Code 1100 nur von Accounts mit
der Rolle `Dispatcher`.
### Code 2000: Nachricht aus einer Gruppe
Soll-Sender: Gruppen-Account. Empfänger: alle Dispatcher, Beobachter und die
eigene Gruppe. Die aktuelle Implementierung prüft die Senderrolle nicht.
eigene Gruppe. Der Broker akzeptiert Code 2000 nur von Accounts mit der Rolle
`Gruppe`. Zusätzlich muss die aufgelöste Zielgruppe die eigene Gruppe des
Absenders sein; Nachrichten an eine fremde Gruppe werden abgewiesen.
## 7. Broker-Ablauf
@@ -319,19 +334,30 @@ eigene Gruppe. Die aktuelle Implementierung prüft die Senderrolle nicht.
`WebSocketBroker.connections` ist ein verschachteltes Dictionary:
```text
connections[tenant_id][account_id] = {
ws, role, group_id, session_id,
connections[tenant_id][client_id] = {
ws, account_id, client_id, role, group_id,
last_ping, connected_at, last_pong_at, send_lock
}
```
Pro Account wird derzeit genau eine Verbindung gespeichert. Eine neue
Verbindung desselben Accounts überschreibt die alte Registrierung.
Eine Client-ID gehört genau zu einer Webview. Ein Account kann daher mehrere
Clients parallel betreiben. Eine neue Verbindung mit derselben Client-ID ersetzt
nur diese eine Verbindung; andere Clients desselben Accounts bleiben erhalten.
`authenticated[tenant_id][account_id]` speichert den Authentifizierungsstatus.
`authenticated[tenant_id][client_id]` speichert den Authentifizierungsstatus.
Ohne erfolgreichen Code-0-Handshake werden keine fachlichen Nachrichten
zugestellt.
Zusätzlich hält der Broker:
- `client_accounts[(tenant_id, client_id)] = account_id`,
- `account_clients[(tenant_id, account_id)] = {client_id, ...}`,
- `disconnected_clients[(tenant_id, client_id)] = Zeitpunkt`.
Diese Zuordnungen bleiben nach einem Verbindungsabbruch erhalten, damit
kurzfristige Reconnects ihre Queue wiederfinden. Dauerhaft verlassene Webviews
werden nach `WS_CLIENT_RETENTION_MINUTES` (Default 60 Minuten) aufgeräumt.
### Empfängerermittlung
`_get_recipients()` entscheidet anhand des Codes und der Absenderrolle:
@@ -344,33 +370,36 @@ zugestellt.
- Code 2000: Dispatcher, Beobachter und die eigene Gruppe,
- Code 2: nur Dispatcher.
Die Empfänger werden als Account-IDs ermittelt. Gruppen-Accounts werden über
`group_accounts` aufgelöst.
Die fachlichen Empfänger werden weiterhin als Account-IDs ermittelt.
Gruppen-Accounts werden über `group_accounts` aufgelöst. Anschließend expandiert
`_client_ids_for_accounts()` jeden Empfänger-Account auf alle seine bekannten
Client-IDs. Damit erhalten auch mehrere Tabs/Webviews desselben Accounts die
Nachricht.
### Zustellung
`_deliver()` sendet die Nachricht an jeden ermittelten Empfänger. `_send()`
prüft zuerst die Authentifizierung:
`_deliver()` sendet die Nachricht an jeden ermittelten Client. `_send()` prüft
zuerst die Authentifizierung:
- authentifiziert und Verbindung vorhanden: direkter Versand,
- nicht authentifiziert oder Versand fehlgeschlagen: Eintrag in die
Sitzungs-Queue, sofern eine Sitzungs-ID bekannt ist.
Client-Queue, sofern die Client-ID bekannt ist.
Der direkte Versand erfolgt pro Verbindung über einen `send_lock`. Dadurch
werden Heartbeat, Route-Thread und HTTP-ausgelöste Broadcasts nicht gleichzeitig
in denselben Socket schreiben.
### Sitzungs-Queues
### Client-Queues
Queues werden unter dem Schlüssel
```text
(tenant_id, account_id, session_id)
(tenant_id, client_id)
```
gespeichert. Die zuletzt bekannte Session-ID wird zusätzlich in
`account_sessions` gehalten, damit Nachrichten auch ohne aktive Verbindung der
richtigen Queue zugeordnet werden können.
gespeichert. Die Account-Zuordnung liegt in `client_accounts`. Sie bleibt auch
ohne aktive Verbindung bestehen, damit weitere Nachrichten für dieselbe Webview
gepuffert werden können.
Eigenschaften:
@@ -381,22 +410,28 @@ Eigenschaften:
Verbindungsabbruch,
- abgelaufene Queues werden geleert und als „Tombstone“ für den
Code-99-Hinweis behalten,
- dauerhaft getrennte Clients werden nach `WS_CLIENT_RETENTION_MINUTES`
(Default 60 Minuten) samt Queue und Zuordnung entfernt,
- Queues liegen ausschließlich im Arbeitsspeicher und überleben keinen
Serverneustart,
- es gibt derzeit keine feste Obergrenze für die Anzahl gepufferter
Nachrichten.
Da die Client-ID bei jedem Neuladen neu erzeugt wird, erbt eine neu geladene
Webview keine Nachrichten-Queue der vorherigen Seite. Nicht persistierte
Code-100/200/300-Ereignisse werden in diesem Fall über den neu geladenen
Initialzustand abgedeckt; persistierte Chat-Nachrichten kommen als Late Entries.
### Late Entries
Nach erfolgreicher Authentifizierung sendet der Broker persistierte
Chat-Nachrichten der letzten acht Stunden, für die der Account berechtigt ist.
Bereits aus der Sitzungs-Queue zugestellte Nachrichten werden dabei
übersprungen.
Bereits aus der Client-Queue zugestellte Nachrichten werden dabei übersprungen.
Die aktuelle Implementierung sendet Late Entries bei **jeder** erfolgreichen
Authentifizierung, also auch bei einer bereits bekannten Sitzung. Die
Soll-Beschreibung sieht eine initiale Historiennachlieferung für neue
Websessions vor. Das kann bei Reconnects zu zusätzlichen Wiederholungen führen.
Authentifizierung. Bei einem Reconnect mit derselben Client-ID können dadurch
Nachrichten erneut ankommen, die bereits live zugestellt wurden. Bei einer neu
geladenen Webview mit neuer Client-ID ist die Nachlieferung dagegen gewollt.
### Heartbeat und Gruppenpräsenz
@@ -408,28 +443,29 @@ prüft alle 15 Sekunden die Gruppenpräsenz. Bei fehlendem Pong wird eine
Berücksichtigt sind:
- `queue_lock` schützt `session_queues` und die Queue-Übergänge.
- `queue_lock` schützt `client_queues` und die Queue-Übergänge.
- `send_lock` pro Verbindung serialisiert alle ausgehenden Frames.
- Timer laufen als Daemon-Threads.
- SQLite-Zugriffe erfolgen pro Thread über die Flask-App-Kontexte.
Nicht vollständig abgesichert sind:
- `connections` und `authenticated` werden ohne eigenen Lock gelesen und
geschrieben. Einzelne Dictionary-Operationen sind durch den GIL atomar,
zusammengesetzte Prüfungen und Ersetzungen sind es nicht.
- Eine neue Verbindung für denselben Account ersetzt die alte Registrierung,
ohne den alten Socket aktiv zu schließen. Der alte Socket kann bis zum
Client-seitigen Schließen weiter existieren; seine Route verwendet aber den
Account-Kontext der neuen Verbindung.
- `account_sessions`, `group_last_pong` und `group_online_since` werden ohne
eigenen Lock aktualisiert.
- `connections`, `authenticated`, `client_accounts` und `account_clients`
werden ohne eigenen Lock gelesen und geschrieben. Einzelne
Dictionary-Operationen sind durch den GIL atomar, zusammengesetzte Prüfungen
und Ersetzungen sind es nicht.
- Eine neue Verbindung mit derselben Client-ID ersetzt die alte Registrierung.
Der alte Socket wird dabei aktiv geschlossen; seine Route entfernt über den
`ws`-Vergleich nicht die neue Verbindung.
- `group_last_pong` und `group_online_since` werden ohne eigenen Lock
aktualisiert.
- Zwischen Auth-Prüfung und tatsächlichem Senden kann eine Verbindung ersetzt
werden. Dann kann eine Nachricht an die neue Verbindung gehen oder in der
Queue landen.
- Der Broker ist prozesslokal. Bei mehreren WSGI-Workern hat jeder Worker
eigene Verbindungen und Queues. Eine HTTP-ausgelöste Benachrichtigung kann
nur die Verbindungen des Workers erreichen, der den HTTP-Request bearbeitet.
Das ist die wichtigste verbleibende Einschränkung für den Mehrclient-Betrieb.
## 9. Debugausgabe
@@ -465,19 +501,19 @@ tail -f CMBNet/logs/cmbnet-ws-$(date +%F).log
Jede eingehende Nachricht wird mit folgenden Feldern protokolliert:
- `code`
- `sender` mit Account-ID, Name, Rolle, Gruppen-ID und Gruppenalias
- `sender` mit Account-ID, Client-ID, Name, Rolle, Gruppen-ID und Gruppenalias
- `receiver_id`
- `session_id`
- `client_id` der Absender-Webview
- `ts`
- `msg` (bei Code 0 redigiert)
- `recipients`: ermittelte Empfänger mit Name, Rolle, Gruppe,
`connected` und `authenticated`
- `recipients`: ermittelte Clients mit Client-ID, Account-ID, Name, Rolle,
Gruppe, `connected` und `authenticated`
- `note`: Grund, falls die Nachricht ignoriert oder abgelehnt wurde
Beispielzeile (gekürzt):
```text
2026-10-31 13:31:47.247 [TENANT:1] WS-IN {"code": 100, "sender": {"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1"}, "receiver_id": null, "session_id": null, "ts": 1793449907246, "msg": "{\"name\": \"Weg\", \"state\": \"erledigt\", \"actor\": 10, \"street_id\": 30, \"group_id\": 20}", "recipients": [{"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "connected": true, "authenticated": true}, {"account_id": 11, "account_name": "dispatcher", "role": "Dispatcher", "group_id": null, "group_alias": null, "connected": true, "authenticated": true}], "note": null}
2026-11-01 10:03:55.247 [TENANT:1] WS-IN {"code": 100, "sender": {"account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "client_id": "group-page-1"}, "receiver_id": null, "client_id": "group-page-1", "ts": 1793449907246, "msg": "{\"name\": \"Weg\", \"state\": \"erledigt\", \"actor\": 10, \"street_id\": 30, \"group_id\": 20}", "recipients": [{"client_id": "disp-page-1", "account_id": 11, "account_name": "dispatcher", "role": "Dispatcher", "group_id": null, "group_alias": null, "connected": true, "authenticated": true}, {"client_id": "group-page-1", "account_id": 10, "account_name": "gruppe", "role": "Gruppe", "group_id": 20, "group_alias": "G1", "connected": true, "authenticated": true}], "note": null}
```
Die Debugausgabe dokumentiert den **Soll-Empfängerkreis**. Ob der einzelne
@@ -486,9 +522,9 @@ Versand tatsächlich erfolgreich war, ergibt sich erst aus dem anschließenden
## 10. Abweichungen zwischen Soll-Beschreibung und aktuellem Code
Die folgenden Punkte sind bei einer Weiterentwicklung zu beachten. Sie sind
bewusst als Ist-Zustand dokumentiert und nicht alle in diesem Schritt
funktional geändert.
Die folgenden Punkte sind bei einer Weiterentwicklung zu beachten. Mit
„behoben“ markierte Punkte beschreiben den korrigierten Stand; die übrigen
Punkte sind weiterhin offen.
### 10.1 Code 2 erreicht den Admin nicht
@@ -514,49 +550,39 @@ erfolgt ausschließlich serverseitig über `notify_reload()` aus HTTP-Handlern.
Das Ergebnis ist für die Clients identisch, der Übertragungsweg weicht aber von
der Beschreibung ab.
### 10.4 Keine Rollenprüfung bei Chat-Codes
### 10.4 Rollenprüfung bei Chat-Codes (behoben)
Soll:
- Code 1000 und 1100: nur Dispatcher,
- Code 2000: nur Gruppen-Account.
Ist: Jeder authentifizierte Account kann Code 1000, 1100 oder 2000 senden. Die
Empfängerermittlung ist korrekt, aber die Senderrolle wird nicht geprüft.
Der Broker prüft die Senderrolle jetzt in `_validate_chat_sender()`. Bei Code
2000 wird zusätzlich kontrolliert, dass die aufgelöste Zielgruppe die eigene
Gruppe des Absenders ist. Unberechtigte Nachrichten werden vor der Persistenz
und Zustellung mit einer Warnung und einem Debug-Eintrag abgewiesen.
### 10.5 Code 2000 verliert Gruppen-ID und Empfänger-ID
### 10.5 Code-2000-Normalisierung (behoben)
In `_prepare_message()` werden Nachrichten ab Code 1000 vorzeitig an
`_normalize_chat_message()` übergeben. Die anschließenden Zweige für Code 1100
und 2000 sind dadurch nicht erreichbar.
`_normalize_chat_message()` setzt für Code 2000 jetzt sowohl
`message.receiver_id` als auch `group_id` im normalisierten Payload. Dadurch
können Dispatcher-Ansichten die Nachricht der Gruppe zuordnen, und Late Entries
werden nach einem Reconnect wieder an die eigene Gruppe zugestellt.
Folge für Code 2000:
Weiterhin offen ist die clientseitige Anzeige:
- `message.receiver_id` bleibt `null`.
- Das normalisierte Payload enthält kein `group_id`.
- Die Live-Zustellung an die Gruppe funktioniert nur, weil
`_resolve_group_id()` als Fallback die Gruppe des Absenders verwendet.
- Die Late-Entry-Prüfung `_is_allowed_for_client()` findet bei gespeicherten
Code-2000-Nachrichten weder `group_id` noch `receiver_id` und liefert für
Gruppen-Clients `False`. Code-2000-Nachrichten werden damit nach einem
Reconnect nicht als Late Entry an die eigene Gruppe nachgeliefert.
- Der Dispatcher-Client kann die Gruppenzuordnung nicht aus dem normalisierten
Payload lesen. `handleGroupChatMessage()` in
`static/js/views/dispatcher.js` ermittelt die Gruppe aus `payload.group_id`
oder `message.receiver_id`; beide fehlen, deshalb wird die Nachricht dort
verworfen.
- In der Dispatcher-Ansicht wird Code 2000 nicht als Infodialog angezeigt.
- Im Beobachter-Modus (`CMBNET_VIEW_MODE === 'observer'`) wird Code 2000
vollständig ignoriert, obwohl Beobachter zum Empfängerkreis gehören.
- Der mobile Gruppen-Client zeigt die Nachricht an, weil sein Filter eine
fehlende Gruppen-ID als „eigene Gruppe“ behandelt. Die Anzeige „An“ kann
dabei jedoch leer bleiben.
- Der mobile Gruppen-Client zeigt die Nachricht an; die neue `group_id` dient
dort der Filterung, während „An“ für Code 2000 weiterhin fest „Dispatcher“
lautet.
### 10.6 Code 1100: Alias-Präfix ist toter Code
### 10.6 Code 1100: Alias-Präfix wird nicht angewendet
Der Code-1100-Zweig in `_prepare_message()` ist wegen des vorzeitigen
`code >= 1000`-Returns nicht erreichbar. Der dort vorgesehene Alias-Präfix
(`"<Alias>: "`) wird daher nicht angewendet. Der Alias ist weiterhin im
Der frühere Code-1100-Zweig in `_prepare_message()` war wegen des vorzeitigen
`code >= 1000`-Returns nicht erreichbar und wurde entfernt. Ein Alias-Präfix
(`"<Alias>: "`) wird daher weiterhin nicht gesetzt. Der Alias ist im
normalisierten `sender`-Objekt enthalten.
### 10.7 Fehlende Namen bei Code 100/200/300
@@ -578,11 +604,11 @@ sollte der Broker den Zeitstempel auch für diese Codes setzen.
### 10.9 Late Entries bei jedem Reconnect
`authenticate()` ruft `send_late_entries()` bei jeder erfolgreichen
Authentifizierung auf. Bei einer bereits bekannten Sitzung werden damit
Authentifizierung auf. Bei einem Reconnect mit derselben Client-ID werden damit
persistierte Chat-Nachrichten erneut gesendet, auch wenn sie vor dem
Verbindungsabbruch schon live zugestellt wurden. Die Clients haben teilweise
eigene Deduplizierungsschlüssel, die das abfangen; der Broker selbst
unterscheidet nicht zwischen „neue Sitzung“ und „bekannte Sitzung“.
unterscheidet nicht zwischen „bekannte Client-ID“ und „neue Client-ID“.
### 10.10 Queue-Alter und Queue-Länge
@@ -591,13 +617,13 @@ Verbindungsabbruch, kann aber bei einer Queue, die erst durch eine nicht
zustellbare Nachricht entsteht, etwas später liegen. Es gibt keine Obergrenze
für die Anzahl oder den Speicherbedarf der gepufferten Nachrichten.
### 10.11 Nur eine Verbindung pro Account
### 10.11 Mehrere Verbindungen pro Account (behoben)
`connections[tenant_id][account_id]` enthält genau eine Verbindung. Öffnet
derselbe Account mehrere Tabs, überschreibt der neue Tab die Registrierung.
Der alte Socket wird nicht aktiv geschlossen. Die Sitzungs-Queue ist zwar pro
Tab, aber die Verbindungsverwaltung und `account_sessions` kennen nur die
zuletzt registrierte Sitzung.
`connections[tenant_id][client_id]` enthält genau eine Client-Verbindung.
Mehrere Tabs bzw. Webviews desselben Accounts besitzen unterschiedliche
Client-IDs und damit getrennte Verbindungen und Queues. Eine neue Verbindung
mit derselben Client-ID ersetzt nur diese eine Verbindung; der alte Socket wird
dabei aktiv geschlossen.
### 10.12 Prozesslokaler Broker
@@ -615,12 +641,13 @@ nutzt dies intern, um nach bereits erfolgter DB-Änderung ein Code-100/200-Event
zu verteilen. Ein direkter WebSocket-Frame eines Administrators wird ebenfalls
akzeptiert.
### 10.14 Queues nur bei bekannter Sitzung
### 10.14 Queues nur bei bekannter Client-ID
`_queue_undeliverable()` benötigt eine bekannte Sitzungs-ID in
`account_sessions`. War ein Account in diesem Broker-Prozess noch nie
authentifiziert, wird eine nicht zustellbare Nachricht nicht gepuffert. Nach
einem Serverneustart sind alle Sitzungszuordnungen leer.
`_queue_undeliverable()` benötigt eine dem Broker bekannte Client-ID in
`client_accounts`. Vor dem Code-0-Handshake und nach einem Serverneustart sind
keine Client-Zuordnungen vorhanden; Nachrichten werden dann nicht gepuffert.
Eine neu geladene Webview erhält stattdessen den aktuellen Initialzustand und
die persistierten Late Entries.
### 10.15 Broadcasts ohne Empfänger-ID
@@ -639,18 +666,16 @@ erfolgt.
## 11. Empfohlene nächste Schritte
1. Code-2000-Normalisierung korrigieren: `receiver_id` und `group_id` vor dem
Normalisieren setzen und in das gespeicherte Payload aufnehmen. Danach die
Dispatcher- und Beobachter-Anzeige für Code 2000 prüfen.
2. Rollenprüfung für Code 1000/1100/2000 ergänzen.
3. Late Entries nur für neue Sitzungen oder mit einem serverseitigen
1. Late Entries nur für neue Client-IDs oder mit einem serverseitigen
„zuletzt gesehen“-Zeitpunkt senden.
4. Code 2 zusätzlich an Administratoren verteilen oder einen separaten
2. Code 2 zusätzlich an Administratoren verteilen oder einen separaten
Status-Endpoint für Pong-Überfälligkeit bereitstellen.
5. Zeitstempel für Code 100/200 und Chat-Nachrichten serverseitig setzen.
6. Verbindungsverwaltung für mehrere Tabs oder explizites Schließen der alten
Verbindung absichern.
7. Queue-Länge begrenzen und Queue-Verhalten bei mehreren Workern klären.
3. Zeitstempel für Code 100/200 und Chat-Nachrichten serverseitig setzen.
4. Queue-Länge begrenzen und Queue-Verhalten bei mehreren Workern klären.
5. Code 2000 im Beobachter-Modus und als Infodialog anzeigen.
6. Den prozesslokalen Broker durch einen gemeinsamen Message-Bus oder einen
einzelnen WebSocket-Worker ersetzen, falls mehrere WSGI-Worker betrieben
werden.
## 12. Debugausgabe und Tests
@@ -664,4 +689,7 @@ eine Zeile erzeugt. Damit lässt sich nachvollziehen, ob eine Nachricht
- und ob der Empfänger verbunden und authentifiziert war.
Für automatisierte Tests können `WS_DEBUG_MESSAGES=0` gesetzt und die
bestehenden Queue- und WebSocket-E2E-Tests verwendet werden.
bestehenden Queue- und WebSocket-E2E-Tests verwendet werden. Die Tests decken
insbesondere zwei Clients desselben Accounts, die getrennte Zustellung von
Code 100/300, Reconnect mit derselben Client-ID sowie eine neue Client-ID nach
einem Reload ab.
+11
View File
@@ -239,3 +239,14 @@ Erläutere, an welchen Stellen die Beschreibung vom aktuellen Code-Stand abweich
Bau in die Software eine Debugausgabe für die beim Broker eingehenden Nachrichten ein einschließlich einer Ausgabe, an welche Clients diese weitergeleitet werden soll.
------8<-----------------
Aktuell verwaltet der Broker die Verbindungen anhand des Mandanten und des Accounts.
Künftig soll der Broker Verbindungen statt anhand von Accounts anhand der Client-ID verwalten.
Ziel soll sein, dass ein Account auch mehrere Clients betreiben kann.
Dazu muss der Broker selbst umgebaut werden.
Die Client-ID wird in jedem Webview einmalig nach dem Laden generiert. Deshalb muss sie auch nicht im SessionStorage gespeichert werden.
Ich sehe jetzt, dass beispielsweise Code-300 Nachrichten vom Gruppen-Client an den Broker geschickt werden, sie aktualisieren aber nicht die Karte oder sonst ein Element im User Interface.
Gleiches gilt auch für Code-100. Werden diese Nachrichten nicht über den Broker an die anderen Cleints weitergeleitet?
Oder werden sie im Client verworfen?
------8<-----------------