إمكانية التشغيل المتبادل للمشاركين

(القسم: النظام الإيكولوجي والشبكة)

1) ما هي قابلية التشغيل البيني للمشاركين

قابلية التشغيل البيني - قدرة المنظمات المختلفة (المشغلون والاستوديوهات وشركة PSP ومقدمو خدمات KYC/AML والجسور والشركات التابعة والمحللون والمحافظون) على التفاعل بشكل موثوق مع بعضها البعض من خلال البروتوكولات والعقود المتفق عليها، مع الحفاظ على الأمن والخصوصية وقابلية تكرار نتائج الأعمال.

• حان وقت الاندماج ↓
• القدرة على التنبؤ (استقرار منهاج العمل/جيش تحرير السودان حسب التدفقات الحرجة).
• الأمن والامتثال (الحد الأدنى من الحقوق الكافية، مراجعة الحسابات).
• التطور بدون أعطال (إصدار، توافق خلفي).

2) مستويات التشغيل البيني (نموذج الطبقة)

1. النقل والشبكة: HTTP/2/3، gRPC/QUIC، WebSockets، P2P، mTLS.
2. الهويات والثقة: org_id، peer_id، X.509/mTLS، التوقيعات، تناوب المفتاح.
3. الأحداث والبيانات: مخططات الأحداث الموحدة، كتالوجات الأصول/الشبكات، الخصوصية.
4. العمليات وعقود العمل: الدفع/التسوية، الإسناد، إشارات المخاطر، الحد من التكرار.
5. الإدارة/الطبقة القانونية: جيش تحرير السودان/جيش تحرير السودان، إدارة الشؤون السياسية، التراخيص، لوائح المحافظين.
6. إمكانية الملاحظة والجودة: SLI/SLO، قطع الأشجار، التعقب، مراجعة الحسابات.

لكل طبقة عقودها واختباراتها وسياسة التوافق الخاصة بها.

3) مبادئ التصميم

العقد أولاً: يتم إضفاء الطابع الرسمي على واجهات برمجة التطبيقات/المخططات/الأحداث قبل التنفيذ.
التغييرات المتوافقة مع الخلف: استراتيجية «إضافة الحقول فقط» ونافذة الاستنكار ≥ 90 يومًا.
التفاوض بشأن القدرات: يتبادل المشاركون القدرات المدعومة ويختارون مجموعة فرعية مشتركة.
العزل و PoLP: يتم إصدار «الحد الأدنى الضروري» للوصول والحدود.
الفراغ والحتمية: تكرار العمليات الآمنة، قواعد الصراع التي يمكن التنبؤ بها.
القابلية للرصد الافتراضي: ارتباط التعقب بالطلبات/الأحداث، فواتير يمكن التحقق منها.
تقليل البيانات إلى أدنى حد: عدم وجود مؤشر الاستثمار الدولي في القياس عن بُعد/التسميات، التسمية المستعارة.

4) التفاوض على القدرات

عند المصافحة، ينشر المشاركون بيانًا بالميزات والإصدارات.

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 }

يتطابق محرك التوافق مع بيانات الطرف ويختار ملف تعريف العمل (على سبيل المثال "الدفع: v2"، "الأحداث: v1. 9`).

5) API/عقود ومخططات الأحداث

عقود API: OpenAPI/gRPC IDL، رموز خطأ واضحة، مفاتيح خفية («Idempotency-Key»)، قيود الجسم.

نموذج الحدث: "الإيداع. '،' دفع تعويضات. «،» الجسر. '،' kyc. «،» المخاطرة. «،» المنتج. مع حقول مستقرة

الأدلة/الكتالوجات: الشبكات، والأصول، وطرق الدفع، وإصدارات SDK، والمناطق/الولايات القضائية.
عقود البيانات - تم اختبارها في CI، وتتغير من خلال الحوكمة مع الوقت المحدد.

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) الحرث والتوافق

الإصدارات الدلالية: 'MAJOR. قاصر. PATCH '.
القواعد: MINOR/PATCH - متوافقة مع الخلف ؛ الوجود الرئيسي - بالتوازي مع «المحولات»، يستخف ≥ 90 يومًا.
كتب اللعب المتعلقة بالهجرة: نماذج الهجرة لواجهة برمجة التطبيقات/الأحداث/الأدلة ؛ محاكيات الأشكال القديمة.

7) أنماط التكامل (الأنماط)

الطلب - الرد + الخصوصية: المدفوعات/الحدود/الاحتياطيات المضمونة.
الحدث: «مصادر الحقيقة» ترسل التغيير ؛ يتجسد المشتركون في واجهات المتاجر.
Outbox/Inbox: النشر الذري للأحداث من قاعدة البيانات ؛ الاستقبال الخفي للمشترك.
SAGA (التنسيق/تصميم الرقصات): عمليات منسقة متعددة المجالات (على سبيل المثال، «popolneniye→igrovoye sobytiye→vyplata»).
واقي مزدوج الكتابة: لا توجد إدخالات مزدوجة مباشرة بدون صندوق خارجي.
إعادة/ملء الخلف: فشل مع الطلب والانتهاء.

8) الأمن والثقة

mTLS وربط المفتاح بـ 'org _ id/peer _ id'.
التوقيعات على الأحداث، وسجل الثقة (من وماذا وقع/تلقى).
RBAC/ABAC والحصص: الحقوق حسب الدور، والحدود حسب التشغيل/الحجم.
الإدارة السرية: التناوب، حظر الرموز «طويلة العمر»، النطاقات القصيرة.
PII/privacy: tomenization, regional data segremation (EU/ROW), DSR process (dele/export).
الحماية من الإساءة: حدود السرعة، وإشارات مكافحة الاحتيال، وفحص العقوبات.

