بروتوكولات الاتصال المشتركة

1) لماذا يحتاج النظام البيئي إلى بروتوكولات موحدة

يتكون النظام الإيكولوجي من مشغلين واستوديوهات/RGS ومجمعين و PSP/APM ومقدمي KYC/AML والشركات التابعة والخدمات التحليلية. تستبعد بروتوكولات التفاعل الشائعة «حديقة الحيوان» للتكامل، وتسريع الصعود، وتقليل تكلفة الدعم ومخاطر الحوادث، كما توفر التوافق عند التحجيم (الأفقي والرأسي والقطري).

الأهداف: قابلية التشغيل البيني خارج الصندوق، والمنظمات غير الحكومية التي يمكن التنبؤ بها، وأمن البيانات، والهجرات القابلة للتكرار.

2) طبقة النقل وأشكاله

HTTP/2/3، gRPC - لواجهات برمجة التطبيقات المتزامنة ذات زمن انتقال منخفض ؛ WebSocket - لبث الأحداث/اللوحات القيادية ؛ WebRTC (SRTP/QUIC) - للمحتوى المباشر للصوت/الفيديو.

• JSON - واجهات برمجة التطبيقات الخارجية B2B وخطافات الويب (إمكانية القراءة).
• Protobuf/Avro - ناقل داخلي/تكامل عميق (ضغط/تطور الدائرة).
• الضغط/الربط: gzip/br لـ JSON ؛ zstd for Protobuf/Avro.
• المحلية/الزمنية: ISO-8601 في التوقيت العالمي المنسق، المبالغ بالحد الأدنى من الوحدات النقدية (عدد صحيح).

3) التوثيق والإذن والثقة

OAuth2/OIDC لتطبيقات العملاء/الشركاء (الرموز القصيرة الأجل، PKCE، النطاقات).
MTLS S2S بين المناطق الموثوق بها JWS/HMAC - توقيع الطلبات وخطابات الويب.
RBAC/ABAC: الأدوار والسمات (الولاية القضائية، المستأجر، مستوى المخاطر).
المفاتيح والدوران: KMS/Vault، العمر القصير، الدوران التلقائي (بما في ذلك JWKS).
التحكم في الخروج ونطاقات قائمة السماح و ASN و DNSSEC/DoT/DoH في المناطق الحساسة.
عزل المستأجر: مفاتيح لكل مستأجر، حصص، حدود، مساحة اسم في الإطار.

4) عقود API (REST/gRPC) - Canon

الإصدار: '/v {n} 'in URI for REST;' طرد. vN 'لـ gRPC. تطور طفيف - لا تشوبه شائبة ؛ كسر التغييرات - من خلال التخصص الجديد. الاكتئاب حسب السياسة (انظر الفقرة 12).
الخصوصية: 'مفتاح الخصوصية' في العمليات النقدية/الحرجة ؛ التوفير لساعات N.
Pagination: cursors ('next PageToken'), not 'offet/remide'; الفرز المتسق.
الحدود: «429 عدد كبير جدًا من الطلبات» + رؤوس الحصص («X-RateLimit-»)، رعشة في السحب.
الأخطاء: رموز/رموز فرعية قابلة للقراءة آليًا، «معرف الارتباط»، خريطة حقل التحقق.
التوقيت والتراجع: تأخير أسي + نفاث ؛ لا تتراجع عن الأخطاء غير الآمنة.
سياسة التوافق: عدم قابلية المعنى الميداني للتغيير ؛ حقول جديدة - اختيارية.

5) نموذج الحدث والحافلة (EDA)

سجل المخطط: عقد لكل حدث، والتطور مع التوافق الخلفي.

• «عقد»، «جلسة»، «رهان »/« دوران»، «جولة _ بدء »/« جولة _ نتيجة»،
• «deposit'/» السحب«، »psp _ auth«، »kyc _ status'،« إشارة الاحتيال »،
• «المكافأة _ الممنوحة»، «leaderboard _ update»، «ميزة _ تبديل».
• مفاتيح الحفلة: «معرف اللاعب»، «معرف الحملة»، «معرف الجدول»، «معرف المشغل» (الاختيار حسب المجال).
• الإنجاز: مرة واحدة على الأقل في ظل الخصوصية التجارية ؛ للمجاميع النقدية - ملحمة/txn-outbox.
• الأمر: «نظام مضمون داخل المفتاح»، مفاتيح متقاطعة - من خلال التنسيق.
• دلالات الوقت: «Time» + «InstTime» ؛ الجد لـ «(EventID 'idempotencyKey)».

6) خطوط الويب وضمانات التسليم

