Panou de control

Panoul de control este pagina pe care o vezi imediat după autentificarea în Portal, la /portal/dashboard. Este o privire de ansamblu pe un singur ecran, doar pentru ziua curentă, a stării afacerii: câte dispozitive fiscale ai, câte sunt online chiar acum, câte bonuri au fost emise până acum astăzi și ce venituri însumează acestea. Rolul ei este să răspundă în două secunde la întrebarea "este totul în regulă și sună casa de marcat?" - orice analiză mai în detaliu se face pe paginile dedicate Bonuri, Dispozitive sau Rapoarte.

Tot ce vezi pe panou este restrâns la organizația activă aleasă din comutatorul de organizații. Pentru utilizatorii al căror rol nu este Owner sau Admin (de obicei manageri legați de un singur magazin), datele sunt restrânse automat și la locația lor atribuită, astfel încât un șef de tură vede doar propria casă de marcat.

Cele patru carduri KPI

Rândul de sus al panoului afișează patru numere principale, în această ordine:

• Dispozitive — numărul total de dispozitive fiscale înregistrate în organizația activă.
• Bonuri astăzi — câte bonuri au fost emise astăzi (după ora serverului).
• Venituri astăzi — suma totalurilor acelor bonuri, formatată în RON.
• Dispozitive online — câte dintre dispozitivele tale sunt în acest moment Online (controler conectat și AMEF accesibil).

Panoul aduce bonurile de astăzi cu o limită strictă de 100 de rânduri pe cerere. Când au fost emise mai mult de 100 de bonuri astăzi, cardul Bonuri astăzi afișează 100+, iar Venituri astăzi este suma totalurilor doar pentru acele prime 100 de bonuri. Pentru totaluri exacte pe zi, săptămână sau lună, deschide Rapoarte și citește live istoricul Z al dispozitivului — memoria fiscală este sursa de adevăr — sau filtrează pagina Bonuri după dată.

Starea inițială (zero state)

Când organizația ta nu are încă niciun dispozitiv înregistrat și niciun bon pentru ziua curentă, panoul intră în starea inițială:

• Toate cele patru carduri KPI afișează o linie de pauză (-) în loc de un număr, cu tooltip-ul "Adaugă primul dispozitiv pentru a vedea date."
• Cardul de onboarding Configurează E-BON apare în partea de sus a paginii, cu cei patru pași pentru a aduce online primul dispozitiv fiscal.

Parcurge acești pași o singură dată, iar starea inițială dispare de la sine în momentul în care aplicația controler revendică dispozitivul:

Actualizări în timp real și polling de rezervă la 30 de secunde

Panoul se abonează la același flux de evenimente în timp real folosit de restul Portalului. Când conexiunea WebSocket este activă, cele patru KPI-uri și cele trei panouri laterale se actualizează live pe măsură ce sosesc evenimentele - un bon nou-emis adaugă un rând în vârful listei Activitate recentă și incrementează Bonuri astăzi / Venituri astăzi, o schimbare de status actualizează badge-ul și ultima activitate ale dispozitivului respectiv, iar conectarea sau deconectarea unui telefon controler adaugă sau elimină un rând din panoul Controllere.

Dacă WebSocket-ul nu este conectat (tab-ul s-a trezit din somn, o întrerupere scurtă de rețea, un proxy capricios), panoul trece automat pe polling: re-aduce dispozitivele, bonurile de astăzi, controllerele și statusurile dispozitivelor la fiecare 30 de secunde. Polling-ul se oprește în momentul în care WebSocket-ul se reconectează, astfel încât pagina nu încarcă niciodată de două ori. Pentru imaginea completă a comunicării dintre Portal, App și API, vezi prezentarea generală a arhitecturii.

Panoul Activitate recentă

Primul dintre cele trei panouri inferioare afișează ultimele 5 bonuri ale zilei, cele mai noi primele. Fiecare rând arată numele dispozitivului, ora la care a fost emis bonul, primele 8 caractere din identificatorul bonului și totalul în RON.

Când astăzi nu există încă niciun bon, panoul afișează indiciul de stare goală "Bonurile emise astăzi vor apărea aici." și un buton Vezi bonurile care te duce la pagina completă Bonuri, unde poți parcurge istoricul și filtra după dată, dispozitiv sau locație.

Panoul Starea dispozitivelor

Panoul din mijloc este o listă compactă a tuturor dispozitivelor fiscale din organizația activă, cu numele, un timestamp relativ pentru ultima activitate și badge-ul de status curent. Timestamp-ul relativ folosește una dintre aceste etichete:

• Chiar acum - în ultimul minut.
• acum {X}m - minute.
• acum {X}h - ore.
• acum {X}z - zile.
• Niciodată - dispozitivul nu a raportat niciodată.
• Necunoscut - datele despre ultima activitate lipsesc.

Un punct mic care pulsează în fața badge-ului de status indică faptul că WebSocket-ul controlerului este conectat în acest moment la cloud (independent de statusul AMEF în sine).

Când organizația nu are încă niciun dispozitiv, panoul afișează indiciul "Niciun dispozitiv înregistrat." și un buton Adaugă dispozitiv care te duce la pagina Dispozitive.

Panoul Controllere

Al treilea panou listează fiecare controller E-BON conectat în acest moment la cloud pentru această organizație. Pentru fiecare controller vezi:

• Numele dispozitivului - numele prietenos raportat de telefonul sau tableta controler.
• Versiunea aplicației - versiunea aplicației E-BON pe care o rulează.
• Hardware-ul și versiunea de Android - modelul telefonului sau tabletei controler și versiunea de Android pe care o rulează.
• Conectat de - de cât timp este controlerul online, măsurat din momentul conectării.
• Imprimante conectate - ce imprimante fiscale controlează acest controler în acest moment.

Fiecare rând poartă un badge verde Online cât timp sesiunea WebSocket este activă; rândul dispare în momentul în care controlerul se delogă sau socket-ul se închide.

Când niciun controler nu este conectat, panoul afișează „Niciun controller E-BON conectat.” alături de un buton Configurare. Ești nou în E-BON? Începe cu ghidul de instalare a aplicației.

Pași următori

• Gestionează hardware-ul fiscal care alimentează aceste numere - ghidul Dispozitive.
• Intră în detaliile vânzărilor individuale - pagina Bonuri.
• Citește totalurile zilnice oficiale (istoricul Z) live de pe dispozitive - pagina Rapoarte.
• Organizează dispozitivele între magazine - ghidul Locații.
• Conectează integrări la fluxul de evenimente live folosit de panou - ghidul Chei API.
• Adu primul dispozitiv online de la cap la coadă - ghidul de integrare.