İştirakçıların interaktivliyi

(Bölmə: Ekosistem və Şəbəkə)

1) İştirakçıların interaktivliyi nədir

İnteroperabellik - müxtəlif təşkilatların (operatorlar, studiyalar, PSP, KYC/AML provayderləri, körpülər, affiliatlar, analitiklər və hovernans) razılaşdırılmış protokollar və müqavilələr vasitəsilə bir-biri ilə etibarlı qarşılıqlı əlaqə qurmaq, biznes nəticələrinin təhlükəsizliyini, məxfiliyini və təkrarlanabilirliyini qorumaq qabiliyyəti.

• İnteqrasiya sürəti və miqyaslandırma (time-to-integration ↓).
• Proqnozlaşdırma (kritik axınlar üçün sabit SLO/SLA).
• Təhlükəsizlik və uyğunluq (minimum yetərli hüquqlar, audit).
• Arızasız təkamül (version, backward-uyğunluq).

2) Interperability səviyyələri (qat modeli)

1. Nəqliyyat və şəbəkə: HTTP/2/3, gRPC/QUIC, WebSockets, P2P, mTLS.
2. Kimlik və etimad: org_id, peer_id, X.509/mTLS, imzalar, açarların rotasiyası.
3. Hadisələr və məlumatlar: vahid hadisə sxemləri, aktiv/şəbəkə kataloqları, idempotency.
4. Proseslər və biznes müqavilələri: payout/settlement, atributlar, risk siqnalları, limitlərin replikasiyası.
5. İdarəetmə/hüquqi təbəqə: SLA/SLO, DPA, lisenziyalar, hovernans qaydaları.
6. Müşahidə və keyfiyyət: SLI/SLO, loging, tracking, audit.

Hər təbəqənin öz müqavilələri, testləri və uyğunluq siyasəti var.

3) Dizayn prinsipləri

Contract-first: API/sxemlər/hadisələr həyata əvvəl rəsmiləşdirilir.
Backward-compatible dəyişikliklər: strategiya «yalnız sahə əlavə» və deprekeyt pəncərə ≥ 90 gün.
Capability negotiation: iştirakçılar dəstəklənən imkanları mübadilə edir və ümumi alt çoxluğu seçirlər.
İzolyasiya və PoLP: giriş və limitlər «minimal zəruri» verilir.
İdempotentlik və determinizm: təkrar-təhlükəsiz əməliyyatlar, münaqişənin proqnozlaşdırıla bilən qaydaları.
Default müşahidə: sorğuların/hadisələrin korrelyasiyası (trace-id), yoxlanılan qəbzlər.
Data minimizasiya: telemetriya/etiketlərdə PII olmaması, təxəllüsləşmə.

4) Capability negotiation (danışıqlar imkanları)

Əl sıxdıqda iştirakçılar imkanlar və versiyalar manifestini dərc edirlər.

yaml participant:
org_id: "ORG:ACME"
versions:
api: "2. 6. 1"
events: "1. 9. 0"
capabilities:
payouts: { create: true, cancel: true, currencies: [USD, EUR, USDC] }
kyc: { level: ["basic","enhanced"], sla_minutes_p95: 15 }
bridge: { proof: ["light","zk"], challenge_supported: true }
telemetry: { qos: ["P0","P1"], traces: true }
limits:
payouts_daily_usd: 1_000_000 rate_limits: { create_per_minute: 500 }

Uyğunluq mühərriki tərəflərin manifestlərini müqayisə edir və iş profilini seçir (məsələn, 'payouts: v2', 'events: v1. 9`).

5) API müqavilələri/hadisələr və sxemlər

API müqavilələri: OpenAPI/gRPC IDL, dəqiq səhv kodları, idempotent açarları ('Idempotency-Key'), bədən məhdudiyyətləri.
Hadisə modeli: 'deposit.', 'payout.', 'bridge.', 'kyc.', 'risk.', 'product.' - sabit sahələrlə.
Kataloqlar: şəbəkələr, aktivlər, ödəniş metodları, SDK versiyaları, regionlar/yurisdiksiyalar.
Data Contracts (Data Contracts): CI-də sınaqdan keçirilir, dəyişikliklər - timelock ilə governance vasitəsilə.

yaml event:
id: uuid ts: timestamp_utc type: payout. created    payout. finalized    bridge. lock...
src_org: string dst_org: string payload: object trace_id: string idempotency_key: string signature: string # source signature

