Audit: Jármű adatfolyam (DB → API → Frontend) teljes körű elemzése #275

New Issue

kincses · 2026-06-21T11:35:57+02:00

kincses commented

2026-06-21 11:35:57 +02:00

Mérföldkő: 2A Adatinfrastruktúra és Audit

Cél: A járművek adatbázis modelljei, API rétege és frontend komponensei közötti adatfolyam teljes körű auditálása, a Dashboard kártyák linkelésének, a jármű részletek megjelenítésének és az API lefedettség ellenőrzése.

🔗 Függőségek (Dependencies)

Bemenet (Mikre támaszkodik): Database (vehicle.asset, vehicle.asset_catalog, vehicle.asset_event, fleet_finance.*), Backend API (assets.py endpointok), Frontend komponensek (VehicleCardStandard, VehicleDetailModal, OverviewTab, FinancialsTab)
Kimenet (Mik támaszkodnak rá): N/A - ez egy audit kártya, nem fejlesztési feladat

📝 Elemzés

Teljes körű adatfolyam elemzés a Service Finder rendszerben:

1. Dashboard jármű kártyák (VehicleCardStandard) linkelése:

A kártya @click eseménye a VehicleDetailModal-t nyitja meg
A kártya adatforrása: GET /assets/vehicles lista endpoint (AssetResponse tömb)
Megjelenített adatok: license_plate, brand, model, year_of_manufacture, current_mileage, power_kw/engine_capacity, color (JSONB), nextService (JSONB)

2. VehicleDetailModal (4 tab):

Tab 1 (Alapadatok): Asset modell mezői + individual_equipment JSONB (car_specs, ev_specs, dates)
Tab 2 (Pénzügyek): GET /assets/{id}/costs (AssetCost), nincs AssetFinancials/Insurance/Tax itt!
Tab 3 (Figyelmeztetések): individual_equipment JSONB (mot_expiry, next_service, tire_change)
Tab 4 (Szervizkönyv): GET /assets/{id}/events (AssetEvent)

3. OverviewTab adatforrásai:

inject('vehicle') - Asset modell közvetlen mezői
expenseStore (useExpenseStore) - AssetCost tábla, legutóbbi 3 item
individual_equipment.dates.mot_expiry - JSONB mező

4. API lefedettség ellenőrzés:

Asset modell 50+ mezője teljesen le van fedve az AssetResponse által
Fleet_finance modellek (AssetFinancials, VehicleInsurancePolicy, VehicleTaxObligation) külön API endpointokon
AssetEvent, AssetCost szintén külön endpointokon
Összességében az API lefedi az összes adatbázis mezőt

5. Feltárt probléma:

A VehicleDetailModal Pénzügyek tabja csak a costs (AssetCost) adatokat jeleníti meg, NEM tartalmazza az AssetFinancials, insurance policies, tax obligations adatokat - ezek a FinancialsTab komponensben érhetők el, ami egy külön oldalon (pl. CompanyGarageView) és nem a modálban jelenik meg
A VehicleCardStandard nem mutatja vizuálisan az is_primary státuszt
A frontend Vehicle típus tartalmaz asset_financials, insurance_policies, tax_obligations mezőket, de ezek NEM részei az AssetResponse-nak - külön API hívásokkal töltődnek be

