Platforma ýadrosynyň wersiýalaryny yzarlamak näme üçin möhümdir?

"Platformanyň özeni" näme we näme üçin wersiýalar möhüm?

"Ýadro" diýmek, ýalňyşlyklary bagyşlamaýan domenleri göz öňünde tutýarys: gapjyk we dolandyryjy, stawkalar/tapgyrlary hasaplamak, kassa (goýumlar/tölegler), şahsyýet (KYC/AML/RG), oýun üpjün edijileri bilen şertnamalar we billing/hasabat.

Bu ýerdäki islendik täzelenme pula, düzgünleşdirijä, ynama täsir edýär. Şonuň üçin ýadro wersiýasy "package" däl. json", üýtgeşmeleri we jogapkärçiligi dolandyrmak guraly.

Näme üçin wersiýalary yzarlamaly?

1. Pul töwekgelçiligini dolandyrmak. Haýsy koduň haýsy tapgyrda/tölegde hasaplanandygyny anyk bilýäris - jedelleri aýyrýar we wakalary derňemegi çaltlaşdyrýar.

2. Integrasiýalaryň laýyklygy. Oýunlaryň/tölegleriň üpjün edijileri şertnamalara baglydyr. Wersiýa = meýdanlaryň, statuslaryň we işewürlik düzgünleriniň birmeňzeşdigine kepillik.

3. Komplayens we audit. Düzgünleşdiriji köpeldilmegini talap edýär: "haýsy build, haýsy shema, haýsy gözegçilik". Wersiýa - subutnama bazasynyň labyry.

4. Downtaym bolmazdan çalt çykarylýar. Wersiýalaşdyrmak gabat gelýän üýtgeşmeleri goýbermäge we kanareýa bilen togalamaga mümkinçilik berýär.

5. Waka dolandyryşy. Rollback/roll-forward taglanan artefaktlar, göçmeler we gabat geliş matrisi bolanda ýönekeý.

6. Azyk toparlary üçin aç-açanlyk. "Şertnama X.Y çenli durnukly" bolanda, frontlar/marketing/analitika garaşylmadyk ýagdaýda meýilleşdirilýär.

Wersiýa syýasaty (ýadro üçin SemVer)

SemVer 'MAJOR ulanýarys. MINOR. PATCH '+ "shemanyň barlagy" we "wakalaryň şertnamasynyň wersiýasy":

PATCH (x.y. Z) - API/shemalary/hasaplama logikasyny üýtgetmezden düzedişler. Rollout çalt, rollback ownuk.
MINOR (x.Y.z) - gabat gelýän giňeltmeler: täze "nullable" meýdanlary, täze wakalar, baýdaklar. Göçmek "expand-only".
MAJOR (X.y. z) - bozýan üýtgeşmeler: meýdanlary/wakalary aýyrmak, hasaplamagyň kadalaryny, ledjeriň täze üýtgemelerini üýtgetmek.

Goşmaça bellik edýäris:

'schemaVer' (BD/ledger/kataloglar), 'contractVer' (şin we webhuk wakalary), 'calcVer' (hasaplaşyk/bonus düzgünleriniň hereketlendirijisi).

💡 Düzgün: goýberilişde bir ugur. "Döwülmezden giňeldýäris" ýa-da "kölege bilen döwýäris". Garyşyk - hadysalara barýan ýol.

Şertnamalar we ters laýyklyk

Daşarky we içerki sarp edijiler üçin şertnamalar

API/webhuklar/wakalar: URL ('/v2/... '), sözbaşy (' X-Contract-Version '), peýdaly ýükde' schemaVer 'meýdany.

Tekerdäki wakalar: 'eventVer' meýdany, silent-breaking gadaganlygy (meýdanyň görnüşini, statuslaryň manysyny üýtgetmek).

BD: expand → migrate → contract stilindäki göçmeler.

Goşup bilersiňiz, üýtgedip bilersiňiz - seresaplylyk bilen, aýyryp bilersiňiz - "kölege" bilen

Meýdanlary goşmak - diňe nullable/c defolt.

Manyny üýtgetmek - geçiş döwri üçin "köne" meýdanyň ('_ legacy') paralel çap edilmegi bilen diňe MAJOR-da.

Aýyrmak - deprekeýt we telemetriýadan soň "köne okaýanlar".

Shemalaryň we maglumatlaryň göçmegi

Expand: sütün/indeks goşmak, bar bolan okyjylara degmezden täze bir waka girizmek.

Migrate: fondaky bahalary doldurmak/sanamak (batch/online), goşa ýazgyny (dual-write) täze ýere goşmak.

Contract: okyjylary terjime ediň, legacy şahasyny indiki MAJOR-da aýyryň.

Gurallar: feature-flag, shadow-tablisalar, onlaýn-DDL, DB (check-constraints) we domen derejesinde üýtgemez.

Hasaplaşyklaryň wersiýalary: pul, stawkalar, bonuslar

Pul hasaplaşygynyň logikasynyň "calcVer" görnüşini (stawka/hold/settle/VOID, bonuslar we oýnamak düzgünleri) aýratyn belläň.

