feat: multi-robot architecture, car-robot rename, and credit-based OCR logic spec

backend/app/api/v1/api.py

@@ -1,5 +1,10 @@
 from fastapi import APIRouter
-from app.api.v1.endpoints import auth
+from app.api.v1.endpoints import auth, catalog # <--- Hozzáadtuk a catalog-ot
 
 api_router = APIRouter()
+
+# Autentikáció és KYC végpontok
 api_router.include_router(auth.router, prefix="/auth", tags=["Authentication"])
+
+# Jármű Katalógus és Robot kereső végpontok
+api_router.include_router(catalog.router, prefix="/catalog", tags=["Vehicle Catalog"])

backend/app/api/v1/endpoints/catalog.py

@@ -0,0 +1,37 @@
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select, or_
+from app.db.session import get_db
+from app.models.vehicle import VehicleCatalog
+from typing import List
+
+router = APIRouter()
+
+@router.get("/search")
+async def search_catalog(
+    q: str = Query(..., min_length=2, description="Márka vagy típus keresése"),
+    category: str = None,
+    db: AsyncSession = Depends(get_db)
+):
+    """Keresés a Robot által feltöltött katalógusban."""
+    stmt = select(VehicleCatalog).where(
+        or_(
+            VehicleCatalog.brand.ilike(f"%{q}%"),
+            VehicleCatalog.model.ilike(f"%{q}%")
+        )
+    )
+    if category:
+        stmt = stmt.where(VehicleCatalog.category == category)
+    
+    result = await db.execute(stmt.limit(20))
+    items = result.scalars().all()
+    
+    return [
+        {
+            "id": i.id,
+            "full_name": f"{i.brand} {i.model}",
+            "category": i.category,
+            "status": i.verification_status,
+            "specs": i.factory_specs
+        } for i in items
+    ]

backend/app/core/config.py

@@ -63,4 +63,5 @@ class Settings(BaseSettings):
         extra="ignore"
     )
 
+
 settings = Settings()

backend/app/models/vehicle.py

@@ -16,13 +16,14 @@ class VehicleCatalog(Base):
     generation = Column(String(100))
     year_from = Column(Integer)
     year_to = Column(Integer)
-    category = Column(String(50)) # car, bike, boat, plane, truck
+    category = Column(String(50))
-    engine_type = Column(String(50)) # petrol, diesel, electric, hybrid
+    engine_type = Column(String(50))
     engine_power_kw = Column(Integer)
     
-    # DNS ADATOK: Minden technikai részlet (kerékméret, olajmennyiség, stb.)
+    # --- EZ A SOR HIÁNYZOTT ---
+    verification_status = Column(String(20), default="verified") 
+    
     factory_specs = Column(JSON, default={})
-    # SZERVIZTERV: Gyári előírások
     maintenance_plan = Column(JSON, default={})
     
     created_at = Column(DateTime(timezone=True), server_default=func.now())

backend/app/services/auth_service_old.py

