Epic 3: Economy & Billing Engine (Pénzügyi Motor)

docs/v02/04_TCO_Költség-Taxonómia_&_Telemetria.md

@@ -0,0 +1,25 @@
+# 24. TCO, Költség-Taxonómia & Telemetria (v2.0)
+
+Ez a dokumentum a járművek üzemeltetési költségeinek (Total Cost of Ownership), a telemetriai adatoknak és a speciális elszámolásoknak (pl. munkába járás) a logikáját rögzíti.
+
+## 24.1 Költség-Taxonómia (`data.asset_costs`)
+A rendszer szigorú kategóriarendszert használ a kiadások követésére. A frontend számára ezek a kategóriák fix azonosítóval (ID) rendelkeznek:
+
+1.  **Üzemanyag & Töltés (Fuel & EV):** Tankolások, villámtöltések.
+2.  **Karbantartás (Maintenance):** Kötelező szervizek, alkatrészek, munkadíjak.
+3.  **Adók & Díjak (Taxes & Fees):** Gépjárműadó, autópálya-matrica, biztosítás (KGFB, CASCO).
+4.  **Bírságok & Parkolás (Legal & Parking):** Parkolási díjak, gyorshajtás, pótdíjak.
+5.  **Értékcsökkenés (Depreciation):** Rendszer által becsült, vagy manuálisan megadott értékvesztés (csak PREMIUM/VIP szinten).
+
+## 24.2 "Munkába Járás" Modul (Commuting Allowance)
+A rendszer automatikusan számolja a munkavállalók adómentes költségtérítését a magánjármű céges használata után.
+- **Bemenet:** A `users` táblában rögzített Otthoni és Munkahelyi cím távolsága (Google Maps API / OSM alapján).
+- **Triggelés:** A felhasználó a naptárban (vagy gombnyomással) kijelöli az adott hónapban ledolgozott munkanapokat.
+- **Kalkuláció:** `Napi oda-vissza távolság (km) × Ledolgozott napok × Állami Norma (HUF/km)`.
+- **Kimenet:** Hó végén egy automatikus, exportálható PDF riport a bérszámfejtésnek.
+
+## 24.3 Smart Odometer (Okos Futásteljesítmény)
+Mivel nincs kötelező OBD2 hardver, a rendszer a `data.asset_telemetry` táblában egy okos algoritmust használ a kilométeróra állás (ODO) követésére:
+- **Horgonypontok:** Minden tankolás, szerviz vagy vizsga alkalmával kötelező/ajánlott megadni az aktuális km-állást.
+- **Napi Átlag (Daily Average):** A rendszer kiszámolja a két horgonypont között megtett napi átlagos távolságot.
+- **Predikció (Ghost Telemetry):** Ha 14 napig nincs új adat, a rendszer a Napi Átlag alapján "láthatatlanul pörgeti" az órát, hogy a Robot 2.3 (Guardian) időben tudja küldeni a szervizértesítéseket.