Releases: cnecrea/fleet
Release list
1.5.4
Manager de flotă v1.5.4
Ce s-a schimbat
A fost corectată o problemă în care, în anumite configurații, perioada de evaluare (trial) putea fi atribuită incorect.
Ce trebuie să faci
Nu este necesară nicio acțiune. Actualizarea se aplică automat la repornirea Home Assistant.
De ce este important
Unele instanțe de Home Assistant puteau fi confundate între ele, ceea ce ducea la afișarea incorectă a perioadei de evaluare. Această actualizare rezolvă această problemă.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 1.1k | 504 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.5.3
Manager de flotă v1.5.3
Notificări expirare licență
Când perioada de evaluare sau licența expiră, integrarea te anunță acum în două locuri:
- Reparații — în Setări → Sistem → Reparații apare un avertisment cu butonul „Mai multe informații" care duce direct la pagina de obținere a licenței.
- Notificare persistentă — la clopoțelul din bara de sus apare un mesaj cu link direct pentru reînnoire sau achiziție.
Mesajul diferă în funcție de situație: dacă a expirat o perioadă de evaluare, vei vedea „Licența de probă a expirat", iar dacă a expirat o licență activă, vei vedea „Licența a expirat".
Ambele notificări dispar automat în momentul în care licența redevine validă.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 1.1k | 504 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.5.2
Manager de flotă v1.5.2
Îmbunătățiri și optimizări
Sistem de licențiere
- Îmbunătățiri de securitate pentru procesul de activare și dezactivare a licențelor
- Optimizarea validării sesiunilor și a comunicării cu serverul de licențe
- Îmbunătățirea mecanismului anti-abuz pentru perioada de evaluare
Stabilitate
- Gestionare îmbunătățită a conexiunilor HTTP
- Tratare mai robustă a erorilor la inițializarea integrării
- Recuperare automată îmbunătățită în cazul pierderii temporare a conexiunii la server
Performanță
- Optimizarea apelurilor API — se evită traficul inutil atunci când integrarea nu este activă
- Îmbunătățirea gestionării conturilor asociate
Diverse
- Corecții minore de stabilitate și fiabilitate
- Îmbunătățiri interne ale fluxului de date
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 1.1k | 486 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.5.1
Manager de flotă v1.5.1
Pregătire integrare pentru HACS
Această versiune pregătește integrarea pentru trimiterea către HACS (Home Assistant Community Store).
Modificări
- Îmbunătățirea documentației
- Pregătire generală pentru compatibilitate HACS
Note
Această versiune nu adaugă funcționalități noi.
Se concentrează pe alinierea repository-ului la standardele necesare pentru distribuția în HACS.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 894 | 399 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.5.0
Manager de flotă v1.5.0
Ce este nou?
Îmbunătățiri aduse integrării
Comunicare îmbunătățită cu serverul de licențiere
Am optimizat modul în care integrarea comunică cu serverul de licențiere. Schimbul de date este acum mai eficient și mai fiabil, reducând consumul de resurse în timpul verificărilor periodice.
Compatibilitate extinsă
Am îmbunătățit compatibilitatea cu versiunile recente de Home Assistant, asigurând o funcționare stabilă indiferent de configurația folosită.
Optimizări interne
Diverse îmbunătățiri de performanță și stabilitate în procesul de verificare a licenței.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 771 | 338 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.4.0
Manager de flotă v1.4.0
Ce este nou?
Îmbunătățiri aduse integrării
Stabilitate crescută
Am rezolvat o problemă care putea apărea la pornirea Home Assistant, în special când integrarea gestiona mai multe intrări simultan. Acum totul pornește corect, fără verificări duplicate sau întârzieri.
Reacție mai rapidă la schimbările de licență
Integrarea se adaptează acum automat la intervalele de verificare primite de la server. Dacă licența expiră sau devine din nou validă, senzorii se actualizează imediat — fără să fie nevoie de restart.
Informare clară despre starea licenței
Când licența sau perioada de evaluare expiră, integrarea afișează acum un mesaj clar direct în senzori: „Licență necesară". Nu mai rămân senzori cu valori vechi sau incomplete — știi exact ce se întâmplă și ce trebuie să faci.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 771 | 338 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.3.0
Manager de flotă v1.3.0
Îmbunătățiri de stabilitate
-
Reziliență la indisponibilitatea temporară a serverului — integrarea continuă să funcționeze normal în cazul în care serverul de licențiere este temporar inaccesibil (mentenanță programată, probleme de rețea, DNS). Senzorii rămân funcționali pe durata întreruperii, fără intervenția utilizatorului.
-
Eliminarea mesajelor repetitive din log — un avertisment care anterior se genera de mii de ori pe oră (în anumite condiții de rețea) apare acum o singură dată. Dimensiunea fișierului de log scade semnificativ în scenarii de conectivitate intermitentă.
-
Reacție instantanee la expirarea cache-ului — un mecanism de programare precisă elimină complet fereastra moartă dintre expirarea datelor locale și verificarea la server. Integrarea detectează și reacționează imediat la schimbările de stare.
Îmbunătățiri în gestionarea fluxului
-
Backoff adaptiv la reconectare — în loc să bombardeze serverul cu cereri în cazul unei indisponibilități, integrarea crește progresiv intervalul dintre încercări (de la 1 minut la maximum 1 oră), reducând traficul inutil și protejând atât clientul cât și serverul.
-
Recuperare automată la reconectare — în momentul în care serverul redevine accesibil, integrarea se reconectează automat, restaurează senzorii și revine la funcționarea normală, fără repornire sau intervenție manuală.
-
Tranziții curate între stări — trecerea de la licență validă la invalidă (și invers) se face printr-un mecanism de reload controlat, fără senzori în stare „indisponibil" și fără erori vizibile în interfață.
Notificări lifecycle
- Corecție la trimiterea evenimentelor de dezactivare și ștergere — un bug care împiedica trimiterea corectă a evenimentelor lifecycle (dezactivare, reactivare, ștergere integrare) a fost identificat și corectat.
Alte îmbunătățiri
- Link direct către asistență în ecranul de configurare, vizibil atunci când licența este expirată sau lipsește, pentru a ghida utilizatorul spre obținerea unei licențe.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 628 | 265 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.2.0
Manager de flotă v1.2.0
Sistem standardizat de licențiere
Această versiune introduce un sistem standardizat de licențiere utilizat de integrările din ecosistemul Hub Inteligent.
Sistemul este gestionat server-side, iar integrarea Home Assistant verifică periodic starea licenței și păstrează temporar rezultatul local pentru a reduce numărul de verificări.
Flux de licențiere
- Integrarea generează un identificator unic al dispozitivului
- Serverul verifică licența sau activează automat o perioadă de trial de 30 de zile
- Răspunsul serverului este validat criptografic de integrare
- Rezultatul este cache-at temporar pentru a optimiza verificările ulterioare
În majoritatea cazurilor, procesul este complet automat și nu necesită nicio acțiune din partea utilizatorului.
Securitate
Sistemul utilizează mecanisme moderne de securitate pentru a asigura:
- validarea criptografică a răspunsurilor primite de la server
- integritatea comunicării între integrare și serviciul de licențiere
- legarea licenței de dispozitiv
- protecție împotriva modificării sau coruperii datelor locale
- mecanisme de recuperare în cazul unor erori de stocare
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 538 | 225 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.1.0
Manager de flotă 1.10
Data: 2026-03-21
Compatibilitate: Home Assistant 2024.1+
Vulnerabilitate path traversal în serviciul de import
Fișier: __init__.py
Severitate: Critică
Serviciul _handle_importa_date accepta orice cale de fișier fără validare. Un atacator putea citi fișiere arbitrare de pe sistem prin construirea unei căi malițioase.
Fix: Verificări adăugate:
- Path resolution cu
resolve()(previne symlink traversal) - Containment obligatoriu în
config_dir(previne escape din directorul HA) - Extensie
.jsonobligatorie - Validare a structurii JSON importat
9. Verificare cost_total type safety
Fișier: helpers.py → intreg()
Severitate: Informațional
Verificat — funcția intreg() gestionează deja conversia safe cu int(float(val)) + try/except. Nicio modificare necesară.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 507 | 216 |
Dacă integrarea Manager de flotă îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
1.0.0
Manager de flotă 1.0.0 — Lansare inițială
Data: Martie 2026
Autor: Ciprian Nicolae (@cnecrea)
Platformă: Home Assistant (Custom Integration)
Licență: Proprietary — All Rights Reserved
Ce este Manager de flotă?
Manager de flotă este o integrare custom pentru Home Assistant care permite gestionarea completă a unei flote de vehicule de transport. Integrarea monitorizează documente, asigurări, mentenanță, costuri, șoferi și remorci — totul centralizat într-un singur loc, cu notificări automate pentru expirări.
Fiecare vehicul apare ca un dispozitiv separat în Home Assistant, cu senzori dedicați pentru fiecare categorie de date. Senzorii sunt condiționați — apar doar când au date completate.
Funcționalități principale
Vehicul — Identificare și date tehnice
Nr. înmatriculare, serie CIV, VIN, marcă, model, motorizare, combustibil, an fabricație, an prima înmatriculare, capacitate cilindrică, putere (kW/CP), MMA, masă proprie, sarcină utilă (calculată automat), nr. axe, tip vehicul, categorie Euro, tip suspensie, tip proprietate, proprietar.
Documente și asigurări (cu countdown automat)
Fiecare document afișează zilele rămase până la expirare și starea (valid / expiră curând / expirat).
- RCA — nr. poliță, companie, date emitere/expirare, cost
- Casco — nr. poliță, companie, date emitere/expirare, cost
- ITP — data expirare, stație, kilometraj la ITP
- Rovinieta — date început/sfârșit, categorie, preț
- Impozit — sumă, scadență, localitate
- Leasing — data expirare (apare doar dacă tip proprietate = leasing)
Mentenanță (cu tracking km și istoric)
Fiecare categorie de mentenanță afișează km rămași sau luni de la ultima operațiune.
- Revizie ulei — km ultima/următoarea revizie, data, cost
- Distribuție — km ultima/următoarea schimbare, data, cost
- Anvelope — date montare vară/iarnă, tip, DOT, nr. reșapări, cost
- Baterie — data schimb, cost, luni de la schimb
- Plăcuțe frână — km ultima/următoarea schimbare, cost
- Discuri frână — km ultima/următoarea schimbare, cost
- DPF (filtru particule) — data/km curățare, cost
- Turbo — data/km revizie, cost
- Trusă prim ajutor — data expirare
- Extinctor — data expirare, capacitate
Șofer
- Date identificare — nume, CNP, nr. permis, categorii permis
- Permis — data expirare, countdown automat
- CPC — număr, tip (marfă/persoane), data expirare
- Card tahograf — număr, data expirare
- Fișă medicală — data examen, data expirare, apt/inapt
- Fișă psihologică — data examen, data expirare
- Atestat ADR — număr, clase, data expirare
Licențe transport
- Licență transport — număr, tip, data expirare
- Copie conformă — număr, data expirare
- Licență comunitară — număr, data expirare
ADR (Transport mărfuri periculoase)
Certificat ADR vehicul — număr, clase, data expirare, consilier, echipament complet.
Tahograf
Tip (analog/digital/smart), data verificare, data următoare verificare, data calibrare.
Combustibil și alimentare
- Combustibil — capacitate rezervor, nivel (%), consum mediu, AdBlue (capacitate + nivel)
- Alimentare — data, litri, preț/litru, cost total, km la alimentare
Remorcă (completă)
- Identificare — nr. înmatriculare, tip, marcă, MMA, masă proprie, sarcină utilă, nr. axe, an fabricație
- ITP remorcă — data expirare
- RCA remorcă — data expirare
- Rovinieta remorcă — data expirare
Costuri extinse
- Taxe de drum — țară, sumă, valută, data (16 țări suportate)
- Amenzi — sumă, motiv, țară, status (plătită/neplătită/contestată)
Cost total (senzor agregat)
Calculează automat costul total pe anul curent, cu defalcare pe categorii (asigurări, taxe, mentenanță, combustibil) și istoric pe ani anteriori din datele arhivate.
Sistem de licențiere
Integrarea include un sistem de licențiere cu verificare server-side.
Trial
La prima instalare, integrarea primește automat o perioadă de evaluare de 30 de zile. În această perioadă, toate funcționalitățile sunt disponibile fără restricții. Durata trial-ului este controlată exclusiv de server.
Activare licență
Din configurarea integrării, meniul Licență, introduceți cheia primită (format: FLEET-XXXX-XXXX-XXXX-XXXX). Activarea se face automat prin API.
Tipuri de licență
- Perpetuală — fără dată de expirare
- Anuală — validă 365 de zile de la activare
Fără licență validă
Senzorii afișează „Licență necesară" în loc de date reale. Integrarea rămâne instalată dar nu funcționează.
Securitate
- Semnătură criptografică Ed25519 pe fiecare token
- Fingerprint unic legat de hardware + instalare HA
- HMAC-SHA256 pe fiecare request
- Zero constante locale modificabile — serverul controlează totul
Alte funcționalități
Istoric (arhivare automată)
La reînnoirea unui document sau operațiune de mentenanță, datele vechi se arhivează automat. Fiecare senzor afișează numărul de reînnoiri anterioare și detaliile ultimei intrări arhivate.
Servicii disponibile
fleet.actualizeaza_date— Actualizează kilometrajul unui vehiculfleet.exporta_date— Exportă datele vehiculului în fișier JSON (backup)fleet.importa_date— Importă datele unui vehicul din backup JSON
Traduceri
Integrarea este disponibilă complet în română și engleză (524 chei de traducere).
Date tehnice
| Parametru | Valoare |
|---|---|
| Versiune | 1.0.0 |
| Domeniu | fleet |
| Platforme | sensor |
| Config Flow | da |
| IoT Class | calculated |
| Senzori per vehicul | până la 37 (condiționați) |
| Constante CONF_* | 145 |
| Selectoare (dropdown) | 13 |
| Servicii | 3 |
| Pași de configurare | 29 |
| Chei traducere | 524 |
| Limbi | Română, Engleză |
Cerințe
- Home Assistant 2024.1 sau mai nou
- Conexiune la internet — necesară pentru verificarea licenței la server
Instalare
- Copiază folderul
fleetînconfig/custom_components/ - Repornește Home Assistant
- Mergi la Setări → Dispozitive și servicii → Adaugă integrare → Manager de flotă
- Introdu numărul de înmatriculare al vehiculului
- Configurează datele din meniul de opțiuni (fiecare categorie se completează separat)
Suport
Copyright (c) 2026 Ciprian Nicolae. All rights reserved.
📈 Integrarea în cifre
| ⭐ Stars | 📥 Instalări | 🔄 Clone (14z) |
|---|---|---|
| 1 | 180 | 90 |
Dacă integrarea fleet îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.
💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors
