service-finder/docs/V01_gemini/10_Billing_Credits_Subscriptions.md

💰 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 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 é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	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.

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.

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.

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üli visszamenőleges befizetéssel minden funkció és korábbi adat újra aktiválódik.