From cab87069802da9755559ea2fa6c25f301a09a41a Mon Sep 17 00:00:00 2001
From: Kincses <kincses@gmail.com>
Date: Sat, 7 Feb 2026 01:29:46 +0000
Subject: [PATCH] feat: vehicle catalog system and harvester robot
 implementation

---
 .../__pycache__/organization.cpython-312.pyc  | Bin 2046 -> 2666 bytes
 backend/app/models/organization.py            |  23 ++++++++++++++----
 docs/V01_gemini/15_Changelog.md               |  18 +++++++++++++-
 .../18_ASSET_AND_FLEET_SPECIFICATION.md       |  18 +++++++++++++-
 4 files changed, 52 insertions(+), 7 deletions(-)

diff --git a/backend/app/models/__pycache__/organization.cpython-312.pyc b/backend/app/models/__pycache__/organization.cpython-312.pyc
index 35c7bef6b1076551d4e137e0b96d52ee5403cb1a..915fd291082aad6e9b5d3fbd0e12954df1e26aa1 100644
GIT binary patch
delta 1281
zcma)+O-vI(6vt<4ySx3`r5{@>7*Hc01;nq!LSjr*1SJ9qU{DgROJ~rn+mFn)YPqx|
zMo&h_9z;*|CZPwsdGKJonivc<(!FsqdeIn89*i?BEUV#Qll|@6H~%;9&CHwr7QY3B
z_g=3HkY7}PsCfAWA<TSOXn%Uz1_l9iJpj;+gylU{0Kk+V`4Vk)+e+k%1-HNROvLl*
z-4li>>0`E`0uT9RralIpW!JK;Zcn*v067p#=!R}nVJ~xLE>BJ2g?3Anu!~RJ^05|O
z1ND)|S0Le@zoy?Vz`rfADu^$T=-6J$&U<;wEPKrbNdFaoeJjwMKrkl=kqP!f5jH?y
z*>A2oT=NECLpf+F_tkt73|V}Q`Mr^_?zDIJE!hlr1}jM!=VNzJ-f$=>i0%(8F$SN?
zsj57!qOT`N8CWDBUJjxeIj3fS>CoO+aGcdNlr=nQd`nI#vvO8Rr)K@Ks&*fMNJUw6
zB#kq-<y6FG2-9->PArqo<WxC}G=q!FT3m+6@Q+%8hf#7G;UxwiBk2tL6%An{kiM5f
zFlNo6jYOJo0O*{fU!QV3W?7lmp?`NAWxnVwY>%)ZN((cKV|wCccSVfqGTX{j^+)VY
zL1<iTU+GyLx>51QiUayj_AnD)@JY7kKp(fAEYOzXA#0vFSLV&lb&|1q)A7)`tD@eP
zZs;nz&F!a+=!G8WE$<wjkQXBjm~N{Pv@R=FNY>V`;R9q0A0(K-hX`jSC}-s!t5)k#
z-~eu=x=sRvg;=?ZFsA*7n<@G!P7;hnM6y}rgI+T%QJkWPQqaqZ?G(KL6aaP-(-5th
zVhS|4961SMU<Vzx<Ftw}z4!PiMI%KM#eRxfzfeTTqs0gwfc0Q!ad<t{Tw+(H_Tos@
zDb91HiIrf*d8&A>8rr`&`697;{QSkWwo9uM*D9f@;%HR}&QCr|ylh!(?t6QoA`BG=
zt8U+XTdAYs?ke_g1X@bM>wG0}Y3_18c`c=+hq<|Et%UO=v%%j*x0Sexw128J_|wTW
z%&F)M9w$2bFQZ-6-*C~$CTL^^nay6F8DbWLn}EK5guuSm&*83*;jW_R6Od{N{{Rrq
BDWL!W

delta 701
zcmaDQ@{gbIG%qg~0}#Z@wq|Z*oyaG_IBlZ(be2j+O|Ff<`WcxvF;0$WH=ewYNvxhL
zm3uWKNG$_HDtDFygoRA5;aJTC;YaZ@F{HAlvH?lH6i%3~6qYsYtC^uH_`xa!fMN(;
zf>^|apki$GND75Pf<P<+)Xs%sJj?;2*i-<;#Ip2|oeW{Gh6=6WhI>E)Lw`L`5kUiZ
z;08zn)k>xCrtq!dhl@#r#RO6Wk;G)cVnQjxNMf>;BATMNc>Igf6Z0~w5=%1k^KS7@
zwr7#i*JQfIT~L&nn^;sCpPgEHi#0PZCAGp$lkpZuUTIEFVp2{jkj<WwnwD6aQ&Kf~
z3X7#Wdsu2lW^zvIE$-yfqN3EilKA|hbf7A}q{QUx_=5a`(wxMS)Z)nktRj53cz|+n
zODAiy$}-AL_GESEFJcFJzlaY+hyjVo6IgpWILaUfPgZ8rXM8m|m`zXQCco&!lo{re
zb6134*R{W>Yk!5`VRAp4D&xb+TiFu01!QJ;ZpgjD@6zBgS(#mhNmFQY5ND&Z6v$X<
o5FrC3ZgJS;=BJeAq}mm^0lA<gS8O$zi_4t*D}xlHJ0n;n0CZ}WFaQ7m

