# صَقِل | 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` لكل تطبيق. مثال لتطبيق الطالب، من جذر المستودع:

الباك إند PHP أصلي ولا يوجد أمر `artisan` في النسخة المدققة. اقرأ سكربتات الاختبار قبل تشغيلها؛ بعضها يستدعي خدمات خارجية أو يكتب بيانات. خطة اختبارات التكامل المطلوبة موضحة في وثائق المرحلة القادمة. ### 2. تشغيل الـAPI محليًا: من جذر المستودع:

الإنتاج يعمل عبر PHP-FPM وNginx مباشرة، ولا يعتمد على Laravel أو Docker. --- ## 📂 مسار التوثيق والتحليلات **ابدأ بمراجع المرحلة القادمة المعتمدة للتخطيط بتاريخ 2026-09-09:** - [مواصفات المنتج والتعليم ودخل المعلمين](docs/NEXT_PHASE_MASTER_SPEC.md) - [تدقيق الكود: المنفذ والفجوات الفعلية](docs/CURRENT_STATE_AUDIT_2026-09-09.md) - [برومبتات فحص الفيديو وMarkdown والأسئلة ومناقشة الدرس](docs/VIDEO_REVIEW_AND_SOCRATIC_PROMPTS.md) - [مهام التنفيذ واختبارات القبول](docs/NEXT_PHASE_EXECUTION_BACKLOG.md) - [تعليمات النماذج الدائمة](AGENTS.md) هذه الدفعة توثيق فقط، ولا تعني تنفيذ الميزات المخططة أو تحقق تشغيل الإنتاج. الوثائق التالية تاريخية؛ لا تُعتمد ادعاءاتها عن الاكتمال أو المنافسة أو المال عند تعارضها مع التدقيق الأحدث: - [وثيقة المخطط المعماري والاستراتيجي الشامل (docs/PLATFORM_MASTER_PLAN.md)](./docs/PLATFORM_MASTER_PLAN.md) - [تحليل الجدوى الشامل (FEASIBILITY_ANALYSIS.md)](./FEASIBILITY_ANALYSIS.md)