Nima uchun platforma yadrosini kuzatish muhim?

«Platforma yadrosi» nima va nima uchun versiyalar tanqidiy

«Yadro» deganda, xatolar kechirilmaydigan domenlar tushuniladi: hamyon va legger, stavkalar/raundlarni hisoblash, kassa (depozitlar/to’lovlar), identifikatsiya (KYC/AML/RG), o’yin provayderlari bilan shartnomalar va billing/hisobot.

Bu yerda har qanday yangilanish pul, tartibga solish, ishonchga taʼsir qiladi. Shuning uchun yadro versiyasi «package» dagi raqam emas. json", o’zgarishlar va mas’uliyatni boshqarish vositasi.

Nima uchun versiyalarni kuzatish

1. Pul xavfini boshqarish. Qaysi kod qaysi tur/to’lov bo’yicha hisoblanganligini aniq bilamiz - bu nizolarni hal qiladi va hodisalarni tahlil qilishni tezlashtiradi.

2. Integratsiyalarning mosligi. O’yinlar/to’lovlar provayderlari kontraktlarga bog’langan. Versiya = maydon, maqom va biznes qoidalari bir-biriga mos kelishini kafolatlaydi.

3. Komplayens va audit. Regulyator takrorlanuvchanlikni talab qiladi: «qanday qurilish, qanday sxema, qanday nazorat». Versiya - dalillar bazasining langari.

4. Tezkor relizlar. Versiyalash mos keladigan o’zgarishlarni chiqarish va kanareik yoyish imkonini beradi.

5. Hodisa-menejment. Rollback/roll-forward teglangan artefaktlar, migratsiyalar va mos matritsalar mavjud bo’lganda oddiy.

6. Oziq-ovqat buyruqlari uchun shaffoflik. «Shartnoma X.Y.gacha barqaror bo’lganda», marketing/tahlilchilar kutilmagan hodisalarsiz rejalashtirishadi.

Versiyalar siyosati (yadro uchun SemVer)

SemVer’MAJOR’dan foydalanamiz. MINOR. PATCH’+ «sxema taftishi» va «voqealar kontrakti versiyasi»:

PATCH (x.y. Z) - API/sxemalar/hisob-kitob mantig’ini o’zgartirmasdan tuzatishlar. Rollout tezkor, rollback kichik.
MINOR (x.Y.z) - mos keladigan kengaytmalar: yangi «nullable» maydonlari, yangi voqealar, bayroqlar. «expand-only» migratsiyasi.
MAJOR (X.y. z) - buzuvchi o’zgarishlar: maydonlar/hodisalarni olib tashlash, hisob-kitob qoidalarini, ledjerning yangi invariantlarini o’zgartirish.

Qo’shimcha ravishda qayd etamiz:

’schemaVer’ (BD/ledjer/kataloglar),’contractVer’(shina va vebxuk voqealari),’calcVer’(hisob-kitob/bonus qoidalar dvigateli).

💡 Qoida: relizda bitta yo’nalish. Yoki «soya bilan sindiramiz». Aralashish - hodisalarga olib boradigan yo’l.

Kontraktlar va teskari muvofiqlik

Tashqi va ichki iste’molchilar uchun shartnomalar

API/vebxuklar/hodisalar: URL (’/v2/...’), sarlavha (’X-Contract-Version’), foydali yuklamadagi’schemaVer’.

Shina hodisalari:’eventVer’maydoni, silent-breaking (maydon turini, maqom maʼnosini oʻzgartirish) taqiqlangan.

BD: expand → migrate → contract uslubidagi migratsiyalar.

Qo’shish, almashtirish - ehtiyotkorlik bilan, olib tashlash - «soya» bilan

Maydonlarni faqat nullable/c defolt bilan qoʻshish.

Ma’no o’zgarishi faqat MAJOR’da o’tish davri uchun «eski» maydonni (’_ legacy’) parallel ravishda nashr etish orqali amalga oshiriladi.

Olib tashlash - deprekeyt va telemetriyadan keyin «eski narsalarni yana kim o’qiydi».

Sxemalar va ma’lumotlar migratsiyasi

Expand: ustun/indeks qoʻshish, mavjud oʻquvchilarga tegmasdan yangi hodisani kiritish.

Migrate: fondagi qiymatlarni toʻldirish/qayta sanash (batch/online), qoʻshaloq yozuvni (dual-write) yangi joyga kiritish.

Contract: o’quvchilarni tarjima qilish, keyingi MAJOR’dagi legacy filialini olib tashlash.

Instrumentlar: feature-flag, shadow-jadvallar, onlayn-DDL, DB (check-constraints) va domen darajasidagi invariantlar ostida migratsiyalar.

Hisob-kitoblarni versiyalash: pul, stavkalar, bonuslar

Pul hisob-kitobi mantig’ining’calcVer’versiyasini (stavka/hold/settle/VOID, bonuslar va o’yin qoidalari) alohida qayd qiling.

Har bir’round. settled`, `payout. completed`, `bonus. issued’’calcVer’ni yozing.

Agar siz bahs qilsangiz, hisoblashni voqea sodir bo’lgan paytdagi mantiq bilan takrorlashingiz mumkin.

’calcVer’ almashtirishni o’yinlarning trafik/mintaqa/toifasiga qarab amalga oshiring.

