=====================================================
نظام الامتحان الإلكتروني الاحترافي - ثانوية الأوائل
=====================================================

هذه النسخة تعمل بقاعدة بيانات MySQL وتحفظ نتائج الطلاب داخل جدول exam_submissions.
تمت مراعاة توافق PHP القديم وعدم استخدام عامل ?? حتى لا تظهر مشكلة HTTP ERROR 500.

---------------------------------
1) الملفات المهمة
---------------------------------

index.php
واجهة الامتحان للطالب.

submit.php
استلام الإجابات وتصحيحها وحفظها في قاعدة البيانات.

results.php
لوحة إدارة النتائج. كلمة المرور الافتراضية داخل config.php هي 1997.

config.php
ملف الإعدادات: اسم الامتحان، مدة الامتحان، الألوان، كلمة مرور الإدارة، وبيانات قاعدة البيانات.

questions.php
ملف الأسئلة. عدّل الأسئلة والخيارات والإجابة الصحيحة من هنا.

database.sql
أوامر إنشاء جدول قاعدة البيانات.

install_database.php
ملف اختياري ينشئ الجدول تلقائياً بعد تعديل بيانات قاعدة البيانات داخل config.php.
بعد نجاح التنصيب احذف هذا الملف من الاستضافة.

---------------------------------
2) طريقة التركيب على cPanel
---------------------------------

أولاً: أنشئ قاعدة بيانات من cPanel
MySQL Databases > Create New Database
ثم أنشئ مستخدم قاعدة بيانات وأعطه جميع الصلاحيات ALL PRIVILEGES.

ثانياً: عدّل ملف config.php
ابحث عن:

'storage_mode' => 'database',

ثم عدّل بيانات الاتصال:

'db' => array(
    'host' => 'localhost',
    'user' => 'PUT_DB_USER_HERE',
    'pass' => 'PUT_DB_PASSWORD_HERE',
    'name' => 'PUT_DB_NAME_HERE'
),

مثال:
'user' => 'mosuclaz_examuser',
'name' => 'mosuclaz_examdb',

ثالثاً: أنشئ الجدول بإحدى الطريقتين:

الطريقة الأولى عبر phpMyAdmin:
افتح phpMyAdmin > اختر قاعدة البيانات > Import > اختر ملف database.sql > Go.

الطريقة الثانية عبر المتصفح:
بعد رفع الملفات افتح:
your-domain.com/pro_exam_form_db/install_database.php
إذا ظهرت رسالة نجاح، احذف ملف install_database.php فوراً.

رابعاً: ارفع المجلد إلى public_html وافتح:
your-domain.com/pro_exam_form_db/index.php

لوحة النتائج:
your-domain.com/pro_exam_form_db/results.php

---------------------------------
3) تعديل الأسئلة
---------------------------------

افتح questions.php
كل سؤال بهذا الشكل:

array(
    'id' => 'q1',
    'text' => 'نص السؤال هنا',
    'choices' => array('اختيار 1', 'اختيار 2', 'اختيار 3', 'اختيار 4'),
    'correct' => 'اختيار 1',
    'points' => 1
),

مهم جداً:
قيمة correct يجب أن تكون مطابقة تماماً لأحد الاختيارات داخل choices.

---------------------------------
4) ملاحظات مهمة
---------------------------------

- إذا ظهرت صفحة HTTP ERROR 500، تأكد من أن بيانات قاعدة البيانات صحيحة.
- تأكد من استيراد database.sql.
- لا تترك install_database.php على الاستضافة بعد نجاح التنصيب.
- إذا تريد الرجوع لطريقة الحفظ بدون قاعدة بيانات، اجعل storage_mode = file داخل config.php.
- كلمة مرور النتائج الافتراضية 1997، يفضل تغييرها من config.php.

