Initial commit: Robot ökoszisztéma v2.0 - Stabilizált jármű és szerviz robotok

archive/2026.02.18 Archive_old_mapps/V01_gemini/11_Gamification_Social.md

@@ -0,0 +1,147 @@
+(A Validációs Rendszer.)
+# 🏆 GAMIFICATION & SOCIAL VALIDATION
+
+## 1. Validációs Logika (Q8)
+- **Hivatalos Szerviz:** Számla/Munkalap feltöltése -> Automatikus Trust Score növekedés.
+- **Magán/Sufni Javítás:** Rögzíthető, de "Low Trust" besorolást kap (csökkenti a jármű értékét), kivéve ha egy **Validátor** (High Rank User) igazolja.
+- **Validátor:** Olyan felhasználó, aki magas XP szinttel rendelkezik. Feladata: Képek és adatok ellenőrzése kreditért.
+
+## 2. Véleményezés (Review)
+- **Szabály:** Csak "Verified Visit" után lehet értékelni (GPS vagy Számla).
+- **Fellebbezés:** A szerviz jelezheti, ha a vélemény valótlan. Ilyenkor a Moderátorok (vagy magas szintű Validátorok) döntenek.
+
+## 3. "Service Hunt" (Szerviz Vadászat)
+A felhasználók játékosított formában validálják az adatbázist.
+
+### 3.1 Validációs Szabályok
+* **Radius:** A felhasználónak **50-100 méteren** belül kell tartózkodnia a szerviz GPS koordinátáihoz képest a validáláshoz.
+* **Jutalom:** Csak akkor jár, ha a validáció sikeres (GPS + Fotó).
+* **Bot vs. Ember:**
+    * Ha a Bot találta a szervizt, de nincs validálva: A felhasználó megkapja a "Validator" bónuszt.
+    * Ha már validálva van (Status: Verified): A felhasználó látja a térképen, hogy "Már validálva", nem jár érte pont (kivéve adatfrissítés).
+
+### 3.2 Okos Értékelési Rendszer (Review Logic)
+A rendszer védi a szolgáltatókat a "Review Bombing"-tól, de jutalmazza a konzisztenciát.
+
+* **Negatív élmény (1-3 csillag):**
+    * Egy felhasználótól **csak a legutolsó** negatív értékelés számít bele az átlagba.
+    * Ha a user újra értékel (mert visszament), az előző negatív értékelés `is_active = False` státuszba kerül (de az admin látja az előzményeket).
+* **Pozitív élmény (4-5 csillag):**
+    * Minden pozitív értékelés számít és összeadódik (kumulatív).
+    * Ez ösztönzi a szervizt a folyamatos jó teljesítményre.
+
+    ## 4. Social Flexing & Vanity Items
+A "dicsekvési faktor" kezelése.
+
+### 4.1 Megjelenítési Helyek
+* **Profil oldalon:** A megszerzett jelvények (Badges) "vitrinje".
+* **Ranglistákon:** Kiemelt név, egyedi háttérszín vagy ikon a név mellett.
+* **Térképen:** Egyedi pin ikon a saját járműveknél (pl. arany színű autó ikon a térképen a sima kék helyett).
+
+### 4.2 Ritkasági Szintek (Rarity)
+A tárgyakhoz ritkasági szintet rendelünk a `system_configs`-ban:
+1.  **Common (Gyakori):** Bárki megveheti olcsón.
+2.  **Rare (Ritka):** Drágább, vagy teljesítményhez kötött (pl. 10 validált szerviz).
+3.  **Epic (Epikus):** Csak Prémium+ tagoknak vagy nagyon sok kreditbe kerül.
+4.  **Legendary (Legendás):** Egyedi eventeken szerezhető (pl. "Service Hunt 2026 Győztes").
+
+### 4.3 "Equipped" Status
+A felhasználónak lehet 50 jelvénye, de egyszerre (típustól függően) csak korlátozott számút mutathat meg (pl. 3 Slot a profilkép alatt). Ezt a `user_inventory.is_equipped` flag kezeli.
+
+## 5. Büntetőpontok és Rehabilitáció (Strike System)
+
+A rendszer 3-szintes büntetőrendszert alkalmaz a hibás vagy szándékosan téves adatok kiszűrésére.
+
+### 5.1 Büntetőpontok (Strikes)
+* **Ok:** Szándékos félrevezetés, nem létező szerviz rögzítése, hamis fotók.
+* **Következmény:** 3 strike után a felhasználó véglegesen vagy ideiglenesen ki lesz tiltva a "Service Hunt" és validációs feladatokból.
+
+### 5.2 Rehabilitációs Logika (Strike eltávolítás)
+Egy büntetőpont (1 strike) levonható az alábbi feltételek teljesülése esetén (Adminról állítható értékek):
+* **Javítás:** 10 sikeres és elfogadott adatjavítás (más hibájának korrigálása).
+* **Validáció:** 20 sikeres és megerősített validáció.
+* **Példás rögzítés:** 3 olyan új szerviz rögzítése, amit a Bot és az Admin is 100%-ban validnak talál.
+
+### 5.3 Területi Monitoring (Geofence Blacklist)
+Amennyiben egy adott földrajzi körzetből (pl. egy városrész) kiugróan sok (százalékos arányban mérve) téves adat érkezik, a rendszer automatikusan korlátozhatja az onnan érkező új regisztrálók hozzáférését a szociális feladatokhoz, amíg az Admin felül nem vizsgálja a helyzetet.
+
+## 6. Versenyrendszer (Leaderboards)
+
+A közösségi munka (Service Hunt, Validáció) egy globális és régiós ranglistát táplál.
+
+### 6.1 Ranglista kategóriák
+* **The Explorer (A Felfedező):** Legtöbb új szerviz rögzítése.
+* **The Verifier (A Hitelesítő):** Legtöbb sikeres adat-visszaigazolás.
+* **The Master Mechanic:** Legtöbb technikai adat kiegészítés.
+
+### 6.2 Szintlépési Bónuszok (Milestones)
+A fejlődés nem csak dicsőség, hanem gazdasági előny is.
+* **Level 5:** 1.000 Kredit jutalom.
+* **Level 10:** 5.000 Kredit + "Expert" jelvény.
+* **Level 20:** Egyedi avatar keret + állandó 5% kedvezmény a hirdetési árakból (céges esetén).
+
+### 6.3 Éves/Havi Szezonok
+Minden hónap végén az első 3 helyezett extra Kreditet vagy "Voucher"-t kap, amit a partnereinknél (szervizeknél) válthat be.
+
+### 3. Jutalmazási Szabályok (Social Points)
+- **Célcsoport**: Kizárólag természetes személyek (`role: user`, `driver`).
+- **Kizárások**: Szervezetek (Organizations) és Adminisztrátorok nem gyűjtenek XP-t.
+- **Logika**: Minden `PointsLedger` bejegyzés kötelezően hivatkozik egy `user_id`-ra.
+- **Mezőnevek**: Adatbázis szinten a pontok az `id`, `user_id`, `points`, `reason` mezőkben tárolódnak.
+
+## 2026.02.10 FRISSÍTÉS - GAMIFICATION ÖKOSZISZTÉMA
+
+### 1. Pontrendszer Logika
+A rendszer különválasztja a tekintélyt és a jutalmat:
+- **XP (Tapasztalat):** Végleges szintlépéshez. Képlet: $BaseXP \times Level^{1.5}$. (Nehezedő görbe).
+- **Social Points (Szezonális):** Időszakos versenyekhez (pl. Hónap Vadásza).
+- **Kredit:** Fizetőeszköz, amit Social Pontokból lehet váltani (pl. 1000 pont = 100 Kredit).
+
+### 2. Konfiguráció
+Minden érték (szorzók, határok) a \`GAMIFICATION_MASTER_CONFIG\` JSON paraméterben állítható Admin felületről, kódmódosítás nélkül.
+
+### 3. Audit
+Minden pontmozgás a \`PointsLedger\` táblába kerül rögzítésre a visszakövethetőség érdekében.
+
+XP Formula: $XP_{required} = BaseXP \times Level^{1.5}$Penalty Logic: restriction_level bevezetése (0-3).Weighting: Saját adat vs. Közösségi adat súlyozási táblázata.
+
+# 11. Gamification és Social Engine Specifikáció
+
+## 1. XP (Experience Points) - A Tekintély
+Az XP a felhasználó végleges, nem csökkenthető tekintélypontja.
+- **Képlet:** A szintlépéshez szükséges összes XP:
+  $$XP_{total} = 500 \times Level^{1.5}$$
+- **Súlyozás:**
+  - **Saját adat (Fleet):** Alacsony érték (pl. 10 XP).
+  - **Közösségi adat (Service Discovery):** Magas érték (pl. 100 XP).
+
+## 2. Social Points - A Valuta Alapja
+Szezonális pontok, amelyek Kreditre válthatóak.
+- **Váltószám:** Alapértelmezett: 100 Social Point = 1 Kredit.
+- **Váltási mód:** Automatikus (rendszerparaméter alapján) vagy manuális (felhasználói döntés).
+
+## 3. Trust & Penalty Engine (Büntetőrendszer)
+A rendszer integritásának védelme érdekében hibapontokat (Penalty Points) alkalmazunk.
+- **Szintek (Restriction Level):**
+  - **0 (Normal):** Teljes pontszorzó (1.0x).
+  - **1 (Warning):** Csökkentett pontszerzés (0.5x).
+  - **2 (Restricted):** Szigorú moderátori ellenőrzés minden adatnál, 0.1x pontszerzés.
+  - **3 (Blocked):** Pontszerzés és adatbeküldés tiltva.
+- **Ledolgozás:** Minden pozitív XP szerzés a büntetőpontokat is csökkenti (pl. 1 XP jóváírás = 0.5 Penalty pont levonás).
+
+## 4. Szintlépési Bónuszok
+Minden 10. szint elérésekor a rendszer automatikus Kredit jutalmat oszt a `GAMIFICATION_MASTER_CONFIG` alapján.
+
+## 5. Büntetőrendszer (Strike System)
+A rendszer integritásának megőrzése érdekében hibapontokat alkalmazunk, amelyek befolyásolják a pontszerzés hatékonyságát.
+
+- **Szorzók (Multipliers):**
+  - Level 0 (Normal): 1.0x
+  - Level 1 (Warning): 0.5x
+  - Level 2 (Restricted): 0.1x
+  - Level 3 (Blocked): 0.0x
+
+- **Ledolgozás (Recovery):**
+  A büntetőpontok pozitív aktivitással (XP szerzéssel) ledolgozhatóak. Az elért XP egy admin által meghatározott része (alapértelmezett: 50%) levonásra kerül a büntetőpontokból.
+
+- **Admin-Vezérelt Küszöbök:** Minden szintváltási határ a `GAMIFICATION_MASTER_CONFIG` paraméterben definiált.