الموارد · Architecture

معمارية Runtime في OpenQCore

معمارية على مستوى النظام لتوجيه المزودين، والتحكم في المسارات، وتوحيد العقود، والاعتمادية التشغيلية للإنتاج.

معمارية التشغيل

نموذج تنفيذي طبقي يبدأ من دخول الطلب وينتهي باستجابة حتمية وتنظيف نهائي.

API Gateway

المصادقة، التحقق من النطاق، تهيئة الطلب، وإنشاء التتبع.

Decision Router

تصنيف النية والوسيط مع اختيار مسار مبني على السياسات.

Execution Engine

تنفيذ Chat/Voice/Iris مع دعم streaming و non-streaming.

Safety Controls

حدود المعدل، الأقفال الموزعة، circuit breakers، وحماية الحمل.

تدفق التنفيذ

Persistence Layer

حفظ رسائل الجلسة، dedup cache، وسجلات الاستخدام/الأحداث.

Provider Connectors

موصلات OpenAI وGemini وClaude وReplicate عبر واجهة موحدة.

Contract Builder

يبني استجابات ثابتة للواجهات والعملاء والأنظمة التابعة.

طبقة المزودين

طبقة تجريد موحدة للمزودين مع توجيه مبني على السياسات وآليات fallback.

OpenAI

المسار الأساسي للمحادثة/الصوت/توليد الصور.

Gemini

مسار متعدد الوسائط للاستدلال مع دعم الصورة.

Claude

مسار احتياطي مركّز على الاستدلال النصي.

Replicate

مسار متخصص لتوليد الصور والفيديو.

توجيه مبني على السياسات

موجّه تجريد المزودين

يختار المزود حسب القدرات، وزمن الاستجابة، وحالة الاعتمادية، وسياسات البيئة.

مصفوفة التوجيه

توزيع مبني على النية مع اختيار أساسي/احتياطي حسب القدرات.

نوع النيةالمسار الأساسيالمسار الاحتياطيعقد المخرجات
محادثة نصيةOpenAI/ClaudeGeminiEnvelope نصي موحد
محادثة صوتيةOpenAI (voice lane)Azure/OpenAI fallbackEnvelope صوت + metadata
توليد صورةOpenAI/ReplicateReplicate/OpenAIمصفوفة images + usage + metadata
توليد فيديوReplicate video laneحسب السياسةمصفوفة videos + metadata

طبقة عقد المخرجات

Envelope استجابة موحد عبر جميع المزودين والوسائط.

{
  "success": true,
  "content": "...",
  "provider": "...",
  "usage": {},
  "metadata": {},
  "images": [],
  "files": [],
  "videos": []
}

ركائز المعمارية

  • نقطة دخول موحدة للمصادقة والتحقق من النطاق والسياسات.
  • توجيه مبني على النية مع استراتيجيات تنفيذ حسب الوسيط.
  • تجريد المزودين يعزل فروقات الموردين عن واجهات المنتج.
  • توحيد العقود يضمن ثبات الواجهة الأمامية وSDKs.

ضمانات الإنتاج

  • تنظيف حتمي للأقفال وتتبع الطلبات المعلقة.
  • خفض تدريجي للأثر عند ضغط النظام أو فشل المزود.
  • تنفيذ قابل للتتبع عبر معرفات الطلب والجلسة وtrace.
  • عقود استجابة ثابتة عبر جميع المزودين.
  • ضوابط تشغيل مناسبة لأحمال إنتاج مؤسسية واسعة النطاق.