1440 lines
53 KiB
Plaintext
Executable File
1440 lines
53 KiB
Plaintext
Executable File
2026.01.25 Leírás Bővített
|
||
|
||
Nem kell semmilyen trükköt alkalmaznod, hiszen a beszélgetésünk minden részlete itt van a „fejemben” (a kontextusban). Az a feladatom, hogy ezt a tudást strukturáljam és átadjam neked.
|
||
|
||
Mivel a célod az, hogy **egyetlen, mindent átfogó dokumentumod** legyen, amit egy új GEM-be betáplálhatsz, most összegyúrtam az összes eddigi technikai döntést, üzleti logikát, jövőbeli tervet és egyeztetett szabályt.
|
||
|
||
Ezt a szöveget másold ki, és ez legyen az **ÚJ GEM Rendszerutasítása (System Instructions)**. Ez a létező legrészletesebb leirat a projektünkről.
|
||
|
||
---
|
||
|
||
# 🚀 SERVICE FINDER - TELJES RENDSZER- ÉS FEJLESZTÉSI DOKUMENTÁCIÓ (v3.0)
|
||
|
||
Ez a dokumentum a "Service Finder" alkalmazás teljes körű, minden részletre kiterjedő leírása. Tartalmazza az architektúrát, az adatmodellt, az üzleti logikát, a jogosultsági rendszert és a jövőbeli ütemtervet.
|
||
|
||
---
|
||
|
||
## 1. A PROJEKT IDENTITÁSA ÉS FILOZÓFIÁJA
|
||
|
||
* **Név:** Service Finder (Digital Twin Platform).
|
||
* **Alapkoncepció:** A jármű egy önálló entitás („Digitális Iker”), amelynek története és adatai függetlenek a tulajdonostól.
|
||
* **Aranyszabály (The Golden Rule):** **„A jármű örök, a tulajdonos vándor.”**
|
||
* Járművet és Felhasználót soha nem törlünk véglegesen (kivéve adminisztratív megsemmisítés).
|
||
* Csak inaktiválás (Soft Delete) vagy lecsatolás (Unlink) létezik.
|
||
|
||
|
||
* **Architektúra:** **„Smart Backend, Dumb Frontend”** (Vékony kliens).
|
||
* A frontend nem végez számításokat, csak megjelenít.
|
||
* Minden validációt, kalkulációt és döntést a backend végez.
|
||
|
||
|
||
|
||
---
|
||
|
||
## 2. ÜZEMELTETÉSI KÖRNYEZET (TECH STACK)
|
||
|
||
* **Szerver IP:** `192.168.100.43`
|
||
* **Konténerizáció (Docker Compose):**
|
||
* `service_finder_api`: Backend (Python 3.12 + FastAPI + Uvicorn). Port: `8000`.
|
||
* `service_finder_db`: Adatbázis (PostgreSQL). Port: `5432`.
|
||
* `pgadmin`: Adatbázis menedzsment.
|
||
|
||
|
||
* **Adatbázis technológia:** PostgreSQL, aszinkron eléréssel (`asyncpg`), SQLAlchemy ORM, Alembic migrációk.
|
||
* **Frontend:** HTML5, Bootstrap 5, Vanilla JS (Fetch API). Nincs nehéz keretrendszer (React/Angular), hogy a kód hordozható és egyszerű maradjon.
|
||
* **Mobil App stratégia:** Offline-first működés (helyi tárolás), amely hálózat esetén szinkronizál a szerverrel.
|
||
|
||
---
|
||
|
||
## 3. ADATBÁZIS ÉS ADATSTRUKTÚRA (`data` séma)
|
||
|
||
### 3.1 Törzsadatok (Katalógus - Big Data)
|
||
|
||
Statikus, központi adatbázis a járművek pontos meghatározásához.
|
||
|
||
* **Márkák:** Név, Logo URL (a csempés megjelenítéshez).
|
||
* **Modellek & Típusok:** Részletes specifikációk (Motorizáció, Üzemanyag, Generáció).
|
||
* **Felszereltség:** Gyári extrák listája (JSON).
|
||
|
||
### 3.2 Járművek (`data.user_vehicles`)
|
||
|
||
A fizikai autó digitális leképzése.
|
||
|
||
* **Azonosítás:** `id`, `vin` (Alvázszám - Egyedi, nem módosítható!), `license_plate` (Rendszám).
|
||
* **Tulajdonos:** `user_id` (Csak az aktuális birtokost jelöli).
|
||
* **Technikai állapot:**
|
||
* `current_odometer`: A rendszer által folyamatosan frissített, aktuális km állás.
|
||
* `initial_odometer`: Rendszerbe lépéskori km.
|
||
|
||
|
||
* **Okmányok:** `mot_expiry_date` (Műszaki), `insurance_expiry_date` (Biztosítás).
|
||
* **Beállítások:** `is_primary` (Elsődleges jármű jelölő a gyors rögzítéshez).
|
||
|
||
### 3.3 Események (`data.vehicle_events`)
|
||
|
||
A jármű élettörténete (Append-only napló).
|
||
|
||
* **Adatok:** `event_type` (Tankolás, Szerviz, Javítás, Parkolás, Matrica), `amount` (Összeg), `description`.
|
||
* **Kritikus adatok:** `event_date` (Tényleges dátum - lehet múltbeli is!), `odometer` (Km állás az eseménykor).
|
||
* **Minősítés (Verification Level):**
|
||
* `A` (Hitelesített): Rendszeren keresztüli, vagy számlával/fotóval igazolt.
|
||
* `B` (Deklarált): Felhasználó által rögzített.
|
||
* `C` (Legacy): Rendszerbe lépés előtti, importált adat.
|
||
* `U` (Ismeretlen): Nincs adat.
|
||
|
||
|
||
|
||
### 3.4 Felhasználók (`data.users`)
|
||
|
||
* **Adatok:** `email`, `hashed_password`, `full_name`.
|
||
* **Típus:** `company_type` ('PRIVATE' - Magánszemély/Minicég, 'CORPORATE' - Cég).
|
||
* **Céges adat:** `tax_number` (Csak céges profilnál kötelező).
|
||
* **UI Preferencia:** `ui_skin` ('CLEAN' - Letisztult céges, 'FUN' - Egyedi/Játékos).
|
||
|
||
---
|
||
|
||
## 4. MŰKÖDÉSI ÉS ÜZLETI LOGIKA
|
||
|
||
### 4.1 Regisztrációs Folyamat
|
||
|
||
1. **Egykapus rendszer:** Mindenki ugyanott regisztrál (`/auth/register`).
|
||
2. **Adatbekérés:** Teljes név, Email, Jelszó (kötelező).
|
||
3. **Típus elágazás:**
|
||
* **Magánszemély / Minicég:** Nem ad meg adószámot. Nincs szigorú cégellenőrzés.
|
||
* **Cég (Corporate):** Adószám megadása kötelező. (Később API alapú cégadat ellenőrzés).
|
||
|
||
|
||
4. **Visszaigazolás:** Email kiküldése megerősítő linkkel. A fiók csak kattintás után aktív.
|
||
|
||
### 4.2 Jármű Életút Kezelés (VIN Logic)
|
||
|
||
* **Új jármű felvétele:** A rendszer először **VIN (Alvázszám)** alapján keres az adatbázisban.
|
||
* **Ha létezik:** Nem hoz létre újat! A meglévő jármű `user_id`-ját frissíti az új tulajdonosra (birtokba vétel). A jármű előélete megmarad.
|
||
* **Ha nem létezik:** Létrehozza az új rekordot.
|
||
|
||
|
||
* **Eltávolítás:** A felhasználó a "Lecsatolás" gombbal kiveszi a garázsából. A jármű az adatbázisban marad "gazdátlan" státuszban, vagy archív tulajdonosi előzménnyel.
|
||
|
||
### 4.3 Költség és Km Szinkronizáció (Smart Update)
|
||
|
||
* Amikor a felhasználó eseményt rögzít (pl. Tankolás 150.000 km-nél):
|
||
1. A Backend ellenőrzi: `Beküldött km >= Jelenlegi km?`
|
||
2. Ha érvényes, elmenti az eseményt.
|
||
3. **Automatizmus:** A Backend frissíti a `user_vehicles.current_odometer` mezőt az újra. Így a jármű állapota mindig naprakész.
|
||
|
||
|
||
|
||
---
|
||
|
||
## 5. JOGOSULTSÁGI RENDSZER (RBAC)
|
||
|
||
### 5.1 Szerepkörök (Roles)
|
||
|
||
1. **TULAJDONOS (Owner):** Jogi birtokos. Teljes körű jogok (szerkesztés, lecsatolás, sofőr hozzáadás).
|
||
2. **FLOTTA MANAGER:** Céges környezetben az autók kezelője. Jogosítványokat, orvosi engedélyeket ellenőriz.
|
||
3. **SOFŐR (Driver):** Csak a hozzá rendelt autót látja.
|
||
* **Korlátozás:** Csak költséget/eseményt rögzíthet. Törzsadatot nem módosíthat.
|
||
* **Ellenőrzés:** Ha a sofőr jogosítványa ("B") nem felel meg a járműnek ("C"), a rendszer **PIROS** riasztást küld a Managernek.
|
||
|
||
|
||
4. **SZERVIZ PARTNER:** Validált bejegyzéseket tehet a szervizkönyvbe.
|
||
|
||
---
|
||
|
||
## 6. MEGJELENÍTÉS ÉS UI/UX (Smart Dashboard)
|
||
|
||
### 6.1 Csempe Nézet (Smart Tiles)
|
||
|
||
Minden jármű egy interaktív kártya.
|
||
|
||
* **Fejléc:** Márka logó (kicsiben) + Rendszám + Becenév.
|
||
* **Adatok:** Típus, Aktuális km.
|
||
* **Vizuális állapotjelzők (Traffic Light System):**
|
||
* 🔴 **PIROS Felkiáltójel:** Kritikus hiba (Lejárt műszaki, lejárt biztosítás, túlfutott szervizintervallum > 1000 km).
|
||
* 🟡 **SÁRGA Felkiáltójel:** Figyelmeztetés (30 napon belüli lejárat, közeledő szerviz).
|
||
* 🟢 **Zöld Pipa / Keret:** Minden rendben.
|
||
|
||
|
||
|
||
### 6.2 Funkciók a Dashboardon
|
||
|
||
* **Elsődleges Jármű:** Külön kiemelt hely/gomb a "Primary" autónak a villámgyors rögzítéshez.
|
||
* **Skin Választó:**
|
||
* *Cégeknek:* Letisztult, Excel-szerű táblázatos nézet.
|
||
* *Magánszemélyeknek:* "Fun", grafikus, testreszabható felület.
|
||
|
||
|
||
|
||
---
|
||
|
||
## 7. SZOCIÁLIS ÉS KÖZÖSSÉGI FUNKCIÓK (Jövőkép)
|
||
|
||
### 7.1 Adatgyűjtés (Harvesting)
|
||
|
||
* A rendszer anonim módon gyűjti a szervizköltségeket, hogy piaci átlagárakat képezzen ("Mennyibe kerül egy Citigo vezérléscsere?").
|
||
|
||
### 7.2 Szerviz és Értékelés
|
||
|
||
* **Szervizkereső:** A felhasználó kereshet a közelben lévő, rendszer által minősített szervizeket.
|
||
* **Hiteles Értékelés:** Csak az értékelhet szervizt, akinek van **igazolt** (GPS vagy számla alapú) eseménye az adott helyen.
|
||
* **"Social Help":** Pánikgomb lerobbanás esetére, ami értesíti a közeli márkatársakat vagy autómentőket.
|
||
|
||
---
|
||
|
||
## 8. SPECIÁLIS KEZELÉSI ESETEK
|
||
|
||
* **Történelmi Adatok (Múlt):**
|
||
* Lehetőség van visszamenőleges rögzítésre (Dátumválasztóval).
|
||
* Ezek az adatok alacsonyabb (`C` vagy `Legacy`) minősítést kapnak a megbízhatósági indexben.
|
||
|
||
|
||
* **Hibás rögzítés:**
|
||
* Felhasználó nem törölhet eseményt véglegesen (hogy ne lehessen manipulálni a szervizkönyvet).
|
||
* Csak "Stornó" bejegyzés tehető, vagy Adminisztrátori kérésre javítható.
|
||
|
||
|
||
|
||
---
|
||
|
||
## 9. API VÉGPONT STRATÉGIA
|
||
|
||
Minden funkció REST API végponton érhető el (`/api/v1`).
|
||
|
||
* **Auth:** `register`, `login`, `verify-email`, `password-reset`.
|
||
* **Fleet:**
|
||
* `POST /vehicles` (Jármű felvétel - VIN logikával).
|
||
* `GET /vehicles` (Lista - Jogosultság szűrve).
|
||
* `DELETE /vehicles/{id}` (Lecsatolás a garázsból).
|
||
* `POST /vehicles/{id}/events` (Költség rögzítés + Odometer frissítés).
|
||
|
||
|
||
* **Catalog:** Márkák, modellek, logók lekérése.
|
||
* **Users:** Profil kezelés, sofőr adatok (jogosítvány érvényesség).
|
||
|
||
---
|
||
|
||
Ez a dokumentáció tartalmazza a **Service Finder** projekt teljes tudásanyagát a 2026.01.25-ös állapot szerint. Minden fejlesztésnek ezt a logikai keretrendszert kell követnie.
|
||
|
||
__________________________________________________________________________________________
|
||
Nem töröltem ki semmit, minden funkció (a korábbi V1.0-tól a legfrissebb ötletekig) benne van, de a szerkezetet átalakítottam úgy, hogy a Gamifikáció és a Verseny (Adatfeltöltés) a prioritási lista elejére került, és az Üzleti Modell (Lejárat/Családi flotta) a legfrissebb logikát tükrözi.
|
||
|
||
Ezt a blokkot mentsd el.
|
||
|
||
📂 SERVICE FINDER – UNIFIED MASTER SPECIFICATION
|
||
Verzió: 3.0 (Konszolidált Mesterterv) Prioritás: Gamifikáció vezérelt Bevezetés (Launch) Dátum: 2026.01.24.
|
||
|
||
🟢 HOGYAN HASZNÁLD EZT A DOKUMENTUMOT?
|
||
(Másold be ezt a szöveget új chat indításakor)
|
||
|
||
"Szia! Itt a Service Finder projekt aktuális, konszolidált Mesterterve. Minden korábbi verzió és ötlet ebben van egyesítve. A fejlesztési prioritás a 'Gamifikáció és Adatfeltöltés', mint a rendszer motorja. Kérlek, olvasd el, tárold el a memóriádban, és ez alapján folytassuk a munkát."
|
||
|
||
🏗️ I. ARCHITEKTURÁLIS ALAPELVEK (TECH STACK)
|
||
A rendszer nem egyetlen app, hanem egy moduláris ökoszisztéma ("Modular Monolith").
|
||
|
||
Platform: Docker konténerizált környezet.
|
||
|
||
Backend: Python FastAPI (Aszinkron).
|
||
|
||
Adatbázis: PostgreSQL 15 (Shared DB - Minden modul közös adatbázist használ, szeparált sémákkal).
|
||
|
||
Fájltárolás: MinIO (S3 kompatibilis - Képek, Dokumentumok, OCR alapanyag).
|
||
|
||
Frontend: React (SPA/PWA) - Mobilapp-szerű élmény, "buildelt" kódvédelem.
|
||
|
||
Elérés & Proxy: Nginx Proxy Manager (dev.profibot.hu, stb.).
|
||
|
||
🔑 II.0 REGISZTRÁCIÓ ÉS BIZTONSÁGI PROTOKOLL (v1.0)
|
||
A rendszerbe való belépés többszintű védelmi vonalon keresztül történik a botok és csalások kiszűrése érdekében.
|
||
|
||
Eszközszintű védelem (Rate Limiting):
|
||
|
||
ID alapú korlát: Egy adott eszközről (Device ID) 24 órán belül maximum 3 regisztrációs kísérlet engedélyezett.
|
||
|
||
Hűtési időszak: A limit elérése után az eszköz 24 órára zárolásra kerül az új regisztrációk elől (elkerülve a tömeges bot-regisztrációt, de kímélve a használt mobilt vásárlókat).
|
||
|
||
Többcsatornás Hitelesítés (Omnichannel Verification):
|
||
|
||
Email: Alapértelmezett visszaigazolás (AWS SES alapokon).
|
||
|
||
Telefonszám (Kritikus műveletekhez): Kötelező a versenyben való részvételhez és a Szerviz Partnereknek.
|
||
|
||
Csatornaválasztás: A felhasználó választhat, hogy a hitelesítő kódot SMS, WhatsApp vagy Telegram üzenetben kéri-e (költséghatékony és modern megoldás).
|
||
|
||
Flash Call opció: A rendszer egy véletlenszerű számról hívást indít, a usernek a hívó fél utolsó 4 számjegyét kell beírnia (opcionális, költségkímélő).
|
||
|
||
Hibrid Social Login:
|
||
|
||
Google / Apple ID: Engedélyezett a gyors belépéshez.
|
||
|
||
Adatkiegészítés: Ha a közösségi fiók nem tartalmaz minden szükséges adatot (pl. telefonszám), a rendszer egy popup ablakban kéri be azokat az első kritikus művelet előtt.
|
||
|
||
Bot-elleni védelem:
|
||
|
||
Láthatatlan reCAPTCHA v3 integráció a háttérben a gyanús tevékenységek (automatizált script-ek) kiszűrésére.
|
||
|
||
🏆 II. A "LAUNCH ENGINE": GAMIFIKÁCIÓ ÉS VERSENY (PRIORITÁS #1)
|
||
Ez a rendszer legfontosabb eleme az induláskor. Cél: A térkép "kifehérítése" és az adatbázis feltöltése közösségi erővel.
|
||
|
||
1. A Nagy Adatverseny (The Data Race)
|
||
Cél: Minél több minőségi szerviz és járműadat rögzítése rövid idő alatt.
|
||
|
||
Szezonok: 3-6 havonta zárás és díjazás.
|
||
|
||
Pontrendszer:
|
||
|
||
+10 pont: Új szerviz rögzítése (Fotó + Nyitvatartás + Alapadatok).
|
||
|
||
+5 pont: Márkaspecializáció rögzítése (Validáltan).
|
||
|
||
+50 pont: Hirdető beszervezése (Partnerkód megadásával).
|
||
|
||
+1 pont: Validálás (Más által feltöltött adat ellenőrzése).
|
||
|
||
Büntetés és Kizárás:
|
||
|
||
-2 pont: Téves adat beküldése.
|
||
|
||
-10 pont (Kritikus szint): Kizárás a versenyből. A felhasználó "Read-only" (csak olvasó) módba kerül a közösségi téren, nem vihet fel új szervizt.
|
||
|
||
2. Díjazás és Ranglisták
|
||
Jutalmak:
|
||
|
||
1-3. hely: Pénzjutalom.
|
||
|
||
4-10. hely: VIP előfizetés (1 év).
|
||
|
||
További helyezettek: Prémium tagságok (6-3 hónap).
|
||
|
||
Speciális Szerepkörök:
|
||
|
||
Helyi Validátor: A régió legaktívabb adatfeltöltője. Ő hagyhatja jóvá a vitatott módosításokat és szervezhet hirdetéseket.
|
||
|
||
👤 III. FELHASZNÁLÓK ÉS "MINI CÉGEK" (RBAC)
|
||
A rendszer mindenkit "Flottaként" kezel, a magánszemélytől a nagyvállalatig.
|
||
|
||
1. Magánszemély = "Családi Flotta" (Mini Cég)
|
||
Struktúra: A Családfő (Tulajdonos) kezeli a fiókot.
|
||
|
||
Tagok: Max 4 fő (Házastárs, Gyerekek) hívható meg "Sofőr" szerepkörbe.
|
||
|
||
Limit: Alapcsomagban 3 jármű.
|
||
|
||
Logika: A háttérben ugyanaz a céges logika fut, csak a felület barátságosabb ("Családtag meghívása").
|
||
|
||
2. Jogosultsági Szintek (Dinamikus)
|
||
Cégtulajdonos: Jogokat oszt/von meg (pl. kilépő dolgozó). Beállíthatja, ki rögzíthet költséget.
|
||
|
||
Flotta Manager: Látja a TMS-t, riasztásokat, költségeket.
|
||
|
||
Sofőr:
|
||
|
||
Csak a hozzá rendelt időszakban látja az autót.
|
||
|
||
Jogosultság: Csak Tankolás / Szerviz Rögzítés / Teljes Nézet.
|
||
|
||
Hirdetésszervező / Validátor:
|
||
|
||
Helyi szervizek fizikai ellenőrzése.
|
||
|
||
Szervizek "beszervezése" hirdetőnek (Kredit jutalékért).
|
||
|
||
📊 IV. ÜZLETI MODELL, LEJÁRAT ÉS HIRDETÉS (V2.5)
|
||
1. Előfizetési Csomagok
|
||
Free: Max 3 jármű. (Reklámokkal, Hirdetők előre sorolva).
|
||
|
||
Premium / VIP: Magasabb limitek, reklámmentes, Excel export, részletes statisztika.
|
||
|
||
Kiegészítő Járműdíj (Add-on):
|
||
|
||
Opció csomagváltás helyett (+1 autó).
|
||
|
||
Magán: +300 Ft (vagy kredit) / hó.
|
||
|
||
Céges: +500 Ft (2 €) / hó.
|
||
|
||
2. Lejárat Kezelése (3 Fázisú Lifecycle)
|
||
Ha az előfizetés lejár:
|
||
|
||
Türelmi Idő (1-30. nap) - "Vak Rögzítés":
|
||
|
||
Adatot lehet rögzíteni (nincs lyuk a szervizkönyvben).
|
||
|
||
Statisztika, Költségösszesítő, Előzmények NEM láthatóak.
|
||
|
||
Trust Score csökken.
|
||
|
||
Leminősítés (31. naptól):
|
||
|
||
Visszaáll Free szintre (Max 3 autó). A többi autó zárolásra kerül.
|
||
|
||
Visszamenőleges Aktiválás (Max 60. napig):
|
||
|
||
Ha rendezi a díjat (visszamenőleg is), az adatok és a Trust Score helyreállnak.
|
||
|
||
3. Hirdetési Rendszer (Hibrid)
|
||
Szervizeknek:
|
||
|
||
Idő alapú: Havi fix díjért kiemelt hely.
|
||
|
||
Kredit alapú (PPC): Egyenlegből vonódik le a megjelenés/kattintás.
|
||
|
||
Promóció (Win-Win):
|
||
|
||
User meghívja a szervizt -> User Kreditet kap.
|
||
|
||
User az Appra hivatkozik ("Innen jöttem") -> Szerviz Kedvezményt ad a munkadíjból.
|
||
|
||
🚗 V. JÁRMŰ ÉS KÖLTSÉG NYILVÁNTARTÁS (CORE)
|
||
1. Jármű Adatmodell (Deep Dive)
|
||
Törzsadatok: Kategória -> Márka -> Modell -> Generáció -> Motor.
|
||
|
||
Felszereltség: Dinamikus (Klíma, Multimédia, Felépítmény, Speciális eszközök).
|
||
|
||
Gumiabroncs Modul: Márka, Típus, Évszak, DOT szám figyelés (Riasztás 6 évnél öregebb guminál).
|
||
|
||
Trust Score: Százalékos megbízhatósági index (Fotó, Validált szerviz, Folyamatos km rögzítés növeli).
|
||
|
||
2. Költségnyilvántartás
|
||
Üzemeltetés: Üzemanyag, Adalék, Mosás, Parkolás.
|
||
|
||
Hatósági: Adók (Súly/Cégautó), Útdíj (Matrica/HU-GO), Bírságok.
|
||
|
||
Pénzügyi: Vételár, Lízing, Hitel, Értékcsökkenés.
|
||
|
||
Karbantartás: Szerviz, Gumi, Alkatrész.
|
||
|
||
Láthatóság (Privacy): Tulajdonosváltáskor az új tulajdonos nem látja a régi költségeit részletesen, csak statisztikát.
|
||
|
||
🛠️ VI. SZERVIZ KERESŐ ÉS SOS
|
||
Struktúra: Fa-rendszerű kategóriák (pl. Járműépítés -> Lakóautó -> Bútorozás).
|
||
|
||
Keresési Logika: Relevancia > Távolság > Hirdetői Státusz (Free) > Minőség.
|
||
|
||
SOS Protokoll: Választható "Biztonságos" (Szerződött partner) vagy "Gyors" (Legközelebbi műhely) opció.
|
||
|
||
Értékelés: Többszempontú (Szakmai, Ár, Sebesség). Csak validált látogatás után adható.
|
||
|
||
📡 VII. HALADÓ MODULOK (JÖVŐBENI BŐVÍTÉS)
|
||
Ezek az alaprendszerre épülnek, de külön fejlesztési fázisok.
|
||
|
||
TMS (Logisztika): Útvonaltervezés, Fuvarszervezés, Sofőr app nézet.
|
||
|
||
Telematika (Biztosítás): Opt-in adatgyűjtés (GPS, G-szenzor) a "Pay-how-you-drive" biztosításhoz.
|
||
|
||
Nemzetközi Modul: Ország sablonok (Vizsga intervallumok, Kötelező tartozékok betöltése).
|
||
|
||
Rendezvények: Eseménynaptár, Márkatalálkozók, Túrák szervezése.
|
||
|
||
🗓️ VIII. FEJLESZTÉSI ÜTEMTERV (ÚJ PRIORITÁSOK)
|
||
FÁZIS 1 (MVP + LAUNCH ENGINE):
|
||
|
||
Core Modul: Jármű, Költség, Szervizkereső, User/Cég alapok.
|
||
|
||
Gamifikáció: Verseny, Pontozás, Validálás (Hogy legyen adat!).
|
||
|
||
Üzlet: "Vak rögzítés" és Lejárat logikája.
|
||
|
||
FÁZIS 2 (NÖVEKEDÉS):
|
||
|
||
OCR: Hogy könnyebb legyen a feltöltés. (prémium és vip előfizetéssel credit levonállsal hanincs előfizetés vagy kredit nem aktív)
|
||
|
||
Referral Rendszer: Meghívók és Kreditek követése.
|
||
|
||
Ország Sablonok: Nemzetközi nyitás alapjai.
|
||
|
||
FÁZIS 3 (MONETIZÁCIÓ & PRO):
|
||
|
||
Hirdetési rendszer (PPC/Fix).
|
||
|
||
TMS és Telematika modulok.
|
||
|
||
Rendezvény szervezés.
|
||
|
||
📝 III. ÜZLETI ÉS FEEDBACK MODUL néven:
|
||
|
||
3.1 Üzletkötői hálózat:
|
||
|
||
Struktúra: Kizárólag jutalékos rendszer, három szinttel (Junior, Senior, Country Boss).
|
||
|
||
Területek: Flotta-akvizíció (SaaS) és Szerviz-partneri hirdetések.
|
||
|
||
Kifizetés: Szerződött partnereknek pénzügyi elszámolás, alkalmi ajánlóknak max. 2 havi Prémium/Kredit jóváírás.
|
||
|
||
3.2 Feedback és Minőségbiztosítás:
|
||
|
||
Hiba-bejelentés: Automatizált diagnosztikai adatok küldése az alkalmazásból.
|
||
|
||
Fejlesztési javaslatok: Közösségi szavazásra bocsátott ötletek, rangsorolt megvalósítás.
|
||
|
||
Jutalmazás: A valid hibákért és sikeres fejlesztési ötletekért extra pontok és "System Builder" rang jár.
|
||
|
||
🏢 1. Az "Üzletkötői Portál" (Partner Dashboard)
|
||
Azok számára, akik fizetést vagy valódi pénzbeli jutalékot akarnak, egy külön szintet kell létrehozni a rendszerben.
|
||
|
||
Szerződéses háttér: Náluk a regisztráció nem egy gombnyomás. Fel kell tölteniük a vállalkozói igazolványukat vagy cégadataikat, és egy digitális keretszerződést kell kötniük veled.
|
||
|
||
Egyedi Partnerkódok: Olyan kódokat kapnak, amelyek nem csak kedvezményt adnak az ügyfélnek, hanem a rendszerben "Jutalékos" jelzővel vannak ellátva.
|
||
|
||
Transzparencia: Egy külön felületen látják, hány cég regisztrált a kódjukkal, mennyi volt a befizetett összeg, és mennyi a felhalmozott, kifizethető jutalékuk.
|
||
|
||
💰 2. Jutalékkezelési Modellek (Pénzügyi logika)
|
||
Ahelyett, hogy fix fizetést adnál (ami nagy kockázat az elején), a sikerdíjas modellt javaslom, három szinten:
|
||
|
||
Szervezési jutalék (Egyszeri): Az első éves vagy féléves előfizetési díj egy magasabb százaléka (pl. 15-20%).
|
||
|
||
Gondozási jutalék (Recurring): Amíg az ügyfél fizeti a havidíjat, az üzletkötő kap egy kisebb, fix százalékot (pl. 3-5%). Ez motiválja őt, hogy tartsa a kapcsolatot a flottával, segítsen nekik az adatok tisztításában.
|
||
|
||
Adattisztítási bónusz: Ha egy moderátor/üzletkötő manuálisan validál egy szervizt vagy ellenőriz egy vitatott adatot, fix összeget (pl. 0.5 - 1 €) írhatunk jóvá a számláján munkadíjként.
|
||
|
||
🌍 3. Nemzetközi "Master Franchise" Modell
|
||
Ha kilépünk az országhatáron kívülre, nem tudsz mindenhol te lenni a moderátor. Ilyenkor jön a Country Manager szint:
|
||
|
||
Országfelelős: Ő kap egy százalékot az összes adott országból származó bevételből.
|
||
|
||
Feladata: Ő kezeli a helyi üzletkötőket, ő felel a jogszabályi sablonok (műszaki vizsga időközök, adók) helyességéért, és ő végzi a legfelsőbb szintű moderációt.
|
||
|
||
🛠️ 4. Technikai megvalósítás (Pénztárcabarát módon)
|
||
Hogy ne kelljen bonyolult bérszámfejtő szoftvert írnunk:
|
||
|
||
Kifizetési küszöb: Csak akkor kérhet kifizetést, ha elér pl. 100 € jutalékot.
|
||
|
||
Számlázás: Ő állít ki neked egy számlát "Marketing tevékenység" vagy "Adatkezelés" címen, te pedig utalsz.
|
||
|
||
Kredit-Pénz hibrid: Az üzletkötő választhat: ha pénzben kéri, adózni kell utána. Ha kreditben kéri (hogy hirdesse a saját üzletét a rendszerben), akkor több "virtuális értéket" kap.
|
||
|
||
📝 Mesterterv Kiegészítés (v3.3)
|
||
Partneri és Üzletkötői Modul:
|
||
|
||
Hibrid Jutalmazás: Lakossági szinten Kredit, Üzletkötői szinten Pénzbeli jutalék (Szerződés alapján).
|
||
|
||
Partner Dashboard: Külön felület az értékesítési statisztikák és kifizetések követésére.
|
||
|
||
B2B Protection: Céges előfizetés esetén a magánszemély meghívója nem kaphat privát anyagi előnyt, a jutalékot vagy a cég kapja kedvezményként, vagy a hivatásos üzletkötő jutalékként.
|
||
|
||
📘 SERVICE FINDER ECOSYSTEM – FINAL MASTER SPECIFICATION (v3.5)
|
||
Dátum: 2026.01.24. | Státusz: Fejlesztésre kész (Ready for Implementation)
|
||
|
||
1. Média és Offline Kezelés
|
||
Média: Kizárólag fotó alapú rögzítés (számla, forgalmi, állapotrögzítés). Nincs videótámogatás a sávszélesség és tárolási költségek optimalizálása érdekében.
|
||
|
||
Offline mód: PWA/Mobil kliens oldali gyorsítótárazás. Az adatok netkapcsolat hiányában a telefonon tárolódnak.
|
||
|
||
Háttér-szinkronizáció: Amint Wi-Fi vagy mobilnet rendelkezésre áll, az alkalmazás a háttérben (indítás nélkül is) elküldi a függőben lévő adatokat a szerverre.
|
||
|
||
2. SOS és Helymeghatározás
|
||
Logika: Nincs folyamatos GPS követés (erőforrás-kímélés).
|
||
|
||
SOS Esemény: Csak a gomb megnyomásakor kérdezi le a rendszer a koordinátákat.
|
||
|
||
Megjelenítés: A user kijelzőjén azonnal megjelenik a pontos GPS koordináta és (geocoding segítségével) a legközelebbi cím (város, utca, házszám), hogy segítse a szóbeli hibabejelentést.
|
||
|
||
3. Felhasználói Élmény (UI/UX Strategy)
|
||
Hibrid Dizájn: Letisztult, funkcionális alapfelület (B2B/Flotta), amely kreditért vásárolható egyedi skinekkel, ikonokkal és animációkkal tehető "csicsássá" a magánszemélyek/fiatalok számára.
|
||
|
||
🛠️ Megvalósítási Útmutató (PM-nek és Fejlesztőnek)
|
||
Mivel a tervezési fázist lezártuk, íme a technikai start-szekvencia, amint hozzáférsz a szerverhez:
|
||
|
||
Infrastruktúra ellenőrzése:
|
||
|
||
Docker konténerek futásának ellenőrzése (docker ps).
|
||
|
||
Adatbázis elérés tesztelése (pgAdmin vagy terminal).
|
||
|
||
Környezeti változók (.env) véglegesítése:
|
||
|
||
AWS SES (Email) API kulcsok.
|
||
|
||
Google OAuth Client ID & Secret.
|
||
|
||
WhatsApp/SMS Gateway API kulcsok.
|
||
|
||
Adatbázis Migráció (Alembic):
|
||
|
||
A korábban elkészített gamification.py, user.py, company.py és referral.py modellek alapján a táblák létrehozása a data sémában.
|
||
|
||
Backend "Skeleton" felépítése:
|
||
|
||
Routerek regisztrálása a main.py-ban.
|
||
|
||
A háttérben futó szinkronizációs logikához szükséges "worker" (pl. Celery vagy FastAPI BackgroundTasks) beállítása.
|
||
_______________________________________________________________________________________________________________________________
|
||
|
||
|
||
|
||
A kérésedre a megoldás a "Modular Monolith" (Moduláris Monolit) dokumentáció. Hogy hogyan bontsuk? Úgy készítettem el az alábbi Master Dokumentumot, hogy MARKDOWN formátumban van.
|
||
|
||
Hogyan használd új chat nyitásakor? Nem kell mást tenned, mint kimásolni az egész lenti blokkot (a --- vonalak között), és beilleszteni az új chat ablakba ezzel a felütéssel:
|
||
|
||
"Szia! Itt a Service Finder projekt aktuális Mesterterve és státusza. Kérlek, olvasd el, tárold el a memóriádban, és ez alapján folytassuk a munkát."
|
||
|
||
Íme a véglegesített, mindenre kiterjedő specifikáció:
|
||
|
||
📂 SERVICE FINDER SPECIFICATION UPDATES
|
||
Módosított Modulok: Felhasználók, Üzleti Modell, Gamifikáció, Roadmap
|
||
|
||
👤 II. FELHASZNÁLÓK ÉS CSALÁDI FLOTTÁK (MÓDOSÍTOTT)
|
||
A rendszer mindenkit "Flottaként" kezel, csak a méret és a jogi státusz változik.
|
||
|
||
1. Magánszemély ("Mini Cég")
|
||
Struktúra: A Családfő (Tulajdonos) kezelheti a családi flottát.
|
||
|
||
Hozzáadható tagok: Max 4 fő (pl. Házastárs, Gyerekek). Ők "Sofőr" szerepkört kapnak.
|
||
|
||
Jármű limit: Alapcsomagban 3 db.
|
||
|
||
Logika: Ugyanaz a kód fut a háttérben, mint a cégeknél, csak a gombok felirata barátságosabb (pl. "Sofőr hozzáadása" helyett "Családtag meghívása").
|
||
|
||
2. Validátor és Hirdetésszervező (Kiemelt Szerepkörök)
|
||
A közösségből kiemelkedő, megbízható felhasználók.
|
||
|
||
Feladat:
|
||
|
||
Helyi szervizek adatainak fizikai ellenőrzése (pl. "Tényleg létezik, ott a tábla").
|
||
|
||
Szervizek "beszervezése" hirdetőnek.
|
||
|
||
Jutalom:
|
||
|
||
Kiemelt státusz (Trust Score növelése).
|
||
|
||
Jutalék (Kredit formájában): A beszervezett hirdetések után kreditet kap, amit saját prémiumra vagy szolgáltatásokra fordíthat.
|
||
|
||
📊 V. ÜZLETI MODELL, LEJÁRAT ÉS PROMÓCIÓ (KOMBINÁLT v2.5)
|
||
Rugalmas bővítési lehetőségek, szigorú, de fair lejárat-kezelés és közösségi alapú marketing.
|
||
|
||
1. Előfizetési Szintek és Bővítés
|
||
Free (Ingyenes): Max 3 jármű. (Reklámokkal támogatott, "Hirdető" szervizek előre sorolva a keresőben).
|
||
|
||
Premium / VIP: Magasabb járműlimitek, reklámmentes felület, Excel export, részletes statisztikák.
|
||
|
||
Kiegészítő Járműdíj (Add-on):
|
||
|
||
Cél: Ha a felhasználó nem akar teljes csomagot váltani, de a limiten felül +1 autót rögzítene.
|
||
|
||
Árazás (Magán): +300 Ft (vagy kredit) / hó / jármű.
|
||
|
||
Árazás (Céges): +500 Ft (2 €) / hó / jármű.
|
||
|
||
2. Lejárat és Türelmi Idő (Lifecycle Management)
|
||
A rendszer 3 fázisban kezeli a lejárt előfizetést vagy a be nem fizetett kiegészítő díjat:
|
||
|
||
Fázis 1: Türelmi Idő és "Vak Rögzítés" (1-30. nap):
|
||
|
||
Státusz: "Felfüggesztett / Grace".
|
||
|
||
Adatkezelés (Write-Only): A felhasználó továbbra is be tudja írni a tankolást/szervizt (hogy ne legyen lyuk a szervizkönyvben), DE:
|
||
|
||
Nem látja a statisztikákat és diagramokat.
|
||
|
||
Nem látja a költségösszesítőt.
|
||
|
||
Nem látja a részletes szerviztörténetet (csak rögzíteni tud).
|
||
|
||
Minősítés: A "Trust Score" lassú csökkenésnek indul (mivel a rendszer nem futtat prémium anomália-ellenőrzéseket).
|
||
|
||
Fázis 2: Leminősítés (31. naptól):
|
||
|
||
Státusz: "Downgraded to Free".
|
||
|
||
Korlátozás: A rendszer visszaállítja a fiókot Free szintre (Max 3 jármű).
|
||
|
||
Szelekció: A felhasználónak ki kell választania, melyik 3 jármű marad aktív. A többi (4.+) jármű teljesen zárolásra kerül (már rögzíteni sem lehet hozzá adatot).
|
||
|
||
Fázis 3: Visszamenőleges Aktiválás (Max 60. napig):
|
||
|
||
Retroaktív fizetés: Ha a felhasználó újra fizet (és kifizeti a kimaradt időszakot is), a "Vak időszakban" rögzített adatok láthatóvá válnak, a statisztikák helyreállnak, és a Trust Score normalizálódik.
|
||
|
||
3. Promóció, Referral és Hirdetésszervezés
|
||
A rendszer "Win-Win" alapon ösztönzi a terjedést.
|
||
|
||
Szerviz Meghívása (B2B Referral):
|
||
|
||
Logika: A User bemutatja az Appot egy szerviznek.
|
||
|
||
Jutalom: Ha a szerviz regisztrál (a User kódjával), a User Kreditet kap, amit prémiumra vagy szolgáltatásra válthat.
|
||
|
||
Ügyfélkedvezmény (B2C Benefit):
|
||
|
||
Logika: A User az Appra hivatkozva érkezik a szervizbe ("Jöttem a Service Finderből").
|
||
|
||
Jutalom: A Szerviz X% kedvezményt biztosít (munkadíjból vagy alkatrészből).
|
||
|
||
Előny: A szerviznek ez "sikerdíjas marketing" (csak akkor ad kedvezményt, ha ott a vevő), az App pedig ingyen reklámot kap.
|
||
|
||
Helyi Szervezők (Validátorok):
|
||
|
||
Kiemelt felhasználók, akik "Mini Ügynökként" működnek: ellenőrzik a helyi adatokat és segítik a szervizek regisztrációját (Kredit/Jutalék alapon).
|
||
|
||
🏆 VIII. VERSENY ÉS ADATFELTÖLTÉS (ELŐREHOZVA!)
|
||
Ez a Launch Engine. A program terjedésének alapja.
|
||
|
||
1. A Nagy Adatverseny (The Data Race)
|
||
Cél: A térkép "kifehérítése" (szervizekkel való feltöltése) minél rövidebb idő alatt.
|
||
|
||
Pontozás:
|
||
|
||
Új szerviz + Fotó + Nyitvatartás: +10 pont.
|
||
|
||
Márkapspecializáció rögzítése (validáltan): +5 pont.
|
||
|
||
Hirdető beszervezése (Partnerkód megadásával): +50 pont.
|
||
|
||
Büntetés (-10 pont): Fals adat beküldése -> Kizárás a versenyből.
|
||
|
||
2. Lokális Helytartók (Validátorok)
|
||
A rendszer automatikusan felajánlja a régió legaktívabb adatfeltöltőjének a "Helyi Validátor" címet.
|
||
|
||
Ők hagyhatják jóvá a vitatott módosításokat a környékükön.
|
||
|
||
🗓️ IX. FEJLESZTÉSI ÜTEMTERV (ÚJ ROADMAP)
|
||
A Gamifikáció az MVP utáni azonnali prioritás lett.
|
||
|
||
Fázis 1 (MVP - Alapok):
|
||
|
||
Core modul (Jármű, Költség, Szervizkereső).
|
||
|
||
Mini-Cég / Családi logika implementálása.
|
||
|
||
Költségek és Lejárat (Write-only mód) logikája.
|
||
|
||
Fázis 2 (Növekedés - A Vírus):
|
||
|
||
Gamifikáció és Verseny modul (Adatfeltöltés, Ranglisták).
|
||
|
||
Validátor rendszer és Referral (Meghívás) követés.
|
||
|
||
OCR (hogy a feltöltés könnyebb legyen).
|
||
|
||
Fázis 3 (Monetizáció):
|
||
|
||
Hirdetési rendszer (Kredit/Fix).
|
||
|
||
Kiegészítő járműdíjak (Add-on fizetés).
|
||
|
||
Ország sablonok.
|
||
|
||
Fázis 4 (Expurzió):
|
||
|
||
Telematika, TMS, Rendezvények.
|
||
|
||
📂 SERVICE FINDER ECOSYSTEM – MASTER SPECIFICATION
|
||
Verzió: 2.3 (Véglegesített Logika: Telematika, TMS, Hibrid Hirdetés) Dátum: 2026.01.24. Státusz: MVP Fejlesztés alatt / Architektúra fixálva
|
||
|
||
🏗️ 1. ARCHITEKTURÁLIS ALAPELVEK
|
||
A rendszer nem egyetlen app, hanem egy moduláris ökoszisztéma, amely egy közös adatbázison ("Single Source of Truth") osztozik.
|
||
|
||
Core App (Service Finder): Nyilvántartás, Keresés, Költségek.
|
||
|
||
TMS Modul (Logisztika): Útvonaltervezés, Fuvarszervezés (külön nézet/gomb).
|
||
|
||
Telematika Modul (Biztosítás): Háttérben futó adatgyűjtés.
|
||
|
||
Adatbázis: PostgreSQL (Shared DB) - A sofőrök, autók és cégek közösek minden modulban.
|
||
|
||
👤 2. FELHASZNÁLÓK ÉS JOGOSULTSÁGOK (RBAC)
|
||
|
||
Dinamikus, cégenként konfigurálható szerepkörök.
|
||
|
||
Szerepkörök:
|
||
|
||
Superadmin: Rendszerkarbantartás.
|
||
|
||
Cégtulajdonos: Jogkezelés, Előfizetés menedzsment.
|
||
|
||
Flotta Manager: TMS irányítás, Költség kontroll, Riasztások.
|
||
|
||
Sofőr:
|
||
|
||
Lakossági: Saját autó menedzselése.
|
||
|
||
Céges: Hozzárendelt autók vezetése, TMS feladatok látása.
|
||
|
||
Szerviz Partner: Időpontkezelés, Hirdetés kezelés.
|
||
|
||
Nemzetközi Árazás (Geo-Pricing):
|
||
|
||
Automatikus IP alapú detektálás regisztrációkor.
|
||
|
||
Különböző árszabás (PPP alapú) országonként a kreditekre és előfizetésekre.
|
||
|
||
🚗 3. JÁRMŰ ÉS KÖLTSÉG MODUL (CORE)
|
||
3.1. Jármű Adatmodell
|
||
Hierarchia: Kategória -> Márka -> Modell -> Generáció -> Motor.
|
||
|
||
Felszereltség: Dinamikus JSON (Klíma, Multimédia, Felépítmény).
|
||
|
||
Gumiabroncs: DOT szám figyelés, Szezonális riasztás.
|
||
|
||
3.2. Költségnyilvántartás (Részletes)
|
||
Üzemeltetés: Üzemanyag, Adalék (AdBlue), Mosás/Kozmetika, Parkolás, Tárolás.
|
||
|
||
Hatósági: Súlyadó/Cégautóadó, Útdíj (Matrica/HU-GO), Vagyonszerzési illeték, Eredetvizsga, Bírságok.
|
||
|
||
Pénzügyi: Vételár, Lízing/Bérleti díj, Hitel, Értékcsökkenés.
|
||
|
||
Biztosítás: KGFB, CASCO, Balesetbiztosítás.
|
||
|
||
Karbantartás: Tervezett szerviz, Váratlan javítás, Gumiabroncs, Alkatrész.
|
||
|
||
🛠️ 4. SZERVIZ KERESŐ ÉS SOS (CORE)
|
||
4.1. Keresési Logika
|
||
Fa-struktúra: Főkategória (Javítás) -> Alkategória (Mechanika) -> Címke (BMW).
|
||
|
||
Ranking: Relevancia > Távolság > Hirdetői Státusz (Free usereknél) > Minőség.
|
||
|
||
4.2. Vészhelyzeti Protokoll (SOS)
|
||
A felhasználó választása alapján:
|
||
|
||
A) Biztonságos: Legközelebbi Szerződött/Preferált partner (akár távolabb).
|
||
|
||
B) Gyors: Fizikailag legközelebbi műhely (akár validálatlan is).
|
||
|
||
4.3. Értékelés
|
||
Többszempontú (Szakmai, Kommunikáció, Ár, Sebesség).
|
||
|
||
Csak validált látogatás után (GPS/Számla).
|
||
|
||
Munkafelvétel és Szerelő külön értékelhető (ha a szerviz engedélyezi).
|
||
|
||
📊 5. ÜZLETI MODELL ÉS HIRDETÉS
|
||
5.1. Előfizetések (User oldal)
|
||
Free: Max 3 autó, Reklámok, PDF export.
|
||
|
||
Premium: Max 5 autó, Nincs reklám, Excel export, Tiszta találatok.
|
||
|
||
VIP (Flotta): 10+ autó, Anomália figyelés, TMS integráció lehetősége.
|
||
|
||
5.2. Hirdetési Rendszer (Szolgáltató oldal)
|
||
Két párhuzamos modell (választható):
|
||
|
||
Idő alapú (Subscription): Havi fix díjért állandó kiemelt hely/megjelenés.
|
||
|
||
Kredit alapú (PPC/Performance):
|
||
|
||
Feltöltött egyenlegből vonódik le minden megjelenés/kattintás után.
|
||
|
||
Ha elfogy a kredit, a hirdetés leáll (normál listázásra vált).
|
||
|
||
Statisztika: A hirdető részletes kimutatást kap a konverziókról.
|
||
|
||
🛣️ 6. LOGISZTIKA ÉS TMS (PRO MODUL)
|
||
Külön nézet, de közös adatbázis. Gombnyomással váltható.
|
||
|
||
Funkciók:
|
||
|
||
Többpontos útvonaltervezés (Multi-drop).
|
||
|
||
Útvonal optimalizálás (sorrendezés).
|
||
|
||
Sofőr app nézet: Feladatlista, Vevő értesítése érkezéskor.
|
||
|
||
Visszatérés bázisra vagy új pontra.
|
||
|
||
Kapcsolat: A TMS-ben futott km és költség automatikusan bekerül a Core modul költségnyilvántartásába.
|
||
|
||
📡 7. TELEMATIKA ÉS BIZTOSÍTÁS (INSURTECH MODUL)
|
||
Működés: Opt-in (Önkéntes) alapon.
|
||
|
||
Adatgyűjtés: GPS, Gyorsulás (G-szenzor), Sebességprofil.
|
||
|
||
Szinkronizáció: Wi-Fi/Mobilneten keresztül kötegelt feltöltés (nem real-time stream a sávszélesség védelméért, kivéve baleset).
|
||
|
||
Cél: "Pay-how-you-drive" biztosítási ajánlatok generálása az alkuszi modulban.
|
||
|
||
Privacy: Ha a user nem engedélyezi, nincs mérés, de nincs kedvezmény sem.
|
||
|
||
🏆 8. KÖZÖSSÉG ÉS GAMIFIKÁCIÓ
|
||
8.1. Verseny és Pontgyűjtés
|
||
Cél: Adatbázis töltés (Új szerviz +5 pont, Validálás +1 pont).
|
||
|
||
Büntetés: -10 pontnál kizárás a szerkesztésből (Read-only).
|
||
|
||
Szezonok: 3-6 havonta díjazás (Pénz, VIP tagság).
|
||
|
||
8.2. Rendezvények (MVP)
|
||
Funkció: Eseménynaptár + Térkép nézet (Hol van találkozó a közelben?).
|
||
|
||
Típusok: Márkatalálkozó, Túra, Kiállítás.
|
||
|
||
Jövő: Social feed, Csoportszervezés (későbbi fázis).
|
||
|
||
🗓️ 9. FEJLESZTÉSI ÜTEMTERV (ROADMAP)
|
||
MVP (Most): Core modul (Jármű, Költség, Szervizkereső), Jogosultságok, MinIO/DB alapok.
|
||
|
||
Fázis 2 (Adat): Ország sablonok, OCR, Gumiabroncs modul.
|
||
|
||
Fázis 3 (Üzlet): Hirdetési rendszer (Kredit/Fix), Előfizetések.
|
||
|
||
Fázis 4 (Expurzió): Telematika modul, TMS nézet, Gamifikáció start.
|
||
|
||
📘 Service Finder – Rendszer Specifikáció 2.2 (MASTER)
|
||
Verzió: 2.2 (Nemzetközi Modul, SOS Logika, Szerviz Kereső, Gamifikáció) Státusz: Fejlesztésre kész (Ready for Development)
|
||
|
||
I. Rendszer Architektúra (Technikai Alapok)
|
||
A rendszer célja egy nemzetközi, közösségi alapú jármű- és szerviznyilvántartó platform biztosítása SaaS modellben.
|
||
|
||
Platform: Docker konténerizált környezet (FastAPI Backend, PostgreSQL DB, React Frontend, MinIO Storage).
|
||
|
||
Adatbiztonság: Szigorú szeparálás (Tenant/User szinten).
|
||
|
||
Elérés: Webes felület (PWA - Progresszív Web App), ami mobilon applikációként viselkedik.
|
||
|
||
II. Felhasználók és Jogosultságok (RBAC)
|
||
A jogosultságok dinamikusak, cégenként/flottánként változhatnak.
|
||
|
||
1. Szerepkörök
|
||
Superadmin: Rendszerkarbantartás.
|
||
|
||
Cégtulajdonos: Jogokat oszthat ki és vonhat vissza (pl. kilépő dolgozó).
|
||
|
||
Flotta Manager: Látja a riasztásokat, költségeket, visszaéléseket.
|
||
|
||
Sofőr:
|
||
|
||
Csak a hozzá rendelt időszakban látja az autót.
|
||
|
||
Jogosultsága lehet: Csak Tankolás, Szerviz Rögzítés, vagy Teljes Nézet.
|
||
|
||
Szerviz Partner: Saját adatlapot kezel, időpontot fogad, promóciót állít be.
|
||
|
||
III. Jármű Nyilvántartás ("A Vas")
|
||
Hierarchikus, részletes adatstruktúra a pontos szerviz-ajánláshoz.
|
||
|
||
1. Jármű Adatmodell
|
||
Törzsadatok: Kategória (Személy/Teher/Motor/Egyéb) -> Márka -> Modell -> Generáció -> Motor.
|
||
|
||
Felszereltség (Dinamikus attribútumok):
|
||
|
||
Személyautó: Klíma típus, Multimédia, Vonóhorog.
|
||
|
||
Teherautó: Tachográf, Útdíj-box, Raktérhűtés.
|
||
|
||
Speciális: Lószállító felépítmény, Lakóautó bútorzat.
|
||
|
||
Gumiabroncs Modul:
|
||
|
||
Márka, Típus, Méret, Évszak.
|
||
|
||
DOT Figyelés: Riasztás 6 évnél öregebb gumi esetén.
|
||
|
||
2. Nemzetközi Megfelelőség (EU Compliance) – ÚJ!
|
||
Ország Sablonok (Country Templates): A rendszer előre definiált szabályrendszereket kínál fel (pl. "Magyarország", "Ausztria", "Németország").
|
||
|
||
Logika: A felhasználó kiválasztja az országot, a rendszer betölti a kötelező elemeket:
|
||
|
||
Vizsga intervallumok: (Pl. HU: 4-2-2 év).
|
||
|
||
Kötelező tartozékok: (Pl. Izzókészlet, Mellények száma).
|
||
|
||
Adózási szabályok: (Cégautóadó, Súlyadó kalkuláció alapjai).
|
||
|
||
Ideiglenes Engedélyek: Kezelni tudja az "Ideiglenes forgalomba helyezés" vagy "Próba rendszám" speciális lejáratait.
|
||
|
||
IV. Szerviz Kereső és Szolgáltatások (A "Lelke")
|
||
Ez a modul köti össze a hibát a megoldással.
|
||
|
||
1. Szolgáltatás Fa-struktúra (Taxonómia)
|
||
Nem ömlesztett lista, hanem címkézett fa-rendszer a pontos találatért:
|
||
|
||
Főkategória: (Pl. Járműjavítás, Mentés, Kényelmi átalakítás).
|
||
|
||
Alkategória: (Pl. Villamosság, Mechanika, Gumiszerviz).
|
||
|
||
Specializáció (Címkék): (Pl. "Csak BMW", "Csak Klíma", "Lószállító építés").
|
||
|
||
Szűrés: Ha a jármű "Honda", a rendszer elrejti a "Csak BMW" címkéjű szervizeket, kivéve ha a felhasználó kéri az összeset.
|
||
|
||
2. Keresési Logika (Matching Algorithm)
|
||
A találati lista sorrendjét az alábbi súlyozás határozza meg:
|
||
|
||
Relevancia: Képes-e megoldani a konkrét hibát? (Pl. Defekt -> Gumis).
|
||
|
||
Távolság: GPS alapú távolság.
|
||
|
||
Előfizetés: A Hirdető/Partner szervizek előrébb (Free/Premium usereknél). VIP-nél csak a minőség dönt.
|
||
|
||
Validáltság: Ellenőrzött szervizek előnyben.
|
||
|
||
Minősítés: Csillagok és "Trust Score".
|
||
|
||
3. Vészhelyzeti Protokoll (SOS) – ÚJ!
|
||
Két opciót kínál fel a rendszer (User Decision):
|
||
|
||
"A" Opció (Biztonságos): A legközelebbi Szerződött/Preferált partner (lehet, hogy 50 km).
|
||
|
||
"B" Opció (Gyors): A fizikailag legközelebbi szerviz, akár validálatlan is (lehet, hogy 2 km).
|
||
|
||
Autómentés: Ha a jármű mozgásképtelen, a rendszer azonnal trélert vagy "Sárga Angyalt" ajánl a javítóműhely mellé.
|
||
|
||
4. Progresszív Profilozás
|
||
A szervizek regisztrációja gyors (Név + Cím + Főtevékenység).
|
||
|
||
Jutalmazás: Ha kitölti a részleteket (pl. "Vállalok hétvégét is", "Van váróterem"), jobban rangsorolja a rendszer.
|
||
|
||
Feedback hurok: Ha a felhasználó jelzi, hogy "A szerviz adatlapja szerint van klímatöltés, de a helyszínen elhajtottak", a szerviz büntetőpontot kap.
|
||
|
||
V. Értékelés és Minőségbiztosítás
|
||
1. Többszempontú Értékelés
|
||
Nem csak egy csillag, hanem kategóriák (1-5):
|
||
|
||
Szakmai munka: Megjavult?
|
||
|
||
Kommunikáció: Felvették a telefont? Kedvesek voltak? (Itt értékeljük a munkafelvételt név nélkül).
|
||
|
||
Ár/Érték arány: Korrekt volt a számla?
|
||
|
||
Sebesség: Tartották a határidőt?
|
||
|
||
2. Validált Értékelés
|
||
Csak akkor értékelhet, ha igazolja, hogy ott járt (GPS check-in, Fotó a munkalapról, vagy Számla feltöltés).
|
||
|
||
Negatív értékelés: Szervizenként/Javításonként max 1 db (Anti-spam).
|
||
|
||
VI. Gamifikáció és Adatverseny
|
||
A közösség építi az adatbázist.
|
||
|
||
1. Verseny Szezonok (3-6 hónap)
|
||
Cél: Minél több minőségi adat feltöltése.
|
||
|
||
Pontozás:
|
||
|
||
+5 pont: Új szerviz (validált adatokkal).
|
||
|
||
+1 pont: Validálás (más által feltöltött adat megerősítése).
|
||
|
||
-2 pont: Téves adat beküldése.
|
||
|
||
Kizárás (-10 pont): A felhasználó elveszti a rögzítési jogot (Read-only), csak a saját költségeit írhatja.
|
||
|
||
2. Jutalmazás
|
||
Ranglista alapján: Pénzjutalom (1-3.), VIP előfizetés, Prémium tagság.
|
||
|
||
VII. Előfizetési Csomagok (Üzleti Modell)
|
||
Free: Max 3 jármű, Reklámok, PDF export, Hirdetők előre sorolva.
|
||
|
||
Premium: Max 5 jármű, Nincs reklám, Excel export, Tiszta találati lista.
|
||
|
||
VIP (Flotta): 10+ jármű.
|
||
|
||
Anomália figyelés: Túl sok tankolás? Gyanús szervizszámla?
|
||
|
||
Smart Alerts: Egyéni időzített értesítések.
|
||
|
||
Prioritás: A rendszer a legideálisabb (nem a fizetett) szervizt adja.
|
||
|
||
VIII. Fejlesztési Ütemterv (Roadmap)
|
||
Fázis 1 (MVP - A Gerinc):
|
||
|
||
Adatbázis (User, Vehicle, Service, Ownership, Audit).
|
||
|
||
Alap jogosultságok (Cég/Sofőr).
|
||
|
||
Jármű rögzítés (Manuális) + Költség rögzítés.
|
||
|
||
Szerviz kereső (Alap, távolság alapú).
|
||
|
||
Fázis 2 (Okosítás):
|
||
|
||
Sablon alapú Ország modul (HU, DE, AT kezdésnek).
|
||
|
||
OCR bevezetése a dokumentumokhoz.
|
||
|
||
Gumiabroncs (DOT) modul.
|
||
|
||
Fázis 3 (Közösség):
|
||
|
||
Gamifikáció és Verseny indítása.
|
||
|
||
Részletes értékelési rendszer.
|
||
|
||
VIP elemzések (Anomália detektálás).
|
||
|
||
📘 Service Finder – Rendszer Specifikáció 2.1
|
||
Verzió: 2.1 (Felszereltség, Előfizetések, Verseny és Launch Stratégia) Státusz: MVP + Üzleti Logika Véglegesítése
|
||
|
||
I. Jármű Adatmodell & Felszereltség (Deep Dive)
|
||
A járművek típusától függően dinamikus felszereltség-listát kezelünk (JSONB formátumban tárolva a rugalmasságért).
|
||
|
||
1. Kategória-specifikus Extrák
|
||
Személyautó:
|
||
|
||
Klíma: Manuális, Automata, 2+ Zónás, Hőszivattyús (EV-nél kritikus).
|
||
|
||
Multimédia: CarPlay/Android Auto, Navigáció, Hangrendszer.
|
||
|
||
Motorkerékpár:
|
||
|
||
Kényelem: Markolatfűtés, Ülésfűtés, Állítható szélvédő.
|
||
|
||
Tech: USB töltő, Multimédia kijelző.
|
||
|
||
Teherautó (Haszongépjármű):
|
||
|
||
Ellenőrzés: Sofőr figyelő rendszer (DMS), Digitális Tachográf.
|
||
|
||
Adminisztráció: Útlevél/Okmány író, Beépített útdíj-fizető (OBU).
|
||
|
||
2. Adatfeltöltési Stratégia (Launch)
|
||
Kezdet: Manuális rögzítés, DE "Okos" segítséggel.
|
||
|
||
Törzsadat Script: Python scripttel előtöltjük a leggyakoribb márkákat/típusokat (kb. a piac 75%-át).
|
||
|
||
Kivételkezelés: Ha a felhasználó nem találja a típust, felvihet újat ("Egyéb"), de a rendszer fuzzy search (hasonlóság keresés) segítségével figyelmezteti: "Nem erre gondoltál: 'Toyota' a 'Tojota' helyett?"
|
||
|
||
II. Előfizetési Modellek (Monetizáció)
|
||
A rendszer 3 szinten működik.
|
||
|
||
1. Free (Ingyenes)
|
||
Limit: Max 3 jármű.
|
||
|
||
Reklám: Belépéskor és statisztika letöltéskor.
|
||
|
||
Keresés: A "Hirdető" (fizetős) szervizek előre sorolódnak (szponzorált találatok).
|
||
|
||
Export: Csak PDF (nem szerkeszthető).
|
||
|
||
Szerviz láthatóság: Összesítve látja a költségeket.
|
||
|
||
2. Prémium (Haladó)
|
||
Limit: Max 5 jármű.
|
||
|
||
Reklám: Nincs direkt reklám.
|
||
|
||
Keresés: "Tiszta" találati lista (a hirdetők nem tolakodnak előre, valós értékelés dönt).
|
||
|
||
Export: Excel (.xlsx) a saját elemzésekhez.
|
||
|
||
3. VIP (Flotta / Pro)
|
||
Limit: 10 jármű (felette egyedi ajánlat).
|
||
|
||
Funkciók:
|
||
|
||
Intelligens Riasztások: Egyéni intervallumok (pl. "Szólj 60 nappal műszaki előtt").
|
||
|
||
Anomália Detektálás: Túlhasználat figyelése, átlagtól eltérő fogyasztás vagy gyanúsan magas szervizszámla jelzése a Managernek.
|
||
|
||
Vizualizáció: Finomított havi diagramok, trendek.
|
||
|
||
III. Közösség és Gamifikáció (A "Motor")
|
||
A cél az adatbázis minőségi feltöltése.
|
||
|
||
1. Versenyszabályok
|
||
Időtartam: 3-6 hónapos "Szezonok".
|
||
|
||
Díjazás:
|
||
|
||
1-3. hely: Pénzjutalom.
|
||
|
||
4-10. hely: VIP előfizetés (1 év).
|
||
|
||
11-25. hely: Prémium (1 év).
|
||
|
||
26-50. hely: Prémium (6 hónap).
|
||
|
||
50-100. hely: Prémium (3 hónap).
|
||
|
||
2. Pontrendszer és Büntetés
|
||
+5 pont: Új szerviz rögzítése (ha validált adatokkal történik).
|
||
|
||
+1 pont: Validálás (az első 5 megerősítőnek).
|
||
|
||
0 pont: További validálások (de növeli a szerviz népszerűségét).
|
||
|
||
-2 pont: Rossz/Hamis adat megadása.
|
||
|
||
KIZÁRÁS (-10 pontnál): A felhasználó "Read-only" módba kerül a közösségi téren. Nem vihet fel új szervizt, csak a saját költségeit rögzítheti meglévő partnerekhez.
|
||
|
||
3. Szerviz Értékelés és Státusz
|
||
Státuszok: Rögzített -> Ellenőrzött (5 user által) -> Minősített/Hirdető.
|
||
|
||
*Értékelés (1-5):**
|
||
|
||
Kötelező elem: Munkalap/Számla fotó (vagy annak hiányának jelzése).
|
||
|
||
Szabály: Pozitív értékelés minden eseménynél adható. Negatív értékelés szervizenként max 1x (spam védelem).
|
||
|
||
4. Jármű Trust Score (%)
|
||
Nem bináris (Jó/Rossz), hanem százalékos.
|
||
|
||
Egy kihagyott tankolás alig ront rajta.
|
||
|
||
Súlyozás: A hivatalos (műszaki vizsga, szerviz) km óra állás fotóval sokkal többet ér, mint egy kézi tankolás bejegyzés.
|
||
|
||
IV. Implementáció: Céges Modellek (Python Kód)
|
||
Ahhoz, hogy a fenti jogosultsági rendszert (Cégvezető vs. Sofőr) kezelni tudjuk, itt van a szükséges adatbázis modell.
|
||
|
||
Ezt a kódot mentsd el a Code-Serverben: app/models/company.py
|
||
|
||
📘 Service Finder – Rendszer Specifikáció 2.0
|
||
Verzió: 2.0 (Bővített Üzleti és Gamifikációs Logika) Fókusz: MVP (Stabil alapok) + Jövőbiztos architektúra
|
||
|
||
I. Felhasználók és Jogosultsági Rendszer (RBAC)
|
||
Itt élesen szétválasztjuk a Rendszerüzemeltetést (IT) és az Üzleti Működést (App).
|
||
|
||
1. Rendszer Szint (IT & Support)
|
||
Superadmin: Hozzáférés az adatbázishoz, szerverhez (DevOps).
|
||
|
||
Moderátor: Adatok validálása, vitás esetek rendezése, szerviz törzsadatok tisztítása.
|
||
|
||
User (Technikai): Az alap entitás az adatbázisban.
|
||
|
||
2. Alkalmazás Szint (Business Logic) – Dinamikus Jogosultságok
|
||
A jogosultságok nem "beégetettek", hanem Cégenként/Flottánként konfigurálhatók.
|
||
|
||
Cégtulajdonos:
|
||
|
||
Létrehozza a Céget/Flottát.
|
||
|
||
Meghívhat Flotta Managert és Sofőrt.
|
||
|
||
Joga van bármikor visszavonni a hozzáférést (pl. kilépő dolgozó azonnal elveszti az autók láthatóságát).
|
||
|
||
Beállíthatja a szabályokat: "Ebben a cégben a sofőr csak tankolást rögzíthet, szervizt nem."
|
||
|
||
Flotta Manager:
|
||
|
||
Kezeli az autókat, kiosztja őket sofőröknek.
|
||
|
||
Látja a lejáratokat, költségeket, riasztásokat.
|
||
|
||
Sofőr:
|
||
|
||
Vezethet egy vagy több autót (akár egyszerre több cégtől is).
|
||
|
||
Csak a hozzá rendelt időszakban fér hozzá az autó adataihoz.
|
||
|
||
Jogosultság: Lehet csak "Read-only" (látja a forgalmit), vagy "Editor" (rögzít tankolást).
|
||
|
||
II. Jármű Adatmodell – A "Deep Dive" (Mély Adatbázis)
|
||
Az MVP-ben a struktúrát hozzuk létre, az adatokat folyamatosan töltjük.
|
||
|
||
1. Hierarchikus Törzsadatok
|
||
Nem flat (sima) szövegként tároljuk, hanem relációs adatbázisban a pontos kereshetőségért:
|
||
|
||
Kategória: Személyautó, Kisteher, Motor, Teherautó.
|
||
|
||
Gyártó (Make): BMW, Honda, Toyota.
|
||
|
||
Modell (Model): X5, CR-V, Yaris.
|
||
|
||
Generáció/Évjárat: Pl. 2018-2022.
|
||
|
||
Motor: Üzemanyag (Benzin/Diesel/Hybrid/EV) + Motorkód + Teljesítmény.
|
||
|
||
Felszereltség (Trim): Ez a legnehezebb (Executive, M-Sport). MVP Megoldás: Kezdetben szöveges mező vagy JSON, később strukturált lista.
|
||
|
||
2. Gumiabroncs Menedzsment (Tire Module) – Kiemelt Fontosságú
|
||
Külön tábla (vehicle_tires), mert kritikus biztonsági elem.
|
||
|
||
Adatok: Márka, Típus, Méret (pl. 205/55 R16), Évszak (Nyári/Téli/4évszak).
|
||
|
||
DOT Szám (Gyártási idő): Pl. "2223" (2023. 22. hét).
|
||
|
||
Figyelmeztetések (Logika):
|
||
|
||
Szezonális: "Itt a november, rakd fel a télit!"
|
||
|
||
Kor alapú: "A gumi elmúlt 6 éves (DOT alapján), csere javasolt!"
|
||
|
||
Futás alapú: "Már 40.000 km-t mentél ezzel a szettel."
|
||
|
||
III. Közösség, Gamifikáció és Adatgyűjtés ("Data Race")
|
||
Hogyan vegyük rá az embereket, hogy töltsék fel az adatokat? Jutalmazással.
|
||
|
||
1. Rögzítési Verseny & Pontrendszer
|
||
Adatbeküldés: Ha egy felhasználó beküld egy új szervizt a térképre, vagy feltölti egy ritka autó adatait -> Pontokat kap.
|
||
|
||
Validálás: Ha egy másik felhasználó megerősíti ("Igen, ez a szerviz tényleg létezik és jó"), azért is pont jár.
|
||
|
||
Ranglista: "A Hónap Flotta Managere", "A Leggondosabb Tulaj".
|
||
|
||
2. Jármű "Trust Score" (Bizalmi Index)
|
||
Ez az autó értéke eladáskor. A rendszer automatikusan számolja 0-100% között.
|
||
|
||
Van feltöltve fotó? (+10 pont)
|
||
|
||
A kilométeróra rögzítések konzisztensek? (+30 pont)
|
||
|
||
Van OCR-rel igazolt szervizszámla? (+50 pont)
|
||
|
||
Cél: Egy 90+ pontos autó többet ér a piacon, mert "Service Finder Igazolt".
|
||
|
||
3. Szervizek Értékelése
|
||
Nem csak csillagozás (1-5).
|
||
|
||
Validált értékelés: Csak akkor értékelhet, ha van ott rögzített, GPS/Időbélyeggel vagy számlával igazolt eseménye. (Így szűrjük a fake értékeléseket).
|
||
|
||
IV. Audit és Biztonság
|
||
1. Naplózás és Csalásszűrés
|
||
Adatforrás jelölése: Minden bejegyzésnél tároljuk: source_type.
|
||
|
||
MANUAL: Kézzel írta be (Alacsony bizalom).
|
||
|
||
OCR_VALIDATED: Fotóról ismerte fel a rendszer (Magas bizalom).
|
||
|
||
VERIFIED_PARTNER: Regisztrált szerviz töltötte fel (Legmagasabb bizalom).
|
||
|
||
Csalás detektálás: Ha a source_type hirtelen változik, vagy a km óra csökken, a rendszer "Flag"-eli (megjelöli) az autót.
|
||
|
||
V. MVP Stratégia (Hogyan indulunk?)
|
||
Hogy ne bonyolítsuk túl az elején, de a kód ne ütközzön később:
|
||
|
||
Fázis 1 (Indulás - A "Gerinc"):
|
||
|
||
Infrastruktúra (Kész).
|
||
|
||
User/Cég/Jogosultság alapok (Create, Invite, Remove).
|
||
|
||
Jármű alapadatok + Tulajdonlás (Ownership).
|
||
|
||
Szerviz/Tankolás rögzítés (Kézi + MinIO fotó feltöltés).
|
||
|
||
Audit Log alapjai.
|
||
|
||
Fázis 2 (Adatdúsítás):
|
||
|
||
OCR bevezetése (automatikus kitöltés).
|
||
|
||
Gumiabroncs modul (DOT szám figyelés).
|
||
|
||
Értesítések (Email/Popup).
|
||
|
||
Fázis 3 (Közösség):
|
||
|
||
Gamifikáció (Pontgyűjtés).
|
||
|
||
Trust Score számítás.
|
||
|
||
Szerviz kereső és értékelő modul.
|
||
|
||
📘 Service Finder – Rendszer Specifikáció és Fejlesztési Terv
|
||
Verzió: 1.0 (Tervezési fázis) Státusz: Infrastruktúra kész, Üzleti logika implementálás alatt.
|
||
|
||
I. Infrastruktúra és Technológia (Már kész/beállítva)
|
||
Ez a réteg biztosítja a rendszer futását a szervereden (192.168.100.43).
|
||
|
||
Konténerizáció: Docker alapú környezet, szeparált szolgáltatásokkal.
|
||
|
||
Backend: Python FastAPI (Aszinkron, gyors, modern).
|
||
|
||
Adatbázis: PostgreSQL 15 (Külön data sémába szervezve a biztonságért).
|
||
|
||
Fájltárolás: MinIO (S3 kompatibilis objektumtároló képeknek, doksiknak).
|
||
|
||
Elérés & Proxy: Nginx Proxy Manager kezeli a domaineket és SSL-t:
|
||
|
||
dev.profibot.hu -> Backend API
|
||
|
||
db.profibot.hu -> pgAdmin (Adatbázis menedzsment)
|
||
|
||
code.profibot.hu -> Code-Server (Fejlesztői környezet)
|
||
|
||
(Tervben): files.profibot.hu -> MinIO
|
||
|
||
Frontend Technológia (Döntöttünk): React (vagy Vue.js) SPA (Single Page Application).
|
||
|
||
Cél: Mobilapp-szerű élmény, nincs oldal újratöltés, kódvédelem (buildelt kód).
|
||
|
||
II. Adatbázis Modell (A Rendszer Gerince)
|
||
A táblák a data sémában helyezkednek el, szigorú relációkkal.
|
||
|
||
Users (Felhasználók):
|
||
|
||
Alapadatok (Email, Jelszó Hash, Név).
|
||
|
||
Jogosultságok: is_superuser (Rendszergazda), is_active.
|
||
|
||
Okmányok: Jogosítvány, Személyi lejárati dátumok.
|
||
|
||
Reputation Score: Pontrendszer a megbízhatósághoz.
|
||
|
||
Vehicles (Járművek):
|
||
|
||
Törzsadatok: Rendszám, Alvázszám (VIN), Márka, Típus, Évjárat.
|
||
|
||
Szerviz adatok: initial_odometer (rögzítéskori km), current_odometer (aktuális).
|
||
|
||
Lejáratok: Műszaki vizsga (mot_expiry), Biztosítás.
|
||
|
||
VehicleOwnerships (Birtoklási Történet) – ÚJ!
|
||
|
||
Kapcsolótábla a User és Vehicle között.
|
||
|
||
Mezők: start_date (vétel/rendszerbe kerülés), end_date (eladás).
|
||
|
||
Funkció: Ez alapján döntjük el, ki láthatja a költségeket.
|
||
|
||
AuditLogs (A "Fekete Doboz") – ÚJ!
|
||
|
||
Minden módosítás naplózása.
|
||
|
||
Rögzíti: KI (User), MIT (Target ID), MIKOR, HONNAN (IP).
|
||
|
||
Változás részletei (JSON): { "old_value": 150000, "new_value": 145000 } -> Csalás detektálása.
|
||
|
||
III. Üzleti Logika és Működés (A "Szabálykönyv")
|
||
1. Jogosultsági Szintek
|
||
Admin / Superuser: Teljes hozzáférés, rendszerbeállítások.
|
||
|
||
Moderátor: Adatok ellenőrzése, javítása.
|
||
|
||
Szerelő: Nincs dedikált szerepkör (vagy csak korlátozott), a rendszerben adminisztratív funkciója nincs.
|
||
|
||
Felhasználó (User): Kizárólag az Appon keresztül léphet be. Nem látja az adatbázis struktúrát.
|
||
|
||
2. Jármű Életút & Adatbevitel ("Modern Megoldás")
|
||
Rögzítés: Nem feltétlenül a vétel pillanatában történik.
|
||
|
||
Kezdő dátum: A rendszerbe kerülés napja rögzítve lesz (start_date), innentől "minősített" a jármű.
|
||
|
||
OCR (Automatikus Kitöltés):
|
||
|
||
Felhasználó fotózza a forgalmit/számlát.
|
||
|
||
Kép feltöltése MinIO-ba.
|
||
|
||
Backend (Tesseract/Vision) elemzi.
|
||
|
||
Jóváhagyás: A User látja a felismert adatot, és csak az "OK" gomb után kerül az adatbázisba.
|
||
|
||
3. Költségek és Láthatóság (Privacy)
|
||
Szerviz/Tankolás bejegyzés: Örökre a járműhöz kapcsolódik.
|
||
|
||
Láthatóság szabály:
|
||
|
||
Aktuális tulajdonos: Látja a saját költségeit és a jármű technikai előéletét (de az előző tulajdonos költségeinek összegét csak összesítve/anonimizálva láthatja, vagy egyáltalán nem, beállítástól függően).
|
||
|
||
Előző tulajdonos: Eladás után már csak egy statisztikai összesítőt lát (Mennyit költöttem rá?), nem látja az új tulajdonos tankolásait.
|
||
|
||
4. Értesítési Rendszer (A "Figyelő")
|
||
Automatikus háttérfolyamat (Scheduler) figyeli a dátumokat.
|
||
|
||
Kinek?
|
||
|
||
Tulajdonos/Sofőr: Figyelmeztetés lejárat előtt.
|
||
|
||
Flotta Menedzser: Riasztás, ha jogosulatlan sofőr vezet (lejárt jogsi).
|
||
|
||
Hogyan?
|
||
|
||
Popup: Belépéskor a felületen.
|
||
|
||
Jelzés: Piros (lejárt/kritikus) vagy Sárga (hamarosan lejár) ikon a lista nézetben.
|
||
|
||
Email: 30 nappal a lejárat (Műszaki, Okmány, Gumicsere szezon) előtt.
|
||
|
||
5. Naplózás (Logging)
|
||
Minden esemény visszakereshető az AuditLogs táblából.
|
||
|
||
Események: Tankolás, Km óra rögzítés, Adatmodosítás.
|
||
|
||
Tartalom: Időpont, User ID, Rendszám, Művelet (Create/Update), Régi érték vs Új érték.
|
||
|
||
Cél: Vitás esetek rendezése és a kilométeróra-manipuláció kiszűrése.
|
||
|
||
IV. Biztonság és Kódvédelem
|
||
Frontend: React alapú "buildelt" kód. A forráskód nem olvasható a böngészőben (minifikálás). Az üzleti logika a szerveren marad.
|
||
|
||
Backend: Docker konténerbe zárva, környezeti változók (.env) használata jelszavakhoz.
|
||
|
||
Adatvédelem: Az API csak hitelesített (Token alapú) kéréseket szolgál ki. |