Katılımcı etkileşim kalıpları

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

1) Bağlam ve hedefler

Ekosistemin birçok aktörü vardır (operatörler, sağlayıcılar, ödeme ve KYC hizmetleri, bağlı kuruluşlar, düzenleyiciler, topluluklar, geliştiriciler). "Etkileşim kalıpları", birlikte çalışabilirlik, güvenlik, maliyet etkinliği ve ölçeklenebilirlik sağlayan değer ve verileri paylaşmanın sürdürülebilir yollarıdır.

• İşlem maliyetlerini ve entegrasyon süresini azaltın.
• Düğümler arası akışların güvenilirliğini ve gözlemlenebilirliğini artırın.
• Gecikme ve tutarlılığı dengeleyin.
• Etkileşim protokollerine uyum ve ekonomik teşvikler dikin.

2) Katılımcıların ve rollerin taksonomisi

Operatörler/kiracılar: kullanıcılar için son hizmet, kendi onboarding ve UX.
Sağlayıcılar/stüdyolar/içerik düğümleri: dizinler/API'ler/etkinlikler, yayınlanmak üzere SLA'lar sağlar.
Ödeme/risk hizmetleri: yetkilendirme, takas, ters ibraz, puanlama, limitler.
Ortaklar/bağlı kuruluşlar: trafiği yönlendirir, dönüşümlerin web kitaplarını oluşturur, raporlar alır.
Düzenleyiciler/denetimler: günlükler, raporlama, veri yerelleştirme gerektirir.
Topluluklar/geliştiriciler: SDK'yı genişletin, uygulamalar/botlar/entegrasyonlar oluşturun.

3) İletişim kanalları ve ulaşım

Eşzamanlı istekler: RQ/RS için REST/gRPC, canlı etkinlikler için WebSockets/SSE.
Asenkron otobüsler: Kafka/AMQP/streaming servisleri, alan adı etkinlikleri için Pub/Sub.
Webhooks: kanalı harici bir ortağa itin (gerekli: imza, zaman aşımları, retrai).
Dosya/toplu iş arabirimleri: Raporlama ve geri doldurma için NACHA/CSV/Parquet.
Kenar/PoP: önbelleğe alma, WAF, hız sınırları, imza doğrulama, gecikme azaltma.

4) Temel etkileşimler (protokol katmanı desenleri)

1. İstek/Yanıt (RQ/RS)

"Şimdi kararlar" için kullanın: ödeme yetkisi, sınırların doğrulanması, yapılandırmalar.
Teknisyenler: zaman aşımları, devre kesici, jitter ile yeniden denemeler, idempotent anahtarlar.

2. Yayınla/Abone Ol (Olay odaklı)

Gerçekleri yaymak için: "anlaşma tamamlandı", "denge değişti", "oyun olayı".
Teknikler: anahtar bölümleme (by user_id/tenant_id), mesaj anahtarı ile dedup, derginin uzun süreli depolanması.

3. Komut/Yanıt

Gecikmeli correlation_id yanıtı/korelasyon ile "Yap" komutu.
Teknikler: giden kutusu deseni, garantili yayın, telafi komutları.

4. Webhook Callback

Tekrarlanan teslimat ile bildirimlerin ortak alınması (en az bir kez).
Teknikler: istek imzası, zaman damgası + anti-replay, alıcıda idempotency.

5. Parti/Delta Sync

Gece kapanışları, raporlama, dizin senkronizasyonu.
Teknikler: anlık görüntüler + artışlar, sağlama toplamı, sürüm şemaları.

5) Süreç koordinasyonu: orkestrasyon vs koreografi

Koreografi (etkinlik): Katılımcılar alan olaylarına merkezi bir koordinatör olmadan tepki verirler.

Artıları: zayıf bağlantı, ölçeklenebilirlik. Eksileri: Daha zor izleme/olaylar.
Orkestrasyon (destanlar): Koordinatör adımları ve tazminatları yönetir.

