Clienti Legacy

HandyCafe può gestire installazioni client V3 e V4 insieme ai client moderni sullo stesso server. I client legacy appaiono nel Pannello di Amministrazione come un tipo di scheda a sé stante, con un set di azioni ridotto che corrisponde a ciò che supporta il protocollo originale.

Prima di poter vedere i client legacy nel Pannello di Amministrazione, abilita il supporto runtime in Impostazioni > Clienti Legacy.

Come Appaiono i Clienti Legacy

I client legacy si connettono al server tramite il protocollo multicast UDP originale. Non usano mDNS come i client moderni. Invece, il server li scopre in due modi:

Percorso di Scoperta	Trigger
Login TCP	Il client invia una LoginRequest sulla porta di comando TCP. Il server registra il peer ed emette un evento di connessione.
Ping UDP	Il client trasmette un frame di Ping sul gruppo multicast. Il server lo riceve, aggiorna il record del peer ed emette un evento online.

Lo stato per-MAC è mantenuto in un archivio client legacy con IP, nome host, utente connesso, versione del client, timer di sessione e un timestamp dell'ultima visualizzazione. Ogni frame in entrata reimposta il timer di inattività. Se il timer scade senza traffico (predefinito 10 secondi), il client viene segnato come offline. Il record persiste nel database per non perdere la cronologia.

La Scheda del Client Legacy

Ogni client legacy viene visualizzato come una scheda distinta dalle schede dei client moderni. L'intestazione mostra il nome visualizzato (nome host quando disponibile, MAC quando non lo è), un badge online o offline con colore e un'etichetta di stato.

Colori e Etichette di Stato

Stato	Colore	Significato
Online	Verde	È in corso una sessione attiva.
Idle	Ciano	Il client è connesso e in attesa. Nessuna sessione attiva.
Paused	Ambra	La sessione è in pausa. La fatturazione è sospesa.
Busy	Viola	Il client sta elaborando una richiesta.
Payment	Rosa	Il client è in un flusso di pagamento.
Admin	Indaco	Il client è in modalità amministrativa o di manutenzione.
Offline	Grigio	Nessun traffico recente. Le azioni sono disabilitate fino a quando il client non torna online.
Timed	Celeste	È in corso una sessione a tempo limitato con una scadenza.

Orologio della Sessione

Quando una sessione è attiva, la scheda visualizza un blocco orologio:

Ora di inizio.
Ora di fine (per sessioni a tempo limitato).
Minuti utilizzati.
Minuti rimanenti con un conto alla rovescia in tempo reale.
Costo accumulato.

Informazioni di Identità

La scheda mostra sempre:

Indirizzo MAC.
Indirizzo IP.
Versione del client (ad esempio "3.4.01").
Utente connesso, se presente.

Barra degli Strumenti delle Azioni

Quando il client è online, una barra degli strumenti delle azioni sotto le informazioni di identità offre le operazioni disponibili.

Controllo della Sessione

Pulsante	Visibile Quando	Comportamento
Login	Stato è idle	Apre la finestra di dialogo di Login del Dispositivo. Seleziona minuti e metodo di pagamento. Il server invia un comando di Login con i valori scelti. La sessione inizia sul client.
Logout	Stato è online, timed, paused, busy, o payment	Se la sessione è postpagata, una finestra di dialogo di pagamento raccoglie l'importo e il metodo. Una transazione viene scritta nel registro. Il server invia un comando di Logout. La sessione si chiude sul client.

Aggiungi Tempo

Apre un selettore di minuti. Accetta valori positivi (estendi) o negativi (detrarre). La magnitudine massima è di 10.000 minuti in entrambe le direzioni. Funziona per sessioni sia prepagate che postpagate.

Se hai configurato valori di minuti preimpostati nelle tue impostazioni di prezzo, la scheda mostra anche una fila di pulsanti preimpostati. Tocca un preimpostato per applicare il valore senza aprire il selettore.

Screenshot

Richiede uno screenshot live dal client legacy tramite la porta di trasferimento file. Il flusso è:

