Quickspin - syn we integrasiýa

2) Portfel we mehanika

2. 1 Yuvalar (core)

Mowzuklar: ertekiler we mifologiýa, Aziýa, Günbatar/talaňçylyk, Müsüriň ugry, "nusgawy/miweler".
Mehanikler: Wild/Stacked/Expanding Wild, Respins, Free Spins, Multiplier, Ways/Lines, Cluster/Grid (aýry-aýry atlarda), käwagt Feature Buy (bazarlarda).
RTP profilleri: adatça birnäçe wariant (mysal üçin, 96. x/94. x/92. x) dürli ýurisdiksiýalar üçin.
Üýtgewsizlik: giň huni üçin low/medium-dan VIP/akym üçin high/very high-a çenli.

2. 2 Firma çipleri

Quickspin Promote - mahabatyň ekosistemasy (§ 7 serediň): Frispinler, Achievements/Challenges, ýaryşlar/liderler tagtalary, Prize Drops/ýaryşlar.
Achievements/Challenges - baýraklar bilen oýnuň içindäki meseleler (CRM arkaly monetizasiýa).
"Feature Triggers" - mahabat kampaniýalarynyň çäginde (rugsat berlen ýerlerde) frispin/bonuslaryň dolandyrylýan triggeri.

3) Top-atlary (mysallary) we özüni alyp barşy

Big Bad Wolf (seriýa) - nyşanlaryň kaskadlary/öwrümleri (blowing down houses), durnukly onbording.
Sakura Fortune (1/2) - giňelýän wildlar we respinler; güýçli ykjam çykyş.
Sticky Bandits (seriýa) - "ýelmeşýän" wildlar, haýroller hereketleri.
Eastern Emeralds - bonus tapgyrynda animatorlar, frispinlerde ýokary ekspozisiýa.
Golden Glyph (1/2) - grid/cluster-mehanika, bonus derejeleri.
Spinions, Tiger's Glory, Ark of Mystery, Nero's Fortune, Hammer of Vulcan - durnukly hitler.

4) Ýurisdiksiýalar we çäklendirmeler

Tapawutlanýar: RTP profilleri, jedelleriň/ýeňişleriň çäkleri, "Autoplay/Quick Spin/Feature Buy" statuslary, Responsible Gaming hökmany tekstleri we şriftlere/nyşanlara bildirilýän talaplar.
Promote mahabat gurallarynyň hemmesi her bazarda elýeterli däl.
Düzgünleşdirijiler hasabatlylygy kesmegi we round-level ýazgylaryny saklamagy talap edýärler.

• `region → rtp_profile, features_allowed, bet_limits, promote_tools, texts_required`.

5) Integrasiýa arhitekturasy

5. 1 Gapjyk modeli

Seamless (transfer-less): operator tarapynda balans; '/authorize ', '/bet', '/win ', '/rollback' çagyryşlary; berk idempotentlik.
Transfer Wallet: RGS-e serişdeleri öňünden geçirmek; sessiýa ýapylanda ahyrky sinhronizasiýa.

5. 2 Interfeýsler we wakalar

REST/JSON + вебхуки/Callbacks: `bet|win|bonus|session_start|session_end|disconnect|reconnect|promo_event`.
/ balance - balans/çäkler ;/bonus - frispinler/kynçylyklar (eger olar API arkaly işjeňleşdirilse).
Idempotentlik: 'transaction _ id' (UUID/ULID) her 'bet/win'; öňki netijäniň gaýtalanmagy (manysy boýunça exactly-once).
Tertibi: 'round _ id' hökmany; mapping 'provider _ game _ id internal_game_id'.

5. 3 Wagt/retrauslar

Müşderi wagtlary 2-3 s; eksponensial backoff; replay-nobat; jogaplaryň gaýtalanmagy.

5. 4 Lokalizasiýa/enjam

Köp dilli UI, ýerli walýutalar/formatlar, ýeňil assets; tor/kaskad oýunlary üçin mobile-first.

6) Wakalaryň shemasy we seljermesi

6. 1 Wakanyň kiçi shemasy (JSON)

json
{
"event_id": "01J...QSPIN",
"event_time": "2025-11-02T12:31:05Z",
"type": "bet    win    bonus    promo    session_start    session_end    disconnect    reconnect",
"user": {"id":"u123","tenant":"op1","country":"FI"},
"game": {"id":"qs_sakura_fortune_2","rgs":"quickspin","category":"slot"},
"session": {"id":"s456","device":"ios"},
"wager": {"amount":0. 50,"currency":"EUR","round_id":"r789"},
"payout": {"amount":7. 20,"jackpot":false},
"promo": {"type":"achievement","id":"ach_sf2_10_respins","progress":1. 0},
"meta": {"rtp_profile":"96","jurisdiction":"MGA"}
}

