5.1 KiB
5.1 KiB
وثيقة المعمارية المؤسسية والهندسية لمنصة صَقِل (SAQEL Enterprise Architecture Blueprint)
الإصدار: 3.1.0 (Unified Dynamic Multi-Persona App, Guardian Portal, School Admin SaaS & Curriculum Ingestion)
المؤسس والمهندس المعماري للتقنية: الأستاذ حمزة الغويري (Hamza Ayed)
تاريخ الاعتماد والتحديث: 2026-08-28
1. الملخص التنفيذي والرؤية الاستثمارية (Executive Summary & Moat)
منصة صَقِل (Saqel) هي البنية التحتية التعليمية الذكية الأحدث في المملكة الأردنية الهاشمية والشرق الأوسط (MENA). تجمع المنصة بين:
- التطبيق الموحد الذكي للطالب والأسرة: تطبيق واحد يعمل على (Web, Windows, Tablets, Mobile) ويدعم التبديل بين الطالب وولي الأمر فقط. تطبيق المعلم وتطبيق الإدارة مستقلان.
- التعلم السقراطي النشط وسد الثغرات (Productive Struggle & AI Remediation): إرجاع الفيديو عند الخطأ وتوليد فحوصات وتلميحات موجهة لمعالجة نقاط ضعف الطالب اللحظية.
- المعمارية المؤسسية الهجينة (B2B2C Multi-School Ecosystem): ربط مدارس الثقافة العسكرية والمدارس الخاصة عبر كشوفات الأرقام الوطنية (
school_rosters). - بوابة ولي الأمر والأبناء المتعددين (Guardian Portal & Multi-Child Graph): متابعة جاهزية الأبناء وسجل معالجة نقاط الضعف من شاشة واحدة (
/guardian). - لوحة إدارة المدارس السحابية (School Admin SaaS): استيراد كشوفات الطلاب الرقمية ومتابعة تقارير المدرسة (
/school-admin). - محرك تحويل المناهج إلى مارك داون (Curriculum PDF to Markdown Engine): تحويل كتب وزارة التربية والتعليم إلى قاعدة معرفية فائقة السرعة لدعم الذكاء الاصطناعي.
2. معمارية التطبيق الموحد والبوابات (Unified App Routing)
2.1 خريطة البوابات والروابط الرسمية
- بوابة الطالب الذكية:
https://saqel.intaleqapp.com/student - بوابة استوديو المعلم:
https://saqel.intaleqapp.com/teacher - بوابة ولي الأمر التفاعلية:
https://saqel.intaleqapp.com/guardian - لوحة إدارة المدارس والمؤسسات:
https://saqel.intaleqapp.com/school-admin
2.2 دورة الدخول وتعيين كلمة المرور
- المستخدم المسجل مسبقاً: يسجل دخوله برقم هاتفه وكلمة المرور (أو OTP) ليفتح له حسابه فوراً.
- المستخدم الجديد (Zero-Mock Policy): يدخل رقم هاتفه، ويطلب منه النظام ملء نموذج التسجيل الحقيقي (الاسم الكامل، التخصص/الرقم الوطني، كلمة المرور) وتفعيل حسابه بدون أي بيانات وهمية.
3. محرك علاج نقاط الضعف السقراطي (AI Diagnostic & Remediation Loop)
عندما يجيب الطالب على فحص فهم أثناء الحصة:
- في حال الإجابة الصحيحة: يثني النظام على الطالب، يعزز مؤشر الجاهزية (+0.5%)، ويستأنف الفيديو.
- في حال الإجابة الخاطئة:
- يُرجع المشغل الفيديو
Nثوانٍ لإعادة الاستماع للنقطة الجوهرية. - يُسجل المفهوم المتعثر في سجل التشخيص الجنائي (
exam_attempts.weak_topics_json). - يُرسل إشعار مباشر في بوابة ولي الأمر يوضح النقطة التي تعثر فيها الابن وكيف تمت معالجتها.
- يُرجع المشغل الفيديو
4. محرك تحويل وأرشفة المناهج (Curriculum PDF to Markdown Ingestion)
أداة سطر أوامر لتحويل وتفصيص كتب المناهج الرسمية:
php backend/curriculum_converter.php
- تُخزن الملفات في المسار:
backend/storage/curriculum/{subject}/{grade}/. - تُقسم إلى وحدات وفصول ونتاجات تعلم إجرائية وقواعد رياضية لدعم البحث اللحظي وتوليد الأسئلة.
5. البنية السحابية وهندسة البث (Cloud Infrastructure & Zero-Egress R2)
- محرك البث: تقطيع فيديوهات HLS عبر FFmpeg، والتخزين السحابي على Cloudflare R2 بدون رسوم خروج بيانات.
- محرك المحادثات الفورية: خادم Workerman WebSocket على المنفذ 8080 لتوصيل الرسائل والإشعارات في زمن 0ms.
- الأداء العالي: تشغيل مباشر عبر PHP 8.3+ وPHP-FPM وNginx دون Laravel أو Docker.