Metrici LPR Plugin for Milestone XProtect

1. Funcționalități

• Endpoint HTTP API: Primește date LPR (multipart/form‑data).
• Autentificare: Autentificare pe bază de MD5, configurabilă per cameră.
• Stocare evenimente: Bază de date SQLite pentru stocarea persistentă a evenimentelor.
• Interfață completă – vizualizare principală, panou lateral, vizualizare detaliată a evenimentelor.
• Actualizare în timp real și refresh automat.
• Export în fișiere text.
• Interfață de administrare pentru configurarea camerelor.

2. Cerințe de sistem

• Milestone XProtect (compatibil cu MIPSDK)
• .NET Framework 4.7.2 sau o versiune ulterioară
• Windows Server 2016+ (pentru componentele server) sau Windows 10/11 (client)
• Port TCP 8080 deschis (sau alt port configurat) pentru comunicarea HTTP

3. Instalare

1. Compilați plugin-ul (dacă folosiți codul sursă):

   dotnet restore MetriciLprPlugin.sln
   dotnet build MetriciLprPlugin.sln --configuration Release

2. Copiați fișierele în directorul de plugin-uri XProtect, de exemplu:

   C:\Program Files\Milestone\XProtect <Version>\Server\Plugins\MetriciLprPlugin\
     MetriciLprPlugin.dll
     MetriciLprPlugin.Admin.dll

3. Înregistrați plugin-ul în XProtect Management Application → Servers → Plugins → Add → selectați MetriciLprPlugin.dll și activați-l.
4. Configurați setările de bază (port HTTP, cheie de autentificare, director pentru date) prin interfața de configurare a plugin-ului.
5. Deschideți portul în firewall pentru portul ales, de exemplu:

   New-NetFirewallRule -DisplayName "Metrici LPR Plugin" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow

6. Reporniți serviciile XProtect (Smart Client, Management Server, Recording Server, Event Server) și verificați că plugin-ul se încarcă corect.

4. Configurare

Configurarea camerelor

Din XProtect Management Client → Plugin Configuration → Camera Configuration puteți adăuga fiecare cameră LPR:

• Camera ID (trebuie să corespundă cu cel din motorul Metrici)
• Cheie unică de autentificare (secret MD5)
• Asocierea cu o cameră din XProtect
• Locație, descriere, activare/dezactivare

Setări server HTTP

• Port – implicit 8080 (configurabil)
• Endpoint – POST /lpr/event
• Verificare stare – GET /lpr/health

Autentificare per cameră

Fiecare cerere trebuie să conțină un câmp auth — un hash MD5 calculat din câmpurile cererii și cheia secretă specifică camerei.

5. Utilizare API

Câmpuri obligatorii (multipart/form‑data)

• id – ID cameră (integer)
• number – Număr de înmatriculare
• country_code
• first_seen – yyyy‑mm‑dd_hh:mm:ss
• last_seen
• probability – grad de încredere (0‑1)
• direction – 1=intrare, 2=ieșire, 3=necunoscut
• transactionkey
• auth – hash MD5

Câmpuri opționale

• plate_image, car_image, companion_image (JPEG codificat base64)
• Coordonate GPS, atribute vehicul etc.

Exemplu de cerere

curl -X POST http://localhost:8080/lpr/event \
  -F "id=1" \
  -F "number=ABC123" \
  -F "country_code=RO" \
  -F "first_seen=2024-01-15_14:30:25" \
  -F "last_seen=2024-01-15_14:30:27" \
  -F "probability=0.95" \
  -F "direction=1" \
  -F "transactionkey=tx_12345" \
  -F "vehicle_class=Car" \
  -F "auth=YOUR_MD5_HASH" \
  -F "plate_image=@plate.jpg" \
  -F "car_image=@car.jpg"

6. Interfața utilizator

Vizualizare principală

• Tabel cu evenimente, cu opțiuni de sortare și filtrare (număr de înmatriculare, tip vehicul, direcție, cameră XProtect, interval de date).
• Refresh automat și manual.
• Dublu-click pe un eveniment pentru a deschide vizualizarea detaliată cu imagini și asocierea camerei.

Panou lateral

• Afișează ultimele 10 evenimente, cu direcția marcată prin culori.
• Statistici — total evenimente și numărul evenimentelor din ziua curentă.
• Dublu-click pentru a deschide detaliile unui eveniment.

Interfața de administrare

• Configurarea camerelor — adăugare/editare/ștergere camere LPR, asociere cu camere XProtect, setare chei de autentificare.
• Setări generale — port HTTP, cheie de autentificare implicită, director pentru date, nivel de logare.

7. Dezvoltare

Proiectul este o soluție .NET bazată pe WinForms. Componentele principale includ:

• LprEventService – operațiuni cu baza de date.
• LprHttpServer – server HTTP Kestrel.
• AuthenticationService – validare MD5.
• Componentele UI se găsesc în src/MetriciLprPlugin/UI.

Pentru a compila din surse:

# Restaurare pachete
dotnet restore

# Compilare Release
dotnet build --configuration Release

# Rulare teste (dacă există)
dotnet test

8. Depanare

Probleme frecvente

• Serverul HTTP nu pornește – verificați dacă portul este ocupat, setările de firewall și permisiunile.
• Erori de autentificare – verificați cheia specifică camerei și calculul hash-ului MD5.
• Erori legate de baza de date – asigurați-vă că directorul pentru date are permisiuni de scriere.
• Plugin-ul nu se încarcă în XProtect – confirmați versiunea .NET, permisiunile fișierelor și plasarea corectă a fișierelor DLL în directorul de plugin-uri.

9. Suport

Pentru suport tehnic, consultați log-urile plugin-ului (situate în directorul de date al aplicației) sau contactați echipa de dezvoltare. Mai multe informații despre soluțiile Metrici sunt disponibile la www.metrici.ro.