English Română

Drag to rotate • Scroll to zoom • Right-click to move

Bun venit! Acest ghid acoperă tot ce aveți nevoie pentru a configura și opera Metrici Document Scanner. Dispozitivul scanează documente de identitate (cărți de identitate și pașapoarte), primește numere de înmatriculare de la motorul Metrici LPR și procesează documente de transport precum AWB-uri și facturi. Toate datele capturate sunt trimise către aplicația Web Metrici (găsite in secțiunea „Visitor Journal") pentru gestionarea centralizată a vizitatorilor și transportatorilor.

Cuprins

  1. Introducere
  2. Prima pornire
  3. Setări
  4. Visitor Journal
  5. Referință API
  6. Fluxul utilizatorului
  7. Depanare

1. Introducere

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:

Date tehnice

SpecificațieDetalii
DescriereTerminal de scanare documente pentru înregistrare vizitatori cu integrare LPR
Tipuri de documenteCărți de identitate, pașapoarte, facturi, AWB-uri
Motor AIExtracție date bazată pe LLM (model configurabil, implicit: qwen3vl)
ConectivitateEthernet 10/100/1000 Mbps (RJ45)
AlimentarePoE+ (Power over Ethernet Plus, IEEE 802.3at minim) — alimentare și date printr-un singur cablu. PoE standard (802.3af) nu este suficient.
EcranEcran tactil integrat cu flux de lucru ghidat
CamerăCameră integrată de înaltă rezoluție pentru documente
Limbi15 (engleză, română, bulgară, maghiară, poloneză, sârbă, ucraineană, turcă, croată, franceză, italiană, spaniolă, portugheză, germană, olandeză)
IntegrareMetrici Visitor Journal (REST API), Metrici LPR
ConfigurareInterfață web accesibilă la adresa IP a dispozitivului
Câmpuri extraseNumă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

Flux de lucru

Document Scanner urmează un flux ghidat pas cu pas pentru fiecare vizitator sau transportator:

🌐 Limbă 👤 Rol 🚗 Număr auto 🪪 Scanare CI 📄 Documente 📍 Destinație ✅ Acces

Conectivitate și alimentare

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.

Necesar PoE+ minim! Acest dispozitiv necesită PoE+ (IEEE 802.3at) ca standard minim — PoE standard (IEEE 802.3af) nu furnizează suficientă putere. Asigurați-vă că switch-ul sau injectorul dvs. suportă PoE+ (802.3at) sau superior (PoE++/802.3bt). Utilizarea unui port doar cu PoE standard va duce la nepornirea dispozitivului sau la funcționare instabilă.
Instalare cu un singur cablu: Cablul Ethernet transportă atât alimentarea cât și datele. Aceasta înseamnă că un singur cablu ajunge la dispozitiv — minimizând complexitatea instalării. Nu este necesară o priză separată sau cablare suplimentară la punctul de instalare.

2. Prima pornire

2.1 Selectare limbă

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.

Ecranul de selectare a limbii cu 15 opțiuni de limbă și steaguri naționale
Fig.1 Selectare limbă — 15 limbi disponibile

Limbi disponibile: engleză, română, bulgară, maghiară, poloneză, sârbă, ucraineană, turcă, croată, franceză, italiană, spaniolă, portugheză, germană și olandeză.

Notă: După finalizarea sesiunii (acces acordat sau anulat), dispozitivul repornește automat și revine la acest ecran de selectare a limbii. Intervalul de repornire este configurabil din Application Settings (implicit: 20 secunde).

3. Setări

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.

3.1 Admin Settings

Accesarea meniului de administrare

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.

Notă: Această metodă de acces bazată pe gesturi este concepută pentru a preveni intrarea accidentală în configurarea de administrare. Asigurați-vă că apăsați ferm și în aceeași zonă de fiecare dată.

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.

Pagina de configurare cu tab-ul Admin Settings, câmpul New Admin Password și butoanele Salvează și Ieșire
Fig.2 Admin Settings — Schimbarea parolei de administrator

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.

Important! Setați întotdeauna o parolă puternică pentru a preveni accesul neautorizat la interfața de configurare. Aveți grijă să nu uitați parola, deoarece aceasta nu mai poate fi schimbată. Va trebui să trimiteți dispozitivul înapoi la Metrici pentru resetarea parolei.

3.2 Application Settings

Tab-ul Application Settings conține toate endpoint-urile API și parametrii operaționali — vezi Fig.3 Application Settings.

Pagina de configurare cu tab-ul Application Settings cu câmpurile Request Access URL, LLM API URL, Plate Number URL, LLM Model, Destinations URL și Restart Delay
Fig.3 Application Settings — Endpoint-uri API și configurare
CâmpDescriereExemplu
Request Access URLEndpoint-ul API al Metrici Visitor Journal pentru trimiterea cererilor de acceshttp://IP_ADDRESS/api_v2/vj/event_receiver.php
LLM API URLEndpoint-ul serviciului AI utilizat pentru extragerea datelor din documentehttp://LLM_ADDRESS:PORT/v1/chat/completions
Plate Number URLEndpoint-ul API Metrici LPR pentru obținerea ultimului număr de înmatriculare recunoscuthttp://IP_ADDRESS/api_v2/lpr/get_last_plate.php?camera_id=2
LLM ModelModelul AI utilizat pentru recunoașterea documentelorqwen3vl
Destinations URLEndpoint-ul API pentru obținerea listei de destinații disponibilehttp://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 sesiuni20

Î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.

3.3 Network Settings

Tab-ul Network Settings afișează informațiile curente ale interfeței Ethernet — vezi Fig.4 Network Settings.

Pagina de configurare cu tab-ul Network Settings cu Interface (eth0), IP Address și MAC Address
Fig.4 Network Settings — Informații interfață Ethernet
CâmpDescriere
InterfaceNumele interfeței de rețea (ex: eth0)
IP AddressAdresa IP curentă atribuită dispozitivului
MAC AddressAdresa 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.

Conectare prin browser

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:

  1. Mai întâi, aflați adresa IP a dispozitivului. Puteți face acest lucru în două moduri:
    • De pe dispozitiv: deschideți meniul de administrare (atingeți partea de jos a ecranului de 8 ori), mergeți la tab-ul Network Settings și citiți câmpul IP Address — vezi Fig.4 Network Settings.
    • Din router: verificați lista de clienți DHCP sau pagina de dispozitive conectate din router pentru a găsi IP-ul atribuit Document Scanner-ului.
  2. Deschideți orice browser web (Chrome, Firefox, Edge, Safari) pe un calculator sau telefon conectat la aceeași rețea ca dispozitivul.
  3. Tastați adresa IP în bara de adrese a browser-ului. De exemplu, dacă tab-ul Network Settings arată 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.

Recomandare: Salvați adresa IP a dispozitivului în bookmark-urile browser-ului pentru acces rapid. Dacă dispozitivul este setat pe DHCP, IP-ul se poate schimba după o repornire — în acest caz, verificați din nou tab-ul Network Settings sau lista de dispozitive din router. Pentru o adresă permanentă, luați în considerare atribuirea unui IP static prin funcția de rezervare DHCP a router-ului.

4. Visitor Journal

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.

Important! Tipul camerei trebuie setat pe ID card reader în Aplicația Web Metrici. Selectarea unui alt tip de cameră va împiedica comunicarea Document Scanner-ului cu Visitor Journal.

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.

Pagina People din Visitor Journal cu lista vizitatorilor înregistrați: nume, prenume, CNP, data nașterii, naționalitate, sex și număr de cărți de identitate
Fig.4.1 Persoane — Toți vizitatorii înregistrați și cărțile de identitate scanate

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.

Pagina Events din Visitor Journal cu lista filtrată de evenimente check-in: dată, oră, cameră, nume, CNP, tip document, număr auto, tip eveniment, destinație și detalii documente
Fig.4.2 Evenimente — Jurnal de check-in vizitatori cu opțiuni de filtrare și export

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.

5. Referință API

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.

5.1 Visitor Journal — Cerere de acces

ProprietateDetalii
Endpointhttp://IP_ADDRESS/api_v2/vj/event_receiver.php
MetodăPOST
Content-Typeapplication/json (cu imagini codificate base64)
ScopTrimite o înregistrare completă de vizitator/transportator/livrator către Visitor Journal

5.2 Număr de înmatriculare — Integrare LPR

ProprietateDetalii
Endpointhttp://IP_ADDRESS/api_v2/lpr/get_last_plate.php?camera_id=2
MetodăGET
ScopObține ultimul număr de înmatriculare recunoscut de camera LPR conectată

5.3 Destinații — Locații din incintă

ProprietateDetalii
Endpointhttp://IP_ADDRESS/api_v2/vj/get_destinations.php?location_id=1
MetodăGET
ScopObține lista destinațiilor disponibile în incintă pentru selectorul dropdown

5.4 LLM API — Extragere date din documente

ProprietateDetalii
Endpointhttp://LLM_ADDRESS:PORT/v1/chat/completions
MetodăPOST
ScopTrimite imaginea unui document capturat către modelul AI pentru extragerea structurată a datelor
ModelConfigurabil (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.

6. Fluxul utilizatorului

6.1 Selectare rol

După selectarea limbii, utilizatorul este prezentat cu trei opțiuni de rol — vezi Fig.5 Selectare rol:

Ecranul de selectare a rolului cu trei butoane: Vizitator (albastru), Transportator (portocaliu), Livrator (verde) și un buton Anulează
Fig.5 Selectare rol — Vizitator, Transportator sau Livrator

Apăsarea butonului Anulează revine la ecranul de selectare a limbii.

6.2 Recunoaștere număr de înmatriculare

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.

Ecranul de confirmare a numărului de înmatriculare B108EDC cu butoanele Anulează, Introduceți manual și Confirmă
Fig.6 Confirmare număr de înmatriculare

Trei opțiuni sunt disponibile:

Cum funcționează: Dispozitivul trimite o cerere către API-ul Metrici LPR la 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.

6.3 Scanare carte de identitate / pașaport

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.

Ecranul de scanare CI cu Zona Carte de Identitate, previzualizare cameră și butoanele Anulează și Capturează și extrage datele
Fig.7 Scanare CI / Pașaport — Previzualizare cameră cu buton de captură

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ă.

6.4 Verificare date extrase

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âmpDescriere
Număr CNPCod Numeric Personal
Tip DocumentIDENTITY CARD sau PASSPORT
Număr de serieSeria și numărul documentului
Data nașteriiData de naștere
NumeNumele de familie
PrenumePrenumele
NaționalitateNaționalitatea așa cum apare pe document
SexM sau F
Ecranul de verificare a datelor extrase cu câmpurile Număr CNP, Tip Document, Număr de serie, Data nașterii, Nume, Prenume, Naționalitate, Sex și butoanele Anulează, Reîncercare capturare și Confirmă și continuă
Fig.8 Date extrase — Rezultatele recunoașterii documentului prin AI

Trei acțiuni sunt disponibile:

Important! Acuratețea extragerii datelor depinde de calitatea documentului, condițiile de iluminare și plasarea corectă pe tavă. Dacă datele extrase sunt incorecte, utilizați Reîncercare capturare pentru a face o nouă fotografie. Asigurați-vă că documentul este plat, bine iluminat și complet vizibil în cadrul camerei.

6.5 Scanare documente (AWB / Factură)

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.

Ecranul de scanare documente de călătorie cu Zona Document de Călătorie, document deja scanat și butoanele Anulează, Scanează această pagină și Revizuiește și solicită acces
Fig.8b Scanare documente de călătorie — AWB-uri, facturi, chitanțe

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").

Notă: Scanarea documentelor este disponibilă doar pentru fluxurile Transportator și Livrator. Vizitatorii trec direct de la scanarea CI la selectarea destinației.

6.6 Sumar și verificare

Înainte de a solicita accesul, utilizatorul vede un sumar complet al tuturor datelor capturate — vezi Fig.9 Ecran sumar. Acest ecran afișează:

Ecranul de sumar cu numărul de înmatriculare B111TKE, datele CI cu imagine pe stânga și documentele de călătorie cu factură scanată pe dreapta, cu butoanele Anulează și Confirmă și selectează destinația
Fig.9 Sumar — Număr auto, date CI și documente de călătorie

Două acțiuni sunt disponibile:

6.7 Selectare destinație

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.

Ecranul de selectare destinație cu meniu dropdown și butoanele Anulează și Solicită acces
Fig.10 Selectare destinație — Alegeți destinația din listă

După selectarea destinației, apăsați Solicită acces pentru a trimite toate datele către Metrici Visitor Journal.

Cum funcționează: Când utilizatorul apasă „Solicită acces", dispozitivul trimite o cerere POST către API-ul Visitor Journal la 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.

6.8 Acces acordat

Dacă cererea de acces este aprobată, un mesaj verde de confirmare este afișat — vezi Fig.11 Acces acordat.

Ecranul de acces acordat cu mesajul: Accesul este acordat! Vă rugăm să intrați în locație. Mulțumesc! și cronometru de repornire automată
Fig.11 Acces acordat — Sesiune finalizată, repornire automată

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.

7. Depanare

Nu se poate accesa interfața de configurare

Dispozitivul nu pornește

Cartea de identitate sau pașaportul nu este recunoscut corect

Lista de destinații este goală sau afișează N/A

Dispozitivul nu repornește după sesiune