Jagd auf WS Abbrüche

This commit is contained in:
concierge committed 2026-11-02 11:00:58 +01:00
1 parent a95204b8d6
commit 1e2a58e563
9 files changed
+462 -51

No files matched your search

+65 -4
View File
@@ -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