Her 'round. settled`, `payout. completed`, `bonus. issued 'calcVer'.

Jedel ýüze çykanda, hasaplamany wakanyň pursatyndaky logika bilen köpeldip bolýar.

'calcVer' geçişini, traffigiň/sebitiň/oýun kategoriýasynyň göterimine görä kanareýka ediň.

Wersiýa üçin observability

Trade bellikleri: 'buildId', 'gitSha', 'semver', 'schemaVer', 'contractVer', 'calcVer' ähli möhüm spenlerde (nyrh, settle, payout).

Wersiýalar boýunça daşbordlar: ýalňyşlyklar, gizlinlik, wersiýalar boýunça fin-delta.

"Wersiýa süýşmegine" alertler: şinany sarp edijileriň bir bölegi nädogry shemany okasa.

Howpsuzlyk we laýyklyk

Wersiýa edilen artefaktlara (şekiller, göçmeler) gol çekildi; üýtgemeýän registry/bucket-de saklanylýar.

DR/audit: "T senesinde bolşy ýaly" gurşawy galdyryp bilersiňiz (surat, wersiýa göçmek, DB snapshotlar).

AML/RG/KYT düzgünleriniň barlagy hem wersiýalar (policyVer) we olary ulanmagyň ýazgylarydyr.

Çykyş proseduralary

1. Kontrakt-rewyu: "PATCH/MINOR/MAJOR" bellikli üýtgeşmeleriň sanawy, daşarky/içerki sarp edijilere täsiri.

2. Backwards-compat synaglary: köne müşderiler/wakalar boýunça barlaglar (şertnama synaglary).

3. Kanar aýlawy: traffigiň 1-5%; p95, ýalňyşlyklar, maliýe tapawudy boýunça metrikler.

4. Legacy ulanmagyň telemetriýasy: başga kim diňleýär 'v1', haýsy meýdanlar okalýar - deprekeýt meýilnamasy.

5. Komm-paket: köne wersiýalaryň ömri gutaranda näme üýtgeýär, nädip göçmeli.

Gabat geliş matrisalary (mysal)

Komponent	Müşderi (iň kiçi wersiýasy)	Serwer	Döwlet
`wallet-api`	1. 7	2. 3	OK (MINOR)
`bets-webhook`	1. 4	2. 0	OK, legacy-field 'odds _ legacy' 2026-01-31 çenli
`ledger-schema`	–	3. 1	Çykarylýança 'expand' göçmegini talap edýär 3. 2
`events. contract`	1. x	2. x	Dual-publish 'v1' öçürilýänçä

Şertnamalaryň mysallary

Şinanyň wersiýasy:

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"
}

Şertnamanyň wersiýasy bilen REST:


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

Anti-patternler

"Sessiz" üýtgeşmeler: MAJOR we deprequeit bolmazdan meýdanlaryň görnüşlerini/manylaryny üýtgetmek.

Data migrasiýasyny we pul logikasyny bir goýberişde dual-write bolmazdan garyşdyryň.

Wersiýalaryň ýerine global baýdaklar ("şol wagt näme hereket edendigini" dikeltmek mümkin däl).

Şertnama synaglarynyň we shemalaryň katalogynyň ýoklugy.

Legacy-i telemetrisiz aýyrmak - hyzmatdaşlar/daşbordlar döwülýär.

Artefaktlarsyz/gollarsyz "bir ýerde wiki" belgisini köpeltip bolmaýar.

Ýadro wersiýalarynyň düzgün-nyzamynyň çek-sanawy

Standartlar

Wersiýa maşgalasy: 'semver', 'schemaVer', 'contractVer', 'calcVer', 'policyVer'.
Taryhy we eýeleri bolan maglumatlar/shemalar katalogy (data catalog).

Şertnamalar

Wersiýa/wakalar, başlyk/wersiýa meýdançasy.
Ulanyş seneleri we telemetriýasy bilen deprecation-prosedura.

Göçmek

Expand→Migrate→Contract, dual-write, онлайн-DDL.
Shadow tablisalary we BD derejesindäki üýtgemeler.

Relizler

Kanar rollout, gabat gelmek matrisi, rollback meýilnamasy.
Gol çekilen şekiller/göçmeler, üýtgemeýän artefaktlar.

Observability

Trace/loglarda/metriklerde wersiýa bellikleri.
Wersiýalara görä ýalňyşlyklaryň/gizlinligiň/fin-deltanyň daşbordlary.

Utgaşma/DR

"T senesinde" gurşawyň çalynýan ýokarlanmagy.
PolicyVer ulanyş ýazgylary (AML/RG/KYT).

Ýadrosyň wersiýalylygy - puluň "ätiýaçlandyrylmagy" we önümiň ösüş depgini. Onuň bilen platforma çak edilip bilinjek derejede ösýär: täze mümkinçilikler bökdençsiz çykýar, maliýe köpelýär, integrasiýa - gabat gelýär, audit - asuda. Wersiýalary prosesiň bir bölegine öwüriň (şertnamalar, göçmeler, telemetriýa, goýberişler) - we arka tarapyňyz P&L we abraý üçin ýitgiler bolmazdan birnäçe ýyllap dowam eder.