diff --git a/backend/app/models/organization.py b/backend/app/models/organization.py
index 9e4693b..da087ee 100755
--- a/backend/app/models/organization.py
+++ b/backend/app/models/organization.py
@@ -16,14 +16,14 @@ class Organization(Base):
 
     id = Column(Integer, primary_key=True, index=True)
     name = Column(String, nullable=False)
-    org_type = Column(Enum(OrgType), default=OrgType.INDIVIDUAL)
+    # A stabilitás miatt VARCHAR-ként kezeljük a DB-ben
+    org_type = Column(String(50), default="individual") 
     
     # A flotta technikai tulajdonosa (User)
     owner_id = Column(Integer, ForeignKey("data.users.id"), nullable=True)
     
     # Üzleti szabályok
     is_active = Column(Boolean, default=True)
-    # Privát flotta (INDIVIDUAL) esetén False, cégeknél True
     is_transferable = Column(Boolean, default=True) 
     
     # Verifikáció
@@ -33,7 +33,20 @@ class Organization(Base):
     created_at = Column(DateTime(timezone=True), server_default=func.now())
     updated_at = Column(DateTime(timezone=True), onupdate=func.now())
     
-    # Kapcsolatok
-    vehicles = relationship("Vehicle", back_populates="current_org")
+    # Kapcsolatok (Asset-re hivatkozunk a Vehicle helyett)
+    assets = relationship("Asset", back_populates="organization", cascade="all, delete-orphan")
     members = relationship("OrganizationMember", back_populates="organization")