Artıları: şeffaf kontrol, öngörülebilirlik. Eksileri: mantık konsantrasyon noktası.

Saga (tazminat işlemleri): Arıza durumunda geri dönüşümlü eylemler içeren bir dizi adım. Finans/bilançolarda, sıkı bir lider ve telafi işlemlerinin en aza indirilmesi tercih edilir.

6) Tutarlılık ve veriler

Güçlü: ödemeler, limitler, KYC durumları (tek lider, yazma, senkron değişmezler).
Nihai/Zaman Çizelgesi: telemetri, kataloglar, pazarlama etkinlikleri (asenkron çoğaltma).
CRDT/sürüm oluşturma: çoklu ana senaryolarda nadir çakışmalar için.
Outbox/CDC: Böylece olay veritabanındaki girişle'her zaman "yayınlanır.
Tanımlayıcılar: global, sıralanmış (ULID/KSUID), teşhis için bölgesel önekler.

7) Güvenilirlik ve istikrar

Idempotence: istek/mesaj düzeyinde anahtar, alıcıda dedup.
Retrai: jitter ile üssel geri dönüş; Operasyonun ömrü sınırlıdır.
Zaman aşımları ve gecikme bütçesi: Kritik rotalar için p95/p99.
Geri basınç: eşzamanlılık kısıtlaması, kuyruklar, önceliklendirme.
Bozunma modları: arıza durumunda kısmi işlevsellik (önbellek, ertelenmiş işlemler).
Chaos/GameDays: Entegrasyon ve kanalların simüle edilmiş başarısızlıkları ile düzenli egzersizler.

8) Güvenlik, güven, uyum

Kimlik doğrulama/yetkilendirme: OAuth2/OIDC, S2S için mTLS, kısa ömürlü belirteçler.
Mesaj/webhook imzası: HMAC + zaman damgası + nonce.
Gizlilik/yerelleştirme: Bölgenin "güven bölgesinde" PII/PCI, olaylarda veri alanının en aza indirilmesi (veri en aza indirilmesi).
Denetim ve değişmez kayıtlar: trace_id ile korelasyon, teslimat/okuma kanıtlarının depolanması.
Sırlar ve anahtarlar: Bölge başına KMS, rotasyon, kod olarak ilke.
Antifraud ve risk: girişte puanlama, katılımcı/kanaldaki sınırlar, davranışsal sinyaller.

9) Etkileşim ekonomisi ve teşvikler

Para kazanma sözleşmeleri: RevShare/telif hakları, API (katmanlı) tarifeler, SLA'lar için cezalar/kredi notları.
Adil kullanım: kotalar, oran limitleri, ortak seviyelerine göre önceliklendirme.
Maliyet bilincine sahip yönlendirme: Birkaç tedarikçi SLA'da eşdeğerse, daha ekonomik olanı seçin.
Şeffaf raporlama: teslimat durumları, tüketim panoları, self servis limitleri.

10) Gözlemlenebilirlik ve SLO

İzler: RQ/RS ve olaylarda uçtan uca trace_id/span_id.
Metrikler: gecikme p50/p95/p99, hata oranı, kuyruk gecikmesi, önbellek isabetlerinin paylaşımı, çıkış.
Günlükler: yapılandırılmış, tenant_id/partner_id/region/release.

Uyarı: Kanal başına SLO ve entegrasyon; İş etkisine göre önceliklendirme (örn. Ödemeler> Telemetri)

11) Genel Sözleşme Şablonları

1. REST/gRPC sözleşmesi:

SemVer sürüm oluşturma, gerekli alanlar: idempotency-key, request-id, trace-context.
Yanıtlar: deterministik hata kodları, yeniden deneme-ipuçları, asenkron işlemin durumuna bağlantı.

2. Etkinlik sözleşmesi:

Поля: event_id, occurred_at, yapımcı, subject_id, versiyon, schema_ref.
Garantiler: en az bir kez, anahtar taraf, TTL/tutma.

3. Webhook sözleşmesi:

