Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- t3:release_notes [12/05/2026 12:38] – luca
+++ t3:release_notes [06/07/2026 17:15] (versione attuale) – luca
@@ Linea 1: / Linea 1: @@
 ====== Note di rilascio delle varie versioni (anno 2026) ======
+===== v4.9.0 =====
+//Raccoglie tutte le novità e correzioni introdotte a partire dalla v4.2.1 (t3_be, t3_fe, t3_bo, t3_he, t3_statlib).//
+==== Nuove funzionalita ====
+=== Prodotti, varianti e listini ===
+  * **Gruppi di varianti/ingredienti con vincoli min/max** — Le varianti e gli ingredienti di un prodotto possono essere organizzati in gruppi omogenei. Nel back office un editor dedicato (scheda articolo, sezione "Gruppi di varianti/ingredienti") permette di creare i gruppi, impostare minimo e massimo tramite slider (0–99), riordinare gruppi e membri via drag & drop e propagare un gruppo a tutti gli articoli della stessa categoria; è impedito l'uso dello stesso tag in due gruppi e il salvataggio è bloccato se un gruppo resta vuoto. In fase d'ordine ogni gruppo diventa una scheda dedicata nel modale (mostrata prima delle schede standard) con conteggio delle selezioni, tetto massimo e obbligatorietà: se un gruppo obbligatorio non è completo, l'invio della comanda viene bloccato indicando il nome del gruppo. > //Richiede attivazione:// FeatureLevel "Gruppi di varianti".
+  * **Dosaggi su varianti e ingredienti (poco / abbondante)** — Nuovi qualificatori di dose con effetto percentuale sul prezzo, definibili per singola variante/ingrediente tramite un editor dedicato (dose predefinita per tipo, etichetta, etichetta breve, percentuale e scala) con applicazione in blocco su tutti gli articoli dello stesso tipo. La dose scelta viene congelata al momento dell'ordine, mostrata come chip sulla riga e stampata in comanda (l'etichetta della dose al posto del semplice "+"); le varianti eliminabili acquisiscono anche la dose "-" (senza). > //Richiede attivazione:// le dosi personalizzate sono sempre visibili; le dosi predefinite +/- compaiono nel pannello varianti abilitando il flag di terminale "Mostra i dosaggi predefiniti (+/-) nel pannello varianti".
+  * **Spicchi e formati pizza in frazioni m/n** — Il carosello dei formati supporta le frazioni m/n complete (intero più ogni frazione per denominatore, es. 2/3) con indicatore grafico che riempie gli spicchi selezionati ed etichetta "Intero / 1/n / m/n". Il selettore mostra la descrizione di menu della variante, si apre con la pressione prolungata sui prodotti a formato, blocca la modifica quantità sulle righe con formato applicato e le varianti aggiunte ereditano il listino forzato del prodotto padre. > //Richiede attivazione:// FeatureLevel "gestione spicchi con numeratore non unitario"; senza il flag si ricade sulle frazioni unitarie 1/n.
+  * **Applica varianti e dosi ad altri articoli dello stesso gruppo** — Nuova funzione che copia (o sostituisce) l'elenco di varianti/aggiunte e le dosi di un articolo su tutti gli altri articoli dello stesso gruppo, preservando ordine e flag di ordinamento.
+  * **Ricerca nel modale varianti** — Campo di ricerca accanto alla barra delle schede che filtra le varianti per descrizione (limitato alla scheda attiva), con stato "nessun risultato" e messa a fuoco automatica all'apertura.
+  * **Ricerca in libreria per codice a barre parziale** — La ricerca in libreria trova gli articoli anche per corrispondenza parziale del codice a barre (barcode articolo e barcode confezione), non più solo per uguaglianza esatta.
+  * **Modifica prezzi e reparti dei tabacchi** — Il back office può modificare prezzi e reparti di vendita dei tabacchi; le modifiche manuali sopravvivono alla sincronizzazione.
+=== Pagamenti ===
+  * **Calcolatrice integrata nella schermata di vendita** — La schermata banco/bar può ospitare una calcolatrice integrata nella colonna dell'ordine (tastierino a 4 colonne, tasto di cancellazione ⌫, moltiplicatore "*" ingrandito, pagamenti rapidi contanti/carta); il display si comprime insieme al tastierino. > //Richiede attivazione:// flag di terminale "Calcolatrice embedded nella vista comanda BAR" sul terminale master.
+  * **SumUp: scontrino allegato al documento fiscale** — A pagamento riuscito lo scontrino SumUp viene recuperato e stampato in coda allo scontrino fiscale. > //Richiede attivazione:// flag di configurazione "allega ricevuta" (chiave affiliato precompilata nel form).
+  * **Z-Pay SoftPOS** — Nuovo tipo di POS software che trasforma il dispositivo Android in terminale di pagamento contactless (tap-to-pay) senza POS esterno, con ricevuta sintetica integrata nel flusso di incasso. > //Richiede attivazione:// dispositivo Android 8.0 (API 26) o superiore con Z-Pay installato e configurato dall'esercente.
+  * **Fattura riepilogativa: cassetto automatico/pos e cambio pagamento** — Prima della stampa, se il pagamento selezionato ha un cassetto automatico o un pos collegato viene ingaggiato (stampa bloccata in caso di errore); è possibile sostituire il pagamento preimpostato con un altro compatibile con la fattura elettronica.
+=== Statistiche ===
+  * **Statistiche multi-attività** — È possibile selezionare più punti vendita contemporaneamente e ottenere statistiche aggregate; una barra di selezione con ricerca a scomparsa consente di scegliere rapidamente i locali. La scelta dell'attività per widget viene salvata e usata anche nei report via email programmati. I periodi legati alle chiusure di cassa (dall'ultima chiusura, ultima chiusura, elenco chiusure) dipendono da un singolo locale e vengono bloccati con avviso quando sono attive più attività.
+  * **Sovrapposizione dei grafici per attività** — Nei grafici temporali, con due o più locali selezionati le serie (venduto, conti, sconti) vengono suddivise per punto vendita e rappresentate come aree impilate, una per attività, offrendo un confronto immediato tra le sedi.
+  * **Totali visibili su grafici e schede** — I grafici cartesiani e a barre mostrano i totali di periodo (valore e quantità) nel titolo; le schede Documenti e Pagamenti riportano valore totale e quantità nel titolo, come già Prodotti e Gruppi.
+  * **Scheda Sconti su grafico temporale** — La scheda Sconti passa dal grafico a barre al grafico temporale, rendendo più leggibile l'andamento degli sconti nel tempo.
+  * **Filtri configurabili e nuovi periodi** — La schermata dei filtri mostra solo le sezioni attive, con pulsanti per aggiungere quelle nascoste e rimuoverle inline. Il selettore del periodo personalizzato è stato rinnovato (campi ora dedicati che aprono il selettore orario) ed è stato aggiunto il periodo "anno precedente"; gli orari/fasce personalizzati vengono mantenuti applicando un filtro salvato.
+  * **Layout ottimizzato su schermi ampi** — Grafici centrati e larghezza massima per griglia statistiche, tabella dati e grafici temporali, evitando che i contenuti si stirino sui monitor larghi.
+=== Importazioni e anagrafiche ===
+  * **Importazione libreria da Cassa In Cloud** — Nuova procedura guidata "Importa da CiC" che legge l'export Excel di Cassa In Cloud e ricostruisce l'intera libreria: prodotti, categorie/gruppi, listini multipli, reparti IVA (creati automaticamente, uno per descrizione), clienti e aziende. Ad ogni prodotto viene assegnato un colore stabile e la stampante d'ordine abbinata in modo euristico (Primi→CUCINA, Pizze→PIZZERIA, Bar→BAR), con creazione automatica delle stampanti mancanti. In presenza di reparti esistenti l'operatore viene avvisato prima della sostituzione. > //Richiede attivazione:// voce "Importa da CiC" nel menu di importazione della Libreria.
+  * **Importazione articoli da Excel con listini multipli** — L'importazione articoli supporta fino a 8 listini: per ogni colonna prezzo si sceglie il listino di destinazione (Prezzo 1 obbligatorio sul listino principale, gli altri opzionali) con prezzo di fallback sui listini non mappati; aggiunta la normalizzazione robusta dei prezzi (virgola decimale, punto migliaia, simboli di valuta) e la lettura file non bloccante.
+  * **Importazione clienti da CSV/Excel e azzeramento anagrafica** — Nuovo flusso di importazione clienti da tracciati arbitrari con mappatura colonne, anteprima ordinabile/filtrabile, caricamento a lotti con avanzamento e annullamento, e separazione automatica del numero civico dall'indirizzo. Introdotto l'azzeramento dell'anagrafica clienti per tipologia (privati/aziende/tutti), riservato al tecnico.
+  * **Importazione e gestione fidelity card** — Nuovo import tessere fedeltà da Excel (selezione foglio, mappatura campi, scelta campagna, associazione a cliente per colonna o fisso, pulizia importi in formato italiano). Dai movimenti di una tessera è possibile aprire il conto di origine, e lo scarico tessera funziona in qualsiasi negozio del gruppo tramite il pagamento di gruppo. > //Richiede attivazione:// flag di terminale "Disabilita ricerca tessera fedeltà da long-press".
+=== Stampa e documenti ===
+  * **Comanda divisa per portata (ticket separati)** — Nuovo flag che emette la comanda come ticket separati per blocco/portata, ciascuno con intestazione, piè di pagina e taglio carta propri (template EPSON_ESC_POS e IMIN_ONBOARD). > //Richiede attivazione:// flag stampante "Stampa ogni portata come comanda separata".
+  * **Ignora le portate nel conto** — Flag che, in fase di conto, raggruppa le righe in un unico blocco così l'ordinamento viene applicato all'intero conto anziché portata per portata. > //Richiede attivazione:// flag stampante "Ignora le portate nel conto".
+  * **Salta le comande di correzione solo-rimozione** — Evita di stampare i ticket di correzione contenenti solo rimozioni (storni); se la variazione contiene anche altre modifiche viene stampata normalmente. > //Richiede attivazione:// flag stampante "Non stampare le comande di solo storno".
+  * **Data di consegna asporto in grande con giorno della settimana** — Se la consegna non è per oggi, la data richiesta viene stampata a doppia altezza/larghezza come "MARTEDI 30/06" (giorno localizzato, senza accenti per le stampanti termiche). > //Richiede attivazione:// flag stampante "Stampa la data di consegna grande con il giorno".
+  * **Righe aggiuntive centrate e allineabili** — Le righe aggiuntive dei documenti possono essere centrate (template EPSON) con selettore di allineamento sinistra/centro per singola riga; righe extra disponibili anche in fattura elettronica.
+  * **Documenti annullati visibili nell'elenco** — I documenti annullati diversi dalle fatture (es. documento commerciale annullato) restano visibili in sola lettura con badge "ANNULLATO"; le azioni di annullo/ristampa vengono nascoste.
+  * **Ridisegno stampa Ditron WEC** — Riscrittura della comunicazione con le stampanti Ditron in modalità WEC (connessione/sessione a passi, spaziatura di 100 ms tra le righe) per maggiore affidabilità.
+  * **Pagina diagnostica emissione documenti commerciali** — Nuova schermata diagnostica per l'emissione ripetuta e controllata di documenti commerciali, con avanzamento, arresto e pausa configurabile tra un documento e l'altro. > //Richiede attivazione:// visibile solo sui terminali marcati come Trend.
+=== Configurazione, sicurezza e infrastruttura ===
+  * **Limite di spesa per reparto** — Nuovo limite di importo per reparto di vendita, configurabile a livello base e con override per singolo terminale; le righe che eccedono bloccano invio/registrazione.
+  * **Rinnovo automatico del token di sicurezza (JWT)** — Il token operatore viene rinnovato automaticamente dopo la chiusura fiscale giornaliera (o via timer di sicurezza a 48 ore) e propagato agli altri terminali del negozio. > //Richiede attivazione:// attivo di default, disattivabile per singolo terminale (flag "Disattiva rinnovo token").
+  * **Sicurezza autenticazione rafforzata** — Nuovo header di login cifrato AES-GCM con verifica di email, codice cliente, password, timestamp e nonce anti-replay (in affiancamento a quello legacy durante il rollout).
+  * **Ripristino di emergenza sync (sovraccarico server)** — In caso di sovraccarico del cloud, il dispositivo tratta la limitazione lato server come temporanea (backoff intelligente, riduzione automatica del lotto, distribuzione dei tentativi) e alla prima sincronizzazione mostra una finestra con le scelte "Riprova" / "Procedi offline" invece di bloccarsi.
+  * **Avvio offline manuale al login** — Con forte perdita di pacchetti l'attesa del login poteva durare fino a circa un minuto: ora dopo 15 secondi compare un pulsante per forzare l'avvio offline, ed è possibile pre-armarlo con una pressione prolungata prima del login. Pensato per il terminale master locale.
+  * **Routing multi-cluster** — App e QR code instradano automaticamente verso il cluster corretto tramite l'indirizzo del negozio, così i negozi ospitati su cluster secondari funzionano correttamente (le installazioni sul cluster predefinito restano invariate).
+  * **Blocco Dashboard su iOS/Android con peer connessi** — Impedisce l'apertura della dashboard sul dispositivo server quando ci sono terminali dipendenti (POS/palmari/totem) collegati, evitando il freeze del server JRPC indotto dal sistema operativo.
+  * **USCITA SESSIONE semplificata** — L'uscita sessione esegue un semplice logout dell'operatore (torna alla scelta operatore) senza smontare il server JRPC, eliminando i blocchi riscontrati su Android e Windows.
+  * **Autologout più sicuro** — Il logout per inattività viene sospeso mentre è aperto un dialogo modale (resto, errore POS) o durante una transazione POS lunga, e scatta solo al termine del flusso.
+  * **Nuovo installer Windows .exe (Inno Setup)** — Oltre al pacchetto MSIX viene prodotto un installer .exe firmato, adatto anche alle edizioni Windows LTSB, che crea l'icona sul desktop e installa automaticamente i certificati radice necessari (Amazon Root CA, GoDaddy, ISRG/Let's Encrypt), evitando problemi TLS su macchine con archivio certificati non aggiornato.
+  * **Supporto Zucchetti Digital Hub** — La licenza "Zucchetti Digital Hub" è ora elencata nella categoria Fatturazione.
+=== Interfaccia e usabilità ===
+  * **Dashboard Home rinnovata** — La home mostra un grafico "Documenti" sotto le statistiche, un nastro di notifiche non lette (con contatore e pallino sull'avatar) accanto al nastro degli articoli sotto soglia di riordino, una barra superiore responsiva con logo/icona compatta e selettore attività ordinato per data di creazione con l'attività principale in cima ed evidenziata. Il menu profilo raccoglie gli strumenti (scarica/carica DB, scarica APP, notifiche) e la hero card espone il "codice fuori orario".
+  * **Prenotazioni** — I giorni bloccati si gestiscono tramite chip con selettore di intervallo date; la data di fine validità può essere impostata fino a 10 anni in avanti (prima il limite era un anno).
+  * **Righe ordine più comode** — Le azioni swipe si chiudono automaticamente (una sola riga aperta per volta, chiusura al tocco fuori) ed è disponibile un flag per saltare la conferma di cancellazione della riga.
+==== Correzioni ====
+=== Tavoli, ordini e comande ===
+  * **Elenco tavoli su sale grandi** — Risolti blocchi e schermate vuote nell'elenco tavoli: filtro Tutti/Liberi/Occupati applicato a livello di lista, ripristino dello scorrimento all'indietro, i tavoli uniti spariscono senza cambiare sala, l'occupazione segue lo stato in tempo reale e la lettura degli stati torna leggera (niente più congelamento su sale con ~300 tavoli).
+  * **Navigazione non più sovrascritta da risposte obsolete** — Toccando un tavolo la schermata si apre solo se il caricamento atteso è ancora quello corrente: una risposta arrivata in ritardo (device lenti) non può più cambiare contesto o navigare sopra ciò su cui l'operatore si è spostato. Corretto in particolare il conto d'asporto che poteva essere emesso con le righe di un tavolo.
+  * **OCCUPA su tavoli mai ordinati** — Il comando OCCUPA funziona ora anche su un tavolo che non ha ancora ricevuto alcun ordine.
+  * **Comande con messaggi non trasmesse** — Eliminata la tempesta di richieste sugli stati tavolo (scatenata dai rebuild durante la digitazione) che accodava e ritardava la trasmissione degli ordini con messaggi.
+  * **Resync conto** — Corretto il resync del conto che avveniva solo dal dispositivo cassa.
+  * **Campi di ricerca utilizzabili con la cattura barcode attiva** — Nella schermata ordine i campi di testo interni (es. ricerca varianti) risultavano di sola lettura perché il fuoco restava bloccato sulla cattura barcode; ora ricevono il fuoco normalmente e la cattura viene ripristinata quando nessun campo editabile è in uso.
+=== Prezzi, sconti e documenti ===
+  * **Prezzi scontati e sconti impilati** — Corretto lo sconto percentuale impilato calcolato su base errata con quantità maggiore di 1; il prezzo scontato è ora mostrato correttamente in comanda e nel TOTALE Ordinati; le dosi degli ingredienti (poco/abbondante) sono prezzate sul prezzo corretto (non più a zero).
+  * **Prezzi a zero e negativi al bar** — Corretto il prezzo prodotto impostato a 0 quando la calcolatrice integrata parte con un prezzo, e impedito l'inserimento di prezzi negativi (modifica prezzo limitata a quantità 1) nella vendita al bar.
+  * **Contatore fattura dopo nota di credito** — Il contatore documenti fattura viene sincronizzato con il cloud dopo l'emissione di una nota di credito (TD04), evitando lo sfasamento della numerazione tra locale e cloud.
+  * **Ristampa documento commerciale a cavallo della mezzanotte** — La data di ristampa usa ora l'ora locale, evitando che un documento creato poco prima di mezzanotte finisca nel giorno sbagliato.
+  * **Elenco documenti vuoto** — Rimosso un filtro fantasma che, con la nuova versione del database cloud, faceva restituire zero risultati nella gestione documenti.
+  * **Coupon** — Corretti il crash nella validità date, la lettura degli stati dei flag dal coupon salvato, la data di default a un mese e il loop di caricamento infinito nell'elenco.
+  * **Limite di spesa reparto ripristinato** — Ripristinata la totalizzazione dell'ordine prima del controllo del limite di reparto, altrimenti il blocco non scattava.
+=== Stampa ===
+  * **Stampa loghi a palette** — I loghi PNG con tavolozza indicizzata, che stampavano come blocco nero uniforme sulle stampanti raster, vengono convertiti in truecolor; corretta anche la risoluzione del logo del negozio e del logo sul display secondario per i riferimenti CDN.
+  * **Giorno della settimana localizzato in stampa** — Corretta la stampa del giorno che compariva in inglese (es. "TUESDAY" invece di "MARTEDI") a causa dei simboli data non inizializzati nell'isolate di stampa.
+=== Statistiche ===
+  * **Conteggio corretto dei conti divisi (split bill)** — Le statistiche di valore (Venduto, Media Giornaliera, Conti, Conto Medio, documenti stampati, elenco conti) sommano ora i totali a livello di riga/conto: in precedenza i conti divisi venivano conteggiati in modo errato perché le loro righe contengono solo segnaposto. Il grafico dei prodotti venduti non esclude più erroneamente gli articoli provenienti da conti divisi.
+  * **Filtri condivisi ed esclusioni coerenti** — Tutte le statistiche di vendita applicano un filtro comune che esclude righe tecniche (conti divisi, riempitivi ticket, mance) e righe di pagamento, scartando le fatture riepilogative dal conteggio documenti; Coperti e Coperto Medio considerano correttamente la quantità di coperto della riga.
+  * **Filtri statistiche per attività** — Corretti diversi problemi al cambio attività: il periodo ("Dall'ultima chiusura" / "Oggi") viene ricalcolato per l'attività selezionata, risolto il crash "Bad state: No element" sui widget personalizzati e sistemato il ripristino del filtro tornando su un'attività con chiusure.
+  * **Orari del filtro periodo in ora locale** — Gli orari della fascia personalizzata vengono mostrati e proposti in ora locale anziché in orario Zulu del backend.
+  * **Orari personalizzati non più azzerati** — Risolto un problema per cui gli orari del filtro periodo venivano riportati a 00:00 durante il ricalcolo dell'interfaccia, con l'intervallo scelto non applicato alla query.
+  * **Selezione del periodo affidabile su web** — Corretto un errore che, in versione web, poteva bloccare l'apertura del selettore "Periodo di interesse" al primo tocco.
+=== Importazioni e immagini (back office) ===
+  * **Blocco importazioni Excel/CSV/PDF su web** — Risolto il crash all'importazione di file Excel/CSV/PDF da web comparso dopo l'aggiornamento di Flutter (ripristinata la lettura dei byte del file e la gestione delle stringhe condivise duplicate nei file xlsx); corretto anche il crash "valore nullo" negli import clienti (CSV) e tessere (JSON).
+  * **"Cancella tutto" varianti non elimina più i formati** — La funzione "cancella tutto" nelle varianti non rimuove più erroneamente i formati (e viceversa), tenendo conto del tipo di elemento della sezione.
+  * **Immagini marketing e home senza duplicati obsoleti** — Alla sostituzione di un'immagine marketing la vecchia viene rimossa (niente più file orfani su S3/Gluster) e i nomi file usano un identificativo univoco per evitare che la CDN serva versioni obsolete.
+  * **Server immagini nelle licenze** — Entrando nella vista licenze anche l'URL delle immagini punta ora al server API selezionato.
+  * **Modifica menu annullabile** — Il menu viene modificato su una copia, così premendo "Indietro" le modifiche non salvate vengono scartate; mostrato inoltre l'interruttore di selezione manuale per i menu auto-selezionabili.
+=== Blocchi di sicurezza (back office) ===
+  * **Blocco eliminazione reparto in uso** — Non è più possibile eliminare un reparto di vendita referenziato nei prezzi di un articolo (viene mostrato l'elenco degli articoli interessati).
+  * **Blocco eliminazione tag in uso** — Non è più possibile eliminare un tag referenziato da un gruppo di varianti.
+  * **Campo riservato ai profili Trend** — Corretto un campo delicato che deve restare gestibile solo dai profili Trend.
+=== Avvio, stabilità e infrastruttura ===
+  * **Blocco all'avvio per lockout token cliente** — Su un rifiuto del token di refresh (401) i token scaduti vengono ripuliti, evitando il loop infinito di caricamento che bloccava l'accesso alla home (soprattutto su web).
+  * **Avvio con credenziali Trend su terminale registrato come client** — Risolto un problema specifico all'avvio del front-end con credenziali Trend su un terminale precedentemente registrato come client.
+  * **Notifiche perse su cluster di test secondari** — Corretto il riconoscimento dei cluster *-test: il mancato allineamento dei topic MQTT faceva perdere le notifiche push (es. il badge PRENOTAZIONI non si aggiornava).
+  * **Zucchetti Digital Hub** — Gli errori di rete transitori durante l'aggiornamento stato non vengono più registrati come permanenti; il documento viene ripreso al ciclo successivo.
+  * **Impostazioni per operatore sovrascritte** — Corretto il salvataggio che sovrascriveva le impostazioni app per singolo operatore.
+  * **Impostazione "area di tocco ampia" applicata all'avvio** — L'override dei gesti per l'area di tocco ampia veniva letto prima dell'inizializzazione del terminale e non applicato; ora viene letto dal valore persistito e applicato correttamente.
+  * **Dashboard block** — Corretta la lettura del terminale server (numero di serie) dalla Configurazione, così il POS locale non compare più nella propria lista di blocco.
+  * **Rotazione log su Windows** — All'avvio, se il file di log è già in uso da un altro processo (es. totem accanto a cassa), l'app ripiega in append invece di andare in crash.
+  * **Riavvii e crash minori** — Corretti: crash della configurazione "chi mi chiama" alla connessione MQTT, errore "numero di serie vuoto" nell'elenco terminali, errore di build del calendario prenotazioni, ordinamento errato dei sotto-ordini (BIS) nell'elenco tavoli e l'interruttore "manutenzione attiva".
+  * **Pipeline di build/firma Windows** — Risolti i problemi che impedivano la generazione dell'installer: selezione automatica del certificato corretto quando ne sono installati più d'uno, uso del nome binario corretto, individuazione di signtool anche fuori dal PATH ed esclusione del pacchetto MSIX dal payload dell'installer .exe.
 ===== v4.2.1 =====