59 lines
5.1 KiB
Markdown
59 lines
5.1 KiB
Markdown
# وثيقة المعمارية المؤسسية والهندسية لمنصة صَقِل (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). تجمع المنصة بين:
|
|
1. **التطبيق الموحد الذكي للطالب والأسرة:** تطبيق واحد يعمل على (Web, Windows, Tablets, Mobile) ويدعم التبديل بين الطالب وولي الأمر فقط. تطبيق المعلم وتطبيق الإدارة مستقلان.
|
|
2. **التعلم السقراطي النشط وسد الثغرات (Productive Struggle & AI Remediation):** إرجاع الفيديو عند الخطأ وتوليد فحوصات وتلميحات موجهة لمعالجة نقاط ضعف الطالب اللحظية.
|
|
3. **المعمارية المؤسسية الهجينة (B2B2C Multi-School Ecosystem):** ربط مدارس الثقافة العسكرية والمدارس الخاصة عبر كشوفات الأرقام الوطنية (`school_rosters`).
|
|
4. **بوابة ولي الأمر والأبناء المتعددين (Guardian Portal & Multi-Child Graph):** متابعة جاهزية الأبناء وسجل معالجة نقاط الضعف من شاشة واحدة (`/guardian`).
|
|
5. **لوحة إدارة المدارس السحابية (School Admin SaaS):** استيراد كشوفات الطلاب الرقمية ومتابعة تقارير المدرسة (`/school-admin`).
|
|
6. **محرك تحويل المناهج إلى مارك داون (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 دورة الدخول وتعيين كلمة المرور
|
|
1. **المستخدم المسجل مسبقاً:** يسجل دخوله برقم هاتفه وكلمة المرور (أو OTP) ليفتح له حسابه فوراً.
|
|
2. **المستخدم الجديد (Zero-Mock Policy):** يدخل رقم هاتفه، ويطلب منه النظام ملء نموذج التسجيل الحقيقي (الاسم الكامل، التخصص/الرقم الوطني، كلمة المرور) وتفعيل حسابه بدون أي بيانات وهمية.
|
|
|
|
---
|
|
|
|
## 3. محرك علاج نقاط الضعف السقراطي (AI Diagnostic & Remediation Loop)
|
|
|
|
عندما يجيب الطالب على فحص فهم أثناء الحصة:
|
|
- **في حال الإجابة الصحيحة:** يثني النظام على الطالب، يعزز مؤشر الجاهزية (+0.5%)، ويستأنف الفيديو.
|
|
- **في حال الإجابة الخاطئة:**
|
|
1. يُرجع المشغل الفيديو $N$ ثوانٍ لإعادة الاستماع للنقطة الجوهرية.
|
|
2. يُسجل المفهوم المتعثر في سجل التشخيص الجنائي (`exam_attempts.weak_topics_json`).
|
|
3. يُرسل إشعار مباشر في بوابة ولي الأمر يوضح النقطة التي تعثر فيها الابن وكيف تمت معالجتها.
|
|
|
|
---
|
|
|
|
## 4. محرك تحويل وأرشفة المناهج (Curriculum PDF to Markdown Ingestion)
|
|
|
|
أداة سطر أوامر لتحويل وتفصيص كتب المناهج الرسمية:
|
|
```bash
|
|
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.
|