@@ -1,130 +0,0 @@
-from datetime import datetime, timezone, timedelta
-from typing import Optional, Dict, Any
-import logging
-from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy import select, and_, text
-
-from app.models.identity import User, Person, Wallet, UserRole
-from app.models.organization import Organization, OrgType
-from app.models.vehicle import OrganizationMember
-from app.schemas.auth import UserRegister
-from app.core.security import get_password_hash
-from app.services.email_manager import email_manager
-
-logger = logging.getLogger(__name__)
-
-class AuthService:
-    @staticmethod
-    async def get_setting(db: AsyncSession, key: str, default: Any = None) -> Any:
-        """Kiolvassa a beállítást az adatbázisból (Admin UI kompatibilis)."""
-        try:
-            stmt = text("SELECT value FROM data.system_settings WHERE key = :key")
-            result = await db.execute(stmt, {"key": key})
-            val = result.scalar()
-            return val if val is not None else default
-        except Exception:
-            return default
-
-    @staticmethod
-    async def register_new_user(db: AsyncSession, user_in: UserRegister, ip_address: str):
-        try:
-            # 1. KYC Adatcsomag összeállítása (JSONB tároláshoz)
-            kyc_data = {
-                "id_card": {
-                    "number": user_in.id_card_number,
-                    "expiry": str(user_in.id_card_expiry) if user_in.id_card_expiry else None
-                },
-                "driver_license": {
-                    "number": user_in.driver_license_number,
-                    "expiry": str(user_in.driver_license_expiry) if user_in.driver_license_expiry else None,
-                    "categories": user_in.driver_license_categories
-                },
-                "special_licenses": {
-                    "boat": user_in.boat_license_number,
-                    "pilot": user_in.pilot_license_number
-                }
-            }
-
-            # 2. Person létrehozása
-            new_person = Person(
-                first_name=user_in.first_name,
-                last_name=user_in.last_name,
-                mothers_name=user_in.mothers_name,
-                birth_place=user_in.birth_place,
-                birth_date=user_in.birth_date,
-                identity_docs=kyc_data
-            )
-            db.add(new_person)
-            await db.flush()
-
-            # 3. User létrehozása
-            hashed_pwd = get_password_hash(user_in.password) if user_in.password else None
-            new_user = User(
-                email=user_in.email,
-                hashed_password=hashed_pwd,
-                social_provider=user_in.social_provider,
-                social_id=user_in.social_id,
-                person_id=new_person.id,
-                role=UserRole.USER,
-                region_code=user_in.region_code,
-                is_active=True
-            )
-            db.add(new_user)
-            await db.flush()
-
-            # 4. Wallet inicializálás
-            new_wallet = Wallet(user_id=new_user.id, coin_balance=0.00, xp_balance=0)
-            db.add(new_wallet)
-
-            # 5. Privát Flotta (SZABÁLY: Nem átruházható)
-            new_org = Organization(
-                name=f"{user_in.last_name} {user_in.first_name} flottája",
-                org_type=OrgType.INDIVIDUAL,
-                owner_id=new_user.id,
-                is_active=True,
-                is_transferable=False
-            )
-            db.add(new_org)
-            await db.flush()
-
-            # 6. Tagság rögzítése
-            db.add(OrganizationMember(organization_id=new_org.id, user_id=new_user.id, role="owner"))
-
-            # 7. Audit Log
-            audit_stmt = text("""
-                INSERT INTO data.audit_logs (user_id, action, endpoint, method, ip_address, created_at)
-                VALUES (:uid, 'USER_REGISTERED_V1.3_FULL_KYC', '/api/v1/auth/register', 'POST', :ip, :now)
-            """)
-            await db.execute(audit_stmt, {
-                "uid": new_user.id,
-                "ip": ip_address,
-                "now": datetime.now(timezone.utc)
-            })
-
-            # 8. Jutalmazás (Dinamikus)
-            reward_days = await AuthService.get_setting(db, "auth.reward_days", 14)
-
-            # 9. Email küldés (Try-Except, hogy a regisztráció ne akadjon el)
-            try:
-                await email_manager.send_email(
-                    recipient=user_in.email,
-                    template_key="registration_welcome",
-                    variables={"first_name": user_in.first_name, "reward_days": reward_days},
-                    user_id=new_user.id
-                )
-            except Exception as e:
-                logger.warning(f"Email delivery failed: {str(e)}")
-
-            await db.commit()
-            return new_user
-
-        except Exception as e:
-            await db.rollback()
-            logger.error(f"Critical error in register_new_user: {str(e)}")
-            raise e
-
-    @staticmethod
-    async def check_email_availability(db: AsyncSession, email: str) -> bool:
-        query = select(User).where(and_(User.email == email, User.is_deleted == False))
-        result = await db.execute(query)
-        return result.scalar_one_or_none() is None

backend/app/services/auth_service_old2.py

