GENVOLT DOCS

                                                Real Edge PC (On-Site)
                                                        │
                                                        │ MQTT over TLS :8883 (mTLS / CA validated)
                                                        ▼
                                                        EMQX Community 5.x Broker (VPS)
                                                        │
                                                        ├── Fastify Node.js Backend (:8000 / api.genvolt.cloud)
                                                        │ ├── TimescaleDB / PostgreSQL 16 (Hypertable)
                                                        │ └── Server-Sent Events (SSE /v1/stream)
                                                        │
                                                        └── Next.js 15 Standalone Frontends
                                                        ├── Web Monitor (monitor.genvolt.cloud)
                                                        └── Web Admin (admin.genvolt.cloud)

                                                        
                                                                curl -X POST https://api.genvolt.cloud/v1/auth/login \
                                                                -H 'Content-Type: application/json' \
                                                                -d '{"email":"[email protected]","password":"SecretPassword123!"}'
                                                        
                                                

                                                        
                                                                const res = await fetch('https://api.genvolt.cloud/v1/auth/login',{
                                                                        method:'POST', headers:{'Content-Type':'application/json'},
                                                                        body: JSON.stringify({email:'[email protected]',
                                                                        password:'SecretPassword123!'})
                                                                });
                                                                const {token} = await res.json();
                                                        
                                                

                                                        
                                                                import requests

                                                                r = requests.post("https://api.genvolt.cloud/v1/auth/login",
                                                                json={"email":"[email protected]","password":"SecretPassword123!"})
                                                                token = r.json()["token"]
                                                        
                                                

                                                        
                                                                curl https://api.genvolt.cloud/v1/devices/GENSET-DSE-01/telemetry/latest -H "Authorization: Bearer $TOKEN"
                                                        
                                                

                                                        
                                                                curl -N "https://api.genvolt.cloud/v1/stream?token=$TOKEN"
                                                                # event: telemetry
                                                                # data:
                                                                {"type":"telemetry","device_id":"GENSET-DSE-01","values":{"engine_speed":1500}}
                                                        
                                                

                                                        
                                                                event: ready
                                                                data: {"ok":true}

                                                                event: telemetry
                                                                data:
                                                                {"type":"telemetry","device_id":"GENSET-DSE-01","ts":"2026-09-21T08:42:00.000Z","values":{"engine_speed":1500,"generator_total_watts":285000},"alarms":[]}

                                                                event: command
                                                                data:
                                                                {"type":"command","id":"3b2e7c10-...","device_id":"GENSET-DSE-01","command":"start","status":"SENT"}

                                                                :hb
                                                        
                                                

                                                        
                                                                const es = new EventSource(`https://api.genvolt.cloud/v1/stream?token=${token}`);
                                                                es.addEventListener('telemetry', e =>
                                                                console.log(JSON.parse(e.data)));
                                                                es.addEventListener('command', e => console.log('cmd',
                                                                JSON.parse(e.data)));
                                                        
                                                

                                                        
                                                                curl -N -H "Accept:text/event-stream" "https://api.genvolt.cloud/v1/stream?token=$TOKEN"