add shares av system

docs/on-progress/WEBSOCKET-PROXY-CONFIG.md

@@ -0,0 +1,117 @@
+# WebSocket Proxy Configuration
+
+Untuk terminal console WebSocket berfungsi dengan baik, reverse proxy (Nginx/Apache) perlu dikonfigurasi untuk mendukung WebSocket upgrade.
+
+## Nginx Configuration
+
+Tambahkan konfigurasi berikut di Nginx untuk mendukung WebSocket:
+
+```nginx
+server {
+    listen 80;
+    listen [::]:80;
+    server_name atlas-demo.avt.data-center.id;
+
+    # WebSocket upgrade headers
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        '' close;
+    }
+
+    location /api/v1/system/terminal/ws {
+        proxy_pass http://localhost:8080;
+        proxy_http_version 1.1;
+        
+        # WebSocket headers
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection $connection_upgrade;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        
+        # WebSocket timeouts
+        proxy_read_timeout 86400s;
+        proxy_send_timeout 86400s;
+    }
+
+    location /api {
+        proxy_pass http://localhost:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+## Apache Configuration (mod_proxy_wstunnel)
+
+Jika menggunakan Apache, pastikan mod_proxy_wstunnel diaktifkan:
+
+```apache
+LoadModule proxy_module modules/mod_proxy.so
+LoadModule proxy_http_module modules/mod_proxy_http.so
+LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
+
+<VirtualHost *:80>
+    ServerName atlas-demo.avt.data-center.id
+
+    # WebSocket endpoint
+    ProxyPass /api/v1/system/terminal/ws ws://localhost:8080/api/v1/system/terminal/ws
+    ProxyPassReverse /api/v1/system/terminal/ws ws://localhost:8080/api/v1/system/terminal/ws
+
+    # Regular API
+    ProxyPass /api http://localhost:8080/api
+    ProxyPassReverse /api http://localhost:8080/api
+
+    # Frontend
+    ProxyPass / http://localhost:3000/
+    ProxyPassReverse / http://localhost:3000/
+</VirtualHost>
+```
+
+## Testing WebSocket Connection
+
+Setelah konfigurasi, test dengan:
+
+```bash
+# Test WebSocket connection
+wscat -c wss://atlas-demo.avt.data-center.id/api/v1/system/terminal/ws?token=YOUR_TOKEN
+```
+
+atau menggunakan curl:
+
+```bash
+curl -i -N \
+  -H "Connection: Upgrade" \
+  -H "Upgrade: websocket" \
+  -H "Sec-WebSocket-Version: 13" \
+  -H "Sec-WebSocket-Key: test" \
+  http://localhost:8080/api/v1/system/terminal/ws?token=YOUR_TOKEN
+```
+
+## Troubleshooting
+
+1. **Error: WebSocket connection failed**
+   - Pastikan reverse proxy dikonfigurasi dengan benar
+   - Check log backend untuk error details
+   - Pastikan port 8080 accessible
+
+2. **Connection closed immediately**
+   - Check WriteTimeout di server config (harus 0 untuk WebSocket)
+   - Check proxy timeouts (harus cukup panjang)
+
+3. **401 Unauthorized**
+   - Pastikan token valid dan tidak expired
+   - Check authentication middleware