3.1 KiB
صَقِل | Saqel Platform 🎓
منصة صَقِل (Saqel) — الجيل الثاني من منصات التعليم التفاعلي لطلبة الثانوية العامة (التوجيهي) في الأردن، والقائمة على فلسفة "صقل الفهم لا الحفظ" بدعم من الذكاء الاصطناعي (EdTech 2.0).
🏛️ الهيكل التقني للمشروع (Tech Stack)
- Backend: PHP 8.3+ / Native PHP REST API with PDO and a lightweight internal Router
- Database: SQLite (Local Development/Testing) / MySQL 8 (Production)
- AI Engine: Google Gemini Flash API (Multimodal / Socratic Tutor / Concept Diagnosis)
- Video & DRM: Bunny Stream (HLS + Dynamic Watermark + DRM)
- Deployment: PHP-FPM/Nginx on the production server; Cloudflare R2 for video and static media
🚀 البدء السريع (Quick Start)
1. تشغيل الاختبارات محلياً:
توجد اختبارات Flutter داخل مجلد test لكل تطبيق. مثال لتطبيق الطالب، من جذر المستودع:
cd apps/student_app
flutter test
الباك إند PHP أصلي ولا يوجد أمر artisan في النسخة المدققة. اقرأ سكربتات الاختبار قبل تشغيلها؛ بعضها يستدعي خدمات خارجية أو يكتب بيانات. خطة اختبارات التكامل المطلوبة موضحة في وثائق المرحلة القادمة.
2. تشغيل الـAPI محليًا:
من جذر المستودع:
cd backend
php -S 127.0.0.1:8000 -t public
الإنتاج يعمل عبر PHP-FPM وNginx مباشرة، ولا يعتمد على Laravel أو Docker.
📂 مسار التوثيق والتحليلات
ابدأ بمراجع المرحلة القادمة المعتمدة للتخطيط بتاريخ 2026-09-09:
- مواصفات المنتج والتعليم ودخل المعلمين
- تدقيق الكود: المنفذ والفجوات الفعلية
- برومبتات فحص الفيديو وMarkdown والأسئلة ومناقشة الدرس
- مهام التنفيذ واختبارات القبول
- تعليمات النماذج الدائمة
هذه الدفعة توثيق فقط، ولا تعني تنفيذ الميزات المخططة أو تحقق تشغيل الإنتاج. الوثائق التالية تاريخية؛ لا تُعتمد ادعاءاتها عن الاكتمال أو المنافسة أو المال عند تعارضها مع التدقيق الأحدث: