Umbau broekr auf client-id
This commit is contained in:
1 parent
268e150f2b
commit
a95204b8d6
17 files changed
+649
-388
No files matched your search
+138
-110
@@ -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.
|
||||
Reference in new issue
Block a user