Il browser preso dalle pagine Browser e Collegamento si restituisce uscendo senza «Ho finito» (anche chiudendo o ricaricando la scheda); dopo «Ho finito» la vista remota si chiude e non si riprende il browser. Vista remota: AltGr/Option come testo, pulsante rilasciato anche fuori dalla vista. Mosaico e scheda account senza risposte vecchie né viste sovrascritte; nuovi elementi dopo la libreria vuota; intestazione sempre aggiornata. Indietro del browser con la richiesta delle modifiche non salvate; nulla resta registrato da una pagina lasciata mentre caricava; maniglie della fascia trascinabili. «Da una data» come giorno locale; niente «@null» nel riquadro di stato; orari futuri dei fermi «verso le». Prove nel browser vero (InterfaceTests). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
3.0 KiB
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<canvas>.
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.