Il server invia un comando di richiesta screenshot.
Il client apre un listener TCP a breve termine su una porta effimera.
Il server si connette, invia un'intestazione di trasferimento file di 9 byte e attende.
Il client cattura lo schermo, lo codifica come BMP compresso e lo trasmette indietro.
Il server decomprime il BMP e lo memorizza nella cartella legacy_screenshots sotto la tua directory dati di HandyCafe.
Il visualizzatore di screenshot si apre con la nuova immagine.

Se il client non risponde entro il timeout (predefinito 30 secondi per connettersi, 20 secondi per i dati), la richiesta fallisce e appare un messaggio di errore. Puoi riprovare immediatamente.

Azioni di Alimentazione

Azione	Conferma	Effetto
Logoff	Nessuna	Disconnette l'utente di Windows sulla macchina client. La sessione di Windows termina ma il computer rimane acceso.
Reboot	Sì	Invia un comando di riavvio. La macchina client si riavvia.
Shutdown	Sì	Invia un comando di spegnimento. La macchina client si spegne.

Reboot e Shutdown mostrano una finestra di dialogo di conferma per prevenire azioni di alimentazione accidentali.

Operazioni Non Supportate

I client legacy non supportano tutte le funzionalità disponibili sui client moderni di HandyCafe. Principali lacune:

Nessuna regolazione di pausa a metà sessione. Le modifiche al tempo inviate mentre la sessione è in pausa sono messe in coda ma il client potrebbe ignorarle. Riprendi prima la sessione, applica la modifica, quindi metti di nuovo in pausa se necessario.
Nessuna modalità Admin tramite comando server. Lo stato amministrativo interno del client non può essere attivato dal server. La modalità Admin è controllata solo sulla macchina client stessa.
Nessuna registrazione della licenza dal server. Il server rispecchia i byte di licenza che vede nei frame del client ma non può inviare una nuova licenza al client. Registra il client localmente.
Nessuna integrazione del portafoglio membro per le sessioni avviate su client legacy. I pagamenti sono registrati come righe transactions semplici con transaction_type=sessions e il MAC del client. I flussi di portafoglio moderni non si applicano.
Nessun desktop remoto. La funzione di desktop remoto utilizza un percorso di streaming UDP non presente nei client legacy.
Nessuna sincronizzazione file push. Sync Explorer invia file solo tramite il protocollo moderno.

Per una funzionalità completa, migra ai client moderni di HandyCafe quando possibile.

Comportamento Offline

Quando il timeout di inattività scade, la scheda si oscura, il badge di stato diventa grigio e ogni pulsante di azione è disabilitato. Il record del client rimane nell'archivio in modo che la cronologia, il MAC, il nome host e i dati dell'ultima visualizzazione siano preservati. Quando il client torna online (nuovo ping UDP o login TCP), la scheda si riattiva e le azioni diventano di nuovo disponibili.

Il record non viene rimosso automaticamente. Per rimuovere definitivamente un vecchio client, modificalo dal database di amministrazione o eliminalo tramite lo strumento di amministrazione pertinente.

Consigli

Mantieni il timeout di inattività a 10 secondi a meno che tu non sappia che i tuoi client legacy trasmettono più lentamente. Un timeout più breve segna erroneamente i client sani come offline durante brevi interruzioni di rete.
Se un client legacy appare online ma non risponde ai comandi, conferma la Variante del Protocollo nelle Impostazioni. Una discrepanza tra la variante del server (STE vs Standard) e la build del client causa la perdita silenziosa dei comandi.
Gli screenshot dai client legacy sono BMP compressi, che sono più grandi delle catture PNG moderne. Mantieni la cartella legacy_screenshots su un'unità con spazio libero adeguato se fai molte catture.
Usa Aggiungi Tempo con i pulsanti preimpostati durante i cambi turno. Un solo tocco estende una sessione di un incremento predefinito, che è più veloce che digitare manualmente i minuti.
Ritira gradualmente i client legacy. Migra un lotto alla volta, conferma che i nuovi client funzionino in modo identico nel Pannello di Amministrazione, e solo allora dismetti i vecchi.