Муҳаррики каталоги мундариҷа

Муҳаррики каталог асоси намоиши бозиҳо ва коллексияҳои таблиғотӣ дар пеш аст: он метамаълумотро аз провайдерҳо (RGS) ҷамъоварӣ ва муқаррар мекунад, ҷустуҷӯ/филтрҳо/рейтингро таъмин мекунад, қоидаҳои дастрасиро аз ҷониби юрисдиксия ва бренд татбиқ мекунад, фардикунонӣ ва ҷойгиркуниро омехта мекунад ва сипас вокунишҳои зудро тавассути API бо SLO пешгӯишаванда мерасонад.

1) Ҳадафҳо ва принсипҳо

Хондани зуд: p95 ≤ 100-150 мс барои як феҳрист/дархости ҷустуҷӯ.
Ҳақиқат ва тару тоза: аҳамияти кафолатноки хусусиятҳои асосӣ (мавҷудият, jackpots, ҳолати провайдер).
Тағйирпазирӣ: маҷмӯаҳои таҳририя ва слотҳои таблиғотӣ бидуни нашр.
Мувофиқат: қоидаҳои гео/синну сол/мундариҷа, литсензияҳо, маҳдудиятҳои бозӣ.
Бисёр иҷорагир/минтақа: ҷудокунии бренд ва мутобиқати будубоши маълумот.
Мушоҳида: Баромади ченакҳои сифат, A/B, Табдили бозӣ/Бет.

2) Модели домейн (ҳадди аққал)

• Бозӣ як бозӣ/маҳсулоти провайдер аст.
• Провайдер - RGS/студия.
• Вариант - вариантҳои як бозӣ (ноустуворӣ, хатҳо, маҳдудиятҳо, сервер).
• Ҷамъоварӣ - интихоби муҳаррирӣ/автоматӣ (мас. "Ашёҳои нав", "Jackpots").
• Ҷойгиркунӣ - мавқеъи собит/баннер/плитка дар саҳифа/дар ковокии.
• Қобилият/Хусусият - хусусиятҳои бозӣ (spins ройгон, хусусияти харид, jackpot).
• Қоидаҳои юрисдиксия - қоидаҳои дастрасӣ/маҳдудият.
• Сигналҳо - сигналҳои рафторӣ/амалиётӣ (маъруфият, CTR, даромад).
• Дороиҳо - ВАО (нишонаҳо, плакатҳо, видеоҳои намоишӣ) бо имконоти дастгоҳҳо/зичӣ.

Калидҳо: 'game _ id' (дохилии устувор, ба provider_game_id) баробар нестанд, 'иҷорагир _ ид', 'минтақа', 'маҳал'.

3) Ворид кардан ва ба эътидол овардан

1. Адаптерҳои манбаъ (pullers): ҳамгироӣ бо RGS/студияҳо (феҳристҳо, хусусиятҳо, RTP, барчаспҳо).

2. Sanitize & Map - Харитаи майдонҳои беруна ба як луғати ягона (ACL), тасдиқ ва такрорӣ.

3. Ғанӣ: маҳаллисозӣ, категорияҳо, барчаспҳои семантикӣ, рейтингҳои маҳдудияти синну сол.

4. Миёна: парчамҳои мундариҷа (NSFW/рамзҳои динӣ/мавзӯъҳои ҳассос) аз ҷониби бозор.

5. Нашр кунед: 'Чорабиниҳои' Game

Idempotence: ҳамаи паёмҳо бо 'source _ id' + 'version _ ts'; такрор бидуни таъсири тараф коркард мешавад.
Нақшаи эволютсия: 'schema _ version' дар адаптерҳо + муҳоҷирати харитасозӣ.

4) Нақшаи муқарраршуда (соддакардашуда)

