""" Heartbeat-Routine für WebSocket-Verbindungen Der Server sendet jede Minute eine Nachricht mit Code 1 an alle authentifizierten Clients. Die Clients antworten mit Code 2; diese Antwort wird vom Broker ausschließlich an Dispatcher-Views weitergeleitet. Zusätzlich räumt die Routine abgelaufene Late-Entry-Nachrichten auf, damit die Tabelle ws_messages_store nicht unbegrenzt wächst. """ from threading import Timer from cmbnet.ws import broker from cmbnet.ws.protocol import WSMessage class HeartbeatManager: def __init__(self, interval=60): self.interval = interval self.running = False self.app = None self._timer = None self._presence_timer = None def start(self, app=None, interval=None): """Startet die zyklische Heartbeat-Routine.""" # Die App-Referenz wird benötigt, um im Hintergrund-Thread einen # Flask-App-Kontext für Datenbankzugriffe öffnen zu können. if app is not None: self.app = app if interval is not None: self.interval = interval if self.running: return self.running = True self._send_heartbeat() self._check_presence() def stop(self): """Stoppt die Heartbeat-Routine.""" self.running = False for timer in (self._timer, self._presence_timer): if timer is not None: timer.cancel() self._timer = None self._presence_timer = None def _check_presence(self): """Prüft die Code-2-Lebenszeichen der Gruppen unabhängig vom Heartbeat.""" if not self.running: return if self.app is not None: try: with self.app.app_context(): broker.check_group_presence_timeouts() except Exception as exc: print(f'Group presence check error: {exc}') # Kürzer als das Zwei-Minuten-Fenster prüfen, damit der Status # zeitnah auf "unterwegs" wechselt. self._presence_timer = Timer(15, self._check_presence) self._presence_timer.daemon = True self._presence_timer.start() def _send_heartbeat(self): if not self.running: return msg = WSMessage(sender_id=0, code=1, msg='ping') # Nur authentifizierte Verbindungen erhalten einen Heartbeat. for tenant_id, connections in list(broker.connections.items()): for client_id in list(connections): if not broker.is_authenticated(tenant_id, client_id): continue broker.send_to_connection(tenant_id, client_id, msg.to_json()) # Abgelaufene persistierte Nachrichten und Client-Queues löschen. if self.app is not None: try: with self.app.app_context(): broker.cleanup_client_queues() broker.cleanup_old_messages() except Exception as exc: print(f'Heartbeat cleanup error: {exc}') # Nächsten Heartbeat planen. Der Timer läuft als Daemon, damit er den # Prozess beim Beenden nicht blockiert. self._timer = Timer(self.interval, self._send_heartbeat) self._timer.daemon = True self._timer.start() heartbeat_manager = HeartbeatManager()