# 🚀 دليل البدء السريع

نظام نتائج الجامعة - خارطة الطريق الكاملة

✅ جاهز للبدء! اتبع الخطوات بالترتيب للحصول على أفضل النتائج.
📋 المرحلة الأولى: التثبيت والإعداد الأساسي
1

### إعداد قاعدة البيانات

من phpMyAdmin:

1. افتح `http://localhost/phpmyadmin`
2. أنشئ قاعدة بيانات جديدة باسم `university_results`
3. استورد ملف `database/schema.sql`

2

### إعداد الاتصال بقاعدة البيانات

افتح ملف `config/database.php` وعدّل:

define('DB_HOST', 'localhost'); define('DB_USER', 'root'); define('DB_PASS', ''); // كلمة المرور define('DB_NAME', 'university_results');
3

### إنشاء حساب المدير

افتح في المتصفح:

http://localhost/GUNS/create_admin.php

ستظهر رسالة نجاح عند اكتمال العملية.

🔐 المرحلة الثانية: تسجيل الدخول
4

### تسجيل الدخول الأول

1. افتح `http://localhost/GUNS`
2. اسم المستخدم: admin
3. كلمة المرور: admin123

⚠️ مهم جداً: غيّر كلمة المرور فوراً بعد تسجيل الدخول!
🏛️ المرحلة الثالثة: إعداد البيانات الأساسية
5

### إضافة كلية

من لوحة التحكم → إدارة الكليات → إضافة كلية

6

### إضافة تخصص

من لوحة التحكم → إدارة التخصصات → إضافة تخصص

7

### إضافة فصل دراسي

من لوحة التحكم → إدارة الفصول الدراسية → إضافة فصل

8

### إضافة مادة

من لوحة التحكم → إدارة المواد → إضافة مادة

👥 المرحلة الرابعة: إدارة الطلاب
9

### إضافة طالب

من لوحة التحكم → إدارة الطلاب → إضافة طالب

✅ حدد "إنشاء حساب تلقائي" لإنشاء حساب للطالب

10

### تسجيل الطلاب في المواد

طريقتان:

1. يدوياً: من صفحة المادة → تسجيل طلاب
2. من Excel: ارفع ملف CSV/Excel بقائمة الطلاب

📊 المرحلة الخامسة: إدخال الدرجات
11

### إدخال الدرجات

الطريقة الأسهل:

1. من لوحة التحكم → إدخال الدرجات (مبسط)
2. اختر الفصل الدراسي
3. اختر المادة
4. أدخل الدرجة لكل طالب (0-100)
5. اضغط حفظ - سيتم حساب التقدير تلقائياً

12

### التحقق من الدرجات

من إدارة الطلاب → اختر طالب → الدرجات

ستظهر: الدرجات، التقدير، النقاط، المعدل الفصلي، المعدل التراكمي

💰 المرحلة السادسة: إدارة الرسوم
13

### إضافة رسوم

من لوحة التحكم → إدارة الرسوم → إضافة رسوم

14

### تسجيل الدفع

من صفحة الرسوم → تسجيل دفع

📜 المرحلة السابعة: إصدار الشهادات
15

### طلب شهادة (للطالب)

سجل دخول كطالب → طلب شهادة → اختر نوع الشهادة

16

### الموافقة على الشهادة (للمسؤول)

من لوحة التحكم → طلبات الشهادات → موافقة

👤 المرحلة الثامنة: إدارة المستخدمين
17

### إضافة مستخدم

من لوحة التحكم → إدارة المستخدمين → إضافة مستخدم

الأدوار: admin, college_admin, registrar, instructor, student

### ✅ قائمة التحقق النهائية

☐ قاعدة البيانات تم إنشاؤها
☐ تم تسجيل الدخول بنجاح
☐ تم إضافة كلية
☐ تم إضافة تخصص
☐ تم إضافة فصل دراسي
☐ تم إضافة مادة
☐ تم إضافة طالب
☐ تم تسجيل طالب في مادة
☐ تم إدخال درجة
☐ تم التحقق من المعدل

### 💡 نصائح مهمة

- احفظ نسخة احتياطية من قاعدة البيانات بانتظام
- غيّر كلمة مرور المدير فوراً بعد التثبيت
- استخدم بيانات تجريبية للاختبار أولاً
- تحقق من الصلاحيات قبل إضافة المستخدمين
- راجع الدرجات قبل إصدار الشهادات

### 🔗 روابط سريعة

تسجيل الدخول لوحة التحكم الدليل الكامل (Markdown)
🆘 حل المشاكل الشائعة

### خطأ في الاتصال بقاعدة البيانات

- تحقق من أن MySQL يعمل
- تحقق من بيانات الاتصال في `config/database.php`
- تأكد من وجود قاعدة البيانات

### صفحة بيضاء

- تحقق من سجلات الأخطاء في PHP
- تأكد من PHP version 7.4 أو أحدث
- تحقق من تفعيل PDO extension

### لا تظهر الطلاب عند إدخال الدرجات

- تأكد من تسجيل الطلاب في المادة أولاً
- استخدم زر "تسجيل طلاب" بجانب المادة
- تأكد من أن الطلاب بحالة "نشط"

🎉 تهانينا! الآن النظام جاهز للاستخدام!

إذا واجهت أي مشاكل، راجع قسم "حل المشاكل الشائعة" أعلاه.