json
{
"game_id": "g_3f92",
"tenant_id": "brand_eu",
"provider": { "id": "pr_evolution", "name": "Evolution" },
"title": { "en": "Lightning Roulette", "de": "Lightning Roulette" },
"capabilities": ["live","roulette","multiplier","bonus"],
"rtp": 97.3,
"volatility": "high",
"limits": { "min": 0.1, "max": 1000.0, "currency": "EUR" },
"jurisdiction": {
"allowed": ["MT","EE","DE"],
"blocked": ["NL","BE"],
"age_rating": 21
},
"assets": {
"tile": { "1x":"...", "2x":"..." },
"poster": { "web":"...", "mobile":"..." }
},
"tags": ["new","jackpot"],
"release_date": "2025-09-12",
"status": "active",
"variants": [{ "id":"v1","server":"eu-central-1","rtp":97.3 }]
}

5) Ҷустуҷӯ, филтрҳо, паҳлӯҳо

Индексҳо: матни пурра бо ном/синонимҳо, паҳлӯҳо аз ҷониби 'провайдер', 'қобилиятҳо', 'ноустуворӣ', 'rtp _ сатил', 'барчаспҳо'.
Филтрҳо: юрисдиксия/минтақа/забон/дастгоҳ/синну сол, танҳо фаъол/тасдиқшуда.
Синонимҳо/таҳаввулот: харитаи истилоҳҳои корбар ("китобҳо", "меваҳо", "тӯбҳо").
Typos: ҷустуҷӯи таҳаммулпазир (масофаи таҳрир ≤ 1 -2) бо маҳдудияти дарозӣ.

6) Гурӯҳбандӣ: сигналҳо ва формула

• Тару тоза (вақти озод шудан).
• Аҳолӣ (оғоз/соат, бозигарони беназир).
• Сифат (CTR аз каталог ба бозӣ, 1/7 рӯз нигоҳ доред).
• Тиҷорат (афзоиши маркетинг, аҳдҳо, ҷойҳои таблиғотӣ).
• Мувофиқат (пастшавии нарм барои мундариҷаи ҳассос, агар лозим бошад).
• Плеери мувофиқ (мутобиқати профил/афзалият).

score = w1freshness + w2popularity + w3ctr + w4player_fit + w5boost

Вазнҳо тавассути конфигуратсия/таҷрибаҳо назорат карда мешаванд; ҳамаи сигналҳо ба [0; 1].

7) Фардикунонӣ

Хотираи кӯтоҳ: ба наздикӣ роҳандозӣ ва жанрҳо, RYW - корбар фавран амали навро мебинад.
Хотираи дароз: Воридкунии профилҳои бозӣ ва плеер (жанрҳои бозӣ/ноустуворӣ/сессияҳо).
Амният: Фардикунонӣ ҳеҷ гоҳ қоидаҳои ҳуқуқӣ/синнусолиро вайрон намекунад.
Бозгашт: агар сигналҳо кам бошанд - рейтинги бетараф + маҷмӯаҳои таҳририя.

8) Маҷмӯаҳо ва ҷойгиркунии таблиғотӣ

• Авто: қоида/дархост (масалан, 'capability дорои' jackpot 'AND release_date> = NOW () -30d') мебошад.
• Муҳаррир: рӯйхати дастӣ бо фармоиш ва вақт.
• Ҷойгиркунӣ: мавқеъҳои собит дар саҳифаҳо (қаҳрамон, сатри 1-слот-3), A/B, ки аз рӯи сегмент/юрисдиксия равона карда шудаанд.
• Санаҳо ва афзалиятҳо: 'оғоз _ at/ends _ at', афзалияти бархӯрд, пешнамоиш пеш аз интишор.

9) Сиёсати мувофиқат ва дастрасӣ

Гео/юрисдиксия: рӯйхати сафед/сиёҳи кишварҳо/минтақаҳо, санҷиши литсензияҳо/шаҳодатномаҳо.
Рейтинги синну сол: синну соли ҳадди аққал, огоҳӣ, пинҳон кардани бозорҳои номувофиқ.
Мавзӯъ/символизм: парчамҳои мундариҷаи ҳассос аз рӯи кишвар (дин, машрубот ва ғайра).
Бозии масъул: Пинҳон/демот барои бозигарони маҳдуд/вақт.
Аудит: сабти тағйирнопазири тағирот дар дастрасӣ бо сабабҳо.

