bug fix shutdown/reconnect WS resultiert in offline für FCM
This commit is contained in:
1 parent
c51ef02f88
commit
b5f928bf76
11 files changed
+331
-11
No files matched your search
@@ -18,7 +18,8 @@ Sie sind kein Anwendungsinhalt.
|
||||
|
||||
| Komponente | Aufgabe |
|
||||
| --- | --- |
|
||||
| `cmbnet/ws/broker.py` | Erkennt nicht zustellbare Nachrichten und fordert ein Wake-Signal an. |
|
||||
| `cmbnet/ws/broker.py` | Erkennt nicht zustellbare Nachrichten, trennt Verbindungen ohne Lebenszeichen und fordert ein Wake-Signal an. |
|
||||
| `cmbnet/ws/heartbeat.py` | Sendet Code-1-Pings und prüft, ob Clients noch antworten. |
|
||||
| `cmbnet/ws/push.py` | Periodischer Worker für den Offline-Timeout. |
|
||||
| `cmbnet/services/fcm_service.py` | Firebase-Admin-Initialisierung und FCM-Versand. |
|
||||
| `cmbnet/api/push.py` | Token-Registrierung, Abmeldung und manueller Wake-Button. |
|
||||
@@ -60,6 +61,33 @@ Sobald eine Nachricht mit Code `>= 99` für einen getrennten mobilen Client
|
||||
eingereiht wird, versucht der Broker ein FCM-Signal. Mehrere Nachrichten
|
||||
innerhalb des Queue-Cooldowns lösen nur ein Signal aus.
|
||||
|
||||
### Offline-Erkennung
|
||||
|
||||
Ein Client gilt nur dann als offline, wenn der Broker seine WebSocket-
|
||||
Verbindung als beendet markiert hat (`ws_clients.disconnected_at`). Dafür gibt
|
||||
es drei Wege:
|
||||
|
||||
1. Ein sauber geschlossener Socket wird in der WS-Route unmittelbar erkannt.
|
||||
2. Die mobile View schließt ihren Socket beim Wechsel in den Hintergrund
|
||||
(`visibilitychange`) bzw. beim Verlassen der Seite (`pagehide`). Damit ist
|
||||
sie sofort offline, ohne auf einen Timeout warten zu müssen. Beim
|
||||
Sichtbarwerden verbindet sie sich neu und frischt ihr FCM-Token auf.
|
||||
3. Halb offene Verbindungen, bei denen das Gerät einschläft, ohne FIN/RST zu
|
||||
senden, werden vom Heartbeat nach
|
||||
`CMBNET_WS_CLIENT_OFFLINE_TIMEOUT_SECONDS` (Default 180) ohne Lebenszeichen
|
||||
geschlossen. Als Lebenszeichen zählt ein Code-2-Pong oder jede andere
|
||||
eingehende WebSocket-Nachricht des Clients.
|
||||
4. Jeder WSGI-Worker hinterlässt ein Lebenszeichen in `ws_workers`. Clients
|
||||
eines nicht mehr laufenden Workers – etwa nach einem Neustart – werden
|
||||
automatisch als getrennt markiert. Das verhindert dauerhaft „verbundene“
|
||||
Karteileichen in der Datenbank.
|
||||
|
||||
Ohne Schritt 3 und 4 blieben schlafende Geräte bzw. Clients aus einem alten
|
||||
Prozess dauerhaft als „verbunden“ markiert und würden nie als Wake-Kandidaten
|
||||
erscheinen. `ws_clients`-Einträge mit gültigem FCM-Token werden beim normalen
|
||||
Client-Aufräumen nicht entfernt; das Token hat eine eigene, großzügigere
|
||||
Aufbewahrungsfrist.
|
||||
|
||||
### Offline-Timeout
|
||||
|
||||
Ein periodischer Worker prüft getrennte Clients. Nach
|
||||
@@ -96,6 +124,11 @@ Desktop-Dispatcher erhalten keine FCM-Behandlung.
|
||||
- `client_type`: Client-Typ für das FCM-Routing
|
||||
- `last_wake_at`, `last_wake_reason`: Drosselung und Nachvollziehbarkeit
|
||||
|
||||
Neue Tabelle `ws_workers`:
|
||||
|
||||
- Lebenszeichen je WSGI-Worker (`started_at`, `heartbeat_at`)
|
||||
- dient der Erkennung verwaister Clients nach einem Worker-Neustart
|
||||
|
||||
Neue Tabelle `ws_push_tokens`:
|
||||
|
||||
- ein FCM-Token ist projektweit eindeutig
|
||||
@@ -105,8 +138,9 @@ Neue Tabelle `ws_push_tokens`:
|
||||
|
||||
Die Registrierung wird bei einem Reload mit neuer Client-ID auf die neue
|
||||
Client-ID verschoben. Nach einer Token-Rotation wird das alte Token derselben
|
||||
Webview entfernt. Verwaiste Tokens werden zusammen mit den Client-Queues
|
||||
aufgeräumt.
|
||||
Webview entfernt. Verwaiste Tokens werden mit einer eigenen Frist aufgeräumt;
|
||||
der zugehörige `ws_clients`-Eintrag bleibt so lange erhalten. Die
|
||||
Client-Queues werden weiterhin nach der kürzeren Queue-Frist bereinigt.
|
||||
|
||||
## Mehrere Worker
|
||||
|
||||
@@ -140,7 +174,8 @@ inaktiv:
|
||||
| `CMBNET_FCM_MANUAL_WAKE_COOLDOWN_SECONDS` | `15` | Cooldown für den Button |
|
||||
| `CMBNET_FCM_SIGNAL_TTL_SECONDS` | `600` | FCM-TTL |
|
||||
| `CMBNET_FCM_WAKE_POLL_INTERVAL_SECONDS` | `30` | Prüfintervall des Workers |
|
||||
| `CMBNET_FCM_PUSH_TOKEN_RETENTION_MINUTES` | `1440` | Aufbewahrung verwaister Tokens |
|
||||
| `CMBNET_FCM_PUSH_TOKEN_RETENTION_MINUTES` | `43200` | Aufbewahrung nicht verbundener Tokens (30 Tage) |
|
||||
| `CMBNET_WS_CLIENT_OFFLINE_TIMEOUT_SECONDS` | `180` | Zeit ohne Lebenszeichen bis zur Offline-Markierung |
|
||||
|
||||
## Beschränkungen und Konsequenzen bei PWAs
|
||||
|
||||
|
||||
Reference in new issue
Block a user