Platforma nüvəsinin versiyalarını izləmək niyə vacibdir?

«Platformanın nüvəsi» nədir və niyə versiyaları kritik

«Nüvə» dedikdə, səhvlərin bağışlanmadığı domenlər nəzərdə tutulur: cüzdan və ledger, dərəcələr/raundların hesablanması, kassa (depozitlər/ödənişlər), identifikasiya (KYC/AML/RG), oyun provayderləri ilə müqavilələr və billing/hesabat.

Burada hər hansı bir yeniləmə pul, tənzimləyici, etimad təsir edir. Buna görə də nüvənin versiyaları "package nömrəsi deyil. json" və dəyişiklik və məsuliyyət idarəetmə aləti.

Niyə versiyaları izləmək lazımdır

1. Pul riskinin idarə edilməsi. Hansı kodun hansı raund/ödənişlə hesablandığını dəqiq bilirik - mübahisələri aradan qaldırır və hadisələrin təhlilini sürətləndirir.

2. İnteqrasiya uyğunluğu. Oyun/ödəniş provayderləri müqavilələrə bağlıdır. Versiya = sahələr, statuslar və biznes qaydaları üst-üstə düşdüyünə zəmanət verir.

3. Komplayens və audit. Tənzimləyici reproduktivliyi tələb edir: «Hansı quruluş, hansı sxem, hansı nəzarət». Versiya sübut bazasının lövbəridir.

4. Downtime olmadan sürətli buraxılışlar. Version uyğun dəyişikliklər buraxmaq və kanarya yaymaq üçün imkan verir.

5. Hadisə menecmenti. Rollback/roll-forward etiketli artefaktlar, miqrasiyalar və uyğunluq matrisi olduqda sadədir.

6. Qida komandaları üçün şəffaflıq. «Müqavilə X.Y qədər sabit olduqda», cəbhələr/marketinq/analitika sürprizsiz planlaşdırılır.

Versiya siyasəti (nüvə üçün SemVer)

SemVer 'MAJOR istifadə. MINOR. PATCH '+ «sxemin təftişi» və «hadisə müqaviləsinin versiyası»:

PATCH (x.y. Z) - API/sxemləri/hesablama məntiqini dəyişmədən düzəlişlər. Rollout sürətli, rollback əhəmiyyətsiz.
MINOR (x.Y.z) - uyğun uzantılar: yeni «nullable» sahələri, yeni hadisələr, bayraqlar. Miqrasiya «expand-only».
MAJOR (X.y. z) - qırıcı dəyişikliklər: sahələrin/hadisələrin silinməsi, hesablama qaydalarının dəyişdirilməsi, ledcerin yeni invariantları.

Əlavə qeyd edirik:

'schemaVer' (BD/ledger/kataloqlar), 'contractVer' (şin hadisələri və vebhuk), 'calcVer' (hesablama mühərriki/bonus qaydaları).

💡 Qayda: buraxılışda bir istiqamət. Ya «sınmadan genişləndiririk», ya da «kölgə ilə sındırırıq». Qarışdırma hadisələrə aparan yoldur.

Müqavilələr və əks uyğunluq

Xarici və daxili istehlakçılar üçün müqavilələr

API/vebhuk/hadisələr: URL ('/v2/... '), başlıq (' X-Contract-Version '), faydalı yükdə' schemaVer 'sahəsi versiyası.

Şin hadisələri: 'eventVer' sahəsi, silent-breaking qadağası (sahə tipinin dəyişməsi, status mənası).

BD: expand → migrate → contract.

Əlavə edə bilərsiniz, dəyişdirə bilərsiniz - diqqətlə, silin - «kölgə» ilə

Sahələrin əlavə edilməsi - yalnız nullable/c defolt.

Məna dəyişikliyi - yalnız MAJOR-da keçid dövrü üçün «köhnə» sahənin ('_ legacy') paralel nəşri ilə.

Silinmə - deprekeyt və telemetriyadan sonra «köhnəni hələ kim oxuyur».

Sxemlərin və məlumatların miqrasiyası

Expand: sütun/indeks əlavə edin, yeni bir hadisə daxil edin - mövcud oxuculara toxunmadan.

Migrate: fonda (batch/online) dəyərləri doldurun/yenidən hesablayın, yeni bir yerə (dual-write) qoşun.

Contract: oxucuları tərcümə edin, növbəti MAJOR legacy filialını çıxarın.

Alətlər: feature-flag, shadow-cədvəllər, onlayn DDL, DB (check-constraints) və domen səviyyəsində invariantlar altında miqrasiya.

Hesablaşmaların versiyası: pul, dərəcələr, bonuslar

Ayrı-ayrılıqda 'calcVer' - pul hesablama məntiqinin versiyasını (bahis/hold/settle/VOID, bonus və oyun qaydaları) qeyd edin.

