# قالب استيراد الطلاب (Excel/CSV)

هذا القالب يطابق حقول جدول `students` في قاعدة البيانات.

## ⚠️ خطأ «Invalid column count in CSV input on line 1»

هذا الخطأ يظهر عند **استيراد الملف من phpMyAdmin**. قالب الطلاب فيه **5 أعمدة** (student_number, full_name_ar, college_id, major_id, status) بينما جدول `students` فيه **18 عموداً**، لذلك phpMyAdmin يرفض الاستيراد.

**الحل:** لا تستورد هذا الملف من phpMyAdmin. استخدم **رفع الطلاب من التطبيق**:
1. ادخل إلى **إدارة الطلاب** (students.php).
2. اضغط **«رفع طلاب من Excel/CSV»**.
3. اختر الكلية والتخصص ثم ارفع ملف القالب (مثل `template_students_law.csv`).

التطبيق يفهم هذا القالب ويُدخل الطلاب في الجدول تلقائياً (مع توليد id و user_id وغيرها).

## الحقول في القالب

| الحقل (إنجليزي) | الحقل (عربي)     | مطلوب | الوصف |
|-----------------|------------------|-------|--------|
| student_number  | الرقم الجامعي    | نعم   | الرقم الجامعي (فريد) |
| full_name_ar    | الاسم العربي     | نعم   | الاسم الكامل بالعربية |
| full_name_en    | الاسم الإنجليزي  | لا    | الاسم الكامل بالإنجليزية |
| national_id     | الرقم الوطني     | لا    | الرقم الوطني (فريد إن وُجد) |
| email           | البريد الإلكتروني| لا    | البريد الإلكتروني |
| phone           | الهاتف           | لا    | رقم الهاتف |
| address         | العنوان         | لا    | العنوان |
| enrollment_date | تاريخ التسجيل    | لا    | تاريخ التسجيل (YYYY-MM-DD)، افتراضي: اليوم |
| graduation_date | تاريخ التخرج     | لا    | تاريخ التخرج (YYYY-MM-DD) |
| status          | الحالة          | لا    | active \| graduated \| suspended \| withdrawn (افتراضي: active) |
| major_code      | رمز التخصص      | لا    | رمز التخصص في النظام (إن لم يُختر من النموذج) |

## ملاحظات

- **لا تضف** أعمدة: id, college_id, major_id, photo_path, results_blocked, user_id, created_at, updated_at — تُدار تلقائياً.
- يمكن استخدام القالب بعناوين إنجليزية (`template_students.csv`) أو بعناوين عربية (`قالب_استيراد_الطلاب.csv`) أو قالب كلية القانون (`قالب_طلاب_كلية_القانون.csv`).
- **ظهور العربية بشكل صحيح:** احفظ الملف بصيغة **CSV UTF-8** (في Excel: حفظ باسم → CSV UTF-8) أو استخدم القالب الجاهز من النظام لضمان ترميز UTF-8 مع BOM.
- احفظ الملف بصيغة **CSV** بترميز **UTF-8** أو بصيغة **Excel (.xlsx, .xls)**.
