الإصدار 2.7.0

# نظام إدارة المدرسه الذكيه

منصة متعددة المؤسسات شاملة لإدارة المدارس والأكاديميات التعليميه

ابدأ الآن

## ما هو نظام AI School؟

نظام إدارة مؤسسات تعليمية متعدد الاستخدام مثل المدارس والأكاديميات ومراكز التدريب، مصمم بأحدث التقنيات لتوفير تجربة سلسة وفعالة.

- إدارة متكاملة للطلاب والمعلمين والدورات
- نظام مدفوعات وأقساط متقدم
- تتبع الحضور والدرجات والتقييمات
- عزل كامل للبيانات بين الفروع (Multi-Tenancy)
- تقارير شاملة وإحصائيات مفصلة
- دعم كامل للغة العربية

4
لوحات تحكم رئيسية
50+
ميزة متقدمة
100%
موثوقية عالية
88%
نسبة الإكمال

## المميزات الرئيسية

نظام شامل يدعم جميع جوانب إدارة المؤسسات التعليمية

##### إدارة الطلاب والمعلمين

نظام متقدم لإدارة بيانات الطلاب والمعلمين مع دعم التصنيفات والفئات المختلفة

##### إدارة الكورسات والمجموعات

نظام شامل لإدارة الكورسات والمجموعات الدراسية مع جدولة الجلسات

##### إدارة المدفوعات والأقساط

نظام متقدم لإدارة المدفوعات والأقساط مع ملاحقة التأخير والتذكيرات

##### تتبع الحضور والدرجات

نظام شامل لتتبع الحضور والدرجات والتقييمات مع تقارير تفصيلية

##### التقارير والإحصائيات

تقارير شاملة وإحصائيات مفصلة لجميع جوانب المؤسسة التعليمية

##### أمان ومتعدد المؤسسات

عزل كامل للبيانات بين المؤسسات مع نظام أدوار وصلاحيات متقدم

## لوحات التحكم الرئيسية

أربع واجهات متخصصة لكل دور في المinstitution

##### لوحة الإدارة (Admin Panel)

لوحة التحكم الرئيسية لمسؤول المؤسسة تتضمن:

- إدارة كاملة للطلاب والمعلمين والموظفين
- إدارة الكورسات والمجموعات والجدولة
- تقارير مالية وإدارة المدفوعات
- نظام الرسائل والإشعارات
- الإعدادات والتخصيصات المتقدمة
- صلاحيات كاملة على جميع الموارد

##### لوحة المعلم (Instructor Panel)

لوحة متخصصة للمعلمين تتضمن:

- عرض الجروبات والطلاب المسجلين
- تسجيل الحضور والدرجات
- رفع المواد التعليمية والملفات
- تقييم أداء الطلاب
- رسائل الاتصال مع الطلاب
- إحصائيات الحضور والأداء

##### لوحة الطالب (Student Portal)

بوابة الويب المتخصصة للطلاب تتضمن:

- متابعة التقدم الدراسي والنسب المئوية
- عرض الدرجات والتقييمات
- تتبع الحضور والغياب
- عرض الواجبات والمواد التعليمية
- عرض حالة المدفوعات والأقساط
- التواصل مع المعلم والإدارة

##### بوابة الآباء (Parent Portal)

بوابة خاصة لأولياء الأمور توفر:

- متابعة تقدم الأبناء الدراسي
- عرض الدرجات والتقييمات
- تتبع الحضور والغياب
- عرض الفواتير والمدفوعات
- تقييم المعلم والمؤسسة
- الاتصال بالإدارة في الحالات الطارئة

## نظام الأدوار والصلاحيات

نظام متقدم للتحكم الدقيق في الصلاحيات

مدير النظام العام (Super Admin)
صلاحيات كاملة
مدير النظام الكامل الذي يدير جميع المؤسسات والمستخدمين
إدارة المؤسسات إدارة الأدوار إدارة المستخدمين 63 صلاحية
مسؤول المؤسسة (Admin)
صلاحيات موسعة
مدير المؤسسة التعليمية يدير جميع جوانب المؤسسة
إدارة الطلاب إدارة المعلمين إدارة الكورسات 49 صلاحية
المعلم الأكاديمي (Instructor)
صلاحيات محدودة
المعلم يدير جروباته وطلابه والعمليات الأكاديمية
تسجيل الحضور إدخال الدرجات رفع المواد 20+ صلاحية
مستخدم عادي (User)
صلاحيات أساسية
مستخدم عادي بصلاحيات محدودة جداً
عرض البيانات عمليات أساسية 10+ صلاحية

##### ملخص الصلاحيات على الموارد

النظام يدعم 9 موارد رئيسية (الطلاب، الكورسات، المعلمين، الدفع، المجموعات، الجدولة، التقارير، الإعدادات، إدارة المؤسسة) وكل مورد يحتوي على 7 عمليات (عرض، إنشاء، تعديل، حذف، استرجاع، حذف نهائي، عمليات خاصة)

## التقنيات والمكتبات

نظام مبني على أحدث التقنيات الويب

##### Backend

Laravel 12 PHP 8.3+ Eloquent ORM Filament 4 Spatie Permission Tenancy

##### Frontend

Bootstrap 5 Livewire Alpine.js Node.js npm Webpack

##### Database & Infrastructure

MySQL 8+ Redis Cache Queue System Seeding & Migrations Global Scopes Policies

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

- عزل البيانات بين المؤسسات (Multi-Tenancy)
- نظام الأدوار والصلاحيات المتقدم
- التسجيل والتدقيق (Activity Logging & Auditing)
- واجهة إدارة احترافية (Filament Admin Panel)
- دعم كامل للغة العربية (RTL)
- API RESTful متكامل
- نظام الإخطارات والرسائل
- التقارير المتقدمة والإحصائيات