10) Бисёр иҷорагир ва бисёр минтақа

Ҳама маълумотҳо 'иҷорагир _ ид' ва 'минтақа' қайд карда шудаанд.
Ҷудокунӣ: кворумҳо/таҳхонаҳо аз рӯи минтақа; пешгӯиҳои байниминтақавӣ - танҳо агрегатҳо.
Адолат: квотаҳо барои ворид кардани/нашрияҳо ба як иҷорагир, то бренди "ғавғо" боқимондаашро ба таъхир надиҳад.

11) Нақшаи меъморӣ

Феҳристи навиштан (CP): нормализатсия + рӯйдодҳои транзаксионӣ.
Пешгӯиҳо/Моделҳои хондан (EC): индексатсияҳои ҷустуҷӯ, маҷмӯаҳои моддӣ, ҳисобкунакҳои маъруфият.

• Edge/CDN барои саҳифаҳои/тасвирҳои хунук.
• Кэшҳои хотира барои дархостҳои гарм (калид = филтрҳо + саҳифа + иҷорагир + минтақа).
• Ficheflags: қоидаҳои гурӯҳбандӣ/ҷамъоварӣ бидуни нашр.

12) API (REST/GraphQL, намунаҳо)

ИСТИРОҲАТ

GET /v1/catalog?tenant=brand_eu&region=EE&locale=ru
&filter=jackpot,true&sort=score_desc&page=1&size=24
→ 200 { items:[...], facets:{...}, as_of:"2025-10-31T12:10:02Z" }

Диаграмма (порча)

graphql query Catalog($tenant:String!,$region:String!,$q:String,$filters:Filters){
catalog(tenant:$tenant, region:$region, q:$q, filters:$filters){
items { gameId title provider { name } score badges assets { tile } }
facets { providers { key,count } capabilities { key,count } }
freshnessMs
}
}

• Ҳамеша 'ҳамчун _ аз/тару тоза', пейджинг, паҳлӯҳо бармегардед.
• Барои фардикунонӣ - нишонаи сессия (RYW) бе PII.

13) Сигналҳо ва ҷараёни маълумот

Маъруфият: афзоишҳо ҳангоми оғози бозиҳо → сатилҳои дақиқаҳо → воҳидҳо дар дурнамо.
CTR/табдилдиҳӣ: Ҳисобкунакҳои клик/оғозёбӣ дар ҷойгиркунӣ/маҷмӯаҳо.
Ҳолати корӣ: провайдерҳои тиббӣ (RGS), jackpots/limits (ҷараёни ҳодиса).
Афзоиши маркетинг: омилҳои вақт барои бозиҳо/категорияҳо/таъминкунандагон.

14) Мушоҳида ва SLO

• 'catalog _ p95 _ ms', 'каталог _ p99 _ ms', 'хато _ rate'.
• 'index _ freshness _ ms' (таъхири лоиҳа), 'infest _ lag _ ms'.
• 'ctr', 'click-to-launch', 'collection _ cover' (% аз маҷмӯаҳо санҷед).

• 'lift _ ctr', 'lift _ conversion', "омӯхтани против истисмор" доля.

• % қоидаҳои гео/синну солро дуруст истифода кард, шумораи блокҳо/соат.

Огоҳиҳо: афзоиши 'ingest _ lag _ ms', тарки CTR дар маҷмӯаҳои калидӣ, таназзули провайдер (барчаспҳо дар масъала).

15) Иҷро ва кэш

Стратегия: дархостҳои гарм - кэш барои 30-120 с бо калиди филтрҳо; блокҳои шахсӣ - TTL кӯтоҳ (10-30 с) ё ҳеҷ кэш.
Маълулият: Аз рӯи 'Чорабиниҳои бозикунӣ/Мавҷудияти тағирёбанда/Ҷойгиркунӣ'.
Пагинатсия: курсорҳои устувор, то ҳангоми навсозии сигналҳо кортҳои "ҷаҳида" нашаванд.

16) Кор бо ВАО

