Katılımcıların birlikte çalışabilirliği

(Bölüm: Ekosistem ve Ağ)

1) Katılımcıların birlikte çalışabilirliği nedir

Birlikte çalışabilirlik - farklı kuruluşların (operatörler, stüdyolar, PSP, KYC/AML sağlayıcıları, köprüler, bağlı kuruluşlar, analistler ve yönetimler) güvenlik, gizlilik ve iş sonuçlarının tekrarlanabilirliğini korurken, üzerinde anlaşılan protokoller ve sözleşmeler aracılığıyla birbirleriyle güvenilir bir şekilde etkileşime girme yeteneği.

• Entegrasyon zamanı ↓
• Öngörülebilirlik (kritik akışlarla kararlı SLO/SLA).
• Güvenlik ve uyumluluk (minimum yeterli haklar, denetim).
• Arızasız evrim (sürüm, geriye dönük uyumluluk).

2) Birlikte çalışabilirlik seviyeleri (katman modeli)

1. Taşıma ve ağ: HTTP/2/3, gRPC/QUIC, WebSockets, P2P, mTLS.
2. Kimlikler ve güven: org_id, peer_id, X.509/mTLS, imzalar, anahtar rotasyonu.
3. Olaylar ve veriler: birleşik olay şemaları, varlık/ağ katalogları, idempotency.
4. Süreçler ve iş sözleşmeleri: ödeme/uzlaşma, ilişkilendirme, risk sinyalleri, limit çoğaltma.
5. Yönetim/yasal katman: SLA/SLO, DPA, lisanslar, valilik düzenlemeleri.
6. Gözlemlenebilirlik ve kalite: SLI/SLO, günlüğe kaydetme, izleme, denetim.

Her katmanın kendi sözleşmeleri, testleri ve uyumluluk politikası vardır.

3) Tasarım ilkeleri

Sözleşme-ilk: API'ler/şemalar/olaylar uygulamadan önce resmileştirilir.
Geriye dönük uyumlu değişiklikler: "Yalnızca alan ekle" stratejisi ve 90 gün ≥ kullanımdan kaldırma penceresi.
Yetenek anlaşması: Katılımcılar desteklenen yetenekleri değiştirir ve ortak bir alt küme seçer.
İzolasyon ve PoLP: erişim ve limitler "minimum gerekli'olarak verilir.
Idempotans ve determinizm: tekrara dayanıklı operasyonlar, öngörülebilir çatışma kuralları.
Varsayılan gözlemlenebilirlik: Isteklerin/olayların trace-id korelasyonu, doğrulanabilir faturalar.
Veri minimizasyonu: telemetri/etiketlerde PII eksikliği, takma isimlendirme.

4) Yetenek müzakeresi

El sıkışırken, katılımcılar özelliklerin ve sürümlerin bir manifestosunu yayınlarlar.

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 }

Uyumluluk motoru, parti manifestolarıyla eşleşir ve bir çalışma profili seçer (örn. 'ödemeler: v2', 'olaylar: v1. 9`).

5) API/Olay Sözleşmeleri ve Şemalar

API sözleşmeleri: OpenAPI/gRPC IDL, açık hata kodları, idempotent anahtarlar ('Idempotency-Key'), gövde kısıtlamaları.
Olay modeli: 'depozito. ',' ödeme. ',' köprü. ',' kyc. ',' risk. ',' ürünü. '- istikrarlı alanları ile.
Dizinler/kataloglar: ağlar, varlıklar, ödeme yöntemleri, SDK sürümleri, bölgeler/yetki alanları.
Veri Sözleşmeleri - CI'da test edildi, zaman kilidi ile yönetişim yoluyla değişiyor.

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) Sürüm oluşturma ve uyumluluk

Anlamsal versiyonlar: 'MAJOR. MINÖR. PATCH '.
Kurallar: MINOR/PATCH - geriye dönük uyumlu; MAJOR - "adaptörler'ile paralel varoluş, 90 gün ≥ kullanımdan kaldırılır.
Migration playbooks: API/events/dizinler için migration şablonları; Eski formatların emülatörleri.

7) Entegrasyon desenleri (desenler)

Request-Reply + Idempotency: güvenli ödemeler/limitler/rezervler.
Olay Odaklı: "Gerçeğin kaynakları" değişim gönderir; Aboneler vitrinleri somutlaştırıyor.
Giden Kutusu/Gelen Kutusu: Olayların veritabanından atomik olarak yayınlanması; Aboneye empotent alımı.
SAGA (orkestrasyon/koreografi): koordineli çok alanlı işlemler (örneğin, "popolneniye ^ igrovoye sobytiye ^ vyplata").
Çift yazma koruması: giden kutusu olmadan doğrudan çift giriş yok.
Replay/Backfill: Sipariş ve sonlandırma ile yük devretme.

8) Güvenlik ve güven

mTLS ve 'org _ id/peer _ id' için anahtar bağlama.
Olay imzaları, güven günlüğü (kim ve ne imzalandı/alındı).
RBAC/ABAC ve kotalar: role göre haklar, işlem/hacme göre sınırlar.
Gizli yönetim: rotasyon, "uzun ömürlü" belirteçlerin yasaklanması, kısa kapsamlar.
PII/gizlilik: tokenization, bölgesel veri ayrımı (EU/ROW), DSR süreçleri (delete/export).
Kötüye kullanıma karşı koruma: hız sınırları, sahtekarlık karşıtı sinyaller, yaptırım kontrolleri.

