szolgáltatók beálltásai, szerkesztése , létrehozása

2026-06-17 11:52:25 +00:00
parent 213ba3b0f1
commit bf3a971ff1
56 changed files with 14421 additions and 1512 deletions
--- a/docs/database_schema_audit_partner_models_2026-06-16.md
+++ b/docs/database_schema_audit_partner_models_2026-06-16.md
@@ -0,0 +1,540 @@
+# 🏗️ Teljes Adatbázis Séma Audit & Partner Modell Felfedezés
+
+**Dátum:** 2026-06-16
+**Auditor:** Rendszer-Architect (DeepSeek Reasoner)
+**Cél:** Partner/Szolgáltató modellek azonosítása és a teljes adatbázis térkép elkészítése
+
+---
+
+## 1. 🔍 CÉLTUDATOS KERESÉS: Cégek / Partnerek / Szolgáltatók
+
+### 1.1. Találatok összefoglalása
+
+| Keresőszó | Találat | Modell | Séma |
+|-----------|---------|--------|------|
+| **Company** | ✅ VAN | `Organization` | `fleet.organizations` |
+| **Partner** | ✅ RÉSZBEN | `Organization.is_affiliate_partner` | `fleet.organizations` |
+| **Vendor** | ❌ NINCS | - | - |
+| **ServiceProvider** | ✅ VAN | `ServiceProvider` (régi) | `marketplace.service_providers` |
+| **ServiceProfile** | ✅ VAN | `ServiceProfile` (új) | `marketplace.service_profiles` |
+| **Contact/Person** | ✅ VAN | `Person` | `identity.persons` |
+| **Tenant** | ❌ NINCS | - | - |
+| **Business** | ✅ VAN | `Organization` (org_type=business) | `fleet.organizations` |
+| **Branch/Location** | ✅ VAN | `Branch` | `fleet.branches` |
+
+### 1.2. Fő következtetés
+
+**NINCS dedikált "Partner" vagy "Szolgáltató" modell.**  
+A rendszer **két különböző, egymástól független** entitáskészlettel dolgozik:
+
+1. **`fleet.organizations`** - Szervezetek (Cégek, Flották, Egyéni vállalkozók)
+2. **`marketplace.service_providers`** + **`marketplace.service_profiles`** - Szerviz szolgáltatók
+
+Ez a két világ **gyengén kapcsolódik** egymáshoz: a `ServiceProfile` hivatkozhat egy `Organization`-ra, de ez opcionális.
+
+---
+
+## 2. 📋 MEGLÉVŐ MODELLEK RÉSZLETES ELEMZÉSE
+
+### 2.1. `fleet.organizations` (Organization modell)
+
+**Fájl:** `backend/app/models/marketplace/organization.py`
+**Tábla:** `fleet.organizations`
+
+**Oszlopok csoportosítva:**
+
+#### 🏢 Alapadatok
+| Oszlop | Típus | Kötelező? | Megjegyzés |
+|--------|-------|-----------|------------|
+| `id` | `INTEGER` | ✅ | PK |
+| `name` | `VARCHAR(255)` | ✅ | Cégnév |
+| `full_name` | `VARCHAR` | ✅ | Teljes cégnév |
+| `display_name` | `VARCHAR(50)` | ❌ | Rövid megjelenítési név |
+| `folder_slug` | `VARCHAR(12)` | ✅ | **UNIQUE** Rendszer azonosító |
+| `org_type` | `ENUM(OrgType)` | ✅ | `individual`, `service`, `service_provider`, `fleet_owner`, `club`, `business` |
+
+#### 📍 Cím adatok (Denormalizált)
+| Oszlop | Típus |
+|--------|-------|
+| `address_id` | `UUID (FK → system.addresses.id)` |
+| `address_zip`, `address_city`, `address_street_name`, `address_street_type`, `address_house_number`, `address_hrsz` | `VARCHAR` |
+| `country_code` | `VARCHAR(2)` → default "HU" |
+| `language` | `VARCHAR(5)` → default "hu" |
+
+#### 🆔 Adóazonosítók
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `tax_number` | `VARCHAR(20)` | **UNIQUE** Adószám |
+| `reg_number` | `VARCHAR(50)` | Cégjegyzékszám |
+
+#### 🛡️ Életút / Biztonság
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `legal_owner_id` | `BIGINT (FK → identity.persons.id)` | Jogi képviselő (Person) |
+| `owner_id` | `INTEGER (FK → identity.users.id)` | Technikai tulajdonos (User) |
+| `first_registered_at` | `TIMESTAMPTZ` | Első regisztráció (örök) |
+| `current_lifecycle_started_at` | `TIMESTAMPTZ` | Aktuális életciklus kezdete |
+| `lifecycle_index` | `INTEGER` | Hányadik életciklus |
+| `is_deleted` | `BOOLEAN` | Soft delete flag |
+| `is_active` | `BOOLEAN` | Aktív flag |
+| `is_anonymized` | `BOOLEAN` | Anonimizált flag |
+| `is_verified` | `BOOLEAN` | KYC verifikáció |
+
+#### 💰 Partner / Értékesítés
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `is_affiliate_partner` | `BOOLEAN` | **PARTNER FLAG** → `false` default |
+| `subscription_plan` | `VARCHAR(30)` | "FREE", "PREMIUM", stb. |
+| `base_asset_limit` | `INTEGER` | Eszköz limit |
+| `is_ownership_transferable` | `BOOLEAN` | Átruházható-e |
+
+#### ⚙️ Konfiguráció
+| Oszlop | Típus |
+|--------|-------|
+| `notification_settings` | `JSON` |
+| `external_integration_config` | `JSON` |
+| `visual_settings` | `JSONB` |
+
+#### 🔗 Kapcsolatok (Relationships)
+```python
+Organization
+  ├── assets: List[AssetAssignment]         # Jármű hozzárendelések
+  ├── members: List[OrganizationMember]      # Tagok (User/Person)
+  ├── owner: User                            # Technikai tulajdonos
+  ├── financials: List[OrganizationFinancials] # Pénzügyi adatok
+  ├── service_profile: ServiceProfile        # Opcionális szerviz profil (1:1)
+  ├── branches: List[Branch]                 # Telephelyek
+  ├── legal_owner: Person                    # Jogi képviselő
+  └── vehicle_costs: List[VehicleCost]       # Jármű költségek
+```
+
+---
+
+### 2.2. `marketplace.service_providers` (ServiceProvider modell - RÉGI)
+
+**Fájl:** `backend/app/models/marketplace/service.py`
+**Tábla:** `marketplace.service_providers`
+
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `id` | `INTEGER` | PK |
+| `name` | `VARCHAR` | ✅ Név |
+| `address` | `VARCHAR` | ✅ Cím (egyszerű szöveg) |
+| `category` | `VARCHAR` | ❌ Kategória |
+| `status` | `USER-DEFINED` | ✅ Státusz (ENUM) |
+| `source` | `USER-DEFINED` | ✅ Forrás (ENUM) |
+| `validation_score` | `INTEGER` | ✅ Validációs pontszám |
+| `evidence_image_path` | `VARCHAR` | ❌ Kép bizonyíték |
+| `added_by_user_id` | `INTEGER` | ❌ Ki adta hozzá |
+| `created_at` | `TIMESTAMPTZ` | Létrehozás |
+
+> ⚠️ **Ez a tábla egy régebbi verzió. Nem használja a `ServiceProfile` modell, hanem külön kezelendő.**
+
+---
+
+### 2.3. `marketplace.service_profiles` (ServiceProfile modell - ÚJ)
+
+**Fájl:** `backend/app/models/marketplace/service.py`
+**Tábla:** `marketplace.service_profiles`
+
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `id` | `INTEGER` | PK |
+| `organization_id` | `INTEGER (FK → fleet.organizations.id)` | **UNIQUE** - Kapcsolat a szervezethez |
+| `parent_id` | `INTEGER (FK → self)` | Hierarchia (pl. franchise) |
+| `fingerprint` | `VARCHAR(255)` | **UNIQUE INDEX** - Robot által generált |
+| `location` | `GEOMETRY(POINT)` | PostGIS hely |
+| `status` | `ENUM(ServiceStatus)` | `ghost`, `active`, `flagged`, `suspended` |
+| `google_place_id` | `VARCHAR(100)` | **UNIQUE** Google Places azonosító |
+| `trust_score` | `INTEGER` | Trust engine pontszám |
+| `is_verified` | `BOOLEAN` | Verifikált szolgáltató |
+| `vibe_analysis` | `JSONB` | AI hangulatelemzés |
+| `social_links` | `JSONB` | Közösségi média linkek |
+| `specialization_tags` | `JSONB` | Specializációs címkék |
+| `opening_hours` | `JSONB` | Nyitvatartás |
+| `contact_phone` | `VARCHAR` | Telefon |
+| `contact_email` | `VARCHAR` | Email |
+| `website` | `VARCHAR` | Weboldal |
+| `bio` | `TEXT` | Leírás |
+| `rating_overall` | `FLOAT` | Átfogó értékelés |
+| `rating_verified_count` | `INTEGER` | Verified review-ok száma |
+
+#### 🔗 Kapcsolatok
+```python
+ServiceProfile
+  ├── organization: Organization       # 1:1 kapcsolat
+  ├── expertises: List[ServiceExpertise] # Szakmai címkék
+  └── reviews: List[ServiceReview]      # Vélemények
+```
+
+---
+
+### 2.4. `marketplace.service_reviews` (Verified Service Reviews)
+
+**Tábla:** `marketplace.service_reviews`
+
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `id` | `INTEGER` | PK |
+| `service_id` | `INTEGER (FK → marketplace.service_profiles.id)` | Melyik szerviz |
+| `user_id` | `INTEGER (FK → identity.users.id)` | Ki írta |
+| `transaction_id` | `UUID` | **UNIQUE** - Tranzakció azonosító |
+| `price_rating` | `INTEGER (1-5)` | Ár értékelés |
+| `quality_rating` | `INTEGER (1-5)` | Minőség értékelés |
+| `time_rating` | `INTEGER (1-5)` | Idő értékelés |
+| `communication_rating` | `INTEGER (1-5)` | Kommunikáció értékelés |
+| `comment` | `TEXT` | Szöveges vélemény |
+| `is_verified` | `BOOLEAN` | Tranzakcióhoz kötött |
+| `created_at`/`updated_at` | `TIMESTAMPTZ` | Audit |
+
+---
+
+### 2.5. `marketplace.ratings` (Általános értékelések)
+
+**Tábla:** `marketplace.ratings`
+
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `id` | `INTEGER` | PK |
+| `author_id` | `INTEGER` | Ki írta |
+| `target_organization_id` | `INTEGER` | Cél szervezet (opcionális) |
+| `target_user_id` | `INTEGER` | Cél felhasználó (opcionális) |
+| `target_branch_id` | `UUID` | Cél telephely (opcionális) |
+| `score` | `NUMERIC` | Pontszám |
+| `comment` | `TEXT` | Szöveges |
+| `images` | `JSONB` | Képek |
+| `is_verified` | `BOOLEAN` | Verifikált |
+
+---
+
+### 2.6. `fleet.branches` (Telephelyek)
+
+**Tábla:** `fleet.branches`
+
+| Oszlop | Típus | Megjegyzés |
+|--------|-------|------------|
+| `id` | `UUID` | PK |
+| `organization_id` | `INTEGER (FK → fleet.organizations.id)` | ✅ Melyik szervezethez |
+| `address_id` | `UUID (FK → system.addresses.id)` | ❌ Cím (strukturált) |
+| `name` | `VARCHAR(100)` | ✅ Telephely név |
+| `is_main` | `BOOLEAN` | Központi telephely |
+| `postal_code`, `city`, `street_name`, stb. | `VARCHAR` | Denormalizált cím |
+| `location` | `GEOMETRY(POINT)` | PostGIS |
+| `opening_hours` | `JSONB` | Nyitvatartás |
+| `branch_rating` | `FLOAT` | Telephely értékelés |
+| `status` | `VARCHAR(30)` | `active`, `inactive` |
+| `is_deleted` | `BOOLEAN` | Soft delete |
+
+---
+
+## 3. 🗺️ TELJES ADATBÁZIS TÉRKÉP (Minden séma és tábla)
+
+### 3.1. Identity séma (Személyek, Felhasználók, Hitelesítés)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `identity.persons` | Természetes személyek (DNS szint) | ✅ **Aktív** |
+| `identity.users` | Technikai fiókok (bejelentkezés) | ✅ **Aktív** |
+| `identity.wallets` | Pénztárcák (Triple Wallet) | ✅ **Aktív** |
+| `identity.active_vouchers` | Aktív voucher-ek | ✅ **Aktív** |
+| `identity.user_trust_profiles` | Trust score profilok | ✅ **Aktív** |
+| `identity.verification_tokens` | Email/telefon verifikáció | ✅ **Aktív** |
+| `identity.one_time_passwords` | OTP kódok | ✅ **Aktív** |
+| `identity.social_accounts` | Közösségi média kapcsolatok | ✅ **Aktív** |
+| `identity.devices` | Eszköz fingerprint | ✅ **Aktív** |
+| `identity.user_device_links` | User-Eszköz kapcsolatok | ✅ **Aktív** |
+
+### 3.2. Fleet séma (Szervezetek, Flották)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `fleet.organizations` | Szervezetek (cégek, flották, szolgáltatók) | ✅ **Aktív** |
+| `fleet.organization_members` | Tagságok (User/Person → Organization) | ✅ **Aktív** |
+| `fleet.organization_financials` | Pénzügyi adatok (éves) | ✅ **Aktív** |
+| `fleet.branches` | Telephelyek | ✅ **Aktív** |
+| `fleet.asset_assignments` | Jármű hozzárendelések | ✅ **Aktív** |
+| `fleet.org_sales_assignments` | Értékesítési hozzárendelések | ✅ **Aktív** |
+
+### 3.3. Vehicle séma (Járművek, Katalógus)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `vehicle.vehicle_model_definitions` | Jármű modellek (MDM) | ✅ **Aktív** |
+| `vehicle.vehicle_catalog` | Katalógus sablonok | ✅ **Aktív** |
+| `vehicle.assets` | Fizikai eszközök (Digital Twin) | ✅ **Aktív** |
+| `vehicle.vehicle_types` | Jármű típusok | ✅ **Aktív** |
+| `vehicle.feature_definitions` | Felszereltség elemek | ✅ **Aktív** |
+| `vehicle.model_feature_maps` | Modell-Felszereltség kapcsolatok | ✅ **Aktív** |
+| `vehicle.dict_body_types` | Karosszéria típus szótár | ✅ **Aktív** |
+| `vehicle.cost_categories` | Költségkategóriák | ✅ **Aktív** |
+| `vehicle.costs` | Jármű költségek (TCO) | ✅ **Aktív** |
+| `vehicle.vehicle_expenses` | Jármű kiadások (jelentésekhez) | ✅ **Aktív** |
+| `vehicle.odometer_readings` | Kilométeróra állások | ✅ **Aktív** |
+| `vehicle.vehicle_ownership_history` | Tulajdonos történet | ✅ **Aktív** |
+| `vehicle.vehicle_transfer_requests` | Átruházási kérelmek | ✅ **Aktív** |
+| `vehicle.catalog_discovery` | Katalógus felfedező várólista | ✅ **Aktív** |
+| `vehicle.gb_catalog_discovery` | UK piaci felfedező | ✅ **Aktív** |
+| `vehicle.auto_data_crawler_queue` | Crawler várólista | ✅ **Aktív** |
+| `vehicle.vehicle_logbook` | Jármű naplókönyv | ✅ **Aktív** |
+| `vehicle.motorcycle_specs` | Motorkerékpár specifikációk | ✅ **Aktív** |
+| `vehicle.external_reference_library` | Külső referencia könyvtár | ✅ **Aktív** |
+| `vehicle.reference_lookup` | Referencia kereső | ✅ **Aktív** |
+| `vehicle.vehicle_user_ratings` | Felhasználói jármű értékelések | ✅ **Aktív** |
+| `vehicle.asset_costs` | Eszköz költségek | ✅ **Aktív** |
+| `vehicle.asset_events` | Eseménynapló | ✅ **Aktív** |
+| `vehicle.asset_financials` | Pénzügyi adatok | ✅ **Aktív** |
+| `vehicle.asset_inspections` | Ellenőrzések | ✅ **Aktív** |
+| `vehicle.asset_reviews` | Eszköz vélemények | ✅ **Aktív** |
+| `vehicle.asset_telemetry` | Telemetria adatok | ✅ **Aktív** |
+
+### 3.4. Marketplace séma (Piactér, Szervizek)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `marketplace.service_providers` | Szolgáltatók (RÉGI, egyszerű) | ⚠️ **Használaton kívül?** |
+| `marketplace.service_profiles` | Szerviz profilok (ÚJ) | ✅ **Aktív** |
+| `marketplace.service_reviews` | Verifikált vélemények | ✅ **Aktív** |
+| `marketplace.expertise_tags` | Szakmai címkék | ✅ **Aktív** |
+| `marketplace.service_expertises` | Szerviz-Szakma kapcsolatok | ✅ **Aktív** |
+| `marketplace.service_specialties` | Specializációk (hierarchikus) | ✅ **Aktív** |
+| `marketplace.service_staging` | Robot által gyűjtött adatok | ✅ **Aktív** |
+| `marketplace.discovery_parameters` | Robot keresési paraméterek | ✅ **Aktív** |
+| `marketplace.service_requests` | Szervizigények | ✅ **Aktív** |
+| `marketplace.ratings` | Általános értékelések | ✅ **Aktív** |
+| `marketplace.votes` | Szavazatok | ✅ **Aktív** |
+| `marketplace.costs` | Költségnapló (Trust Engine) | ✅ **Aktív** |
+
+### 3.5. Finance séma (Pénzügyek)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `finance.credit_logs` | Hitel napló | ✅ **Aktív** |
+| `finance.exchange_rates` | Árfolyamok | ✅ **Aktív** |
+| `finance.issuers` | Kibocsátók | ✅ **Aktív** |
+| `finance.org_subscriptions` | Szervezeti előfizetések | ✅ **Aktív** |
+| `finance.user_subscriptions` | Felhasználói előfizetések | ✅ **Aktív** |
+| `finance.payment_intents` | Fizetési szándékok | ✅ **Aktív** |
+| `finance.withdrawal_requests` | Kifizetési kérelmek | ✅ **Aktív** |
+
+### 3.6. System séma (Rendszeradatok)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `system.addresses` | Strukturált címek | ✅ **Aktív** |
+| `system.documents` | Dokumentumok | ✅ **Aktív** |
+| `system.translations` | Többnyelvű fordítások | ✅ **Aktív** |
+| `system.system_parameters` | Rendszer paraméterek | ✅ **Aktív** |
+| `system.internal_notifications` | Belső értesítések | ✅ **Aktív** |
+| `system.pending_actions` | Függőben lévő műveletek | ✅ **Aktív** |
+| `system.service_catalog` | Szolgáltatás katalógus | ✅ **Aktív** |
+| `system.subscription_tiers` | Előfizetési szintek | ✅ **Aktív** |
+| `system.service_staging` | Szolgáltatás staging | ⚠️ **Duplikáció?** |
+| `system.staged_vehicle_data` | Jármű adat staging | ✅ **Aktív** |
+| `system.geo_postal_codes` | Irányítószám adatok | ✅ **Aktív** |
+| `system.geo_streets` | Utcák | ✅ **Aktív** |
+| `system.geo_street_types` | Utca típusok | ✅ **Aktív** |
+| `system.competitions_deprecated` | Versenyek (DEPR) | ❌ **Deprecated** |
+| `system.user_scores_deprecated` | Pontszámok (DEPR) | ❌ **Deprecated** |
+| `system.service_staging_deprecated` | Staging (DEPR) | ❌ **Deprecated** |
+| `system.system_data_completion_weights` | Adatteljességi súlyok | ✅ **Aktív** |
+
+### 3.7. Audit séma (Naplózás)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `audit.audit_logs` | Általános audit napló | ✅ **Aktív** |
+| `audit.financial_ledger` | Pénzügyi főkönyv | ✅ **Aktív** |
+| `audit.operational_logs` | Működési napló | ✅ **Aktív** |
+| `audit.process_logs` | Folyamat napló | ✅ **Aktív** |
+| `audit.security_audit_logs` | Biztonsági audit napló | ✅ **Aktív** |
+
+### 3.8. Gamification séma (Játékosítás)
+| Tábla | Leírás | Státusz |
+|-------|--------|---------|
+| `gamification.badges` | Jelvények | ✅ **Aktív** |
+| `gamification.competitions` | Versenyek | ✅ **Aktív** |
+| `gamification.level_configs` | Szint konfigurációk | ✅ **Aktív** |
+| `gamification.point_rules` | Pont szabályok | ✅ **Aktív** |
+| `gamification.points_ledger` | Pont főkönyv | ✅ **Aktív** |
+| `gamification.seasonal_competitions` | Szezonális versenyek | ✅ **Aktív** |
+| `gamification.seasons` | Szezonok | ✅ **Aktív** |
+| `gamification.user_badges` | Felhasználói jelvények | ✅ **Aktív** |
+| `gamification.user_contributions` | Felhasználói hozzájárulások | ✅ **Aktív** |
+| `gamification.user_scores` | Felhasználói pontszámok | ✅ **Aktív** |
+| `gamification.user_stats` | Felhasználói statisztikák | ✅ **Aktív** |
+
+---
+
+## 4. 🔗 KAPCSOLATOK TÉRKÉP (Entity Relationship)
+
+```mermaid
+erDiagram
+    PERSON ||--o{ USER : "has"
+    PERSON ||--o{ ORGANIZATION_MEMBER : "member of"
+    PERSON ||--o{ ORGANIZATION : "legal owner of"
+    USER ||--o{ ORGANIZATION : "technical owner of"
+    USER ||--o{ SERVICE_REVIEW : "writes"
+    USER ||--o{ SERVICE_REQUEST : "creates"
+    USER ||--o{ VEHICLE_USER_RATING : "rates"
+    ORGANIZATION ||--o{ ORGANIZATION_MEMBER : "has members"
+    ORGANIZATION ||--o{ BRANCH : "has locations"
+    ORGANIZATION ||--o| SERVICE_PROFILE : "optional service"
+    ORGANIZATION ||--o{ ASSET_ASSIGNMENT : "owns vehicles"
+    ORGANIZATION ||--o{ VEHICLE_COST : "pays costs"
+    SERVICE_PROFILE ||--o{ SERVICE_REVIEW : "receives"
+    SERVICE_PROFILE ||--o{ SERVICE_EXPERTISE : "specializes"
+    SERVICE_PROFILE ||--o{ BRANCH : "operates"
+    BRANCH ||--o{ RATING : "rated by"
+    BRANCH ||--o{ SERVICE_REQUEST : "receives requests"
+    VEHICLE_MODEL_DEFINITION ||--o{ ASSET_CATALOG : "has variants"
+    VEHICLE_MODEL_DEFINITION ||--o{ VEHICLE_COST : "has costs"
+    VEHICLE_MODEL_DEFINITION ||--o{ VEHICLE_USER_RATING : "rated by users"
+    ASSET_CATALOG ||--o{ ASSET : "defines"
+    ASSET ||--o{ ASSET_EVENT : "has events"
+    ASSET ||--o{ SERVICE_REQUEST : "referenced in"
+    ADDRESS ||--o{ PERSON : "lives at"
+    ADDRESS ||--o{ ORGANIZATION : "located at"
+    ADDRESS ||--o{ BRANCH : "address"
+```
+
+---
+
+## 5. 💡 JAVASLATOK a "Közösségi Kereső" funkciókhoz
+
+### 5.1. Jelenlegi hiányosságok
+
+1. **Nincs dedikált "Partner" entitás** - A `fleet.organizations`-ban az `is_affiliate_partner` egy egyszerű boolean, nincs hozzá partner-specifikus adat (pl. jutalék ráta, partner kategória, szerződés állapota).
+2. **`ServiceProvider` (régi) és `ServiceProfile` (új) kettősség** - A régi `marketplace.service_providers` tábla használaton kívülinek tűnik, de még létezik.
+3. **Nincs "aliases" (álnév) támogatás** - Egyik táblában sincs JSONB aliases mező.
+4. **Kategória rendszer hiányos** - A `marketplace.expertise_tags` és `marketplace.service_specialties` párhuzamos címke rendszert alkot.
+
+### 5.2. Javasolt bővítés: `Organization` kiegészítése (AJÁNLOTT)
+
+Ahelyett, hogy új `Partner` táblát hoznánk létre, bővítsük a meglévő `fleet.organizations` táblát az alábbi JSONB oszlopokkal:
+
+```python
+# Javasolt új mezők az Organization modellben
+class Organization(Base):
+    # ... meglévő mezők ...
+    
+    # ÚJ: Partnerek / Közösségi kereső
+    aliases: Mapped[dict] = mapped_column(
+        JSONB, server_default=text("'[]'::jsonb"),
+        comment="Álnevek / alternatív nevek (pl. 'AutoShop Kft.', 'Autóshop')"
+    )
+    is_verified: Mapped[bool] = mapped_column(
+        Boolean, server_default=text("false"),
+        comment="Hivatalosan verifikált szervezet"
+    )
+    verification_level: Mapped[str] = mapped_column(
+        String(20), server_default=text("'basic'"),
+        comment="Verifikációs szint: basic, email, phone, kyc, premium"
+    )
+    partner_category: Mapped[str] = mapped_column(
+        String(50), server_default=text("'none'"),
+        comment="Partner kategória: none, basic, silver, gold, platinum"
+    )
+    commission_rate: Mapped[Optional[float]] = mapped_column(
+        Numeric(5, 2), nullable=True,
+        comment="Jutalék ráta (%-ban)"
+    )
+    service_radius_km: Mapped[Optional[int]] = mapped_column(
+        Integer, nullable=True,
+        comment="Szolgáltatási körzet (km)"
+    )
+    tags: Mapped[dict] = mapped_column(
+        JSONB, server_default=text("'[]'::jsonb"),
+        comment="Címkék a közösségi kereséshez"
+    )
+    search_keywords: Mapped[dict] = mapped_column(
+        JSONB, server_default=text("'{}'::jsonb"),
+        comment="Kereső kulcsszavak több nyelven"
+    )
+    social_profiles: Mapped[dict] = mapped_column(
+        JSONB, server_default=text("'{}'::jsonb"),
+        comment="Közösségi média profilok (Facebook, Instagram, Google Business)"
+    )
+    contact_persons: Mapped[dict] = mapped_column(
+        JSONB, server_default=text("'[]'::jsonb"),
+        comment="Kapcsolattartó személyek adatai"
+    )
+```
+
+### 5.3. Alternatíva: Új `partner_profiles` tábla
+
+Ha a `fleet.organizations` túl nagyra nőne, hozzunk létre egy új táblát:
+
+```python
+class PartnerProfile(Base):
+    """Bővített partner profil a Közösségi Keresőhöz."""
+    __tablename__ = "partner_profiles"
+    __table_args__ = {"schema": "marketplace"}
+    
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    organization_id: Mapped[int] = mapped_column(
+        Integer, ForeignKey("fleet.organizations.id"), unique=True, nullable=False
+    )
+    
+    # --- ALAPADATOK ---
+    aliases: Mapped[dict] = mapped_column(JSONB, server_default=text("'[]'::jsonb"))
+    partner_category: Mapped[str] = mapped_column(String(50), default="none")
+    
+    # --- VERIFIKÁCIÓ ---
+    verification_level: Mapped[str] = mapped_column(String(20), default="basic")
+    verified_at: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
+    verified_by_id: Mapped[Optional[int]] = mapped_column(Integer, ForeignKey("identity.users.id"))
+    
+    # --- KERESÉS ---
+    search_keywords: Mapped[dict] = mapped_column(JSONB, server_default=text("'{}'::jsonb"))
+    tags: Mapped[dict] = mapped_column(JSONB, server_default=text("'[]'::jsonb"))
+    service_radius_km: Mapped[Optional[int]] = mapped_column(Integer)
+    
+    # --- GAZDASÁGI ADATOK ---
+    commission_rate: Mapped[Optional[float]] = mapped_column(Numeric(5, 2))
+    contract_start: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
+    contract_end: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
+    
+    # --- KAPCSOLATOK ---
+    social_profiles: Mapped[dict] = mapped_column(JSONB, server_default=text("'{}'::jsonb"))
+    contact_persons: Mapped[dict] = mapped_column(JSONB, server_default=text("'[]'::jsonb"))
+    
+    # --- AUDIT ---
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    updated_at: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True), onupdate=func.now())
+```
+
+### 5.4. Ajánlott stratégia
+
+1. **Rövid táv**: Az `Organization` modell bővítése JSONB mezőkkel (`aliases`, `tags`, `search_keywords`, `social_profiles`). Ez azonnal használható, nincs szükség új táblára.
+2. **Közép táv**: Ha a partnerek száma eléri a 10.000+ rekordot, hozzuk létre a dedikált `partner_profiles` táblát az `marketplace` sémában.
+3. **Hosszú táv**: A régi `marketplace.service_providers` tábla archiválása/eltávolítása, mivel a `ServiceProfile` és a bővített `Organization` lefedi a funkcióit.
+
+### 5.5. Megjegyzések a "Céges nyilvántartás" funkcióról
+
+A rendelkezésre álló kód és adatbázis alapján:
+
+- ✅ **Van "Céges nyilvántartás"** → `fleet.organizations` tábla
+- ✅ **Van tagságkezelés** → `fleet.organization_members` tábla (User/Person + role)
+- ✅ **Van telephelykezelés** → `fleet.branches` tábla (PostGIS támogatással)
+- ✅ **Van szolgáltatói profil** → `marketplace.service_profiles` tábla
+- ✅ **Van értékelési rendszer** → `marketplace.service_reviews` (verifikált) + `marketplace.ratings` (általános)
+- ❌ **NINCS dedikált partner modell** - Az `is_affiliate_partner` boolean nem elegendő
+- ❌ **NINCS keresőoptimalizált adat** (aliases, tags, keywords)
+
+---
+
+## 6. ⚠️ FIGYELMEZTETÉSEK
+
+### 6.1. Duplikált táblák
+- `marketplace.service_staging` és `system.service_staging` - Valószínűleg csak egy kellene.
+- `marketplace.costs` és `vehicle.costs` - Két külön költség tábla, különböző sémákban.
+- `system.competitions_deprecated` → `gamification.competitions`
+- `system.user_scores_deprecated` → `gamification.user_scores`
+
+### 6.2. Kettős modell architektúra
+- `marketplace.service_providers` (régi, egyszerű) vs `marketplace.service_profiles` (új, komplex)
+- A régi tábla használata nem javasolt új fejlesztésekhez.
+
+### 6.3. Soft delete következetlenség
+- `fleet.organizations`: `is_deleted` + `is_active` boolean mezők
+- `marketplace.service_profiles`: státusz alapú (`ghost`, `active`, `flagged`, `suspended`)
+- `identity.persons`: `deleted_at` datetime mező
+- `identity.users`: `is_active` boolean
+- **Hiányzik egy egységes soft-delete stratégia az egész rendszerben.**
+
+---
+
+**Jelentés vége.** A javasolt bővítések implementálása előtt egyeztetés szükséges a Vezető Tervezővel.