feat: Identity & Company Sync v1.2, Admin hiearchia és Pénzügyi logika véglegesítése

docs/V01_gemini/10_Billing_Credits_Subscriptions.md

@@ -1,35 +1,58 @@
-# 💰 BILLING, CREDITS AND MULTI-CURRENCY (v1.0)
+# 💰 BILLING, CREDITS & SUBSCRIPTIONS (v1.2)
 
 ## 1. Regionális és Valuta Logika (EU Scope)
-A rendszer támogatja a többnyelvű és többvalutás elszámolást. Minden pénzügyi tranzakció két értéket tárol:
-1. **Local Cost:** Helyi pénznemben rögzített összeg (pl. 45.000 Ft).
-2. **Standard Cost (EUR):** A rögzítéskori középárfolyamon átszámított euró érték.
+A rendszer támogatja a többnyelvű és többvalutás elszámolást az EU teljes területén. Minden pénzügyi tranzakció két értéket tárol:
+1. **Local Cost:** A felhasználó helyi pénznemében rögzített összeg (pl. 45.000 Ft).
+2. **Standard Cost (EUR):** A rögzítés pillanatában érvényes középárfolyamon átszámított euró érték.
 
 **Átszámítási képlet:**
 $$Cost_{EUR} = Cost_{Local} \cdot ExchangeRate$$
 
-## 2. Előfizetési Csomagok (Adminból állítható)
-A csomagok limiteit (járműszám, funkciók) a `system_settings` tábla szabályozza.
+## 2. Előfizetési Csomagok és Szinergia
+A csomagok limiteit a `data.system_settings` tábla szabályozza. A cégtulajdonosok ösztönzése érdekében **Business Synergy** kedvezményt alkalmazunk.
 
 | Csomag | Jármű Limit | Kiemelt funkciók |
 | :--- | :--- | :--- |
-| **FREE** | 1 db | Csak GEO keresés, alap költséglog, nincs dokumentum/export. |
-| **PREMIUM** | 3 db | Teljes dokumentum/fotó tár, útvonal alapú kereső, export. |
-| **PREMIUM+** | 5 db | 5 felhasználó, flotta-szintű statisztika, TCO elemzés. |
-| **VIP** | 10 db + | Bővíthető slotok, egyedi szerviz partnerek kezelése. |
+| **FREE** | 1 db | Alap költséglog, GEO keresés. |
+| **PREMIUM** | 3 db | Teljes dokumentumtár, export, útvonal alapú kereső. |
+| **PREMIUM+** | 5 db | Flotta statisztika, TCO elemzés, 5 felhasználó. |
+| **VIP / VIP+** | 10+ db | Egyedi szervizkezelés, bővíthető slotok, prioritásos support. |
 
-## 3. Evidence & Trust Engine (Bizonyíték kezelés)
-A rendszer csak azokat a szerviz eseményeket tekinti **hitelesnek (Verified)**, amelyekhez tartozik:
-- **Fotó:** Kilométeróra állásról és munkalapról.
-- **Digitális számla:** Feltöltött PDF vagy kép.
-- **GPS Check-in:** Igazolás, hogy a felhasználó valóban a szerviznél tartózkodott.
+**VIP Synergy Szabályok:**
+- **Synergy Discount:** Ha egy felhasználó `FLEET_OWNER` szervezetének aktív **VIP** vagy **VIP+** előfizetése van, **15% kedvezményt** kap minden vásárlásra a saját privát flottájában.
+- **Ajándék Kredit:** VIP csomag vásárlásakor a tulajdonos extra krediteket kap, amit skinekre, medálokra vagy a privát Prémium csomagjára költhet el.
+- **Időbeli korlát:** A privát Prémium/Prémium+ kedvezmények időtartama **2-6 hónapra korlátozott**, elkerülve a tartós ingyenhasználatot.
 
-## 4. Szerviz Minősítési Rendszer
-- Csak érvényes szerviz esemény után adható értékelés.
-- **Fellebbezés:** A szolgáltató kérheti a valótlan/troll vélemény felülvizsgálatát.
-- **Validátorok:** Magas rangú felhasználók pontokért/kreditért ellenőrizhetik a vitatott bejegyzéseket.
+## 3. Voucher és Kupon Rendszer
+A kedvezmények nem automatikusak, a kód manuális beírása kötelező.
+- **Gift Card (Fix Kredit):** Fix összegű ajándék kredit (pl. 5000 Ft értékben).
+- **Subscription Coupon (%):** Százalékos kedvezmény előfizetési díjakból, meghatározott időszakra.
+- **Szabályok:**
+    - Minden kupon rendelkezik **lejárati idővel**.
+    - Minden felhasználást auditálni kell: `redeemed_at`, `user_id`, `original_price`, `discount_price`.
 
-## 5. Lejárat és Helyreállítás
-- **Grace Period (30 nap):** Csak rögzítés lehetséges, statisztika/lekérdezés zárolva.
+## 4. MLM Jutalomrendszer (10-5-2%)
+A rendszer jutalmazza a sikeres meghívásokat az első befizetés után:
+- **1. szint (Közvetlen):** 10% jóváírás.
+- **2. szint:** 5% jóváírás.
+- **3. szint:** 2% jóváírás.
+A százalékos érték a befizetés pillanatában rögzül a tranzakcióban (Snapshot).
+
+## 5. Invitation Engine (Meghívó Rendszer)
+A spam elkerülése érdekében korlátozott keretrendszert alkalmazunk:
+- **Lejárati idők:**
+    - **Felhasználói meghívó:** 72 óra.
+    - **Adminisztrátori meghívó:** 24 óra.
+- **Mennyiségi korlát:** Kezdő keret felhasználónként (pl. 10 vagy 20 db).
+- **Anti-Spam Logika:** Új meghívási lehetőséget csak sikeres regisztrációk után kap vissza a felhasználó. A keret mértéke adminisztrációs felületről állítható.
+
+## 6. Evidence & Trust Engine (Hitelesítés)
+A szerviz események és értékelések csak bizonyítékok megléte esetén válnak **Verified** (hiteles) státuszúvá:
+- **Fotó/Dokumentum:** Munkalap és kilométeróra fotó kötelező.
+- **GPS Check-in:** Igazolás a helyszíni tartózkodásról.
+- **Identitás:** Cég mint entitás nem validálhat, csak azonosított `Person`.
+
+## 7. Lejárat és Pénzügyi Helyreállítás
+- **Grace Period (30 nap):** Csak rögzítés lehetséges, statisztika zárolva.
 - **Zárolás (60 nap):** A fiók írásvédetté válik.
-- **Helyreállítás:** 6 hónapon belül visszamenőleges befizetéssel minden funkció (és a Free korszak adatai) aktiválódik.
+- **Helyreállítás:** 6 hónapon belüli visszamenőleges befizetéssel minden funkció és korábbi adat újra aktiválódik.