Files
Febe/src/Febe.Web/Connection/PROTOCOLLO.md
T
Claude 0ceffffe50 Interfaccia: correzioni della revisione (web-1, web-2, web-3, web-4, web-5, web-6, web-7, web-9, web-10, web-11, web-12, web-13, web-14, web-15)
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
2026-10-14 01:38:13 +00:00

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.