**Mérföldkő:** 2A Adatinfrastruktúra és Audit **Cél:** A járművek adatbázis modelljei, API rétege és frontend komponensei közötti adatfolyam teljes körű auditálása, a Dashboard kártyák linkelésének, a jármű részletek megjelenítésének és az API lefedettség ellenőrzése. ### 🔗 Függőségek (Dependencies) - **Bemenet (Mikre támaszkodik):** Database (vehicle.asset, vehicle.asset_catalog, vehicle.asset_event, fleet_finance.*), Backend API (assets.py endpointok), Frontend komponensek (VehicleCardStandard, VehicleDetailModal, OverviewTab, FinancialsTab) - **Kimenet (Mik támaszkodnak rá):** N/A - ez egy audit kártya, nem fejlesztési feladat ### 📝 Elemzés Teljes körű adatfolyam elemzés a Service Finder rendszerben: **1. Dashboard jármű kártyák (VehicleCardStandard) linkelése:** - A kártya @click eseménye a VehicleDetailModal-t nyitja meg - A kártya adatforrása: GET /assets/vehicles lista endpoint (AssetResponse tömb) - Megjelenített adatok: license_plate, brand, model, year_of_manufacture, current_mileage, power_kw/engine_capacity, color (JSONB), nextService (JSONB) **2. VehicleDetailModal (4 tab):** - Tab 1 (Alapadatok): Asset modell mezői + individual_equipment JSONB (car_specs, ev_specs, dates) - Tab 2 (Pénzügyek): GET /assets/{id}/costs (AssetCost), nincs AssetFinancials/Insurance/Tax itt! - Tab 3 (Figyelmeztetések): individual_equipment JSONB (mot_expiry, next_service, tire_change) - Tab 4 (Szervizkönyv): GET /assets/{id}/events (AssetEvent) **3. OverviewTab adatforrásai:** - inject('vehicle') - Asset modell közvetlen mezői - expenseStore (useExpenseStore) - AssetCost tábla, legutóbbi 3 item - individual_equipment.dates.mot_expiry - JSONB mező **4. API lefedettség ellenőrzés:** - Asset modell 50+ mezője teljesen le van fedve az AssetResponse által - Fleet_finance modellek (AssetFinancials, VehicleInsurancePolicy, VehicleTaxObligation) külön API endpointokon - AssetEvent, AssetCost szintén külön endpointokon - Összességében az API lefedi az összes adatbázis mezőt **5. Feltárt probléma:** - A VehicleDetailModal Pénzügyek tabja csak a costs (AssetCost) adatokat jeleníti meg, NEM tartalmazza az AssetFinancials, insurance policies, tax obligations adatokat - ezek a FinancialsTab komponensben érhetők el, ami egy külön oldalon (pl. CompanyGarageView) és nem a modálban jelenik meg - A VehicleCardStandard nem mutatja vizuálisan az is_primary státuszt - A frontend Vehicle típus tartalmaz asset_financials, insurance_policies, tax_obligations mezőket, de ezek NEM részei az AssetResponse-nak - külön API hívásokkal töltődnek be

kincses added the Status: In Progress label 2026-06-21 11:36:09 +02:00

kincses started working 2026-06-21 11:36:09 +02:00

kincses commented

2026-06-21 11:36:09 +02:00

▶️ Munka megkezdve: 2026-06-21 11:36:09

▶️ **Munka megkezdve:** 2026-06-21 11:36:09

kincses added Status: Done and removed Status: In Progress labels 2026-06-21 11:51:32 +02:00

kincses worked for 15 minutes

2026-06-21 11:51:32 +02:00

kincses closed this issue

2026-06-21 11:51:33 +02:00

kincses commented

2026-06-21 11:51:33 +02:00

✅ Munka befejezve: 2026-06-21 11:51:32

Technikai Összefoglaló:
Jármű adatfolyam audit elkészült. Feltárt problémák: (1) VehicleDetailModal Pénzügyek tab csak AssetCost-ot mutat, lízing/biztosítás/adó adatok hiányoznak. (2) is_primary vizuális jelzés hiányzik a VehicleCardStandard-ból. (3) VehicleUserRating, VehicleTransferRequest, VehicleLogbook API-hiányos. Dokumentáció: docs/vehicle_dataflow_audit_2026-06-21.md

⏱️ Az idő rögzítve.

✅ **Munka befejezve:** 2026-06-21 11:51:32 **Technikai Összefoglaló:** Jármű adatfolyam audit elkészült. Feltárt problémák: (1) VehicleDetailModal Pénzügyek tab csak AssetCost-ot mutat, lízing/biztosítás/adó adatok hiányoznak. (2) is_primary vizuális jelzés hiányzik a VehicleCardStandard-ból. (3) VehicleUserRating, VehicleTransferRequest, VehicleLogbook API-hiányos. Dokumentáció: docs/vehicle_dataflow_audit_2026-06-21.md ⏱️ *Az idő rögzítve.*

Sign in to join this conversation.

1 Participants

Notifications

Total Time Spent: 15 minutes

kincses

15 minutes

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kincses/service-finder#275