أكاديميرا

# عن منصة Academyra للتعليم الإلكتروني

أهلاً بكم في **Academyra**، المنصة التعليمية المتكاملة التي تهدف إلى إحداث ثورة في تجربة التعلم عبر الإنترنت. تم تصميم منصتنا لتكون بيئة تفاعلية وشاملة تجمع بين الطلاب، والمعلمين، وإدارة المؤسسات التعليمية في مكان واحد، مما يسهل عملية تبادل المعرفة وتحقيق الأهداف التعليمية بكفاءة عالية.

## رؤيتنا

نسعى في Academyra إلى تمكين المتعلمين من الوصول إلى محتوى تعليمي عالي الجودة في أي وقت ومن أي مكان، وتوفير أدوات متطورة للمعلمين تتيح لهم تقديم المادة العلمية ومتابعة تقدم طلابهم بأفضل الطرق الممكنة.

## مميزات المنصة

### 🎓 تجربة تعلم مخصصة للطلاب

- **المواد والدروس:** تصفح مجموعة واسعة من المواد الدراسية، الدروس، والمحاضرات المصورة.

- **التفاعل المباشر:** إمكانية طرح الأسئلة على المحاضرات، بالإضافة إلى تقييم الدروس لتعزيز جودة المحتوى.

- **الاختبارات والتقييم:** نظام امتحانات شامل يتيح للطلاب اختبار معرفتهم والحصول على تقييم فوري ونظرة مفصلة على نتائجهم.

- **المتجر والاشتراكات:** توفر المنصة باقات واشتراكات مرنة تتيح للطلاب الوصول إلى المحتوى المتميز بسهولة وبطرق دفع آمنة ومتعددة.

- **متابعة التقدم الشخصي:** ملف شخصي شامل يتيح للطالب متابعة تقدمه وإنجازاته عبر المنصة.

### 👨‍🏫 أدوات متقدمة للمعلمين والإدارة

- **لوحة تحكم شاملة:** واجهة سهلة الاستخدام تتيح للإدارة مراقبة الأداء العام، من أرباح واشتراكات إلى إحصائيات تفصيلية للطلاب والمعلمين.

- **إدارة المحتوى:** سهولة تنظيم وإنشاء المستويات الدراسية (Levels & Sub-levels)، المواد، الامتحانات، والمنتجات التعليمية.

- **متابعة أداء الطلاب (Student Progress):** أدوات دقيقة لمتابعة أداء كل طالب على حدة، بما في ذلك استعراض نتائج الامتحانات، الأسئلة المطروحة، وتقييمات الدروس.

- **إدارة المبيعات والاشتراكات:** متابعة دورية للاشتراكات والخطط التعليمية التي يشترك بها الطلاب لضمان استمرارية العملية التعليمية بسلاسة.

## لماذا تختار Academyra؟

- **سهولة الاستخدام:** واجهة مستخدم عصرية وبديهية تضمن تجربة سلسة لكل من الطالب والمعلم.

- **تنوع المحتوى:** هيكلة منظمة للمستويات والصفوف التعليمية تلبي احتياجات مختلف الفئات والمراحل الدراسية.

- **تواصل مستمر:** بيئة داعمة تشجع على النقاش وطرح الأسئلة مما يعزز من الفهم والاستيعاب والنمو الأكاديمي.

نحن في Academyra نؤمن بأن التعليم هو مفتاح المستقبل، ونسخر كافة إمكانياتنا التقنية والتعليمية لتوفير بيئة تلهم العقول وتصنع قادة الغد.

# التقنيات والأدوات المستخدمة في مشروع Academyra

يعتمد مشروع Academyra على أحدث التقنيات وأطر العمل لبناء منصة تعليمية قوية وموثوقة. فيما يلي قائمة تفصيلية باللغات، وأطر العمل، والحزم البرمجية المستخدمة في النظام:

## 1. لغات البرمجة (Programming Languages)

