Jagd auf WS Abbrüche
This commit is contained in:
1 parent
a95204b8d6
commit
1e2a58e563
9 files changed
+462
-51
No files matched your search
+65
-4
@@ -96,6 +96,7 @@ Nach erfolgreicher Prüfung antwortet der Server mit einer Code-0-Bestätigung:
|
||||
"sender_id": 0,
|
||||
"receiver_id": null,
|
||||
"ts": 1793449907241,
|
||||
"seq": 1,
|
||||
"msg": "authenticated"
|
||||
}
|
||||
```
|
||||
@@ -115,6 +116,7 @@ Alle Nachrichten werden als JSON-Text übertragen:
|
||||
"receiver_id": 20,
|
||||
"code": 100,
|
||||
"ts": 1793449907246,
|
||||
"seq": 42,
|
||||
"msg": "{\"street_id\": 30, \"state\": \"erledigt\"}"
|
||||
}
|
||||
```
|
||||
@@ -124,8 +126,24 @@ Alle Nachrichten werden als JSON-Text übertragen:
|
||||
- `receiver_id`: Empfänger-ID, soweit sinnvoll; bei Broadcasts `null`.
|
||||
- `code`: primäres Steuerungsmerkmal.
|
||||
- `ts`: Zeitstempel in Millisekunden.
|
||||
- `seq`: fortlaufende Sequenznummer für genau diese Client-ID.
|
||||
- `msg`: Text oder JSON-String mit dem fachlichen Inhalt.
|
||||
|
||||
Die Sequenznummer wird vom Broker erst beim tatsächlichen Versand an eine
|
||||
Client-Verbindung ergänzt. Jede Client-ID besitzt eine eigene Zählung; mehrere
|
||||
Clients desselben Accounts beeinflussen sich nicht. Die Zählung beginnt bei 1
|
||||
und bleibt über einen WebSocket-Reconnect derselben Webview erhalten. Wird eine
|
||||
Nachricht gepuffert, erhält sie ihre Sequenznummer erst bei der späteren
|
||||
Zustellung. Ein fehlgeschlagener Sendevorgang verbraucht keine Sequenznummer.
|
||||
Nach einem Neuladen der Seite entsteht eine neue Client-ID und damit eine neue
|
||||
Zählung ab 1.
|
||||
|
||||
Clients merken sich die zuletzt empfangene Sequenznummer. Trifft nach einem
|
||||
Reconnect eine andere Nummer als `zuletzt + 1` ein, zeigt der Client einen
|
||||
Code-99-ähnlichen Neulade-Dialog an. Die Sequenzzählung liegt bewusst nur im
|
||||
Broker-Prozess und nicht in der Datenbank; nach einem Broker-Neustart beginnt
|
||||
sie neu und löst bei bereits geöffneten Clients den Neulade-Hinweis aus.
|
||||
|
||||
`sender_id` und `receiver_id` werden nicht in jedem Fall mit lesbaren Namen
|
||||
ergänzt. Chat-Nachrichten enthalten zusätzlich ein `sender`-Objekt mit
|
||||
Accountname, Rolle und Gruppenalias. Bei Code 100/200/300 enthält das Payload
|
||||
@@ -176,7 +194,7 @@ Der Broker sendet standardmäßig jede Minute eine Nachricht mit Code 1 an alle
|
||||
authentifizierten Verbindungen:
|
||||
|
||||
```json
|
||||
{"sender_id": 0, "receiver_id": null, "code": 1, "ts": 1793449907241, "msg": "ping"}
|
||||
{"sender_id": 0, "receiver_id": null, "code": 1, "ts": 1793449907241, "seq": 17, "msg": "ping"}
|
||||
```
|
||||
|
||||
Die Heartbeat-Routine läuft in einem Daemon-Timer. Sie räumt zusätzlich
|
||||
@@ -282,6 +300,41 @@ Aktuelle Implementierung:
|
||||
aber keinen Historieneintrag und keinen Transaktionseintrag.
|
||||
- Das Payload enthält `group_id`, `lat`, `lon`, `ts` und `actor`.
|
||||
|
||||
### Anzeige in den Clients
|
||||
|
||||
Nach der Zustellung müssen die Clients ihren lokalen Zustand und ihre Oberfläche
|
||||
aktualisieren. Der aktuelle Stand:
|
||||
|
||||
- **Mobile Clients**: Im Kopf der Gruppen- und Dispatcher-Mobil-Ansicht zeigt
|
||||
ein Statusfeld den WebSocket-Zustand (`verbinde`, `verbunden`, `getrennt`,
|
||||
`Fehler`). Die Anzeige wird bei Verbindungsaufbau, Code-0-Bestätigung,
|
||||
Heartbeat, Trennung und Tokenfehler aktualisiert.
|
||||
- **Dispatcher und Beobachter** (`dispatcher.js`): Code 100 aktualisiert den
|
||||
Straßenzustand, färbt die Karte neu und synchronisiert ein offenes
|
||||
Straßenfenster sowie die Straßenliste einer offenen Gruppe. Code 200
|
||||
aktualisiert Status-Badge und Statusauswahl der Gruppe sowie die
|
||||
Gruppensteuerung. Code 300 verschiebt den Gruppenmarker und aktualisiert
|
||||
Positionsalter, Fortschrittsanzeige und Navigationsbutton.
|
||||
- **Dispatcher Mobil** (`mobile.js`, `mobile_dispatcher`): Code 100
|
||||
aktualisiert die Straßenliste, die aktuell gezeichnete Straße und ein
|
||||
offenes Bearbeitungsfenster. Neu zugewiesene Straßen werden aufgenommen,
|
||||
abgegebene Straßen entfernt. Code 200 aktualisiert den Gruppenstatus und den
|
||||
Statustext im Gruppenauswahlfeld. Code 300 zeichnet alle Gruppenpositionen
|
||||
neu und aktualisiert den Navigationsbutton.
|
||||
- **Gruppen-View** (`mobile.js`, `mobile_group`): Code 100 aktualisiert die
|
||||
ToDo-Liste und die Karte der eigenen Straßen. Code 200 aktualisiert den
|
||||
Gruppenstatus im lokalen Zustand. Code 300 aktualisiert die Gruppendaten;
|
||||
die eigene Position wird in dieser Ansicht weiterhin durch den lokalen
|
||||
GPS-Marker dargestellt, deshalb wird kein zusätzlicher Gruppenmarker
|
||||
gezeichnet.
|
||||
- **Chat**: Eingehende Chat-Nachrichten werden im Chat-Verlauf ergänzt und
|
||||
lösen Ton bzw. Benachrichtigung aus. Sie wechseln nicht mehr automatisch in
|
||||
den Chat-Tab, damit die Kartenansicht während der Arbeit sichtbar bleibt.
|
||||
- **Sequenzprüfung**: Mobile Clients, Dispatcher/Beobachter und der Admin-
|
||||
Reload-Watcher vergleichen jede empfangene `seq` mit ihrer letzten Zählung.
|
||||
Bei einer Lücke erscheint der Neulade-Dialog; die Nachricht wird trotzdem
|
||||
verarbeitet.
|
||||
|
||||
## 6. Chat-Nachrichten ab Code 1000
|
||||
|
||||
Alle Nachrichten ab Code 1000 werden in `ws_messages_store` persistiert. Sie
|
||||
@@ -336,13 +389,17 @@ Absenders sein; Nachrichten an eine fremde Gruppe werden abgewiesen.
|
||||
```text
|
||||
connections[tenant_id][client_id] = {
|
||||
ws, account_id, client_id, role, group_id,
|
||||
last_ping, connected_at, last_pong_at, send_lock
|
||||
last_ping, connected_at, last_pong_at, send_lock, seq
|
||||
}
|
||||
```
|
||||
|
||||
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.
|
||||
Die zuletzt zugestellte Sequenznummer wird zusätzlich in
|
||||
`client_sequences[(tenant_id, client_id)]` geführt, damit sie einen Reconnect
|
||||
überlebt. `client_sequence_locks[(tenant_id, client_id)]` serialisiert
|
||||
Sequenzvergabe und Versand pro Client.
|
||||
|
||||
`authenticated[tenant_id][client_id]` speichert den Authentifizierungsstatus.
|
||||
Ohne erfolgreichen Code-0-Handshake werden keine fachlichen Nachrichten
|
||||
@@ -352,7 +409,8 @@ 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`.
|
||||
- `disconnected_clients[(tenant_id, client_id)] = Zeitpunkt`,
|
||||
- `client_sequences[(tenant_id, client_id)] = letzte Sequenznummer`.
|
||||
|
||||
Diese Zuordnungen bleiben nach einem Verbindungsabbruch erhalten, damit
|
||||
kurzfristige Reconnects ihre Queue wiederfinden. Dauerhaft verlassene Webviews
|
||||
@@ -387,7 +445,10 @@ zuerst die Authentifizierung:
|
||||
|
||||
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.
|
||||
in denselben Socket schreiben. Zusätzlich serialisiert ein pro Client-ID
|
||||
geführtes `sequence_lock` die Sequenzvergabe und den Sendevorgang. Erst nach
|
||||
erfolgreichem `send()` wird die Sequenznummer fortgeschrieben; schlägt der
|
||||
Versand fehl, bleibt sie unverändert und die Nachricht wird gepuffert.
|
||||
|
||||
### Client-Queues
|
||||
|
||||
|
||||
Reference in new issue
Block a user