feat: Initial commit for Saqel Platform architecture, backend, Docker, and documentation

2026-08-26 15:45:55 +03:00
commit d53b64500a
177 changed files with 19909 additions and 0 deletions
@@ -0,0 +1,34 @@
+# صَقِل | Saqel Platform 🎓
+
+**منصة صَقِل (Saqel)** — الجيل الثاني من منصات التعليم التفاعلي لطلبة الثانوية العامة (التوجيهي) في الأردن، والقائمة على فلسفة "صقل الفهم لا الحفظ" بدعم من الذكاء الاصطناعي (EdTech 2.0).
+
+---
+
+## 🏛️ الهيكل التقني للمشروع (Tech Stack)
+
+- **Backend:** PHP 8.3+ / Laravel 11 / RESTful APIs
+- **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:** Docker & Docker Compose (`saqel_app`, `saqel_nginx`, `saqel_mysql`, `saqel_queue`)
+
+---
+
+## 🚀 البدء السريع (Quick Start)
+
+### 1. تشغيل الاختبارات محلياً:
+```bash
+cd backend
+php artisan test
+```
+
+### 2. تشغيل السيرفر عبر Docker:
+```bash
+docker compose up -d --build
+```
+
+---
+
+## 📂 مسار التوثيق والتحليلات
+- [وثيقة المخطط المعماري والاستراتيجي الشامل (docs/PLATFORM_MASTER_PLAN.md)](./docs/PLATFORM_MASTER_PLAN.md)
+- [تحليل الجدوى الشامل (FEASIBILITY_ANALYSIS.md)](./FEASIBILITY_ANALYSIS.md)