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

2026-09-02 00:55:56 +03:00
parent 1c0cd88a98
commit f4ab43d49a
18 changed files with 409 additions and 214 deletions
@@ -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.