Clienți legacy
HandyCafe poate administra instalări de clienți V3 și V4 alături de clienții moderni pe același server. Clienții legacy apar în Admin Panel ca un tip separat de card, cu un set redus de acțiuni care corespunde funcțiilor suportate de protocolul original.
Înainte să puteți vedea clienții legacy în Admin Panel, activați suportul runtime în Settings > Legacy Clients.
Cum apar clienții legacy
Clienții legacy se conectează la server prin protocolul original UDP multicast. Nu folosesc mDNS ca clienții moderni. În schimb, serverul îi descoperă în două moduri:
| Cale de descoperire | Declanșator |
|---|---|
| TCP Login | Clientul trimite un LoginRequest pe portul TCP de comenzi. Serverul înregistrează peer-ul și emite un eveniment de conectare. |
| UDP Ping | Clientul difuzează un cadru Ping pe grupul multicast. Serverul îl primește, actualizează înregistrarea peer-ului și emite un eveniment online. |
Starea per MAC este păstrată într-un depozit de clienți legacy, împreună cu IP-ul, hostname-ul, utilizatorul autentificat, cronometrele sesiunii și un timestamp pentru ultimul contact. Fiecare cadru intrat resetează timerul de inactivitate. Dacă timerul expiră fără trafic (implicit 10 secunde), clientul este marcat offline. Înregistrarea rămâne în baza de date, astfel încât istoricul să nu se piardă.
Cardul clientului legacy
Fiecare client legacy este afișat ca un card distinct de cardurile clienților moderni. Antetul afișează numele afișat (hostname când este disponibil, MAC când nu), o insignă online sau offline colorată și o etichetă de stare.
Culorile și etichetele de stare
| Stare | Culoare | Semnificație |
|---|---|---|
| Online | Verde | Rulează o sesiune activă. |
| Idle | Cyan | Clientul este conectat și așteaptă. Nu există sesiune activă. |
| Paused | Amber | Sesiunea este pusă pe pauză. Facturarea este oprită. |
| Busy | Purple | Clientul procesează o cerere. |
| Payment | Rose | Clientul se află într-un flux de plată. |
| Admin | Indigo | Clientul este în modul de administrare sau mentenanță. |
| Offline | Gray | Nu a existat trafic recent. Acțiunile sunt dezactivate până când clientul revine online. |
| Timed | Sky | Rulează o sesiune limitată în timp, cu termen. |
Cronometrul sesiunii
Când o sesiune este activă, cardul afișează un bloc de cronometru:
- Ora de început.
- Ora de sfârșit (pentru sesiunile cu durată limitată).
- Minute utilizate.
- Minute rămase cu numărătoare inversă live.
- Costul acumulat.
Informații de identitate
Cardul afișează mereu:
- Adresa MAC.
- Adresa IP.
- Versiunea clientului (de exemplu "3.4.01").
- Utilizatorul autentificat, dacă există.
Bara de acțiuni
Când clientul este online, o bară de acțiuni de sub informațiile de identitate oferă operațiile disponibile.
Controlul sesiunii
| Buton | Vizibil când | Comportament |
|---|---|---|
| Login | Starea este idle | Deschide dialogul Device Login. Selectați minutele și metoda de plată. Serverul trimite o comandă Login cu valorile alese. Sesiunea pornește pe client. |
| Logout | Starea este online, timed, paused, busy sau payment | Dacă sesiunea este postpaid, un dialog de plată colectează suma și metoda. O tranzacție este scrisă în registru. Serverul trimite o comandă Logout. Sesiunea se încheie pe client. |
Add Time
Deschide un selector de minute. Acceptă valori pozitive (extindere) sau negative (reducere). Magnitudinea maximă este 10.000 de minute în ambele direcții. Funcționează atât pentru sesiunile prepaid, cât și pentru cele postpaid.
Dacă ați configurat valori presetate de minute în setările de tarifare, cardul afișează și un rând de butoane presetate. Atingeți un preset pentru a aplica valoarea fără a deschide selectorul.
Screenshot
Cere o captură de ecran live de la clientul legacy prin portul de transfer de fișiere. Fluxul este:
- Serverul trimite o comandă de cerere pentru captură.
- Clientul deschide un ascultător TCP de scurtă durată pe un port efemer.
- Serverul se conectează, trimite un antet de transfer de fișiere de 9 bytes și așteaptă.
- Clientul capturează ecranul, îl encodează ca BMP comprimat și îl transmite înapoi.
- Serverul decompresă BMP-ul și îl stochează în folderul
legacy_screenshotsdin directorul de date HandyCafe. - Vizualizatorul de capturi se deschide cu imaginea nouă.
Dacă clientul nu răspunde în intervalul de timeout (implicit 30 de secunde pentru conectare, 20 de secunde pentru date), cererea eșuează și apare un toast de eroare. Puteți încerca din nou imediat.
Acțiuni de alimentare
| Acțiune | Confirmare | Efect |
|---|---|---|
| Logoff | Nu | Deloghează utilizatorul Windows de pe mașina client. Sesiunea Windows se încheie, dar computerul rămâne pornit. |
| Reboot | Da | Trimite o comandă de repornire. Mașina client se restartează. |
| Shutdown | Da | Trimite o comandă de oprire. Mașina client se închide. |
Reboot și Shutdown afișează un dialog de confirmare pentru a preveni acțiunile de alimentare accidentale.
Operații neacceptate
Clienții legacy nu suportă toate funcțiile disponibile pe clienții moderni HandyCafe. Lipsuri importante:
- Fără ajustări de pauză în mijlocul sesiunii. Modificările de timp trimise cât timp sesiunea este în pauză sunt puse în coadă, dar clientul le poate ignora. Reluați sesiunea mai întâi, aplicați modificarea, apoi puneți din nou pe pauză dacă este nevoie.
- Fără mod Admin prin comandă de la server. Starea internă de admin a clientului nu poate fi comutată de pe server. Modul Admin este controlat doar pe mașina client.
- Fără înregistrare de licență de la server. Serverul oglindește bytes-ii de licență pe care îi vede în cadrele clientului, dar nu poate împinge o licență nouă către client. Înregistrați clientul local.
- Fără integrare de portofel pentru membrii pe sesiunile pornite de clienții legacy. Plățile sunt înregistrate ca rânduri simple
transactionscutransaction_type=sessionsși MAC-ul clientului. Fluxurile moderne de portofel nu se aplică. - Fără desktop la distanță. Funcția de desktop la distanță folosește o cale de streaming UDP care nu există în clienții legacy.
- Fără push de sincronizare fișiere. Sync Explorer trimite fișiere doar prin protocolul modern.
Pentru funcționalitate completă, migrați la clienții moderni HandyCafe când este posibil.
Comportamentul offline
Când expiră timeout-ul de inactivitate, cardul se estompează, insigna de stare devine gri, iar fiecare buton de acțiune este dezactivat. Înregistrarea clientului rămâne în depozit, astfel încât istoricul, MAC-ul, hostname-ul și ultimele date văzute să fie păstrate. Când clientul revine online (un nou UDP ping sau un TCP login), cardul revine la viață și acțiunile devin din nou disponibile.
Înregistrarea nu este eliminată automat. Pentru a șterge definitiv un client vechi, editați-l din baza de date admin sau eliminați-l prin instrumentul administrativ relevant.
Sfaturi
- Păstrați timeout-ul de inactivitate la 10 secunde, cu excepția cazului în care știți că clienții legacy transmit beacon mai lent. Un timeout mai scurt marchează incorect clienții sănătoși ca offline în timpul unor scurte probleme de rețea.
- Dacă un client legacy apare online, dar nu răspunde la comenzi, confirmați Protocol Variant în Settings. O neconcordanță între varianta serverului (STE vs Standard) și build-ul clientului duce la căderi silențioase ale comenzilor.
- Capturile de ecran de la clienții legacy sunt BMP-uri comprimate, mai mari decât capturile PNG moderne. Păstrați folderul
legacy_screenshotspe un disc cu suficient spațiu liber dacă faceți multe capturi. - Folosiți Add Time cu butoane presetate în timpul schimburilor de tură. O singură atingere extinde sesiunea cu un increment predefinit, ceea ce este mai rapid decât introducerea manuală a minutelor.
- Retrageți clienții legacy treptat. Migrați câte un lot, confirmați că noii clienți funcționează identic în Admin Panel și abia apoi scoateți din uz sistemele vechi.