Hər 'round. settled`, `payout. completed`, `bonus. issued 'calcVer' yazın.

Mübahisə zamanı hesablama hadisənin baş verdiyi məntiqlə təkrarlana bilər.

'calcVer' keçid trafik/region/oyun kateqoriyaları faiz kanareik edir.

Versiyası üçün Observability

Trace 'buildId', 'gitSha', 'semver', 'schemaVer', 'contractVer', 'calcVer' bütün kritik spenlərdə (bahis, settle, payout).

Daşbordlar versiyalara görə: səhvlər, gecikmə, fin-delta versiyaları.

«Version sürüklənmə» üçün alertlər: şin istehlakçılarının bir hissəsi səhv sxemi oxuduqda.

Təhlükəsizlik və uyğunluq

Version artefaktlar (şəkillər, miqrasiyalar) imzalanmışdır; dəyişməz registry/bucket saxlanılır.

DR/audit: «T tarixində olduğu kimi» mühiti qaldıra bilərsiniz (görüntü, versiyaya miqrasiya, DB snapshots).

AML/RG/KYT qaydalarının təftişləri də versiyalar (policyVer) və onların tətbiqinin qeydləridir.

Buraxılış prosedurları

1. Kontrakt-review: «PATCH/MINOR/MAJOR» etiketli dəyişikliklər siyahısı, xarici/daxili istehlakçılara təsiri.

2. Backwards-compat testləri: köhnə müştərilər/hadisələr üzərində yoxlamalar (müqavilə testləri).

3. Kanarya rollout: 1-5% trafik; p95, səhvlər, maliyyə uyğunsuzluqları.

4. Legacy istifadə telemetri: başqa kim dinləyir 'v1', hansı sahələr oxunur - deprequit planı.

5. Comm paketi: Köhnə versiyaların end-of-life miqrasiyası zamanı nə dəyişir.

Tipik uyğunluq matrisləri (nümunə)

Komponent	Müştəri (min versiyası)	Server	Dövlət
`wallet-api`	1. 7	2. 3	OK (MINOR)
`bets-webhook`	1. 4	2. 0	OK, legacy-sahəsi 'odds _ legacy' üçün 2026-01-31
`ledger-schema`	–	3. 1	3 buraxılışına qədər 'expand' miqrasiya tələb edir. 2
`events. contract`	1. x	2. x	Dual-publish 'v1' söndürülməzdən əvvəl

Müqavilə nümunələri

Versiyası ilə şin hadisəsi:

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 müqavilə versiyası ilə:


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

Anti-nümunələr

«Sakit» dəyişikliklər: MAJOR və deprequit olmadan sahələrin növlərini/mənalarını dəyişdirin.

Dual-write olmadan bir buraxılışda məlumat miqrasiyası və pul məntiqini qarışdırın.

Versiyaların əvəzinə qlobal bayraqlar («o zaman nə fəaliyyət göstərdiyini» bərpa etmək mümkün deyil).

Müqavilə testləri və sxemlər kataloqunun olmaması.

Telemetriya olmadan legacy silmək - partnyorlar/daşbordlar qırılır.

Artefaktlar/imzalar olmadan «viki haradasa» vahid nömrə - təkrar edilə bilməz.

Çekirdek versiyası intizam çek siyahısı

Standartlar

Versiyalar ailəsi: 'semver', 'schemaVer', 'contractVer', 'calcVer', 'policyVer'.
Tarix və sahibləri ilə məlumat/sxemlər kataloqu (data catalog).

Müqavilələr

Version End Points/Events, header/sahə versiyası.
istifadə tarixləri və telemetriya ilə deprecation proseduru.

Miqrasiya

Expand→Migrate→Contract, dual-write, онлайн-DDL.
Shadow cədvəlləri və DB səviyyəsində invariantlar.

Buraxılışlar

Kanarya rollout, uyğunluq matrisi, rollback planı.
Imzalanmış şəkillər/miqrasiyalar, dəyişməz artefaktlar.

Observability

Trace/log/metrik versiyası Tags.
Dashbord səhvlər/gizli/fin-delta versiyaları.

Komplayens/DR

«T tarixinə» çevrənin təkrar qaldırılması.
policyVer tətbiqinin qeydləri (AML/RG/KYT).

Nüvənin versiyası pulun «sığortası» və məhsulun inkişaf tempidir. Platforma proqnozlaşdırıla bilən şəkildə inkişaf edir: yeni imkanlar qırılmadan çıxır, maliyyə təkrarlanabilir, inteqrasiya uyğun, audit sakit qalır. Versiyaları prosesin bir hissəsinə çevirin (müqavilələr, miqrasiyalar, telemetriya, buraxılışlar) - və sizin arxa planınız P&L və nüfuz üçün itkisiz illərlə davam edəcək.