0.6.0 blocco 3: copertina, versione, documenti e anteprime nelle due lingue

2026-10-10 09:52:32 +02:00
parent 85702880d5
commit 36033daf3f
18 changed files with 385 additions and 123 deletions
@@ -231,3 +231,52 @@ andrebbe disegnata a mano.
  parsing delle statistiche e alla formattazione di importi e mesi (61/61), versione,
  README e `docs/PROTOCOL.md` aggiornati.
 - Nessun comando nuovo all'impianto: tutto questo è **sola lettura**.
+
+---
+
+## 9. Studio UX/UI e riordino delle schermate — v0.6.0
+
+Prima di scrivere codice è stato fatto lo studio in `docs/UX-STUDIO.md`: dieci
+problemi rilevati nelle schermate della 0.5.0, la proposta, i wireframe
+(`docs/ux/`, generati da `scripts/render_wireframes.py`) e il piano di verifica.
+Le quattro scelte di design sono state prese dall'autore: la frase di stato
+lunga va in Impianto, "Altri comandi" diventa "Comandi impianto", le azioni
+rapide sono pulsanti visibili, le azioni sulla copertina restano per dopo la
+prova di `CoverAction` sul kit.
+
+**Home** (`MainPage.qml`, riscritta): una schermata da guardare, non un modulo.
+Stato in una riga con il pallino colorato (verde regolare, ambra modo attivo o
+numeri vecchi, rosso errore), le due letture che contano — casa e acqua calda,
+con obiettivo e barra di carica — affiancate e **toccabili**, e tre azioni
+rapide: boost, assenza, comandi. Escono dalla Home i due slider, i sette
+pulsanti e i tre pulsanti di navigazione ridondanti col menù a tendina. Sotto,
+in una riga toccabile che porta a Impianto: esterna, termostato, zone.
+
+**Regolazioni** (`SetpointsPage.qml`, nuova): un blocco per grandezza, con il
+valore vero dell'impianto sempre visibile, slider (la proposta), fila di valori
+rapidi per le dita fredde e pulsante di conferma che si attiva solo se c'è
+davvero qualcosa da cambiare. Il boost ha qui i suoi due pulsanti.
+
+**Comandi impianto** (`CommandsPage.qml`): da 12 pulsanti in quattro sezioni
+(otto in coppie acceso/spento) a **4 interruttori `TextSwitch` + 3 pulsanti**.
+Gli interruttori non anticipano l'impianto: `automaticCheck: false`, `checked`
+sull'ultimo dato vero, e se il comando non riesce restano dov'erano. La
+diagnostica (verifica impianto) si sposta in Impianto, insieme alle letture che
+non avevano posto: pompa, modi consentiti, modalità manuale, sbrinamento, luci
+di firma.
+
+**Feedback e dati vecchi**: i messaggi dei comandi passano in `ApiClient`
+(`api.notice`) e si mostrano nel nuovo `NoticeBar`, **ancorato al bordo
+inferiore della pagina** invece che dentro il contenuto che scorre: prima,
+premendo un pulsante in fondo alla pagina, il messaggio nasceva fuori schermo.
+In più `stale` e `lastUpdate`: la Home scrive "aggiornato alle HH:MM" e spegne i
+numeri quando l'ultima lettura non è recente. Dopo un comando riuscito lo stato
+si rilegge da solo (2 s): l'aggiornamento automatico, prima, non esisteva.
+
+**Stato breve ed esteso in C++** (`AiraJson::stateShort/stateLong/statusLevel`):
+logica pura, verificabile senza SDK e non duplicata fra Home e Impianto. Test
+del nucleo: **79/79** (erano 61). Stringhe: **190/190** tradotte. Anteprime
+rigenerate (nuova `regolazioni.png`) in italiano e inglese.
+
+- Nessun comando nuovo all'impianto: anche questa versione resta **sola
+  lettura** finché non si prova l'invio dal telefono.