@@ -1,145 +0,0 @@
-# /opt/docker/dev/service_finder/backend/app/services/auth_service.py
-from datetime import datetime, timezone, timedelta
-from typing import Optional, Dict, Any
-import logging
-from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy import select, and_, text
-
-from app.models.identity import User, Person, Wallet, UserRole
-from app.models.organization import Organization, OrgType
-from app.models.vehicle import OrganizationMember
-from app.schemas.auth import UserRegister
-from app.core.security import get_password_hash, create_access_token
-from app.services.email_manager import email_manager
-
-logger = logging.getLogger(__name__)
-
-class AuthService:
-    @staticmethod
-    async def get_setting(db: AsyncSession, key: str, default: Any = None) -> Any:
-        """Admin felületről állítható változók lekérése."""
-        try:
-            stmt = text("SELECT value FROM data.system_settings WHERE key = :key")
-            result = await db.execute(stmt, {"key": key})
-            val = result.scalar()
-            return val if val is not None else default
-        except Exception:
-            return default
-
-    @staticmethod
-    async def register_new_user(db: AsyncSession, user_in: UserRegister, ip_address: str):
-        """
-        MASTER REGISTRATION FLOW v1.3 (Full Integration)
-        """
-        try:
-            # 1. KYC ADATOK (Banki szintű nyilvántartás)
-            kyc_data = {
-                "id_card": {
-                    "number": user_in.id_card_number,
-                    "expiry": str(user_in.id_card_expiry) if user_in.id_card_expiry else None
-                },
-                "driver_license": {
-                    "number": user_in.driver_license_number,
-                    "expiry": str(user_in.driver_license_expiry) if user_in.driver_license_expiry else None,
-                    "categories": user_in.driver_license_categories
-                },
-                "special_licenses": {
-                    "boat": user_in.boat_license_number,
-                    "pilot": user_in.pilot_license_number
-                }
-            }
-
-            # 2. PERSON LÉTREHOZÁSA (Digitális Iker alapja)
-            new_person = Person(
-                first_name=user_in.first_name,
-                last_name=user_in.last_name,
-                mothers_name=user_in.mothers_name,
-                birth_place=user_in.birth_place,
-                birth_date=user_in.birth_date,
-                identity_docs=kyc_data
-            )
-            db.add(new_person)
-            await db.flush()
-
-            # 3. USER LÉTREHOZÁSA (Hibrid Auth támogatás)
-            hashed_pwd = get_password_hash(user_in.password) if user_in.password else None
-            new_user = User(
-                email=user_in.email,
-                hashed_password=hashed_pwd,
-                social_provider=user_in.social_provider,
-                social_id=user_in.social_id,
-                person_id=new_person.id,
-                role=UserRole.USER,
-                region_code=user_in.region_code,
-                is_active=True
-            )
-            db.add(new_user)
-            await db.flush()
-
-            # 4. ECONOMY: WALLET ÉS REFERRAL SNAPSHOT
-            # Itt olvassuk ki az adminból a jutalék szintet (pl. 10%)
-            l1_commission = await AuthService.get_setting(db, "referral.level1", 10)
-            
-            db.add(Wallet(user_id=new_user.id, coin_balance=0.00, xp_balance=0))
-
-            # 5. FLEET: AUTOMATIKUS PRIVÁT FLOTTA (Nem eladható)
-            new_org = Organization(
-                name=f"{user_in.last_name} {user_in.first_name} Private Fleet",
-                org_type=OrgType.INDIVIDUAL,
-                owner_id=new_user.id,
-                is_transferable=False
-            )
-            db.add(new_org)
-            await db.flush()
-
-            # Saját flotta tulajdonjog rögzítése
-            db.add(OrganizationMember(organization_id=new_org.id, user_id=new_user.id, role="owner"))
-
-            # 6. MEGHÍVÓ FELDOLGOZÁSA (Csatlakozás másik céghez)
-            if user_in.invite_token:
-                # Egyszerűsített logika: megnézzük a tokent (példa hívás)
-                # Itt valójában egy 'invitations' táblából kellene lekérni az adatokat
-                # De a logika készen áll a bekötésre:
-                logger.info(f"Processing invite token: {user_in.invite_token}")
-                # db.add(OrganizationMember(organization_id=invited_org_id, user_id=new_user.id, role=invited_role))
-
-            # 7. AUDIT LOG (Minden lépés visszakövethető)
-            audit_stmt = text("""
-                INSERT INTO data.audit_logs (user_id, action, endpoint, method, ip_address, created_at)
-                VALUES (:uid, 'USER_REGISTERED_COMPLETE_V1.3', '/api/v1/auth/register', 'POST', :ip, :now)
-            """)
-            await db.execute(audit_stmt, {
-                "uid": new_user.id, "ip": ip_address, "now": datetime.now(timezone.utc)
-            })
-
-            # 8. JUTALMAZÁS (Admin beállítás alapján)
-            reward_days = await AuthService.get_setting(db, "auth.reward_days", 14)
-
-            # 9. EMAIL KÜLDÉS
-            try:
-                await email_manager.send_email(
-                    recipient=user_in.email,
-                    template_key="registration_welcome",
-                    variables={
-                        "first_name": user_in.first_name,
-                        "reward_days": reward_days
-                    },
-                    user_id=new_user.id
-                )
-            except Exception as e:
-                logger.warning(f"Email delivery skipped during reg: {str(e)}")
-
-            await db.commit()
-            await db.refresh(new_user)
-            return new_user
-
-        except Exception as e:
-            await db.rollback()
-            logger.error(f"Critical error in register_new_user: {str(e)}")
-            raise e
-
-    @staticmethod
-    async def check_email_availability(db: AsyncSession, email: str) -> bool:
-        query = select(User).where(and_(User.email == email, User.is_deleted == False))
-        result = await db.execute(query)
-        return result.scalar_one_or_none() is None

