Initial commit

WEBSOCKET_TROUBLESHOOTING.md

@@ -0,0 +1,50 @@
+# WebSocket Verbindungsprobleme - Lösungen
+
+## Problem
+WebSocket-Verbindungen (ws:// oder wss://) werden oft von Unternehmensnetzwerken blockiert:
+- Firewalls blockieren WebSocket-Protokoll
+- Proxies unterstützen kein WebSocket-Upgrade
+- Nur HTTP/HTTPS Ports (80/443) sind erlaubt
+
+## Implementierte Lösung
+Der Activity Service verwendet jetzt **HTTP Long-Polling** statt WebSockets:
+- Funktioniert über Standard HTTP
+- Umgeht WebSocket-Blockierungen
+- Etwas höhere Latenz, aber zuverlässiger in restriktiven Netzwerken
+
+## Weitere Lösungsansätze
+
+### 1. Proxy-Konfiguration
+Wenn Ihr Netzwerk einen HTTP-Proxy verwendet:
+```python
+# In services/activity_sync.py
+import os
+os.environ['HTTP_PROXY'] = 'http://proxy.company.com:8080'
+os.environ['HTTPS_PROXY'] = 'http://proxy.company.com:8080'
+```
+
+### 2. Alternative Ports
+Fragen Sie Ihren Admin, ob der Activity Server auch auf Port 80 oder 443 laufen kann.
+
+### 3. VPN verwenden
+Wenn verfügbar, kann eine VPN-Verbindung die Netzwerkbeschränkungen umgehen.
+
+### 4. Lokaler Activity Server
+Für Entwicklung/Test einen lokalen Server verwenden:
+- Server URL: `http://localhost:3001`
+- Keine Netzwerkbeschränkungen
+
+## Test der Verbindung
+1. Browser-Test: http://91.99.192.14:3001/health
+2. Curl-Test: `curl http://91.99.192.14:3001/health`
+3. Python-Test-Skript: `python test_activity_connection.py`
+
+## Firewall-Regeln
+Falls Sie Admin-Rechte haben, erlauben Sie:
+- Ausgehende TCP-Verbindungen zu 91.99.192.14:3001
+- HTTP/HTTPS Traffic zu diesem Server
+
+## Status in CPM
+- Grüner Punkt: Verbindung aktiv
+- Meldung "Nicht verbunden": Server nicht erreichbar
+- Die Aktivitätsfunktion ist optional - CPM funktioniert vollständig ohne sie