9) SLI/SLO وقابلية رصد التشغيل البيني

• «p95 وقت الاعتراف».
• «p95 من البداية إلى النهاية» (إنشاء → وضع اللمسات الأخيرة/التنفيذ).
• «معدل النجاح» حسب نوع الحدث/العملية.
• «مخطط/امتثال العقد%» (رسائل صالحة).
• «إثبات التغطية%» (نسبة الأدلة الموقعة/المرفقة).
• «خطأ حرق الميزانية» по P0/P1.

• P0 (payout/bridge): p95 E2E ≤ 5 min, Success ≥ 99. 5٪، Ack ≤ 2 ثانية.
• P1 (product): Freshness p95 ≤ 3 min, Compliance ≥ 99. 9%.
• عقود البيانات: Drift MTTA ≤ 5 دقائق، Breaking changes = 0 بدون MAJOR.

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

10) مصفوفة التوافق (تصميم الاختبار)

• السيناريوهات: المدفوعات، الودائع، الجسر، المخاطر، المنتج، القياس عن بعد.
• الإصدارات: API v2. 6/v2. 5، الأحداث v1. 9/v1. 8.
• أوضاع الشبكة: تأخيرات عادية، تدهور، قلس، DA.
• الولايات القضائية: الاتحاد الأوروبي/المملكة المتحدة/TR/LA - فهارس وقواعد مختلفة.

الاختبارات الذاتية: اختبارات العقد (المنتج/المستهلك)، الخصوصية، إعادة التجربة/التعويض، خطوط المخطط، ملامح التحميل.

11) المخططات والكتالوجات المرجعية

كتالوج الميزات (SQL)

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

سجل العقد/النسخة

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

رصد التوافق

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) التشكيلات (YAML)

سياسة التحرير

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

الخصوصية والتكرار

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

فئات QoS

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) إجراءات التشغيل

يوميًا: تقرير الامتثال للعقود/المخططات، والمفاتيح منتهية الصلاحية، وحرق SLO.
أسبوعيا: لجنة التشغيل البيني (فرص جديدة، هجرات، مستنكرات).
قبل الإصدار: اختبارات العقد، الكناري بمقاييس «الزجاج»، خطط التراجع.
الحوادث: قناة الحالة الفردية، نماذج الرسائل للشركاء، بعد الوفاة ≤ 72 ساعة.

14) حوادث قواعد اللعبة

ألف - المخطط/الانجراف التعاقدي

1. تمكين «وضع صارم» (قطع الرسائل غير المناسبة)،

2. فتح الحادث وإخطار المصادر،

3. توليد diff

4. تحرير المحول/الإصلاح،

5. بعد الوفاة وتحديث البطانة.

باء - عمليات إعادة التشغيل بالجملة/الرسائل المزدوجة

1. تحقق من الخصوصية/المفاتيح،

2. قم بتشغيل مرشحات التخلص،

3. الحد من المنتج الصاخب،

4. إعادة حساب نوافذ المتاجر.

جيم - زيادة زمن الانتظار/التخفيض التدريجي

1. إعطاء الأولوية لـ P0، وزيادة المستهلكين،

2. خفض أخذ العينات P2 مؤقتًا،

3. وتحليل اختناقات الطرق والشبكات.

دال - تسوية مفتاحي الأعضاء

1. إلغاء، تناوب، تحديث سجل موثوق،

2. إعادة توقيع الدفعات/الشهادات الهامة،

3. مراجعة الإجراءات، إبلاغ الشركاء.

هاء - عدم تطابق الدليل (الأصول/الشبكات)

1. رسائل نزاع الحجر الصحي

2. تراجع الكتالوج

3. إعادة حساب المجاميع،

4. رقع النشر.

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

1. تحديد المستويات والعقود (واجهات برمجة التطبيقات والأحداث والأدلة والمفاتيح).
2. تشغيل تفاوض القدرات وسجل النسخة/القدرات.
3. تضمين الخصوصية والحصص و QoS والتوقيعات و mTLS.
4. قم بتهيئة SLI/SLO ولوحات القيادة والتنبيهات (Ack، E2E، الامتثال).
5. أتمتة اختبارات العقد ومصفوفة اختبار التوافق.
6. إدخال إجراءات النقض والهجرة (MAJOR بالتوازي).
7. مراجعة الكتالوجات/قواعد الخصوصية والوصول بانتظام.

16) مسرد

التفاوض بشأن القدرات - التوفيق بين القدرات المدعومة وصورة العمل.
العقد أولاً - واجهات التصميم من خلال العقود الرسمية قبل التنفيذ.
الفراغ - عمليات أمنية متكررة.
المخطط/الانجراف التعاقدي - التناقض بين الرسائل الفعلية والعقود المعلنة.
إن برنامج العمل هو مبدأ الحد الأدنى من الحقوق الضرورية.
نسبة الامتثال هي النسبة المئوية للرسائل/الطلبات التي تتطابق مع العقد.

خلاصة القول: قابلية التشغيل البيني للمشاركين هي نظام مُدار للعقود والنسخ والقدرات وقابلية الملاحظة. من خلال اتباع هذا الإطار، يوفر النظام البيئي عمليات تكامل سريعة وتدفقات أعمال مستدامة وتطور آمن دون أعطال - من مستوى الشبكة والهويات إلى العمليات والحوكمة.