6) Version və uyğunluq

Semantik versiyalar: 'MAJOR. MINOR. PATCH`.
Qaydalar: MINOR/PATCH - geri uyğun; MAJOR - 90 gün ≥ deprekeyt (adapters) ilə paralel varlıq.
Migration playbooks: API/hadisə/kataloqlar üçün miqrasiya şablonları; köhnə formatlarda emulyatorlar.

7) Inteqrasiya şablonları (nümunələr)

Request-Reply + Idempotency: təhlükəsiz ödənişlər/limitlər/ehtiyatlar.
Event-Driven: «həqiqət mənbələri» dəyişikliklər göndərir; abunəçilər vitrinləri materiallaşdırırlar.
Outbox/Inbox: DB-dən hadisələrin atom yayımı; abunəçinin idempotent qəbulu.
SAGA (orkestrasiya/xoreoqrafiya): razılaşdırılmış multi-domen əməliyyatları (məsələn, «doldurma → oyun hadisəsi → ödəniş»).
Dual-write guard: outbox olmadan birbaşa ikiqat qeydlər qadağan.
Replay/Backfill: sifariş və sonlandırma ilə uğursuzluqlardan sonra bərpa.

8) Təhlükəsizlik və etimad

mTLS və 'org _ id/peer _ id' açarlarının bağlanması.
Hadisələrin imzaları, etimad jurnalı (kim və nə imzaladı/aldı).
RBAC/ABAC və kvotalar: rollar üzrə hüquqlar, əməliyyatlar/həcm üzrə limitlər.
Gizli menecment: rotasiya, «uzun sürən» tokenlərin qadağan edilməsi, qısa skuplar.
PII/gizlilik: tokenizasiya, regional məlumat seqreqasiyası (EU/ROW), DSR prosesləri (silmə/ixrac).
Sui-istifadə qorunması: velocity limitləri, anti-frod siqnalları, sanksiya yoxlamalar.

9) SLI/SLO və interoperability müşahidə

• 'p95 Time-to-Acknowledge' (hadisə kvitasiyası).
• 'p95 End-to-End' (yaradılış → tamamlanma/icra).
• 'Success Rate' hadisə/əməliyyat növlərinə görə.
• 'Schema/Contract Compliance%' (valid mesajlar).
• «Proof Coverage%» (imzalanmış/əlavə edilmiş dəlillərin payı).
• `Error Budget Burn` по P0/P1.

• P0 (ödənişlər/körpü): p95 E2E ≤ 5 dəq, Success ≥ 99. 5%, Ack ≤ 2 s.
• P1 (ərzaq): Freshness p95 ≤ 3 dəq, Compliance ≥ 99. 9%.
• Məlumat müqavilələri: Drift MTTA ≤ 5 dəq, Breaking changes = 0 MAJOR olmadan.

Дашборды: Interop Ops, Contract Health, Latency & Success, Schema Drift, Security & Keys.

10) Uyğunluq matrisi (test dizaynı)

• Ssenarilər: payouts, deposits, bridge, risk, product, telemetry.
• Versiyası: API v2. 6/v2. 5, events v1. 9/v1. 8.
• Şəbəkə rejimləri: normal, deqradasiya, reorglər, DA gecikmələri.
• Yurisdiksiyalar: EU/UK/TR/LA - müxtəlif kataloqlar və qaydalar.

Avtostestlər: müqavilə testləri (producer/consumer), idempotency, retry/compensation, schema-linters, yükləmə profilləri.

11) Referans sxemləri və kataloqlar

Xüsusiyyətlər kataloqu (SQL)

sql
CREATE TABLE capabilities (
org_id TEXT,
cap_name TEXT,
version TEXT,
params JSONB,
PRIMARY KEY (org_id, cap_name)
);

Müqavilələrin/versiyaların reyestri

sql
CREATE TABLE contracts (
name TEXT, kind TEXT,     -- api    events    catalog version TEXT, status TEXT,  -- active    deprecated    retired breaking BOOLEAN DEFAULT FALSE,
effective_from TIMESTAMPTZ,
deprecates_at TIMESTAMPTZ,
PRIMARY KEY (name, version)
);

Uyğunluq monitorinqi

sql
SELECT name, version, 100. 0SUM(CASE WHEN compliant THEN 1 END)/COUNT() AS compliance_pct
FROM contract_checks
WHERE ts >= now() - INTERVAL '7 days'
GROUP BY name, version;

