Update Saqel Platform: 2026-09-02 00:55:56

docs/IMPLEMENTATION_STATUS.md

@@ -0,0 +1,38 @@
+# حالة تنفيذ منصة صَقِل
+
+آخر تحديث: 2026-09-02
+
+هذه الوثيقة تفصل بين ما هو موجود في الكود وما هو جزء من الرؤية المستقبلية.
+
+## منفذ فعليًا
+
+- تطبيق Flutter موحد للطالب وولي الأمر.
+- تسجيل الدخول عبر OTP والرقم الوطني مع تخزين آمن للتوكن.
+- شجرة مناهج ديناميكية من الخادم ومحتوى فعلي للصف العاشر.
+- رفع الفيديو، تحويله إلى HLS عبر FFmpeg، ورفع حزمة HLS إلى Cloudflare R2.
+- تشغيل الفيديو عبر HLS من R2 أو المسار المحلي عند عدم توفر R2.
+- فحوص سقراطية مرتبطة بالدرس من قاعدة البيانات.
+- بوابات Web للطالب والمعلم وولي الأمر واستوديو المناهج.
+- API للامتحانات والمحاولات والتحليلات والمحادثة وتقييم المعلم.
+
+## منفذ جزئيًا
+
+- تطبيق المعلم Flutter: shell ترحيبي فقط؛ الاستخدام الحالي للمعلم عبر Web Studio.
+- امتحانات Flutter: واجهة أولية تحتاج ربطًا كاملًا بواجهات `/api/exams`.
+- تنزيل موارد PDF: واجهة تحتاج ربطًا فعليًا بالملف.
+- مؤشر الجاهزية: مصدره الخادم في التحليلات، ويحتاج استكمال عرضه وتحديثه في الشاشات.
+- حماية الفيديو: HLS/R2 متوفران، أما DRM ومنع التسجيل فيحتاجان تكاملًا إنتاجيًا.
+
+## غير منفذ بعد
+
+- تطبيق الإدارة Flutter.
+- RAG كامل مع Embeddings ومصادر إجابة قابلة للتتبع.
+- تنبيهات ولي الأمر الفورية داخل التطبيق.
+- خوارزمية تكيفية إنتاجية متعددة المفاهيم.
+
+## المعمارية المعتمدة
+
+- Backend: Native PHP 8.3+، PDO، Router داخلي، PHP-FPM/Nginx.
+- Storage: Cloudflare R2 لحزمة HLS والملفات، مع تخزين محلي مؤقت أثناء التحويل.
+- Apps: `student_app` موحد للطالب وولي الأمر، `teacher_app` مستقل، و`admin_app` مستقل.
+- لا يعتمد التشغيل على Laravel أو Docker.

docs/PLATFORM_MASTER_PLAN.md

@@ -23,7 +23,7 @@
                                                       │ HTTPS / REST API / JWT + Device Fingerprint
                                                       │
                                  ┌────────────────────▼────────────────────┐
-                                 │    Laravel 11 API Gateway (PHP 8.3)     │
+                                 │       Native PHP API Gateway (PHP 8.3+) │
                                  │  (Zero-Trust Auth / Queues / Logic)     │
                                  └────────┬───────────────┬────────────────┘
                                           │               │
@@ -80,13 +80,13 @@ saqel/
 │   ├── student_app/             # تطبيق صَقِل الموحد (الطالب: كويزات وفيديوهات + ولي الأمر: تقارير الأبناء)
 │   ├── teacher_app/             # تطبيق المعلم (رفع المواد، كويزات، تقارير المبيعات والأرباح)
 │   └── admin_app/               # تطبيق الإدارة ومديري المدارس (B2B Management)
-├── backend/                     # مشروع Laravel 11 / Native PHP 8.3 API Gateway
+├── backend/                     # Native PHP 8.3 API Gateway + PDO + Router
 │   ├── app/Controllers/         # وحدات التحكم بالـ APIs
 │   ├── app/Services/            # خدمات AI، و Nabeh WhatsApp Gateway، و Curriculum
 │   └── database/                # مخطط قاعدة البيانات
 ├── docs/                        # وثائق التخطيط والتحليل
 │   └── PLATFORM_MASTER_PLAN.md  # هذا المرجع المعماري الشامل
-├── docker-compose.yml           # حاويات: saqel_app, saqel_nginx, saqel_mysql, saqel_queue
+├── docs/                        # وثائق الخطة وحالة التنفيذ
 └── README.md                    # دليل التشغيل السريع
 ```
 

docs/SAQEL_ENTERPRISE_ARCHITECTURE.md

@@ -7,7 +7,7 @@
 
 ## 1. الملخص التنفيذي والرؤية الاستثمارية (Executive Summary & Moat)
 منصة **صَقِل (Saqel)** هي البنية التحتية التعليمية الذكية الأحدث في المملكة الأردنية الهاشمية والشرق الأوسط (MENA). تجمع المنصة بين:
-1. **التطبيق الموحد الذكي (Unified Dynamic App Shell):** تطبيق واحد متعدد الهويات يعمل على (Web, Windows, Tablets, Mobile) ويدعم التبديل السلس بين الأدوار (طالب، معلم، ولي أمر).
+1. **التطبيق الموحد الذكي للطالب والأسرة:** تطبيق واحد يعمل على (Web, Windows, Tablets, Mobile) ويدعم التبديل بين الطالب وولي الأمر فقط. تطبيق المعلم وتطبيق الإدارة مستقلان.
 2. **التعلم السقراطي النشط وسد الثغرات (Productive Struggle & AI Remediation):** إرجاع الفيديو عند الخطأ وتوليد فحوصات وتلميحات موجهة لمعالجة نقاط ضعف الطالب اللحظية.
 3. **المعمارية المؤسسية الهجينة (B2B2C Multi-School Ecosystem):** ربط مدارس الثقافة العسكرية والمدارس الخاصة عبر كشوفات الأرقام الوطنية (`school_rosters`).
 4. **بوابة ولي الأمر والأبناء المتعددين (Guardian Portal & Multi-Child Graph):** متابعة جاهزية الأبناء وسجل معالجة نقاط الضعف من شاشة واحدة (`/guardian`).
@@ -55,4 +55,4 @@ php backend/curriculum_converter.php
 ## 5. البنية السحابية وهندسة البث (Cloud Infrastructure & Zero-Egress R2)
 - **محرك البث:** تقطيع فيديوهات HLS عبر FFmpeg، والتخزين السحابي على Cloudflare R2 بدون رسوم خروج بيانات.
 - **محرك المحادثات الفورية:** خادم Workerman WebSocket على المنفذ 8080 لتوصيل الرسائل والإشعارات في زمن 0ms.
-- **الأداء العالي:** تشغيل مباشر عبر PHP 8.4 و PHP-FPM دون حاجة لـ Docker.
+- **الأداء العالي:** تشغيل مباشر عبر PHP 8.3+ وPHP-FPM وNginx دون Laravel أو Docker.