Versiya uchun observability

Treysdagi teglar:’buildId’,’gitSha’,’semver’,’schemaVer’,’contractVer’,’calcVer’barcha tanqidiy spenlarda (stavka, settle, payout).

Versiyalar bo’yicha dashbordlar: xatolar, yashirin, versiyalar bo’yicha fin-deltalar.

Shina iste’molchilarining bir qismi noto’g’ri sxemani o’qiyotganda «versiya dreyfiga» alertlar.

Xavfsizlik va komplayens

Versionlangan artefaktlar (tasvirlar, migratsiyalar) imzolandi; o’zgarmas registry/bucket saqlanadi.

DR/audit: atrof-muhitni «T sanasida bo’lgani kabi» (tasvir, versiyadan oldingi migratsiya, DB snapshotlari) ko’tarish mumkin.

AML/RG/KYT qoidalarini taftish qilish ham versiyadir (policyVer) va ularni qo’llash loglari.

Relizlar tartib-qoidalari

1. Kontrakt-revyu: «PATCH/MINOR/MAJOR» belgisi qo’yilgan o’zgarishlar ro’yxati, tashqi/ichki iste’molchilarga ta’siri.

2. Backwards-compat testlari: eski mijozlar/hodisalarni tekshirish (kontrakt testlari).

3. Kanar rollout: 1-5% trafik; p95, xatolar, moliyaviy tafovutlar bo’yicha metriklar.

4. Legacy telemetriyasi: yana kim eshitadi’v1’, qaysi sohalar oʻqiladi - deprekeyt rejasi.

5. Komm-paket: Eski end-of-life versiyalarida nima o’zgaradi, qanday ko’chib o’tish kerak.

Namunaviy muvofiqlik matritsalari (misol)

Komponent	Mijoz (eng kichik versiya)	Server	Holat
`wallet-api`	1. 7	2. 3	OK (MINOR)
`bets-webhook`	1. 4	2. 0	OK, legacy-maydoni’odds _ legacy’to 2026-01-31
`ledger-schema`	–	3. 1	Chiqarilgunga qadar’expand’migratsiyasini talab qiladi 3. 2
`events. contract`	1. x	2. x	Dual-publish oʻchirilgunga qadar’v1 ’

Kontraktlar namunalari

Shina hodisasi:

json
{
"event": "round. settled",  "eventVer": "2. 4",  "schemaVer": "ledger-3. 1",  "calcVer": "wallet-7. 2",  "roundId": "R-2025-10-17-PRAGM-12",  "bets": [{"betId":"b_9f2","stake":"5. 00","payout":"180. 00","outcome":"WIN"}],  "ts": "2025-10-17T14:23:12. 031Z",  "traceId": "tr_5f1"
}

REST bilan shartnoma versiyasi:


GET /v2/wallet/balance
X-Contract-Version: 2. 3

Anti-patternlar

«Jim» oʻzgarishlar: maydon turlarini/maʼnolarini MAJOR va deprekeytsiz oʻzgartirish.

Ma’lumotlar migratsiyasi va pul mantig’ini bitta relizda dual-writsiz aralashtirish.

Versiyalar o’rniga global bayroqlar («o’sha paytda amalda bo’lgan narsalarni tiklash mumkin emas»).

Kontrakt testlari va sxemalar katalogining yo’qligi.

Legacy’ni telemetriyasiz olib tashlash - sheriklar/dashbordlar buziladi.

Artefaktlar/imzolarsiz «qayerdadir viki» ning yagona raqami takrorlanmaydi.

Yadro versiyalari fanining chek-varaqasi

Standartlar

Versiyalar oilasi:’semver’,’schemaVer’,’contractVer’,’calcVer’,’policyVer’.
Tarix va egalari bilan maʼlumotlar/sxemalar katalogi (data catalog).

Kontraktlar

Versiyalangan endpoint/hodisalar, header/versiya maydoni.
Foydalanish sanasi va telemetriyasi bilan deprecation-protsedura.

Migratsiya

Expand→Migrate→Contract, dual-write, онлайн-DDL.
Shadow jadvallari va DB darajasidagi invariantlar.

Relizlar

Kanar rollout, mos matritsasi, rollback rejasi.
Imzolangan tasvirlar/migratsiyalar, o’zgarmas artefaktlar.

Observability

Trace/loglar/metriklardagi versiya teglari.
Dashbord xatolari/yashirin/fin-delta versiyalari.

Komplayens/DR

«T sanasi» uchun takrorlanadigan atrof-muhit ko’tarilishi.
PolicyVer (AML/RG/KYT) qo’llash daftarlari.

Yadro versiyasi - pulni «sug’urta qilish» va mahsulotning rivojlanish sur’ati. U bilan platforma oldindan aytib bo’lmaydigan darajada rivojlanmoqda: yangi imkoniyatlar buzilishsiz paydo bo’ladi, moliya qayta tiklanadi, integratsiya mos keladi, audit tinch bo’ladi. Versiyalarni jarayonning bir qismiga aylantiring (shartnomalar, migratsiyalar, telemetriya, relizlar) - va sizning orqa tomoningiz P&L va obro’sini yo’qotmasdan yillar davomida o’zgarishlarga bardosh beradi.