service-finder/archive/2026.02.18 Archive_old_mapps/V01_gemini/11_Gamification_Social.md

(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.