Files
saqel/docs/IMPLEMENTATION_STATUS.md
T

2.3 KiB

حالة تنفيذ منصة صَقِل

آخر تحديث: 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.