# دليل نقل قائمة الطلاب خطوة بخطوة (بدون مشاكل الترميز أو «سجل واحد»)

## المشكلة التي يتجنبها هذا الدليل
- **سجل واحد فقط** يُستورد من Excel رغم وجود عشرات الصفوف.
- **الأحرف العربية تظهر كـ ???** أو رموز غريبة بعد الرفع.

## الحل الموصى به: لصق القائمة وتوليد القالب (بدون Excel)

هذه الطريقة تتجنب Excel تماماً في مرحلة «إدخال الأسماء»، فلا ترميز خاطئ ولا تقطيع للصفوف.

---

### الخطوة 1: الحصول على القائمة من مصدرك
- من **Excel**: حدّد عمود الرقم الجامعي وعمود الاسم (بدون العناوين إن أردت)، ثم **نسخ** (Ctrl+C).
- من **Word** أو **جدول آخر**: انسخ العمودين (رقم جامعي + اسم) بنفس الطريقة.

---

### الخطوة 2: فتح صفحة «لصق القائمة»
1. ادخل إلى **إدارة الطلاب** (من القائمة أو من لوحة التحكم).
2. اضغط على الزر: **«📋 لصق القائمة وتوليد القالب (موصى به)»**.
3. أو ادخل مباشرة إلى: `paste_students_list.php` (من نفس مجلد النظام).

---

### الخطوة 3: لصق القائمة في الصندوق
1. في الصندوق الكبير، الصق ما نسخته (Ctrl+V).
2. تأكد أن **كل سطر = طالب واحد**، وأن الرقم والاسم في نفس السطر.
3. الفاصل بين الرقم والاسم يمكن أن يكون:
   - **Tab** (من Excel عادة)، أو
   - **فاصلة**، أو
   - **مسافتان أو أكثر**.

**مثال صحيح:**
```
23-11064571	هبه الله سليمان محمد سليمان
23-11015654	موسى احمد اونور محمد
23-11070385	منية علي محمد ابو القاسم
```

أو:
```
23-11064571, هبه الله سليمان محمد سليمان
23-11015654, موسى احمد اونور محمد
```

---

### الخطوة 4: توليد القالب وحفظه
1. اضغط **«توليد القالب وحفظه»**.
2. ستظهر رسالة نجاح مع عدد الطلاب (مثلاً: تم إنشاء القالب بنجاح: 70 طالب/طالبة).
3. اضغط على الرابط **«📥 تحميل القالب الآن»** لتحميل ملف CSV جاهز بترميز UTF-8.

---

### الخطوة 5: رفع الملف إلى النظام
1. ارجع إلى **إدارة الطلاب**.
2. اضغط **«رفع طلاب من Excel/CSV»**.
3. اختر **الكلية** (مثلاً: كلية القانون).
4. اختر **التخصص** (أو اترك النظام يختار الافتراضي للكليات بدون تشعيب).
5. اختر الملف الذي حمّلته في الخطوة 4.
6. اضغط **«رفع الملف وإضافة الطلاب»**.

ستجد أن **كل** الطلاب يُستوردون والأسماء العربية تظهر بشكل صحيح.

---

## إذا أردت استخدام Excel رغم ذلك

### حفظ الملف بترميز UTF-8 من Excel
1. بعد تعبئة البيانات في Excel:
   - **ملف → حفظ باسم**.
   - اختر الموقع واكتب اسم الملف.
   - في **نوع الملف** اختر **«CSV UTF-8 (فاصلة منقوطة) (*.csv)»** أو **«CSV UTF-8 (delimited) (*.csv)»** إن وُجد.
2. إن لم يظهر خيار UTF-8:
   - احفظ كـ **CSV (فاصلة منقوطة) (*.csv)**.
   - افتح الملف في **المفكرة (Notepad)**.
   - **ملف → حفظ باسم**.
   - في «الترميز» اختر **UTF-8** ثم احفظ (استبدال الملف).

### تنسيق الملف من Excel
- **الصف الأول:** عناوين الأعمدة (مثلاً: `student_number`, `full_name_ar`).
- **من الصف الثاني:** سطر لكل طالب؛ عمود الرقم الجامعي ثم عمود الاسم.
- لا تترك صفوفاً فارغة بين العناوين والبيانات.

---

## ملخص سريع
| الهدف | الإجراء |
|-------|---------|
| نقل الطلاب **بدون** مشاكل ترميز أو سجل واحد | استخدم **لصق القائمة وتوليد القالب** ثم ارفع الملف المُحمَّل. |
| الرابط المباشر لصق القائمة | `paste_students_list.php` |
| بعد التوليد | تحميل القالب → إدارة الطلاب → رفع طلاب من Excel/CSV → اختيار الكلية والتخصص → رفع الملف. |
