# صَقِل | 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. تشغيل الاختبارات محلياً:
```bash
cd backend
php artisan test
```

### 2. تشغيل الـAPI محليًا:
```bash
cd backend
php -S 127.0.0.1:8000 -t public
```

الإنتاج يعمل عبر PHP-FPM وNginx مباشرة، ولا يعتمد على Laravel أو Docker.

---

## 📂 مسار التوثيق والتحليلات
- [وثيقة المخطط المعماري والاستراتيجي الشامل (docs/PLATFORM_MASTER_PLAN.md)](./docs/PLATFORM_MASTER_PLAN.md)
- [تحليل الجدوى الشامل (FEASIBILITY_ANALYSIS.md)](./FEASIBILITY_ANALYSIS.md)