Намоиш додани профилҳо: андоза/зичӣ барои веб/мобилӣ/ТВ.
Оптимизатсия: Web-P/AVIF, сарбории танбал, sprite/атлас барои сафолҳо.
Амнияти мундариҷа: сканкунӣ, нишонаҳои обӣ, манъи inline-PII.

17) Санҷиш

Санҷишҳои шартнома/схема барои адаптерҳо ва API.
Санҷишҳои мувофиқ: маҷмӯи тиллоии дархостҳо → натиҷаҳои/тартиби пешбинишуда.
Фардикунонӣ: офлайнии AUC/NDCG + онлайн A/B бо ченакҳои муҳофизатӣ (вақти бозӣ, амонатҳо, сигналҳои RG).
Хаос: таназзули провайдер, хӯшаҳо, таъхири индексатсия.

18) Китобҳои бозӣ (китобчаҳо)

1. Қафои шохис> SLO: коллексияҳои дуюмдараҷаро қатъ кунед, афзалияти воридшавиро зиёд кунед, рейтинги муваққатиро содда кунед.
2. Провайдери "сурх": бозиҳои худро камтар/пинҳон кунед, коллексияҳои алтернативиро баланд бардоред.
3. Ҷаҳиши хатогии API: кэш/пушти сарро санҷед, вақти бехатариро фаъол созед, андозаи саҳифаро кам кунед.
4. Мавҷудияти нодуруст: қоидаҳои охиринро баргардонед, "рӯйхати сафед" -и бозорҳои муҳим, тағироти аудиториро дар бар гиред.
5. Нашри рейтингӣ: ролики канарӣ (5% → 25% → 50% → 100%), гардиши CTR/табдилдиҳӣ.

19) Хатогиҳои маъмулӣ

Омезиши схемаҳои провайдери беруна бо модели дохилӣ (не ACL).
Набудани 'as _ of/тару тоза' → баҳсҳо дар бораи феҳристи "кӯҳна".
Фардикунонӣ, ки қоидаҳои ҳуқуқиро вайрон мекунад.
Ягона формулаи рейтинги "ҷодугарӣ" бидуни таҷзияи сигналҳо ва A/B.
Саҳифаҳои калон бе кэшкунӣ ва курсорҳо → p99 "тир".
Ба ҷои рӯйдодҳо + пешгӯиҳо ба индекс ва OLTP дучанд нависед.

20) Рӯйхати санҷиши пеш аз фурӯш

• Луғати саҳроии муқаррарӣ ва ACL барои ҳамаи провайдерҳо.
• Idempotent inest, outbox/паёмдони, DLQ ва redrive.
• Пешгӯиҳои каталог ва индексатсияҳои ҷустуҷӯ бо SLO тару тоза.
• Рейтинги вазн, тақсимоти сигнал ва A/B.
• Қоидаҳои мувофиқат (гео/синну сол/мавзӯъ) ва аудити тағирот.
• Бисёр иҷорагир/минтақа: ҷудокунии маълумот, адолат, иқомат.
• API бо 'as _ of', паҳлӯҳо, курсорҳо; кэш ва маъюбӣ аз рӯи ҳодиса.
• p95/p99 ченакҳо, индексатсия/индексатсия, CTR/табдилдиҳӣ; ҳушдор медиҳад.
• Китобҳои бозӣ дар бораи ҳодисаҳо; Варақаҳои канарӣ ва ficheflags.
• Санҷишҳои аҳамият, шартномаҳо, бетартибӣ ва фардикунонӣ.

Хулоса

Муҳаррики каталог "системаи ҷустуҷӯ + системаи қоидаҳо + намоиш" аз болои мундариҷаи бозӣ мебошад. ACL-и қавӣ, маълумоти муқарраршуда, пешгӯиҳо барои хониши зуд, сигналҳои шаффоф, фардикунонӣ бо ченакҳои муҳофизатӣ ва риояи қатъӣ каталогро ба фишанги устувор ва ченшавандаи маҳсулот табдил медиҳанд - бидуни ногаҳонӣ дар истеҳсолот ва бидуни созиш бо танзимгарон.