Başlıklar: imza, zaman damgası, nonce, delivery-id.
Davranış: 2xx = onay; N saate geri dönüş, alıcıda idempotency.

12) Partner onboarding kalıpları

Sandbox ve test anahtarları, ortak API/olay dizini, Postman/SDK, örnekler.
Self servis portalı: webhook oluşturma, olay filtreleri ayarlama, teslimat günlüklerini görüntüleme.
Yerleşik koruma rayları: varsayılan sınırlar, otomatik ayrıştırmadan önce uyarılar.
Entegrasyonların belgelendirilmesi: kontrol listeleri, sözleşmelerin ototestleri, "pazar" durumu.

13) Riskler ve anti-kalıplar

Eşzamanlı "domino zinciri": yabancı sistemlerde uzun RPC'ler - basamaklı dosyalar.
Hiçbir idempotency: çift ödeme/olay.
Sürümsüz şemalar: sürümler sırasında tüketicileri kırın.
Tüm alan için küresel'ana gerçek ": pahalı/kırılgan bölgeler arası tutarlılık.
Opak ekonomi: ortaklar tüketimi görmüyor - çatışmalar ve güvensizlik.

14) Etkileşimlerin Sağlık Metrikleri

Olay teslim başarı oranı (%) ve ortalama gecikme.
Kritik rotalarda p95/p99 gecikmeleri (ödeme, sonuçların hesaplanması).
Entegrasyon/kanal ile 4xx/5xx hataları, MTTR olayları.
Idempotently işlenen payı alır, önbellek hit seviyesi.
1k istek/olay başına maliyet ve ortağa göre çıkış.
Partner onboarding dönüşümü: key-to-first-success time.

15) Uygulama kontrol listesi

1. Etkileşimleri sınıflandırma: eşzamanlı ve olay, tutarlılık kritikliği.
2. SLO'ları ve zaman aşımlarını tanımlayın, devre kesicileri etkinleştirin ve geri çekin.
3. Her yerde idempotency girin (anahtarlar, dedup, tekrarlar).
4. Şema/sözleşme sürümleri ve bir genişlet, göç et, sözleşme politikası oluştur.
5. Webhook'lar ve bölge başına KMS için resim yazılarını ve anti-replay'i etkinleştirin.
6. Uçtan uca gözlemlenebilirlik ve self servis portallar oluşturun.
7. İş ortağı sertifikasyonunu ve sözleşmelerin regresyon testlerini otomatikleştirin.
8. Bir ekonomi oluşturun: kotalar, limitler, raporlama, maliyet bilincine sahip yönlendirme.
9. Entegrasyonlar için GameDays'i düzenli olarak barındırın (kanal bozulması, kitle geri izlemeleri).
10. Etki alanı matrisini dörtte bir kez gözden geçirin: nerede güçlü, nerede zayıflayacağınız.

16) SSS

Ne seçmeli: orkestrasyon veya koreografi? Karmaşık ve kritik süreçler için - orkestrasyon; Geniş ölçeklendirme için - açık sözleşmelerle koreografi.
"Almak" nasıl önlenir? Idempotent tuşları + alıcıda dedup + tüketicilerde tam olarak bir kez benzeri mantık.
Partner onboarding nasıl hızlandırılır? Sandbox, hazır SDK/örnek komut dosyaları, otomatik webhook kontrolleri ve durum sayfaları.
Uyumluluk nasıl oluşturulur? Etkinliklerde PII alanlarını en aza indirin, "güven bölgelerinde" önemli işlemleri saklayın, değiştirilemez denetimler yapın.

Özet: Etkileşim modelleri sadece protokoller değil, aynı zamanda ekonomik teşviklerin, koruma raylarının ve gözlemlenebilirliğin bir kombinasyonudur. Sözleşmeleri resmileştirin, alanları tutarlılığa bölün, idempotency ve retrays "varsayılan olarak" yapın, ortaklara şeffaf araçlar ve ölçümler verin - ekosistem sürdürülebilir ve öngörülebilir bir şekilde büyüyecektir.