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

58 lines
3.6 KiB
Markdown

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