TCO-2: Smart Odometer (napi átlag‑becslés) #23

Closed
opened 2026-03-08 02:07:24 +01:00 by kincses · 3 comments
Owner

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.

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.
kincses added the Status: To DoScope: CoreType: Feature labels 2026-03-08 02:07:24 +01:00
kincses added this to the 🚗 Epic 4: Asset Management & TCO (Garázs és Költs milestone 2026-03-08 02:10:55 +01:00
kincses added this to the Master Book 2.0 project 2026-03-08 02:12:13 +01:00
kincses added Status: In Progress and removed Status: To Do labels 2026-03-11 23:20:49 +01:00
kincses started working 2026-03-11 23:20:49 +01:00
Author
Owner

▶️ Munka megkezdve: 2026-03-11 22:20:49

▶️ **Munka megkezdve:** 2026-03-11 22:20:49
kincses added Status: Done and removed Status: In Progress labels 2026-03-11 23:26:13 +01:00
kincses worked for 5 minutes 2026-03-11 23:26:13 +01:00
Author
Owner

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.

✅ **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.*
Author
Owner

A #23-as kártya (Smart Odometer) implementálása sikeresen befejeződött. A következő komponensek készültek el:

  1. Adatmodell: VehicleOdometerState osztály a vehicle sémában, amely tárolja a kilométeróra állapotot, becsléseket és adminisztrátori felülírásokat.

  2. Rendszerparaméterek: A rendszer a system.system_parameters táblából olvassa ki az ODOMETER_MIN_DAYS_FOR_AVG (alapértelmezett: 7 nap) és ODOMETER_CONFIDENCE_THRESHOLD (alapértelmezett: 0.5) értékeket, lehetővé téve az adminisztrátori paraméterezést.

  3. Odometer szolgáltatás: OdometerService osztály, amely a vehicle.costs bejegyzé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.

  4. Admin API végpontok:

    • GET /admin/odometer/{vehicle_id} – kilométer statisztikák lekérése
    • PATCH /admin/odometer/{vehicle_id} – manuális átlag beállítása (admin felülírás)
  5. Alembic migráció: e2c1207e172a migrációs fájl generálva és futtatva, létrehozva a vehicle.vehicle_odometer_states tá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.

A #23-as kártya (Smart Odometer) implementálása sikeresen befejeződött. A következő komponensek készültek el: 1. **Adatmodell**: [`VehicleOdometerState`](backend/app/models/vehicle.py:107) osztály a `vehicle` sémában, amely tárolja a kilométeróra állapotot, becsléseket és adminisztrátori felülírásokat. 2. **Rendszerparaméterek**: A rendszer a `system.system_parameters` táblából olvassa ki az `ODOMETER_MIN_DAYS_FOR_AVG` (alapértelmezett: 7 nap) és `ODOMETER_CONFIDENCE_THRESHOLD` (alapértelmezett: 0.5) értékeket, lehetővé téve az adminisztrátori paraméterezést. 3. **Odometer szolgáltatás**: [`OdometerService`](backend/app/services/odometer_service.py) osztály, amely a `vehicle.costs` bejegyzé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. 4. **Admin API végpontok**: - `GET /admin/odometer/{vehicle_id}` – kilométer statisztikák lekérése - `PATCH /admin/odometer/{vehicle_id}` – manuális átlag beállítása (admin felülírás) 5. **Alembic migráció**: `e2c1207e172a` migrációs fájl generálva és futtatva, létrehozva a `vehicle.vehicle_odometer_states` tá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.
kincses moved this to Done in Master Book 2.0 on 2026-03-19 09:53:05 +01:00
Sign in to join this conversation.