الملحق ج – مواصفات بنية نظام OrgBrain (Appendix C – OrgBrain System Architecture Specification)
رقم الوثيقة: MH-25-05-015 · الإصدار: 2.0 · آخر تحديث: 20 مايو 2025
لماذا الإصدار 2.0؟
كشف تدقيق ميتا (Meta-Audit) عن ترابط غير صحي، ونقاط اختناق أحادية، وغياب حواجز حماية للسيادة البيانية (Data Sovereignty). هذا الإصدار يُعيد البناء على أسس: المرونة القائمة على الأحداث (Event-Driven Resilience)، وتدفق السياق دون نسخ (Zero-Copy Context Flow)، وقابلية التوسع المعيارية للتفاعلات (Modular Reflex Extensibility).
1. الملخص التنفيذي (Executive Summary)
تعيد OrgBrain v2.0 بناء هيكلها حول نواة شبكة أحداث (Event Mesh Core) تتعامل مع كل تغيير سياقي باعتباره حدثًا غير قابل للتغيير. يصبح Caesar عقلاً تنفيذياً سياسياً رشيقًا، وليس شرطي مرور، مما يفتح المجال للتوسع الأفقي وتنفيذ آمن يعتمد على الفشل السريع.
2. البنية المنطقية (Logical Architecture)
الطبقة | التقنيات / المكونات |
|---|---|
طبقة الخبرة الخارجية | Slack • Notion • GitHub |
شبكة بوابات الأطراف | Wasm Filters • API Gateway |
نواة شبكة الأحداث | NATS JetStream • Pulsar Streams |
الشكل 1 (الإصدار 2) – البنية المنطقية القائمة على الأحداث (Event-Centric Logical Architecture).
3. التغييرات الجوهرية والمنطق التنفيذي (Key Changes & Rationale)
🔄 التغييرالمشكلة المعالجةالنتيجةنواة شبكة الأحداث بدلًا من RabbitMQنقاط اختناق وتراكم الضغطترتيب عالمي، توسيع أفقي، سجل يمكن إعادة تشغيلهشبكة البوابة الطرفية باستخدام Wasmتشابك في كود الالتقاطتبديل فوري للمحللات، تقليل تواتر النشرمحرك سير زمني للمهام الطويلةمنطق إعادة المحاولة العشوائيسير عمل محدد الإصدار وقابل للتكرارOPA/سياسة ككودتشتت الصلاحياتمصدر واحد للحق، قرارات قابلة للتدقيقبحيرة البيانات (Iceberg on S3)انفصال بين OLTP وOLAPتحليلات بدون نسخ، استعلامات زمنيّةGraphQL Federationواجهات REST متعددةعقد موحد، استعلامات ذاتية الخدمةنواة الإضافات لحزم التفاعلالحاجة لإعادة بناء النواةإضافة/تحديث دون إعادة نشر النواةتتبع موزّع (OpenTelemetry + Tempo)نقاط عمياء في حلقات الأحداثخفض وقت الإصلاح بنسبة 95٪
4. مسؤوليات الطبقات (Layer Responsibilities – v2)
الطبقةالتقنية الأساسيةالمسؤولياتشبكة البوابة الطرفيةEnvoy + Proxy-Wasm, OpenAPIالمصادقة، تحديد المعدلات، التحقق من البنيةنواة شبكة الأحداثNATS JetStream, Pulsarنشر/اشتراك قابل للتكرار، معالجة بلا فقدوقت تشغيل التفاعل (Reflex Runtime)Deno Deploy + V8تنفيذ محمي لأوامر التفاعل والأكوادالسياق البياني (Context Graph)Neo4j + ElasticSearchعلاقات الكيانات، البحث النصي الكاملالسياسة والامتثالOPA, HashiCorp Vaultمحرك قرارات لحظي، إدارة الأسرارخدمات التسييلStripe Billing API + License APIإصدار المنتجات، الاستخدام المقنن، الدفع لكل تفاعلالتخزين وبحيرة البياناتApache Iceberg on S3, Postgresوقائع غير قابلة للتغيير، كتابات سياقية آمنة
5. تدفق الحدث النموذجي (Sample Event Flow)
الالتقاط: تعديل في Notion يُفعل Webhook → حدث
notion.page.updated.البث: يُنشر الحدث على
ingest.notionعبر JetStream بتوقيع JWT.المعالجة: يشترك Reflex Runtime كمستهلك دائم، ويُشغّل تحديث السياق.
التخزين: يُكتب إلى Context Graph وLakehouse ويُصدر
context.graph.node_upserted.بوابة السياسة: OPA يُقيّم قابلية التسييل؛ إذا صح، يُصدر
reflex.package.candidate.التسييل: تُنشئ License API منتج SKU أولي؛ يُربط مع رابط Stripe Checkout.
الإشعار: تدفع البوابة رسالة Slack مؤقتة تحتوي على مرجع TimeToken.
6. تحسينات الأمان والسيادة (Security & Sovereignty Enhancements)
توقيع MAC على مستوى الحدث – ضمان كشف العبث بالسياق.
مفاتيح تشفير مخصصة لكل جهة (مشفّرة عبر KMS) – تضمن السيادة البيانية للتنفيذات المدرسية.
تنفيذ حق النسيان (GDPR R2T) عبر أحداث Tombstone ومتجهات حذف Iceberg.
7. التشغيل والرصد (Ops & Observability)
٤ إشارات ذهبية لكل تفاعل: زمن الاستجابة، الخطأ، التشبع، القيمة (SAR المتولدة).
عمليات النشر Red/Black مع تراجع تلقائي عند تجاوز تأخر P99 نسبة 20٪.
اختبارات الفوضى (Chaos Mesh) تُحقن أسبوعيًا ضمن بروتوكول الحارس الموثوق (Trust Sentinel).
8. خارطة الطريق بعد الإصدار 2.0 (Roadmap Beyond v2.0)
الاستدلال الطرفي (Edge Inference): نماذج LLM صغيرة عند البوابة لترتيب السياق مسبقًا.
SDK السوق – الإصدار الثاني: أداة دفع ذاتية لأطراف خارجية من الخوارزميين (Algorithmists).
تحليلات بدون ETL: استعلامات مباشرة على بحيرة DuckDB من لوحات تحكم BI.