12) Konfiqurasiya (YAML)

Version siyasəti

yaml versioning:
events: { compatibility: "BACKWARD", deprecate_days: 90 }
api:  { parallel_majors: true, support_minors: 2 }

Idempotency və təkrar

yaml idempotency:
header: "Idempotency-Key"
ttl_hours: 72 conflict_policy: "prefer-latest-payload-with-signature"

QoS sinifləri

yaml qos:
P0: { ack_timeout_ms: 2000, retries: 3, backoff_ms: [100,400,800] }
P1: { ack_timeout_ms: 5000, retries: 2 }
P2: { best_effort: true }

13) Əməliyyat qaydaları

Gündəlik: müqavilələr/sxemlər üzrə compliance hesabatı, vaxtı keçmiş açarlar, SLO burn.
Həftəlik: İnteraktivlik Komitəsi (yeni imkanlar, miqrasiya, deprekeyt).
Buraxılışdan əvvəl: müqavilə testləri, «şüşə» metrlərlə canary, yuvarlanma planları.

Hadisələr: vahid status kanalı, tərəfdaşlara mesaj şablonları, post-mortem ≤ 72 saat

14) Playbook hadisələr

A. Schema/Contract Drift

1. «Sərt rejimi» işə salın (uyğun olmayan mesajları kəsin),

2. hadisəni açmaq və mənbələri xəbərdar etmək,

3. diff yaratmaq,

4. adapter/fiks buraxmaq,

5. post-mortem və linter yeniləmə.

B. Kütləvi təkrarlamalar/ikiqat mesajlar

1. İdempotentliyi/açarları yoxlayın,

2. dedup filtrləri daxil,

3. səs-küylü prodüseri məhdudlaşdırmaq,

4. vitrinlərin yenidən hesablanması.

C. gecikmə/çökmə ack artımı

1. P0 prioritet, konsumerləri artırmaq,

2. P2 sampling müvəqqəti azaltmaq,

3. marşrutların və şəbəkə dar yerlərin təhlili.

D. iştirakçı açarının kompromasiyası

1. Revoke, rotasiya, etibarlı reyestrin yenilənməsi,

2. kritik batches/sertifikatların yenidən imzalanması,

3. fəaliyyət auditi, tərəfdaşlara hesabat.

E. Kataloqların uyğunsuzluğu (aktivlər/şəbəkələr)

1. Münaqişə mesajlarının karantini,

2. kataloqun geri qaytarılması,

3. aqreqatların yenidən hesablanması,

4. düzəlişlərin dərc edilməsi.

15) Giriş çek siyahısı

1. Səviyyələri və müqavilələri (API, hadisələr, kataloqlar, açarlar) müəyyən edin.
2. Capability negotiation və versiyalar/imkanlar reyestrini başlatın.
3. İdempotentlik, kvotalar, QoS, imzalar və mTLS daxil edin.
4. SLI/SLO, dashboard və alert (Ack, E2E, Compliance) konfiqurasiya.
5. Müqavilə testlərini və uyğunluq test matrisini avtomatlaşdırın.
6. Deprekeyt və miqrasiya qaydalarını daxil edin (paralel olaraq MAJOR).
7. Gizlilik və giriş kataloqlarını/qaydalarını mütəmadi olaraq nəzərdən keçirin.

16) Sözlük

Capability negotiation - dəstəklənən imkanları və iş profilini uyğunlaşdırmaq.
Contract-first - reallaşmadan əvvəl rəsmi müqavilələr vasitəsilə interfeyslərin layihələndirilməsi.
Idempotency - əməliyyatların təkrar təhlükəsizliyi.
Schema/Contract Drift - elan edilmiş müqavilələrlə faktiki mesajların uyğunsuzluğu.
PoLP minimum tələb olunan hüquqların prinsipidir.
Compliance% - müqaviləyə uyğun mesajların/sorğuların payı.

Nəticə: iştirakçıların interoperabelliyi - müqavilələr, versiyalar, imkanlar və müşahidə olunan idarəetmə sistemidir. Bu çərçivəni izləyən ekosistem sürətli inteqrasiyalar, davamlı iş axınları və şəbəkə və şəxsiyyət səviyyəsindən proses və hovernansa qədər heç bir qırılma olmadan təhlükəsiz təkamül təmin edir.