backend/app/services/auth_service_old3.py

@@ -1,129 +0,0 @@
-# /opt/docker/dev/service_finder/backend/app/services/auth_service.py
-from datetime import datetime, timezone
-from typing import Optional, Dict, Any
-import logging
-from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy import select, and_, text
-
-from app.models.identity import User, Person, Wallet, UserRole
-from app.models.organization import Organization, OrgType
-from app.models.vehicle import OrganizationMember
-from app.schemas.auth import UserRegister
-from app.core.security import get_password_hash, create_access_token
-from app.services.email_manager import email_manager
-
-logger = logging.getLogger(__name__)
-
-class AuthService:
-    @staticmethod
-    async def get_setting(db: AsyncSession, key: str, default: Any = None) -> Any:
-        """Kiolvassa az Admin felületről állítható változókat."""
-        try:
-            stmt = text("SELECT value FROM data.system_settings WHERE key = :key")
-            result = await db.execute(stmt, {"key": key})
-            val = result.scalar()
-            return val if val is not None else default
-        except Exception:
-            return default
-
-    @staticmethod
-    async def register_new_user(db: AsyncSession, user_in: UserRegister, ip_address: str):
-        """
-        MASTER ONBOARDING v1.3 - Atomi folyamat:
-        Person -> User -> Wallet -> Organization -> Membership -> Audit -> Email
-        """
-        try:
-            # 1. KYC Adatok struktúrálása
-            kyc_data = {
-                "id_card": {"number": user_in.id_card_number, "expiry": str(user_in.id_card_expiry) if user_in.id_card_expiry else None},
-                "driver_license": {
-                    "number": user_in.driver_license_number, 
-                    "expiry": str(user_in.driver_license_expiry) if user_in.driver_license_expiry else None,
-                    "categories": user_in.driver_license_categories
-                },
-                "special_licenses": {"boat": user_in.boat_license_number, "pilot": user_in.pilot_license_number}
-            }
-
-            # 2. Person (Identitás) létrehozása
-            new_person = Person(
-                first_name=user_in.first_name,
-                last_name=user_in.last_name,
-                mothers_name=user_in.mothers_name,
-                birth_place=user_in.birth_place,
-                birth_date=user_in.birth_date,
-                identity_docs=kyc_data
-            )
-            db.add(new_person)
-            await db.flush()
-
-            # 3. User (Auth) létrehozása
-            hashed_pwd = get_password_hash(user_in.password) if user_in.password else None
-            new_user = User(
-                email=user_in.email,
-                hashed_password=hashed_pwd,
-                social_provider=user_in.social_provider,
-                social_id=user_in.social_id,
-                person_id=new_person.id,
-                role=UserRole.USER,
-                region_code=user_in.region_code,
-                is_active=True
-            )
-            db.add(new_user)
-            await db.flush()
-
-            # 4. Economy: Wallet
-            db.add(Wallet(user_id=new_user.id, coin_balance=0.00, xp_balance=0))
-
-            # 5. Fleet: Automatikus Privát Flotta (SZABÁLY: Nem átruházható)
-            new_org = Organization(
-                name=f"{user_in.last_name} {user_in.first_name} Private Fleet",
-                org_type=OrgType.INDIVIDUAL,
-                owner_id=new_user.id,
-                is_transferable=False
-            )
-            db.add(new_org)
-            await db.flush()
-
-            # 6. Tagság rögzítése (Privát flotta tulajdonos)
-            db.add(OrganizationMember(organization_id=new_org.id, user_id=new_user.id, role="owner"))
-
-            # 7. Meghívó kezelése (Ha másik céghez is csatlakozik)
-            if user_in.invite_token and user_in.invite_token != "string":
-                logger.info(f"Processing invite token: {user_in.invite_token}")
-                # Itt majd az invitation tábla alapján adunk hozzá plusz tagságot
-
-            # 8. Audit Log
-            audit_stmt = text("""
-                INSERT INTO data.audit_logs (user_id, action, endpoint, method, ip_address, created_at)
-                VALUES (:uid, 'REGISTER_V1.3_KYC_FULL', '/api/v1/auth/register', 'POST', :ip, :now)
-            """)
-            await db.execute(audit_stmt, {"uid": new_user.id, "ip": ip_address, "now": datetime.now(timezone.utc)})
-
-            # 9. Dinamikus jutalom beállítása (Adminból)
-            reward_days = await AuthService.get_setting(db, "auth.reward_days", 14)
-
-            # 10. Email küldés
-            try:
-                await email_manager.send_email(
-                    recipient=user_in.email,
-                    template_key="registration_welcome",
-                    variables={"first_name": user_in.first_name, "reward_days": reward_days},
-                    user_id=new_user.id
-                )
-            except Exception as e:
-                logger.warning(f"Email skipped: {str(e)}")
-
-            await db.commit()
-            await db.refresh(new_user)
-            return new_user
-
-        except Exception as e:
-            await db.rollback()
-            logger.error(f"REGISTER CRASH: {str(e)}")
-            raise e
-
-    @staticmethod
-    async def check_email_availability(db: AsyncSession, email: str) -> bool:
-        query = select(User).where(and_(User.email == email, User.is_deleted == False))
-        result = await db.execute(query)
-        return result.scalar_one_or_none() is None