التوقيع: JWS/HMAC مع عدم وجود "(طابع زمني) و" طفل "، فحص النوافذ ± 5 دقائق، إعادة التشغيل محظورة.
Retrai: التراجع مع الترحال حتى دقائق T، وإصلاح المحاولات، والعودة فقط عند 5 × x/مهلة.
الخصوصية: 'ID' + توقيع الجسم ؛ معالجة «مرة واحدة على الأقل».
Webhook Event Registry: Remampling history when out of sync.
الأمان: mTLS قدر الإمكان، السماح بقائمة IP/ASN، CSRF لا ينطبق على أطواق جانب الخادم.

7) البيانات والخصوصية (الخصوصية حسب التصميم)

تقليل PII: ترميز المعرفات («معرف اللاعب» اسم مستعار)، فصل مجالات البيانات.
عقود البيانات: إدارة الشؤون السياسية/إدارة شؤون الإعلام، والأهداف، وفترات الاحتفاظ، والتدفقات عبر الحدود (بلدان القائمة البيضاء).
سياسات مراجعة الحسابات/النسب: من/متى/لماذا ؛ جذوع الأشجار الثابتة (WORM).
RG/قواعد الأخلاقيات: حظر العروض العدوانية للفئات الضعيفة ؛ إطار قانوني واضح.

8) الاتساق والمعاملات

الاتساق القوي - المحفظة/الأرصدة/المدفوعات.
في نهاية المطاف - عروض، لوحات قيادة، قياس عن بعد.
ساغاس للمعاملات التجارية الموزعة ؛ التعويض عن حالات الإلغاء.
مرة واحدة بالضبط بالمعنى التجاري: مفاتيح غبية ومعالجات حتمية.

9) إمكانية الرصد و SLO

التعقب: 'المعرف الناقص' من طرف إلى طرف من النقر/الشباك إلى الدفع/المكافأة ؛ الانتشار ('W3C traceparent').
المقاييس: p50/p95/p99 API، تأخر السمسار، مدفوعات CR/CCL، لوحات الصدارة E2E.
الجذوع: منظمة بدون بيانات شخصية ؛ الرمز/إخفاء المفتاح.
قوائم SLO: تسجيل الدخول p95 ≤ 300-500 ms ؛ الوديعة p95 ≤ 1. 5–2. 0 s ؛ الرهان/الدوران p95 ≤ 150-250 مللي ثانية ؛ تسليم الأحداث ≥ 99. 9%.

10) الأداء والحصص والحماية من العواصف

الحد من الأسعار (دلو رمزي/متسرب) على L7 وفي سياسات الشبكة.
الضغط الخلفي: قوائم الانتظار قبل المنبع الهش (PSP/KYC).
الطرد الخارجي: «التبريد» التلقائي للنواحي الخلفية غير المستقرة.
قاطع الدائرة - يغلق الخيط عند تجاوز عتبات الخطأ/الكمون.
الحصة العادلة: الحصص حسب المستأجر/القناة/المنطقة ؛ أولوية المجالات الحرجة.

11) معايير توافق واختبار SDK

SDK: عملاء HTTP/gRPC، التوقيع على الطلب، إعادة التدوير، الغباء، المؤشرات.
اختبارات العقد: ساعي البريد/نيومان/جي آر بي سي مطابقة، PSP/KYC/محاكاة الاستوديو.
مصفوفة التوافق: إصدارات واجهة برمجة التطبيقات/SDK، المخططات المدعومة، سياسات التخفيض.
المواد التركيبية: مولدات الأحداث والمعاملات، 24/7 الصناديق السوداء للمراقبة.

12) التحديث والإيداع (إدارة التغيير)

الإصدارات الرئيسية كل N شهرًا، مع نافذة موازية ≥ 6-12 شهرًا.
تغييرات طفيفة - إضافة حقول/طرق اختيارية خالية من الاحتكاك.
التخفيض: الإعلان → التحذير في الرؤوس/الردود → العلم في المقاييس → الإغلاق وفقًا للخطة.
هجرات مخطط الحدث - استراتيجية إضافة فقط + محولات بالوكالة عند الحدود.

13) ضمان البروتوكول

Zero Trust: mTLS في كل مكان، عقيدة قصيرة العمر، مبادئ أقل امتياز.
النطاقات السرية: فصل مفاتيح القراءة/الكتابة/الإدارة.
الحماية من التكرار: عدم وجود نافذة زمنية في التوقيعات ؛ حظر إعادة الاستخدام.
مرشحات WAF/bot: الحماية من الاحتيال بالكشط/النقر ؛ إيجابي كاذب منخفض.
مناطق البائعين: التجزئة المجهرية، VPCs/spaces الفردية، ext-encell-list.

