70 lines
3.1 KiB
Markdown
70 lines
3.1 KiB
Markdown
<div dir="rtl" align="right">
|
|
|
|
# صَقِل | 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` لكل تطبيق. مثال لتطبيق الطالب، من جذر المستودع:
|
|
|
|
</div>
|
|
|
|
```bash
|
|
cd apps/student_app
|
|
flutter test
|
|
```
|
|
|
|
<div dir="rtl" align="right">
|
|
|
|
الباك إند PHP أصلي ولا يوجد أمر `artisan` في النسخة المدققة. اقرأ سكربتات الاختبار قبل تشغيلها؛ بعضها يستدعي خدمات خارجية أو يكتب بيانات. خطة اختبارات التكامل المطلوبة موضحة في وثائق المرحلة القادمة.
|
|
|
|
### 2. تشغيل الـAPI محليًا:
|
|
|
|
من جذر المستودع:
|
|
|
|
</div>
|
|
|
|
```bash
|
|
cd backend
|
|
php -S 127.0.0.1:8000 -t public
|
|
```
|
|
|
|
<div dir="rtl" align="right">
|
|
|
|
الإنتاج يعمل عبر 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)
|
|
|
|
</div>
|
|
|