6. 2 Esasy metrikler

GGR/NGR, Hit Rate, Spin Frequency, Bonus Entry/Win Multiplier, Achievement/Challenge Completion, ýaryşlara gatnaşmak.
RGS hili: p95/p99 API, error-rate, webhook lag, retry-nobatyň ululygy.
Oýunçy/sessiýa: ARPPU/ARPU, sessiýanyň ortaça uzynlygy, çurn-signallar, şikaýatlar/1k tapgyrlar.

6. 3 Antifrod/anti-bitraj

Challenge/bonus karuselleri, anomal win-profiller, multi-account/device, geo-anomaliýalar.
Reaksiýalar: segment boýunça mahabat/oýun arakesmesi, nyrh çäkleri, el bilen barlamak.

7) Promo we paket Quickspin Promote

Free Spins/Free Bets - oýunlar/nominallar boýunça paket frispinler.
Achievements/Challenges - wakalara tabşyryklar (X respubliks, Y kaskadlary, ýeňişler ≥ N ×), CRM arkaly baýraklar.
Tournaments/Leaderboards - win-multiplier, ýeňişleriň mukdary, seriýa boýunça skoring.
Prize Drops/Races - şertlere görä tötänleýin düşmek/tizlik ýaryşlary.
Feature Triggers (rugsat edilen ýerlerde) - kampaniýalar üçin dolandyrylýan goşulmalar.

• Mahabatyň býudjeti boýunça guardrails, gatnaşmak üçin min-bet, bazarlary çäklendirmek.
• Bazarlaryň NL/UK görnüşleri üçin mahabatyň/jogapkär oýnuň ýerli düzgünlerine laýyklygyny berk barlaň.

8) RTP, üýtgewsizlik we ekspozisiýa

'rtp _ profile' per bazary saklaň; gadagan edilen ýerlerde "Autoplay "/" Feature Buy "/" Quick Spin" -i bloklaň.
/ Oýun üçin 'max _ potential _ payout' -a gözegçilik ediň; high-volatility üçin - VIP-çäklendirmeler.
Güýçli köpürjikli atlar üçin (mysal üçin, Eastern Emeralds) ekspozisiýa goragçylaryny saklaň.

9) Hasabat we deňeşdirme (reconciliation)

Round-level logs (nyrhlar/tölegler/bonuslar/mahabat/statuslar).
Oýunlar/walýutalar/bazarlar boýunça "Daily Game Report"; üpjün edijiniň serwer wagty boýunça kesmek (TZ/ofseti saklaň).
Deňeşdirme: operator wakalarynyň jemi vs jemleýji hasabatlar; delta diňe ýapylmadyk tapgyrlarda kabul edilýär.

10) Synlamak we SLO integrasiýasy

API: '/authorize ', '/bet', '/win '- p95/p99, error-rate, geleşikleriň dublikatlarynyň paýy.
Wakalar: webhook-lag, retry-nobatyň ululygy, paý 'rollback/void'.
Promo: lag baýraklary hasaplamak/ösüşi täzelemek, gurşap almak we öwrülişik.
Billing: hasabatlaryň gapma-garşylygy <bosagasy, cut-off-a ýapylanlaryň paýy.

SLO (eskiz)

yaml slo:
api:
bet_p95_ms: 250 win_p95_ms: 250 error_rate_pct: <=0. 3 events:
webhook_lag_p95_s: <=3 duplicate_txn_pct: <=0. 1 promo:
reward_grant_p95_s: <=5 challenge_state_lag_s: <=10 billing:
report_delta_pct: <=0. 2 closed_by_cutoff_pct: >=99. 7

11) Howpsuzlyk we gabat gelmek

mTLS + HMAC webhuk gollary/REST; allowlist IP; gysga ömürli tokenler.
PII-hadysalarda minimalizasiýa; 'user _ id' tokenizasiýasy; Sebit/tenant boýunça RLS/CLS.
Responsible Gaming: Reality Check, çäklendirmeler, öz-özüni aýyrmak; degişli tekstler/şriftler we ýerli talaplar.
Işe başlananda ýurisdiksiýa baýdaklary: autoplay/quick spin/feature buy, stawkalaryň/sessiýalaryň çäkleri, RTP-iň aýan edilmegi.

12) Synag-meýilnama we QA

12. 1 Kesgitleýiş barlag sanawy