-    owner = relationship("User", back_populates="owned_organizations")
\ No newline at end of file
+    owner = relationship("User", back_populates="owned_organizations")
+
+class OrganizationMember(Base):
+    __tablename__ = "organization_members"
+    __table_args__ = {"schema": "data"}
+    id = Column(Integer, primary_key=True, index=True)
+    organization_id = Column(Integer, ForeignKey("data.organizations.id"), nullable=False)
+    user_id = Column(Integer, ForeignKey("data.users.id"), nullable=False)
+    role = Column(String, default="driver") 
+
+    organization = relationship("Organization", back_populates="members")
+
+# --- EZT A SORT TEDD KÍVÜLRE, A MARGÓRA ---
+Organization.vehicles = Organization.assets
\ No newline at end of file
diff --git a/docs/V01_gemini/15_Changelog.md b/docs/V01_gemini/15_Changelog.md
index 2206888..756c847 100644
--- a/docs/V01_gemini/15_Changelog.md
+++ b/docs/V01_gemini/15_Changelog.md
@@ -117,4 +117,20 @@ A fejlesztések rendben tartásához javaslom a **`17_DEVELOPER_NOTES_AND_PITFAL
 - **Funkció:** Teljes körű személyazonosság-kezelés és fiókaktiválás.
 - **Automatizálás:** Regisztrációkor automatikusan létrejön a "Privát Flotta" (Organization) és a digitális pénztárca (Wallet).
 - **Adatvédelem:** Elkészült a "Digitális Széf" logika az okmányok és vészhelyzeti adatok biztonságos tárolására.
-- **Technikai fix:** SQLAlchemy `joinedload` integráció az aszinkron adatkezeléshez és JSON-safe dátumkezelés.
\ No newline at end of file
+- **Technikai fix:** SQLAlchemy `joinedload` integráció az aszinkron adatkezeléshez és JSON-safe dátumkezelés.
+
+## [0.3.0] - 2026-02-07
+
+### ✨ Hozzáadva (Added)
+- **Asset DNS Modell:** Új, univerzális eszközkezelő rendszer (Assets, VehicleCatalog, AssetEvents, AssetRatings).
+- **Harvester Robot:** Automata adatgyűjtő rendszer, amely külső forrásokból tölti fel a globális járműkatalógust.
+- **UUID Implementáció:** Az eszközök (Assets) és események (Events) mostantól biztonságos UUID azonosítókat használnak.
+
+### ⚙️ Adatbázis Változások (Database)
+- `data.vehicle_catalog` tábla létrehozva a globális specifikációknak.
+- `data.assets` tábla létrehozva a konkrét példányok (VIN/HIN alapú) tárolására.
+- `data.asset_events` és `data.asset_ratings` táblák az életút és közösségi visszajelzések kezelésére.
+
+### 🛠️ Refaktor (Refactor)
+- **Modell Konszolidáció:** A korábbi `Vehicle` és `VehicleBrand` modellek beolvasztva az új `Asset` és `VehicleCatalog` struktúrába.
+- **Kapcsolati Térkép:** Az `Organization` és `User` modellek frissítve az új Asset logikához.
\ No newline at end of file
diff --git a/docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md b/docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md
index ef9d519..5afa6c5 100644
--- a/docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md
+++ b/docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md
@@ -66,4 +66,20 @@ A rendszer integritásáért és az adatok pontosságáért egy automata Robot f
 ### Adatforrások hierarchiája:
 1. Hivatalos gyártói API-k (ahol elérhető).
 2. Nyilvános műszaki adatbázisok (Auto-Data, UltimateSpecs).
-3. VIN/HIN dekóder algoritmusok.
\ No newline at end of file
+3. VIN/HIN dekóder algoritmusok.
+
+## 7. Kivételkezelés: Ismeretlen és Egyedi Járművek
+
+Ha egy jármű nem található a globális katalógusban, a rendszer kétlépcsős mentőövet nyújt:
+
+### A) On-Demand Harvester (Robot hívása)
+1. A felhasználó jelzi, hogy hiányzik a típus.
+2. A Robot utasítást kap egy mélyebb keresésre (Deep Web Search).
+3. Ha találat van, a Robot rögzíti a katalógusba, és a felhasználó folytathatja a rögzítést.
+
+### B) Custom Asset (Egyedi/Sport jármű rögzítése)
+Ha a jármű sehol nem szerepel (pl. épített versenyautó, egyedi yacht):
+1. **Manuális nyilatkozat:** A felhasználó rögzíti az adatokat.
+2. **Dokumentum alapú validáció:** A forgalmi engedély vagy sportigazolvány fotóját kötelező feltölteni.
+3. **AI Verifikáció:** A rendszer OCR-rel (szövegfelismerés) kiolvassa az adatokat a fotóról, és összeveti a manuális bevitelével.
+4. **"Unverified Model" jelzés:** A katalógusban egyedi azonosítót kap, amíg egy admin vagy a Robot más forrásból meg nem erősíti.
\ No newline at end of file