# دليل رفع الدرجات من ملف Excel

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

## الخطوات

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

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

#### التنسيق المطلوب:

##### **العمود الأول (مطلوب):**
- **رقم الطالب** أو **student_number**: الرقم الجامعي للطالب

##### **الأعمدة التالية:**
- **أكواد المواد**: باقي الأعمدة يجب أن تحتوي على **أكواد المواد** كعناوين
- **القيم**: الدرجات في الصفوف تحت كل مادة

### 3. مثال على التنسيق

```
رقم الطالب,CS101,MATH101,ENG101,PHYS101
2023001,85,90,75,88
2023002,80,85,بد,90
2023003,92,88,95,87
```

**ملاحظة مهمة:**
- العمود الأول: أرقام الطلاب
- باقي الأعمدة: أكواد المواد (مثل CS101, MATH101)
- الصفوف: الدرجات لكل طالب في كل مادة

### 4. أنواع الدرجات المدعومة

يمكن إدخال الدرجات بالطرق التالية:

#### درجات رقمية:
- **0-100**: درجات رقمية من 0 إلى 100
- مثال: `85`, `90`, `75.5`

#### درجات نصية:
- **بد**: بديل
- **غ**: غياب
- **م**: معيد
- **مث**: مستثنى
- **ن**: ناجح
- **ر**: راسب
- أي نص آخر سيتم حفظه كما هو

### 5. رفع الملف

1. اذهب إلى صفحة "رفع درجات الفصل من Excel/CSV"
2. اختر الكلية (إذا كنت مدير عام)
3. اختر التخصص
4. اختر رقم الفصل الدراسي (مثل: 1, 2, 3...)
5. اختر السنة الدراسية (مثل: 2023-2024)
6. اختر الملف واضغط "رفع الدرجات"

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

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

### ⚠️ تحذيرات:
1. **أكواد المواد يجب أن تكون صحيحة**: يجب أن تكون أكواد المواد موجودة في الفصل الدراسي المحدد
2. **الطلاب يجب أن يكونوا مسجلين**: يجب أن يكون الطالب موجوداً في النظام وفي التخصص المحدد
3. **الفصل الدراسي**: يجب تحديد الفصل الدراسي والسنة الدراسية بشكل صحيح
4. **التسجيل التلقائي**: إذا لم يكن الطالب مسجلاً في المادة، سيتم تسجيله تلقائياً

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

### 📋 مثال مفصل:

افترض أن لديك الفصل الدراسي الأول من السنة 2023-2024 مع المواد التالية:
- CS101 (مقدمة في علوم الحاسوب)
- MATH101 (رياضيات 1)
- ENG101 (لغة إنجليزية)

فإن الملف يجب أن يكون كالتالي:

```
رقم الطالب,CS101,MATH101,ENG101
2023001,85,90,75
2023002,80,85,بد
2023003,92,88,95
2023004,70,75,80
```

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

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

**مشكلة: "المادة X غير موجودة"**
- تحقق من كود المادة في الملف
- تأكد من أن المادة موجودة في الفصل الدراسي المحدد
- تحقق من صحة كود المادة (حساسة لحالة الأحرف)

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

**مشكلة: "الدرجة غير صحيحة"**
- تحقق من صيغة الدرجة (رقمية أو نصية)
- الدرجات الرقمية يجب أن تكون بين 0-100
- الدرجات النصية يجب أن تكون واحدة من القيم المدعومة

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

## مثال عملي كامل

### الخطوة 1: تحضير البيانات
```
رقم الطالب,CS101,MATH101,ENG101,PHYS101
2023001,85,90,75,88
2023002,80,85,بد,90
2023003,92,88,95,87
2023004,70,75,80,72
2023005,95,98,90,93
```

### الخطوة 2: رفع الملف
1. اختر الكلية: كلية علوم الحاسوب
2. اختر التخصص: علوم الحاسوب
3. اختر رقم الفصل: 1
4. اختر السنة: 2023-2024
5. اختر الملف واضغط رفع

### الخطوة 3: التحقق
- سترى رسالة: "تم رفع 20 درجة بنجاح" (5 طلاب × 4 مواد)

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

