Manual de utilizare pentru utilizatori și administratori de sistem
Drag to rotate • Scroll to zoom • Right-click to move
Metrici Document Scanner este un terminal hardware dezvoltat de Metrici pentru înregistrarea automată a vizitatorilor, transportatorilor și livratorilor la punctele de acces ale unei locații. Dispozitivul folosește o cameră integrată pentru a captura și extrage informații din documente de identitate (cărți de identitate și pașapoarte) și documente de transport (facturi, AWB-uri). De asemenea, se integrează cu sistemul Metrici LPR (License Plate Recognition) pentru a asocia fiecare vizitator cu numărul de înmatriculare al vehiculului.
Toate datele capturate — date personale, imagini ale documentelor, numere de înmatriculare și documente de transport — sunt transmise către aplicația web Metrici Visitor Journal prin apeluri REST API. Din Visitor Journal, administratorii pot revizui, aproba și gestiona toate înregistrările vizitatorilor dintr-un panou centralizat.
Dispozitivul utilizează un model LLM (Large Language Model) bazat pe inteligență artificială pentru a extrage date structurate din imaginile documentelor, suportând multiple formate și limbi. Ecranul tactil integrat ghidează fiecare utilizator printr-un proces de înregistrare simplu, pas cu pas, disponibil în 15 limbi.
Caracteristici principale:
| Specificație | Detalii |
|---|---|
| Descriere | Terminal de scanare documente pentru înregistrare vizitatori cu integrare LPR |
| Tipuri de documente | Cărți de identitate, pașapoarte, facturi, AWB-uri |
| Motor AI | Extracție date bazată pe LLM (model configurabil, implicit: qwen3vl) |
| Conectivitate | Ethernet 10/100/1000 Mbps (RJ45) |
| Alimentare | PoE+ (Power over Ethernet Plus, IEEE 802.3at minim) — alimentare și date printr-un singur cablu. PoE standard (802.3af) nu este suficient. |
| Ecran | Ecran tactil integrat cu flux de lucru ghidat |
| Cameră | Cameră integrată de înaltă rezoluție pentru documente |
| Limbi | 15 (engleză, română, bulgară, maghiară, poloneză, sârbă, ucraineană, turcă, croată, franceză, italiană, spaniolă, portugheză, germană, olandeză) |
| Integrare | Metrici Visitor Journal (REST API), Metrici LPR |
| Configurare | Interfață web accesibilă la adresa IP a dispozitivului |
| Câmpuri extrase | Număr CNP, Tip Document, Număr de serie, Data nașterii, Nume, Prenume, Naționalitate, Sex |
| Repornire automată | Interval configurabil (implicit 20 secunde) — revine la ecranul de start după finalizarea sesiunii |
Document Scanner urmează un flux ghidat pas cu pas pentru fiecare vizitator sau transportator:
Metrici Document Scanner este alimentat prin PoE+ (Power over Ethernet Plus). Un singur cablu Ethernet furnizează atât alimentarea electrică, cât și conexiunea la rețea — nu este necesar un alimentator separat. Conectați dispozitivul la un switch compatibil PoE+ sau un injector PoE+ folosind un cablu Ethernet standard RJ45, iar dispozitivul va porni și se va conecta la rețea simultan.
La pornirea dispozitivului, primul ecran afișat este cel de selectare a limbii — vezi Fig.1 Selectare limbă. Vizitatorul selectează limba preferată apăsând pe steagul corespunzător. Întreaga interfață (instrucțiuni, butoane și mesaje) va fi afișată în limba aleasă pe toată durata sesiunii.
Limbi disponibile: engleză, română, bulgară, maghiară, poloneză, sârbă, ucraineană, turcă, croată, franceză, italiană, spaniolă, portugheză, germană și olandeză.
Dispozitivul se configurează printr-o interfață web accesibilă la adresa IP a dispozitivului, din orice browser conectat la aceeași rețea. Pagina de configurare are trei tab-uri: Admin Settings, Application Settings și Network Settings.
Pentru a accesa meniul de administrare pe dispozitiv, atingeți zona de jos a ecranului cu degetul (pe dispozitiv) sau faceți click cu mouse-ul (în browser) de 8 ori consecutiv — vezi Fig.1 Selectare limbă (1). După a 8-a apăsare, panoul Admin Settings va apărea.
Tab-ul Admin Settings vă permite să setați sau să schimbați parola de administrator folosită pentru accesarea interfeței de configurare — vezi Fig.2 Admin Settings.
Introduceți o parolă nouă în câmpul New Admin Password și apăsați Salvează. Lăsați câmpul gol pentru a păstra parola curentă. Apăsați Ieșire pentru a reveni la aplicația principală fără a salva.
Tab-ul Application Settings conține toate endpoint-urile API și parametrii operaționali — vezi Fig.3 Application Settings.
| Câmp | Descriere | Exemplu |
|---|---|---|
| Request Access URL | Endpoint-ul API al Metrici Visitor Journal pentru trimiterea cererilor de acces | http://IP_ADDRESS/api_v2/vj/event_receiver.php |
| LLM API URL | Endpoint-ul serviciului AI utilizat pentru extragerea datelor din documente | http://LLM_ADDRESS:PORT/v1/chat/completions |
| Plate Number URL | Endpoint-ul API Metrici LPR pentru obținerea ultimului număr de înmatriculare recunoscut | http://IP_ADDRESS/api_v2/lpr/get_last_plate.php?camera_id=2 |
| LLM Model | Modelul AI utilizat pentru recunoașterea documentelor | qwen3vl |
| Destinations URL | Endpoint-ul API pentru obținerea listei de destinații disponibile | http://IP_ADDRESS/api_v2/vj/get_destinations.php?location_id=1 |
| Restart Delay (seconds) | Câte secunde așteaptă dispozitivul înainte de a reveni la ecranul de start după finalizarea unei sesiuni | 20 |
Înainte de a salva, înlocuiți cu valorile corecte pentru configurația dumneavoastră următoarele:
| Substituent | Descriere |
|---|---|
IP_ADDRESS |
Adresa IP reală a serverului dumneavoastră Metrici. |
LLM_ADDRESS:PORT |
Adresa și portul serviciului LLM. |
camera_id= |
ID-ul camerei (din aplicația web) care detectează plăcuțele de înmatriculare. |
location_id= |
ID-ul locației. Deschideți locația în aplicația web și citiți ID-ul din URL — de exemplu, în http://localhost/pages/view_location/2, ID-ul locației este 2. |
Asigurați-vă că toate URL-urile sunt accesibile din rețeaua dispozitivului, apoi apăsați Salvează pentru a aplica modificările.
Tab-ul Network Settings afișează informațiile curente ale interfeței Ethernet — vezi Fig.4 Network Settings.
| Câmp | Descriere |
|---|---|
| Interface | Numele interfeței de rețea (ex: eth0) |
| IP Address | Adresa IP curentă atribuită dispozitivului |
| MAC Address | Adresa MAC hardware a adaptorului Ethernet |
Pentru a accesa interfața de configurare, deschideți un browser pe aceeași rețea și navigați la adresa IP a dispozitivului.
Configurarea completă a dispozitivului este accesibilă de la distanță din orice browser — nu aveți nevoie de acces fizic la dispozitiv pentru a modifica setările. Pentru conectare:
192.168.100.133, navigați la:http://192.168.100.133
Pagina de configurare se va încărca, oferindu-vă acces la toate cele trei tab-uri de setări (Admin Settings, Application Settings, Network Settings) fără a fi nevoie să fiți fizic la dispozitiv.
Metrici Visitor Journal este aplicația web în care sunt gestionate toate înregistrările vizitatorilor, transportatorilor și livratorilor. Această secțiune explică cum se configurează Visitor Journal pentru a funcționa cu Document Scanner.
Mai întâi, camera trebuie configurată în motorul LPR și să fie complet operațională înainte de a continua. Documentația este disponibilă aici: License Plate Recognition.
După configurarea camerei, trebuie să o adăugați în Aplicația Web Metrici. Puteți afla cum să adăugați o cameră urmând documentația Locații și Camere. Tipul camerei trebuie setat pe ID card reader — acest lucru este esențial, altfel integrarea cu Document Scanner nu va funcționa.
Odată ce un document este scanat, persoana este adăugată automat în baza de date cu toate informațiile extrase din cartea de identitate sau pașaport — inclusiv nume, CNP (Cod Numeric Personal), data nașterii, naționalitate și sex — vezi Fig.4.1 Persoane.
Din pagina People, administratorii pot edita sau șterge înregistrările vizitatorilor și pot vedea câte cărți de identitate au fost scanate pentru fiecare persoană. Fiecare înregistrare este creată automat de Document Scanner — nu este necesară introducerea manuală a datelor.
De asemenea, puteți genera un raport pentru a vedea ce persoane au intrat în locație într-un anumit interval de timp. Utilizați pagina Events pentru a filtra după dată, cameră, locație, tip eveniment, destinație sau CNP — vezi Fig.4.2 Evenimente.
Evenimentele pot fi exportate ca fișiere PDF, Excel sau CSV folosind butoanele de export din partea de sus a paginii. Panoul de detalii din dreapta afișează imaginea cărții de identitate scanate, datele personale și orice documente de transport atașate (facturi, AWB-uri) pentru evenimentul selectat.
Document Scanner comunică cu platforma Metrici prin mai multe endpoint-uri REST API. Toate URL-urile sunt configurabile din Application Settings. Înlocuiți IP_ADDRESS cu adresa IP reală a serverului Metrici.
| Proprietate | Detalii |
|---|---|
| Endpoint | http://IP_ADDRESS/api_v2/vj/event_receiver.php |
| Metodă | POST |
| Content-Type | application/json (cu imagini codificate base64) |
| Scop | Trimite o înregistrare completă de vizitator/transportator/livrator către Visitor Journal |
| Proprietate | Detalii |
|---|---|
| Endpoint | http://IP_ADDRESS/api_v2/lpr/get_last_plate.php?camera_id=2 |
| Metodă | GET |
| Scop | Obține ultimul număr de înmatriculare recunoscut de camera LPR conectată |
| Proprietate | Detalii |
|---|---|
| Endpoint | http://IP_ADDRESS/api_v2/vj/get_destinations.php?location_id=1 |
| Metodă | GET |
| Scop | Obține lista destinațiilor disponibile în incintă pentru selectorul dropdown |
| Proprietate | Detalii |
|---|---|
| Endpoint | http://LLM_ADDRESS:PORT/v1/chat/completions |
| Metodă | POST |
| Scop | Trimite imaginea unui document capturat către modelul AI pentru extragerea structurată a datelor |
| Model | Configurabil (implicit: qwen3vl) |
Dispozitivul trimite imaginea documentului capturat către serviciul LLM, care utilizează recunoaștere vizuală pentru a identifica și extrage câmpuri structurate (nume, CNP, număr de serie, data nașterii, naționalitate, sex, tip document). Modelul returnează un răspuns JSON cu toate câmpurile extrase.
După selectarea limbii, utilizatorul este prezentat cu trei opțiuni de rol — vezi Fig.5 Selectare rol:
Apăsarea butonului Anulează revine la ecranul de selectare a limbii.
Sistemul citește automat numărul de înmatriculare al vehiculului folosind motorul Metrici LPR integrat. Numărul recunoscut este afișat pe ecran pentru confirmare — vezi Fig.6 Confirmare număr auto.
Trei opțiuni sunt disponibile:
http://IP_ADDRESS/api_v2/lpr/get_last_plate.php?camera_id=2 pentru a obține ultimul număr de înmatriculare recunoscut de camera LPR conectată. Numărul este apoi afișat pentru confirmarea utilizatorului înainte de a continua.
Utilizatorul este invitat să plaseze cartea de identitate sau pașaportul pe tava de documente — vezi Fig.7 Scanare CI. Camera integrată captează o imagine a documentului.
Utilizatorul apasă Capturează și extrage datele din cartea de identitate sau pașaport pentru a face fotografia. Imaginea capturată este apoi trimisă către API-ul LLM pentru extragerea datelor prin inteligență artificială.
După ce AI-ul procesează imaginea documentului, datele extrase sunt afișate pentru verificare — vezi Fig.8 Date extrase. Următoarele câmpuri sunt extrase:
| Câmp | Descriere |
|---|---|
| Număr CNP | Cod Numeric Personal |
| Tip Document | IDENTITY CARD sau PASSPORT |
| Număr de serie | Seria și numărul documentului |
| Data nașterii | Data de naștere |
| Nume | Numele de familie |
| Prenume | Prenumele |
| Naționalitate | Naționalitatea așa cum apare pe document |
| Sex | M sau F |
Trei acțiuni sunt disponibile:
Pentru rolurile Transportator și Livrator, este disponibil un pas suplimentar pentru scanarea documentelor de transport precum AWB-uri, facturi sau chitanțe de livrare. Aceste documente sunt capturate de aceeași cameră integrată și atașate la înregistrarea vizitatorului — vezi Fig.8b Scanare documente de călătorie.
Documentele scanate apar în panoul Documente de călătorie alături de datele din CI / Pașaport în ecranul de sumar. Fiecare pagină de document este numerotată și clasificată (ex: „Invoice 2458842").
Înainte de a solicita accesul, utilizatorul vede un sumar complet al tuturor datelor capturate — vezi Fig.9 Ecran sumar. Acest ecran afișează:
Două acțiuni sunt disponibile:
Utilizatorul selectează destinația din incintă dintr-o listă dropdown — vezi Fig.10 Selectare destinație. Lista destinațiilor disponibile este preluată din API-ul Metrici Visitor Journal.
După selectarea destinației, apăsați Solicită acces pentru a trimite toate datele către Metrici Visitor Journal.
http://IP_ADDRESS/api_v2/vj/event_receiver.php conținând toate datele colectate: numarul de inmatriculare ,date personale, imagini documente, documente de transport și destinația selectată. Aplicația web Metrici procesează cererea și acordă sau refuză accesul.
Dacă cererea de acces este aprobată, un mesaj verde de confirmare este afișat — vezi Fig.11 Acces acordat.
Ecranul afișează „Accesul este acordat! Vă rugăm să intrați în locație. Mulțumesc!" împreună cu un cronometru de numărătoare inversă. După intervalul configurat de repornire (implicit: 20 secunde), dispozitivul revine automat la ecranul de selectare a limbii, pregătit pentru următorul vizitator.
http://192.168.100.133).