Smart Learning Systems (SLS)

📋 نظرة عامة

SLS هو نظام ويب متكامل لإدارة المدارس والمراكز التعليمية.
يوفر وظائف أساسية مثل إدارة الطلاب، الحضور، الدرجات، الاشتراكات، والمراسلة الفورية بين المعلمين والطلاب.
يدعم تصدير التقارير (PDF / Excel) بالإضافة إلى تطبيق أندرويد يعرض المنصة داخل WebView.

🛠️ التقنيات المستخدمة

الخادم (Backend): PHP (PDO، جلسات، Bootstrap RTL)

قاعدة البيانات: MySQL / MariaDB

المراسلة الفورية: Ratchet WebSocket + ReactPHP HTTP Notify

التقارير: dompdf و mPDF مع دعم الخطوط العربية

التطبيق: Android (Gradle – WebView)

✨ المميزات الأساسية

إدارة الطلاب (إضافة، تعديل، حذف، موافقات)

إدارة الاشتراكات والمدفوعات

تسجيل الحضور وتقارير الغياب والحضور

إدارة الدرجات والتقارير الأكاديمية

مراسلة فردية وجماعية مع مرفقات وتتبع القراءة ومؤشر الكتابة

تثبيت الرسائل وجدولة إرسالها عبر مهام مجدولة

تصدير جميع البيانات إلى PDF وExcel
⚙️ المتطلبات

PHP 8.0+ مع الامتدادات: PDO، JSON، mbstring، OpenSSL، fileinfo

MySQL 5.7+ أو MariaDB 10.3+

Composer 2+

Apache/Nginx + PHP + MySQL (مثال XAMPP أو WAMP)

منافذ 8080 (WebSocket) و8081 (HTTP Notify)
🗄️ قاعدة البيانات (مختصر)

students: بيانات الطلاب.

grades: الدرجات.

attendance: الحضور والغياب.

messages: المراسلات.

subscriptions: الاشتراكات.

pinned_messages: الرسائل المثبتة.

scheduled_messages: الرسائل المجدولة.

typing_status: حالة الكتابة.

📱 تطبيق الأندرويد

مبني على WebView.

إشعارات فورية.

دليل بناء APK موجود في: android_app/BUILD_APK_GUIDE.md.

🔒 الأمان

استخدام CSRF Tokens.

تشفير كلمات المرور Bcrypt.

فلترة المدخلات.

صلاحيات مخصصة (مدير – مدرس – طالب).

🌐 دعم الـ Multi-Tenant (مراكز متعددة)

جداول tenants, tenant_settings.

إضافة tenant_id لكل جدول رئيسي.

رفع الملفات حسب tenant_slug.

WebSocket مهيأ لمعرفة المستأجر من عنوان الاتصال.

📝 الترخيص والدعم

الترخيص: خاص (أو MIT عند التعميم).

الدعم: من خلال فريق التطوير أو قناة SLS.

💡 Smart Learning Systems (SLS) هو حل متكامل للمراكز التعليمية والمدارس، يدمج الإدارة الأكاديمية والتواصل الفوري والتقارير في منصة واحدة قابلة للتوسع مع دعم Multi-Tenant.