backend/app/services/harvester_base.py

@@ -0,0 +1,34 @@
+import httpx
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+from app.models.vehicle import VehicleCatalog
+
+class BaseHarvester:
+    def __init__(self, category: str):
+        self.category = category
+        self.headers = {"User-Agent": "ServiceFinder-Harvester-Bot/2.0"}
+
+    async def check_exists(self, db: AsyncSession, brand: str, model: str):
+        """Ellenőrzi, hogy az adott modell létezik-e már."""
+        stmt = select(VehicleCatalog).where(
+            VehicleCatalog.brand == brand,
+            VehicleCatalog.model == model,
+            VehicleCatalog.category == self.category
+        )
+        result = await db.execute(stmt)
+        return result.scalar_one_or_none()
+
+    async def log_entry(self, db: AsyncSession, brand: str, model: str, specs: dict = None):
+        """Létrehoz vagy frissít egy katalógus bejegyzést."""
+        existing = await self.check_exists(db, brand, model)
+        if not existing:
+            new_v = VehicleCatalog(
+                brand=brand,
+                model=model,
+                category=self.category,
+                factory_specs=specs or {},
+                verification_status="incomplete" if not specs else "verified"
+            )
+            db.add(new_v)
+            return True
+        return False

backend/app/services/harvester_bikes.py

@@ -0,0 +1,12 @@
+from .harvester_base import BaseHarvester
+
+class BikeHarvester(BaseHarvester):
+    def __init__(self):
+        super().__init__(category="motorcycle")
+        self.api_url = "https://api.example-bikes.com/v1/" # Példa forrás
+
+    async def harvest_all(self, db):
+        # Ide jön a motor-specifikus API hívás logikája
+        print("🏍️ Motor Robot: Adatgyűjtés indul...")
+        # ... fetch és mentés loop ...
+        await db.commit()

backend/app/services/harvester_trucks.py

@@ -0,0 +1,8 @@
+from .harvester_base import BaseHarvester
+
+class TruckHarvester(BaseHarvester):
+    def __init__(self):
+        super().__init__(category="truck")
+
+    async def run(self, db):
+        print("🚛 Truck Robot: Nehézgépek és teherautók keresése...")

backend/app/services/robot_manager.py

