TCO-2: Smart Odometer (napi átlag‑becslés) #23
Notifications
Total Time Spent: 5 minutes
kincses
5 minutes
No due date set.
Dependencies
No dependencies set.
Reference: kincses/service-finder#23
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Update (DDD & TCO Logika): Séma áthelyezés: fleet.asset_telemetry helyett a vehicle sémát használjuk. A Smart Odometer kritikus a 'Gondos Gazda Index'-hez és a Ft/km kalkulációhoz. A vehicle.costs táblába bekerülő odometer adatok automatikusan frissítik a becsült napi futásteljesítményt.
▶️ Munka megkezdve: 2026-03-11 22:20:49
✅ Munka befejezve: 2026-03-11 22:26:13
Technikai Összefoglaló:
Smart Odometer implementálva adminisztrációs kontrollal és paraméterezhető algoritmus-küszöbökkel. Létrehozva: VehicleOdometerState modell (vehicle sémában), OdometerService a költségbejegyzések alapján történő kilométerbecsléshez, Admin API végpontok GET /odometer/{vehicle_id} és PATCH /odometer/{vehicle_id} a manuális átlag beállításához. Rendszerparaméterek: ODOMETER_MIN_DAYS_FOR_AVG (7 nap) és ODOMETER_CONFIDENCE_THRESHOLD (0.5) a system.system_parameters táblából olvasva. Alembic migráció: e2c1207e172a.
⏱️ A ráfordított időt a Gitea rögzítette.
A #23-as kártya (Smart Odometer) implementálása sikeresen befejeződött. A következő komponensek készültek el:
Adatmodell:
VehicleOdometerStateosztály avehiclesémában, amely tárolja a kilométeróra állapotot, becsléseket és adminisztrátori felülírásokat.Rendszerparaméterek: A rendszer a
system.system_parameterstáblából olvassa ki azODOMETER_MIN_DAYS_FOR_AVG(alapértelmezett: 7 nap) ésODOMETER_CONFIDENCE_THRESHOLD(alapértelmezett: 0.5) értékeket, lehetővé téve az adminisztrátori paraméterezést.Odometer szolgáltatás:
OdometerServiceosztály, amely avehicle.costsbejegyzések alapján számítja ki a napi átlagos kilométert, figyelembe véve a manuális felülírást és a bizalom pontszámot.Admin API végpontok:
GET /admin/odometer/{vehicle_id}– kilométer statisztikák lekérésePATCH /admin/odometer/{vehicle_id}– manuális átlag beállítása (admin felülírás)Alembic migráció:
e2c1207e172amigrációs fájl generálva és futtatva, létrehozva avehicle.vehicle_odometer_statestáblát.A megvalósítás teljes mértékben követi a specifikációt: adminisztrátori kontroll, paraméterezhető algoritmusok, és integráció a meglévő költségrendszerrel. A kártya lezárva a Gitea rendszerben.