# دليل رفع الطلاب من ملف Excel

## نظرة عامة
هذا الدليل يوضح كيفية رفع بيانات الطلاب من ملف Excel إلى النظام.

## الخطوات

### 1. تحميل القالب
- من لوحة التحكم، اضغط على "📥 قوالب رفع البيانات"
- اختر "تحميل قالب رفع الطلاب"
- سيتم تحميل ملف Excel يحتوي على الأعمدة المطلوبة

### 2. فتح القالب وتعبئة البيانات
افتح الملف في برنامج Excel أو أي برنامج مشابه وقم بتعبئة البيانات:

#### الأعمدة المطلوبة:

##### **مطلوبة (يجب تعبئتها):**
- **student_number** أو **رقم_جامعي**: الرقم الجامعي للطالب (يجب أن يكون فريداً)
- **full_name_ar** أو **اسم_عربي**: الاسم الكامل بالعربية

##### **اختيارية (يمكن تركها فارغة):**
- **full_name_en** أو **اسم_إنجليزي**: الاسم الكامل بالإنجليزية
- **national_id** أو **رقم_وطني**: الرقم الوطني (يجب أن يكون فريداً إذا تم إدخاله)
- **email** أو **بريد**: البريد الإلكتروني
- **phone** أو **هاتف**: رقم الهاتف
- **major_code** أو **رمز_تخصص**: رمز التخصص (مثل CS001)
- **major_id**: معرف التخصص (رقم ID للتخصص في النظام)
- **enrollment_date** أو **تاريخ_تسجيل**: تاريخ التسجيل (صيغة: YYYY-MM-DD، مثال: 2023-09-01)

### 3. أمثلة على البيانات

```
student_number,full_name_ar,full_name_en,national_id,email,phone,major_code,enrollment_date
2023001,أحمد محمد علي,Ahmed Mohammed Ali,123456789012,ahmed@example.com,0501234567,CS001,2023-09-01
2023002,فاطمة أحمد حسن,Fatima Ahmed Hassan,234567890123,fatima@example.com,0502345678,CS001,2023-09-01
2023003,محمد خالد إبراهيم,Mohammed Khalid Ibrahim,345678901234,mohammed@example.com,0503456789,CS002,2023-09-01
```

### 4. حفظ الملف
- احفظ الملف بصيغة **CSV** أو **Excel (.xlsx, .xls)**
- تأكد من الترميز UTF-8 عند حفظ CSV

### 5. رفع الملف
1. اذهب إلى صفحة "إدارة الطلاب"
2. اضغط على "رفع طلاب من Excel"
3. اختر الكلية (إذا كنت مدير عام)
4. اختر التخصص (اختياري - سيتم استخدامه إذا لم يكن موجوداً في الملف)
5. اختر الملف واضغط "رفع الملف وإضافة الطلاب"

### 6. التحقق من النتائج
بعد الرفع، سترى رسالة تظهر:
- عدد الطلاب المضافين بنجاح
- عدد الطلاب المكررين (تم تخطيهم)
- عدد الأخطاء إن وجدت

## ملاحظات مهمة

### ⚠️ تحذيرات:
1. **الرقم الجامعي يجب أن يكون فريداً**: لا يمكن إضافة طالبين بنفس الرقم الجامعي
2. **الرقم الوطني يجب أن يكون فريداً**: إذا أدخلت رقم وطني، يجب أن يكون فريداً
3. **التخصص**: يجب أن يكون التخصص موجوداً في النظام مسبقاً (عن طريق رمز التخصص أو معرف التخصص)
4. **التاريخ**: تأكد من صيغة التاريخ YYYY-MM-DD (مثل: 2023-09-01)

### ✅ نصائح:
- استخدم القالب المرفق كمرجع
- تحقق من البيانات قبل الرفع
- احفظ نسخة احتياطية من الملف
- يمكن استخدام أسماء الأعمدة بالعربية أو الإنجليزية
- الصفوف الفارغة سيتم تخطيها تلقائياً

### 🔧 حل المشاكل الشائعة:

**مشكلة: "الطالب غير موجود"**
- تحقق من الرقم الجامعي
- تأكد من أن التخصص موجود في النظام

**مشكلة: "الرقم الجامعي مكرر"**
- الطالب موجود مسبقاً في النظام
- سيتم تخطيه تلقائياً

**مشكلة: "التخصص غير موجود"**
- تأكد من رمز التخصص أو معرف التخصص
- أو حدد التخصص من القائمة المنسدلة في صفحة الرفع

**مشكلة: "خطأ في قراءة الملف"**
- تأكد من صيغة الملف (CSV أو Excel)
- تحقق من الترميز (يجب أن يكون UTF-8)
- تأكد من عدم وجود صيغ معقدة في الخلايا

## الدعم
إذا واجهت أي مشاكل، يرجى التواصل مع مدير النظام.