@@ -0,0 +1,22 @@
+import asyncio
+from .harvester_robot import CarHarvester # A korábbi CarHarvester-t nevezzük át így
+from .harvester_bikes import BikeHarvester
+from .harvester_trucks import TruckHarvester
+
+class RobotManager:
+    @staticmethod
+    async def run_full_sync(db):
+        """Sorban lefuttatja az összes robotot."""
+        robots = [
+            CarHarvester(),
+            BikeHarvester(),
+            TruckHarvester()
+        ]
+        
+        for robot in robots:
+            try:
+                await robot.run(db)
+                # Pihenő a kategóriák között, hogy ne kapjunk IP-tiltást
+                await asyncio.sleep(5) 
+            except Exception as e:
+                print(f"❌ Hiba a {robot.category} robotnál: {e}")

docs/V01_gemini/15_Changelog.md

@@ -134,3 +134,15 @@ A fejlesztések rendben tartásához javaslom a **`17_DEVELOPER_NOTES_AND_PITFAL
 ### 🛠️ 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.
+
+## [0.3.5] - 2026-02-07
+### ✨ Robot Technológia & Adatbiztonság
+- **Multi-Robot Architektúra:** Előkészítve a kategória-specifikus (Car, Bike, Truck) Harvester robotok szétválasztása.
+- **Status Tracking:** Bevezetve a `verification_status` a katalógus elemekhez a hiányos adatok kezelésére.
+- **SQL Optimalizálás:** Új indexek és kategória alapú szűrések hozzáadva a globális katalógushoz.
+
+## [0.4.0] - 2026-02-07
+### ✨ Multi-Robot System
+- **Kategória Robotok:** Elkészült a Car, Bike és Truck harvester moduláris szerkezete.
+- **Robot Manager:** Központi vezérlő az ütemezett és sorrendi adatgyűjtéshez.
+- **Katalógus Kereső:** Üzembe helyezve a `/catalog/search` végpont a Swaggerben.

docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md

@@ -83,3 +83,86 @@ Ha a jármű sehol nem szerepel (pl. épített versenyautó, egyedi yacht):
 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.
+
+## 8. Multi-Robot Harvester Architektúra
+
+A rendszer kategóriánként különálló kutató robotokat használ az erőforrások optimalizálása és az adatok pontossága érdekében.
+
+### A) Működési elv
+- **Ütemezett futás:** Minden kategória (Autó, Motor, Teher, Hajó) saját időablakban frissít, elkerülve a szerver túlterhelését.
+- **Hiányos adatok kezelése:** A Robot köteles rögzíteni a járművet akkor is, ha csak részleges információt talál (pl. csak márka és típus).
+- **Státusz jelölések (`verification_status`):**
+    - `verified`: Teljes DNS adatsor (Robot által hitelesítve).
+    - `incomplete`: Alapadatok megvannak, de hiányoznak technikai részletek (pl. guminyomás, olaj).
+    - `pending`: Felhasználó által felvett, Robot általi ellenőrzésre váró egyedi típus.
+
+### B) On-Demand prioritás
+Amikor a felhasználó olyan típust keres, ami nem szerepel a katalógusban, a rendszer egy "Priority Trigger"-t küld az adott kategória Robotjának, amely soron kívül megkezdi a célzott adatgyűjtést.
+
+## 9. OCR és Dokumentum Validációs Stratégia
+
+A rendszer a járműokmányok (forgalmi engedély, hajólevél, lajstrom) feldolgozására hibrid OCR (Optical Character Recognition) technológiát alkalmaz.
+
+### A) Hibrid Feldolgozási Sorrend (Failover Logic)
+A költséghatékonyság és a pontosság érdekében a rendszer az alábbi sorrendben próbálkozik:
+1. **Tier 1 (External Free/Limited APIs):** Ingyenes keretű felhő szolgáltatások (pl. Google Vision API, Azure Form Recognizer). A rendszer figyeli a havi limiteket, és azok elérésekor automatikusan vált a következő szolgáltatóra.
+2. **Tier 2 (Saját Erőforrás - Fallback):** Ha minden ingyenes külső keret elfogyott, a rendszer a saját szerveren futó PaddleOCR (AI alapú) modult használja.
+
+### B) Monetizáció és Jogosultságok
+A dokumentum alapú automata rögzítés és validáció prémium funkció:
+- **Free/Lite:** Manuális rögzítés (limitált mezők).
+- **VIP:** Automata rögzítés (OCR) 1-2 eszközre.
+- **VIP + / Premium +:** Korlátlan okmányfelismerés, automata lejárati figyelmeztetések és hivatalos adat-összevetés.
+
+## 10. Multi-Robot Harvester (Moduláris Felépítés)
+
+A járműkatalógus feltöltését egy bázis-osztályra (`BaseHarvester`) épülő, kategória-specifikus robotcsalád végzi.
+
+- **Autó Robot:** Közúti gépjárművekre optimalizálva.
+- **Motor Robot:** Kétkerekű és hobbi járművekre.
+- **Heavy Duty Robot:** Teherautók, kamionok és munkagépek specifikációira.
+- **Specialty Robot:** Vízi és légi járművek egyedi azonosítóihoz (MMSI, Lajstrom).
+
+# 🏎️ Asset és Flotta Specifikáció: A Járművek DNS-e (v1.2)
+
+## 7. Kivételkezelés: Ismeretlen és Egyedi Járművek
+- **On-Demand Harvester:** Ha a katalógus hiányos, a Robot kérésre (Trigger) indítja a mélykeresést.
+- **Custom Asset:** Egyedi/Sport eszközök rögzítése dokumentum alapú validációval.
+
+## 8. Multi-Robot Harvester Architektúra
+A rendszer kategória-specifikus (Car, Bike, Truck, Specialty) robotokat használ.
+- **Ütemezés:** Éjszakai batch-futás a szerver terhelésének minimalizálására.
+- **Státuszok:** `verified` (teljes), `incomplete` (részleges), `pending` (ellenőrzésre vár).
+
+## 9. VIN (Alvázszám) és Validáció
+- **Algoritmus:** Minden közúti járműnél kötelező a VIN Checksum (MOD 11) ellenőrzése a beíráskor.
+- **Auto-Fill:** Érvényes alvázszám esetén a rendszer felajánlja a gyártói adatok (gyártási év, üzem, motorverzió) automatikus kitöltését.
+
+## 10. Dokumentum Kezelés és Tárolás (NAS)
+Minden eszközhöz csatolt dokumentum (forgalmi, fotók, számlák) központi NAS tárolón kerül rögzítésre.
+- **Elérési út:** `/mnt/nas/app_data/assets/{asset_id}/`
+- **Archiválás:** `/mnt/nas/git_vault/` (Adatbázis mentések és konfigurációk).
+
+## 11. OCR és Üzleti Logika (Tier-based)
+A dokumentumfelismerés (OCR) prioritása a felhasználói csomagtól függ:
+- **VIP+ / Premium+:** Azonnali (Real-time) OCR feldolgozás. A felhasználó a feltöltés után 3-5 másodperccel már látja az előtöltött adatokat.
+- **Alap csomag:** Háttérfolyamat (Background task). A feldolgozás sorban állítás után történik, a felhasználó értesítést kap a befejezésről.
+- **Failover:** Külső API-k (Google/Azure) és saját erőforrás (PaddleOCR) hibrid használata a költségkontroll érdekében.
+
+## 12. OCR Monetizáció és Kreditszabályok (Admin Kontroll)
+
+A rendszer az OCR alapú adatbeolvasást kvótákhoz és kreditekhez köti.
+
+### A) Csomag alapú kvóták (Admin beállítás)
+Az Admin felületen csomagonként (Lite, VIP, VIP+) meghatározható egy ingyenes havi dokumentum-beolvasási keret:
+- **Lite:** 0-1 scan/hó.
+- **VIP:** 10 scan/hó.
+- **VIP+:** Korlátlan vagy magas limit (pl. 100).
+
+### B) Kreditalapú túllépés
+Ha a felhasználó kimerítette a keretét, minden további beolvasás kreditért vásárolható meg.
+- **Egységár:** Admin felületről állítható (pl. 1 beolvasás = 10 kredit).
+- **Tranzakció:** A rendszer levonja a kreditet a felhasználó `Wallet`-jéből a sikeres OCR feldolgozás után.
+
+### C) Egyedi engedélyek (Permissions)
+Lehetőség van egyedi felhasználóknak vagy flottáknak "OCR_Override" jogot adni, amivel a csomagtól függetlenül ingyenes vagy kedvezményes beolvasást kapnak (pl. tesztelők vagy stratégiai partnerek).