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

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