## دليل البدء السريع

تثبيت واستخدام النظام خطوة بخطوة

الخطوة 1
شروط النظام والتثبيت
المتطلبات:

- PHP 8.3 أو أحدث
- MySQL 8 أو أحدث
- Node.js 18+ وnpm
- Composer

الخطوة 2
استنساخ المشروع وتثبيت المكتبات
git clone <repository-url>
cd "Ai School"
composer install
npm install
الخطوة 3
إعداد البيئة وقاعدة البيانات
cp .env.example .env
php artisan key:generate
php artisan migrate:fresh --seed
الخطوة 4
تشغيل النظام
نافذة طرفية 1:
php artisan serve
نافذة طرفية 2:
npm run dev
الوصول إلى:
http://127.0.0.1:8000/admin
الخطوة 5
بيانات الدخول الافتراضية
البريد الإلكتروني:
admin@example.local
كلمة المرور:
password

أو استخدم أي بيانات معرفة في seeders

###### نصائح مهمة

- استخدم الأوامر الموجودة في terminal فقط، لا تستخدم صيغ أخرى
- تأكد من تثبيت جميع المتطلبات قبل البدء
- استخدم قاعدة بيانات منفصلة للتطوير
- لا تشارك بيانات الدخول في الإنتاج
- قم بنسخ احتياطي من قاعدة البيانات بانتظام

## الملفات التوثيقية

مراجع شاملة لكل جانب من جوانب النظام

##### README.md

نظرة عامة على المشروع والموارد

##### ARCHITECTURE_PLAN.md

المعمارية والتصميم

##### ROLES_AND_PERMISSIONS_GUIDE.md

الأدوار والصلاحيات

##### USER_GUIDE.md

دليل المستخدم الشامل

تجد جميع الملفات التوثيقية في مجلد المشروع الرئيسي

## الأسئلة الشائعة

##

Super Admin: مدير النظام الذي يدير جميع المؤسسات والأدوار والصلاحيات وله وصول كامل لكل شيء.
Admin: مسؤول المؤسسة الفردية الذي يدير جوانب مؤسسته فقط دون الوصول لإدارة الأدوار أو المؤسسات الأخرى.

##

نعم، النظام يدعم تعديل الأدوار والصلاحيات من خلال لوحة التحكم، لكن فقط المسؤولون بصلاحيات كاملة يمكنهم القيام بذلك.

##

Multi-Tenancy يعني أن النظام الواحد يمكن أن يخدم عدة مؤسسات بنفس الوقت مع عزل كامل للبيانات بينهم. كل مؤسسة ترى بيانات نفسها فقط.

##

النظام يدعم عدد غير محدود من المستخدمين. الأداء يعتمد على مواصفات الخادم وقاعدة البيانات.

##

النظام الحالي يدعم تسجيل المدفوعات يدويًا. يمكن إضافة بوابات دفع مثل Stripe أو Fawry في المستقبل.

## حالة الإكمال الحالية

ملخص موجز لما تم إنجازه وما تحت التطوير

##### المميزات المكتملة (88%)

- لوحات التحكم الأربع (Admin, Instructor, Student, Parent)
- إدارة الطلاب والمعلمين والموظفين
- إدارة الكورسات والمجموعات الدراسية
- نظام الجدولة والحصص
- نظام المدفوعات والأقساط
- نظام الحضور والدرجات
- نظام الأدوار والصلاحيات
- نظام الإشعارات والرسائل
- نظام التقارير المتقدمة

##### تحت التطوير (12%)

- تحسينات على نظام الحضور المتقدم
- نظام الشهادات والتخرج
- التقييمات والاستطلاعات
- نظام الواجبات والمشاريع
- المزيد من خيارات التقارير
- تكاملات إضافية

###### جاهز للاستخدام الفوري في الإنتاج

النظام قد تم اختباره جيدًا وجاهز للاستخدام الفعلي في المؤسسات التعليمية. يمكن البدء باستخدامه فورًا مع إمكانية إضافة المزيد من الميزات حسب الحاجة.

## معمارية النظام

كيفية تفاعل مكونات النظام مع بعضها

واجهة المستخدم
Admin Panel • Student Portal • Instructor Panel • Parent Portal
↓
طبقة التطبيق
Controllers • Services • Actions • Events
↓
طبقة البيانات
Models • Eloquent ORM • Global Scopes • Policies
↓
قاعدة البيانات
MySQL Database • Multi-Tenant Tables • Relationships

## المميزات الرئيسية بالتفصيل

##### إدارة الطلاب

نظام متقدم لإدارة بيانات الطلاب وتتبع تقدمهم الدراسي والمالي

##### إدارة المعلمين

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

##### إدارة الكورسات

نظام شامل لإدارة الكورسات والمجموعات والمواد التعليمية

##### الجدولة والحصص

نظام ذكي لجدولة الحصص والسيشنات مع تجنب التضارب

##### المدفوعات والأقساط

نظام متطور لإدارة المدفوعات والأقساط والملاحقة

##### التقارير والتحليلات

تقارير شاملة وإحصائيات مفصلة لجميع جوانب المشروع

## الدعم والمساعدة

##### الدليل الشامل

راجع دليل المستخدم الشامل للإجابة على جميع أسئلتك

##### المجتمع

تواصل مع المطورين الآخرين واستفسر عن الأفكار والحلول

##### التواصل المباشر

يمكنك التواصل مع فريق الدعم مباشرة عند الحاجة

##### عرض توضيحي للنظام

النظام متاح الآن للاستخدام

###### بيانات الدخول للعرض التوضيحي:

- البريد: admin@example.local
- كلمة المرور: password

يمكنك الدخول مباشرة واستكشاف جميع الميزات