- Added centralized, self-learning GeoService (ZIP, City, Street) - Implemented Hybrid Address Management (Centralized table + Denormalized fields) - Fixed Gamification logic (PointsLedger field names & filtering) - Added address autocomplete and two-tier (Free/Premium) search API - Synchronized UserStats and PointsLedger schemas
84 lines
5.0 KiB
Markdown
84 lines
5.0 KiB
Markdown
(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. |