14) الحوادث و DRs

إجراءات غرفة الحرب: زر إيقاف النطاقات (المحتوى/PSP/KYC)، RACI، SLA لكل حزمة ضئيلة.
سيناريوهات DR: نقاط إدخال الأصول (Anycast/GSLB)، التخفيض ≤ 60-90 ثانية، التمارين الفصلية.
RCA: قوالب دون العثور على الجاني، الاتصال L3↔L7، تحديثات لبروتوكول/SDK/Runbook.

15) مقاييس نجاح البروتوكول

التوافق: نسبة الشركاء الذين اجتازوا اختبارات المطابقة ؛ وقت الصعود (TTO).
الموثوقية: تكامل وقت التشغيل، واجهة برمجة التطبيقات p95/الحافلة، حصة من خطوط الويب الناجحة.
الأمن: حوادث PD = 0، وقت التناوب الرئيسي، حصة حركة المرور mTLS.
الاقتصاد: التكلفة لكل rps/txn/event، انخفاض التكلفة للخدمة، أوقات الهجرة.
المنتج: رفع FTD/ARPU/LTV من التوحيد القياسي (عدد أقل من تسريبات CCD/الدفع).

16) الأنماط المضادة

«شكل مجاني» للأحداث: نقص المخططات والإصدارات → القيادة حول العروض والتحليلات.
بوابة L7 واحدة بدون N + 1: SPOF وحلق ضيق لخطافات الويب/PSP.
Retrai Unlimited/Jitter: Traffic Storm، Transaction Double.
PD الخام في المقابل: لا يوجد ترميز/DPIA → المخاطر التنظيمية.
التعويض عن الاستعداد: الثغرات/التكرارات تحت التحميل.
أسرار «إلى الأبد» و IP ثابتة بدون تحكم بالخروج.
كسر التغييرات بدون نافذة متوازية ومحولات.

17) قائمة التنفيذ المرجعية

1. تقبل قانون API (الإصدار، الخصوصية، التثبيت، الأخطاء).
2. أدخل Schema Registry وخريطة نطاق مفاتيح الموضوع/الطرف.
3. (هـ) إلزام نظام رصد الأرصاد الجوية + نظام رصد الأرصاد الجوية/نظام رصد الأرصاد الجوية (HMAC) S2S والخطابات الشبكية ؛ أتمتة تناوب المفاتيح/JWKS.
4. وضع حدود/إعادة طباعة/CB/outlier-exection وحصص لكل مستأجر.
5. توسيع نطاق التتبع/المقاييس/الجذوع باستخدام «معرف ضئيل» واحد ؛ الموافقة على قوائم SLO.
6. قم بتوقيع DPA/DPIA، وتمكين الترميز، وتخزين/حذف السياسات.
7. إنشاء مجموعة مطابقة و SDK ؛ إصلاح سياسة الاستنفاد.
8. إجراء تدريبات DR/الفوضى وطقوس غرف الحرب ؛ «بداية سوداء» في المجموعة الدنيا.
9. نفذ كتالوج بروتوكول (بوابة شريك): المواصفات، الأمثلة، أجهزة المحاكاة، صندوق الرمل.

18) خارطة طريق التطور

v1 (المؤسسة): قانون REST/gRPC، مخططات الأحداث الأساسية، توقيعات الشبكات، mTLS.
v2 (الاندماج): خط أنابيب الهجرة، اختبارات المطابقة، SDK، محرك القواعد للحصص/عمليات إعادة التدوير.
v3 (الأتمتة): التشغيل التلقائي بواسطة SLI، صناديق الرمل/أجهزة المحاكاة ذاتية الخدمة، المحولات بين الإصدارات.
v4 (الحوكمة الشبكية): لجنة بروتوكول مشتركة بين الشركاء، ومنظمات/ائتمانات/عقوبات مشتركة، وسياسات برنامج عمل/ميزة مشتركة.

موجز موجز

بروتوكولات التفاعل الشائعة هي «لغة» النظام البيئي: واجهة برمجة التطبيقات الموحدة وعقود الأحداث، والأمن الصارم (mTLS/JWS)، وضمانات الخصوصية والتسليم، وإمكانية الملاحظة ومنظمات SLOs، والهجرات المدارة و DR. بعد القانون، يكون المشاركون أكثر سرعة، ويقعون في كثير من الأحيان، ويتوسع بشكل أسهل وينمو بشكل متوقع - خاضع للخصوصية و المتطلبات القضائية.