9) SLI/SLO ve birlikte çalışabilirlik gözlemlenebilirliği

• '95 Kabul Etme Zamanı'.
• 'P95 Uçtan Uca' (oluştur, sonlandır/çalıştır).
• Olay/işlem türüne göre 'Başarı Oranı'.
• 'Schema/Contract Compliance %' (geçerli mesajlar).
• 'Kanıt Kapsamı %' (imzalı/ekli kanıtların oranı).
• 'Error Budget Burn' по P0/P1.

• P0 (ödeme/köprü): p95 E2E ≤ 5 dakika, Başarı ≥ 99. 5 %, Ack ≤ 2 saniye.
• P1 (ürün): Tazelik p95 ≤ 3 dakika, Uygunluk ≥ 99. 9%.
• Veri sözleşmeleri: Sürüklenme MTTA ≤ 5 dakika, Breaking değişiklikleri = 0 MAJOR olmadan.

Дашборды: Interop Ops, Sözleşme Sağlığı, Gecikme ve Başarı, Şema Sürüklenme, Güvenlik ve Anahtarlar.

10) Uyumluluk matrisi (test tasarımı)

• Senaryolar: ödemeler, depozitolar, köprü, risk, ürün, telemetri.
• Sürümler: API v2. 6/v2. 5, olaylar v1. 9/v1. 8.
• Ağ modları: normal, bozulma, yetersizlik, DA gecikmeleri.
• Yargı Bölgeleri: AB/İngiltere/TR/LA - farklı kataloglar ve kurallar.

Autotests: sözleşme testleri (üretici/tüketici), idempotency, yeniden deneme/tazminat, şema-linters, yük profilleri.

11) Referans şemaları ve kataloglar

Özellikler Katalog (SQL)

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

Sözleşme/Sürüm Kaydı

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)
);

Uyumluluk İzleme

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) Konfigürasyonlar (YAML)

Sürüm oluşturma ilkesi

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

Idempotency ve tekrarlar

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

QoS Sınıfları

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) Çalışma prosedürleri

Günlük: Sözleşmeler/planlar, süresi dolmuş anahtarlar, SLO yanması ile ilgili uyumluluk raporu.
Haftalık: Birlikte çalışabilirlik komitesi (yeni fırsatlar, göçler, amortismanlar).
Piyasaya sürülmeden önce: sözleşme testleri, "cam" metrikli kanarya, geri alma planları.
Olaylar: tek durum kanalı, ortaklar için mesaj şablonları, ölüm sonrası ≤ 72 saat.

14) Playbook olayları

A. şema/sözleşme sürüklenme

1. "Katı modu" etkinleştirin (uygunsuz mesajları kesin),

2. olayı açın ve kaynakları bilgilendirin,

3. diff oluştur

4. adaptörün/düzeltmenin serbest bırakılması,

5. Otopsi ve linter güncellemesi.

B. toplu tekrarlar/çift mesajlar

1. Idempotence/anahtarları kontrol edin,

2. Dedup filtrelerini açın,

3. gürültülü üreticiyi sınırlamak,

4. vitrinlerin yeniden hesaplanması.

C. Ack gecikmesinde/düşüşünde artış

1. P0 öncelik, tüketicileri artırmak,

2. P2 örneklemesini geçici olarak azaltın,

3. Rota ve ağ darboğaz analizi.

D. Üye Anahtar Uzlaşma

1. İptal, rotasyon, güvenilir kayıt defteri güncellemesi,

2. Kritik partilerin/sertifikaların yeniden imzalanması,

3. Eylemlerin denetimi, ortaklara rapor.

E. dizin uyumsuzluğu (varlıklar/ağlar)

1. Karantina çatışma mesajları,

2. Katalog geri alma

3. Agregaların yeniden hesaplanması,

4. Yayım yamaları.

15) Uygulama kontrol listesi

1. Seviyeleri ve sözleşmeleri tanımlayın (API'ler, olaylar, dizinler, anahtarlar).
2. Yetenek müzakeresini ve sürüm/yetenek kaydını çalıştırın.
3. Idempotency, kotalar, QoS, imzalar ve mTLS içerir.
4. SLI/SLO, panoları ve uyarıları (Ack, E2E, Uyumluluk) yapılandırın.
5. Sözleşme testlerini ve uyumluluk test matrisini otomatikleştirin.
6. Amortisman ve geçiş prosedürlerini girin (paralel olarak MAJOR).
7. Katalogları/gizlilik ve erişim kurallarını düzenli olarak gözden geçirin.

16) Sözlük

Yetenek anlaşması - desteklenen yetenekleri ve iş profilini uzlaştırın.
Sözleşme-ilk - Uygulama öncesi resmi sözleşmeler yoluyla tasarım arayüzleri.
Idempotency - tekrarlı güvenlik operasyonları.
Şema/Sözleşme Sürüklenme - gerçek mesajlar ve beyan edilen sözleşmeler arasındaki tutarsızlık.
PoLP, gerekli asgari hakların ilkesidir.
Uyumluluk %, sözleşmeyle eşleşen mesajların/taleplerin yüzdesidir.

Alt satır: Katılımcı birlikte çalışabilirliği, yönetilen bir sözleşme, sürüm, yetenek ve gözlemlenebilirlik sistemidir. Bu çerçeveyi izleyerek, ekosistem hızlı entegrasyonlar, sürdürülebilir iş akışları ve arıza olmadan güvenli bir evrim sağlar - ağ seviyesinden ve kimliklerden süreçlere ve yönetişime kadar.