# Collegamento, vista remota e problemi di configurazione Contratto fra l'interfaccia (pagine Collegamento, Browser, errore di configurazione) e la composizione del server. Lo usano due parti scritte in parallelo: non cambiarlo senza aggiornare entrambe. ## Collegamento (`IConnectionService`) | Endpoint | Corpo e risposta | |---|---| | `GET /api/connection` | `{ state: "notConnected"\|"connected"\|"verificationRequired"\|"browserUnavailable", username, displayName, userIsDriving, currentUrl }` | | `POST /api/connection/begin` | `{ openLogin: bool }` → 204. Alberto usa il browser; con `openLogin` il browser carica la pagina di accesso vera | | `POST /api/connection/finish` | → `{ connected: bool, message }` («Ho finito») | | `POST /api/connection/cancel` | → 204 («Annulla») | | `POST /api/connection/disconnect` | → 204 («Scollega», dopo la conferma nell'interfaccia) | In modalità dimostrativa la scena `scollegato` dà `notConnected`, la scena `fermo` dà `verificationRequired`. L'interfaccia manda `cancel` anche quando Alberto lascia la pagina Browser, o la pagina Collegamento mentre accede, senza «Ho finito» né «Annulla»: un'altra pagina, la scheda chiusa o ricaricata (`fetch` con `keepalive`, che porta l'`Origin` dell'interfaccia). Dopo un «Ho finito» riuscito la pagina chiude la vista remota e non manda un nuovo `begin`. ## Vista remota (`/api/vista`, solo veste Docker) WebSocket sullo stesso host dell'interfaccia; si apre solo da una sessione autenticata e con `Origin` uguale all'host (§13.1). Aprirla mette il motore fermo (`UserIsDriving`); chiuderla lo libera. Dal server al browser di Alberto: - messaggio di testo `{ "type": "meta", "width": 1280, "height": 900, "url": "https://www.instagram.com/accounts/login/" }` all'apertura e a ogni cambio di indirizzo o dimensione (l'indirizzo senza parametri di ricerca); - messaggi binari: un fotogramma JPEG ciascuno (da `Page.startScreencast`), da disegnare su un ``. Dal browser di Alberto al server, solo messaggi di testo JSON: - `{ "type": "mouse", "action": "move"|"down"|"up"|"wheel", "x": 0..1, "y": 0..1, "button": "left"|"right"|"middle", "deltaX": n, "deltaY": n, "clickCount": n }` con coordinate relative al fotogramma; - `{ "type": "key", "action": "down"|"up"|"char", "key": "a", "code": "KeyA", "text": "a", "modifiers": n }` (i tasti non si registrano mai, né sul server né nel browser di Alberto); - `{ "type": "navigate", "action": "back"|"reload" }`. ## Problemi di configurazione `GET /api/capabilities` ha il campo `problems`: elenco di `{ code, title, message, remedy }` in italiano. Se non è vuoto il motore non parte e l'interfaccia mostra solo la pagina che spiega il problema (§8.2, §11): password mancante (`FEBE_PASSWORD`), cartella dei dati non scrivibile o su un disco di rete, runtime WebView2 assente (Windows). In modalità dimostrativa la scena `errore` ne simula uno. `GET /salute` (senza autenticazione) risponde `200 {"stato":"ok"}` o `503 {"stato":"problema"}`, senza altri dettagli.