MAINHACK

Viewing / Editing File: README.md

# نظام إدارة حضور الطلاب

نظام شامل ومتطور لإدارة حضور الطلاب وتتبع الأداء الأكاديمي باللغة العربية.

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

### 🔸 لوحة المدير
- إدارة المراحل الدراسية (ابتدائي، إعدادي، ثانوي)
- إدارة الصفوف الدراسية مع ربطها بالمراحل
- إدارة المواد الدراسية وتخصيصها للصفوف
- إدارة حسابات المعلمين
- إعداد واتساب API للإشعارات التلقائية

### 🔸 لوحة المعلم
- اختيار المواد والصفوف التي يدرسها
- إنشاء مجموعات أسبوعية (حصة أو حصتان)
- إدارة الطلاب وإضافتهم للمجموعات
- تسجيل الحضور مع تقييم الواجبات والاختبارات
- إدارة حصص التعويض للطلاب الغائبين
- تقارير شاملة للطلاب والمجموعات
- تنبيهات للطلاب الذين يحتاجون متابعة (أكثر من 3 غيابات)

### 🔸 بوابة أولياء الأمور
- تسجيل الدخول بكود الطالب ورقم الهاتف
- عرض تقارير الأداء والحضور
- إحصائيات شاملة للطالب
- تفاصيل الاختبارات ومستويات الواجبات

## التقنيات المستخدمة

- **Backend**: PHP (بدون إطار عمل)
- **Database**: MySQL
- **Frontend**: Bootstrap 5 RTL + jQuery
- **AJAX**: للتفاعل السريع بدون إعادة تحميل الصفحة
- **التصميم**: متجاوب ومتوافق مع الجوال

## متطلبات التشغيل

- PHP 7.4 أو أحدث
- MySQL 5.7 أو أحدث
- Apache/Nginx
- مساحة تخزين كافية

## التثبيت

1. **رفع الملفات**
   ```bash
   # رفع جميع ملفات المشروع إلى مجلد الخادم
   ```

2. **إنشاء قاعدة البيانات**
   ```sql
   # تشغيل ملف database/schema.sql في MySQL
   mysql -u username -p < database/schema.sql
   ```

3. **تكوين قاعدة البيانات**
   ```php
   // تعديل ملف config/database.php
   private $host = "localhost";
   private $db_name = "student_attendance";
   private $username = "your_username";
   private $password = "your_password";
   ```

4. **إعداد واتساب (اختياري)**
   - التسجيل في مزود خدمة واتساب API
   - إضافة الـ Token في ملف `config/config.php`

## بيانات الدخول الافتراضية

### المدير
- **اسم المستخدم**: admin
- **كلمة المرور**: password

### المعلم
- يتم إنشاء الحسابات من قبل المدير
- تسجيل الدخول برقم الهاتف وكلمة المرور

### ولي الأمر
- تسجيل الدخول بكود الطالب ورقم هاتف ولي الأمر

## هيكل المشروع

```
├── admin/                 # صفحات المدير
├── teacher/              # صفحات المعلم
├── parent/               # صفحات ولي الأمر
├── config/               # ملفات التكوين
├── includes/             # الملفات المشتركة
├── database/             # ملفات قاعدة البيانات
├── index.php            # الصفحة الرئيسية
└── README.md            # هذا الملف
```

## الأمان

- تشفير كلمات المرور باستخدام `password_hash()`
- حماية من SQL Injection باستخدام Prepared Statements
- التحقق من الصلاحيات في كل صفحة
- جلسات آمنة منفصلة لكل دور

## الدعم الفني

للحصول على الدعم الفني أو الإبلاغ عن مشاكل، يرجى التواصل معنا.

## الترخيص

هذا المشروع مرخص تحت رخصة MIT.

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: README.md

Server Info

System Features

User Info