- **PHP 8.2+**: لغة البرمجة الأساسية للواجهة الخلفية (Backend).

- **TypeScript & JavaScript**: لغات البرمجة الأساسية للواجهة الأمامية (Frontend).

## 2. إطار العمل الخلفي (Backend Framework)

تم بناء الواجهة الخلفية باستخدام **Laravel v13.0**، بالإضافة إلى حزم أساسية تشمل:

- **Laravel Sanctum**: لإدارة المصادقة (Authentication) وحماية مسارات الـ API.

- **Spatie Laravel Permission**: لإدارة الأدوار والصلاحيات للمستخدمين (مدير، معلم، طالب).

- **Laravel Scout**: لتوفير ميزة البحث النصي السريع والمتقدم.

- **Laravel Subscriptions (`laravelcm`)**: للتحكم وإدارة خطط واشتراكات الطلاب.

- **Ziggy (`tightenco/ziggy`)**: لمشاركة مسارات Laravel مع الواجهة الأمامية بسلاسة.

- **Mews Purifier**: لتنظيف وتأمين مدخلات HTML.

## 3. إطار العمل الأمامي (Frontend Framework)

الواجهة الأمامية مبنية كتطبيق صفحة واحدة (SPA) باستخدام:

- **React (v19)**: مكتبة بناء واجهات المستخدم.

- **Inertia.js (v3)**: للربط المباشر بين Laravel و React دون الحاجة لبناء API معقدة.

- **Vite**: أداة تجميع وبناء المشروع (Build Tool) للحصول على أداء تطوير سريع جداً.

## 4. تصميم واجهة المستخدم (UI & Styling)

- **Tailwind CSS**: إطار العمل الأساسي لتنسيق التصميم بسرعة ومرونة.

- **Ant Design (AntD v6)**: مكتبة مكونات واجهة مستخدم (Components) جاهزة ومتقدمة.

- **Framer Motion**: لإضافة حركات وتأثيرات بصرية (Animations) تفاعلية للمنصة.

- **Lucide React & Heroicons**: مكتبات لتوفير الأيقونات عالية الجودة.

## 5. إدارة الحالة والبيانات (State Management & Validation)

- **Redux Toolkit**: لإدارة الحالة المركزية للتطبيق (State Management).

- **Axios**: لإرسال واستقبال طلبات HTTP.

- **Zod**: للتحقق من صحة البيانات المدخلة (Schema Validation).

- **Day.js & Moment.js**: للتعامل مع التواريخ والأوقات وتنسيقها.

## 6. عرض وإدارة الوسائط والمحتوى (Media & Content)

- **@mux/mux-player-react & Video.js**: لتشغيل الفيديوهات والمحاضرات المصورة بأعلى كفاءة.

- **PDF.js (`pdfjs-dist`)**: لعرض ملفات ومذكرات الـ PDF مباشرة داخل المتصفح.

- **React Quill New**: محرر نصوص غني (Rich Text Editor) لكتابة الأسئلة والوصف.

- **DOMPurify**: لتنظيف كود HTML في الواجهة الأمامية للحماية من هجمات XSS.

## 7. الدفع الإلكتروني (Payment Integrations)

- **Stripe**: مدمج في الخلفية (`stripe-php`) والأمامية (`@stripe/react-stripe-js`) لمعالجة مدفوعات البطاقات البنكية.

- **PayPal (`@paypal/react-paypal-js`)**: لتوفير خيار الدفع عبر حسابات باي بال.

## 8. التخزين والخدمات السحابية

- **Flysystem Google Drive**: حزمة (`masbug/flysystem-google-drive-ext`) لربط النظام بخدمة Google Drive لتخزين ورفع الملفات بأمان.

- **Twilio SDK**: لدمج خدمات الرسائل النصية (SMS) والتواصل المباشر.

---

تم اختيار هذه الحزم بعناية لضمان أداء مستقر، وسرعة في التطوير، وأمان عالٍ للمنصة ومستخدميها.