الموارد · 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/Claude | Gemini | Envelope نصي موحد |
| محادثة صوتية | OpenAI (voice lane) | Azure/OpenAI fallback | Envelope صوت + metadata |
| توليد صورة | OpenAI/Replicate | Replicate/OpenAI | مصفوفة images + usage + metadata |
| توليد فيديو | Replicate video lane | حسب السياسة | مصفوفة videos + metadata |
طبقة عقد المخرجات
Envelope استجابة موحد عبر جميع المزودين والوسائط.
{
"success": true,
"content": "...",
"provider": "...",
"usage": {},
"metadata": {},
"images": [],
"files": [],
"videos": []
}ركائز المعمارية
- نقطة دخول موحدة للمصادقة والتحقق من النطاق والسياسات.
- توجيه مبني على النية مع استراتيجيات تنفيذ حسب الوسيط.
- تجريد المزودين يعزل فروقات الموردين عن واجهات المنتج.
- توحيد العقود يضمن ثبات الواجهة الأمامية وSDKs.
ضمانات الإنتاج
- تنظيف حتمي للأقفال وتتبع الطلبات المعلقة.
- خفض تدريجي للأثر عند ضغط النظام أو فشل المزود.
- تنفيذ قابل للتتبع عبر معرفات الطلب والجلسة وtrace.
- عقود استجابة ثابتة عبر جميع المزودين.
- ضوابط تشغيل مناسبة لأحمال إنتاج مؤسسية واسعة النطاق.