• '/authorize '/sessiýanyň ýapylmagy; dogry diller/walýutalar/formatlar.
• '/bet '/'/win 'idempotentdir; şol bir 'transaction _ id' → öňki jogap bilen gaýtalanýar.
• Free Spins/Challenges/Achievements/Tournaments: hasaplamak → çykdajy → hasabat.
• Ýurisdiksiýalar: "Autoplay/Feature Buy" -a gadaganlyk, dogry RTP profili, nyrhlaryň/sessiýalaryň çäkleri.
• Hasabatlar: wakalara gabat gelmek, kesmek, köp walýuta.

12. 2 Negatiw ssenariýalar

Dublikat 'transaction _ id' → 200 saklanan netije bilen.
Taýmaut '/win '→ iki esse tölemezden howpsuz retry.
Belli bir mahabat/walýutasyz sebit → kesgitlenen ret we dogry lokalizasiýa.
Disconnect/Resume → steýtiň/tapgyryň bitewiligi we kynçylyklaryň ösüşini saklamak.

13) Ýygy-ýygydan ýalňyşlyklar we anti-patternler

Ýeke-täk RTP we gadagan edilen şekilleri görkezmek → laýyklyk töwekgelçiligi.
"/bet |/win '→ goşa hasapdan çykarmak/tölemek.
Ignor 'rollback/void' → ledjeriň sinhronizasiýasy.
Cut-off/snapshot ýoklugy → "ýüzýän" hasabatlar.
Promo-hasaplamalaryň laglarynyň hasaba alynmazlygy → şikaýatlar we jedelli ýagdaýlar.
Shemalaryň MINOR-ewolýusiýasynda penjirelerde/ýazgylarda → aşak düşýär.

14) Konfigurasiýa şablonlary

14. 1 Oýun/bazar

yaml game_config:
game_id: "qs_eastern_emeralds"
markets:
- region: "MGA"
rtp: "96. 0"
features: {autoplay: true, feature_buy: true}
bet_limits: {min: 0. 20, max: 100}
- region: "UKGC"
rtp: "94. 0"
features: {autoplay: false, feature_buy: false}
bet_limits: {min: 0. 10, max: 10}

14. 2 Idempotentlik syýasaty

yaml idempotency:
key: "transaction_id"
storage: "redis+db"
ttl: "30d"
behavior: "return_last_result"

14. 3 Wakalaryň shemasy (iň az)

yaml events:
keys: [event_id, event_time, type, user. id, game. id, session. id, wager. round_id]
bet:  [amount, currency, ext_ref]
win:  [amount, ext_ref]
promo: [type, id, value]
tech: [client, device, latency_ms]

14. 4 Mahabat kampaniýasy (Promote, eskiz)

yaml promo_campaign:
id: "qs_promote_q4_2025"
type: ["tournament","prize_drop","achievement","challenge"]
games: ["qs_big_bad_wolf","qs_sakura_fortune_2","qs_eastern_emeralds"]
rules:
tournament: {scoring: "win_multiplier", min_bet: 0. 2}
prize_drop: {budget_eur: 15000, prizes: 1200, min_bet: 0. 2}
achievement: {targets: ["10_respins","fs_trigger>=2"], reward_type: "free_spins"}
challenge: {duration_h: 72, goals: ["win_x>=25","n_respins>=5"]}

15) Durmuşa geçirmegiň ýol kartasy

1. Inventory & Markets: Quickspin oýunlarynyň sanawy, RTP profilleri, fiç baýdaklary/çäkleri; Promote-gurallaryň we walýutalaryň elýeterliligi kartasy.
2. API & Wallet: gapjyk saýlamak, idempotentlik, retrailer, webhuk.
3. Events & Reports: wakalar shemasy, round-level logi, cut-off we TZ.
4. Compliance: ýurisdiksiýa konfiguralary, RG-talaplar, tekstler/bannerler.
5. Promote: ýaryşlar/kynçylyklar/aýlawlar/damjalar, penjirä we CRM-e integrasiýa.
6. Observability: SLO panelleri (API/ivents/promo/billing), alertler, repleýler.
7. Go-Live: kanar traffigi, KPI deňeşdirmesi (GGR, hit rate, achievement completion, complaints), 1-nji hepdäniň post-mortemi.

16) Jemleýji

Quickspin - "Promote" çeýe mahabat ekosistemasy bilen goldanýan UX we matematikadan düşnükli "arassa" slotlaryň bukjasy. Üstünlikli integrasiýanyň açary - idempotent billing, ýurisdiksiýalar boýunça dogry RTP/fiçalar, kesilen aç-açan hasabat we SLO-nyň syn edilmegi. Achievements/Challenges/ýaryşlarynyň oýlanyşykly penjiresi we ulanylmagy bilen, Quickspin dolandyrylýan töwekgelçiliklerde we hyzmat çykdajylarynda GGR/LTV-e durnukly goşant goşýar.