تعليمات التشغيل السريعة
======================

1) ارفع ملفات المشروع إلى الاستضافة كما هي.
2) تأكد أن مجلد data قابل للكتابة من PHP. في أغلب استضافات cPanel يعمل تلقائياً، وإن لم يتم الحفظ اجعل صلاحية مجلد data تساوي 755 أو 775.
3) ملف api.php سيُنشئ قاعدة البيانات تلقائياً داخل:
   data/database.json
4) إذا كان لديك ملف database.json قديم في جذر المشروع، سيقوم api.php بنسخه تلقائياً إلى مجلد data عند أول تشغيل.
5) رابط لوحة التحكم:
   index.html
6) رمز الدخول الافتراضي:
   admin123
7) روابط التسجيل تنشأ من صفحة المجموعات عبر QR أو نسخ الرابط.

أهم التعديلات في هذه النسخة:
- إصلاح حفظ الاستمارة عبر API مباشر وآمن بدل إعادة رفع قاعدة البيانات كاملة من المتصفح.
- إضافة قفل للكتابة لمنع ضياع التسجيلات عند وجود أكثر من تقديم بنفس الوقت.
- إنشاء قاعدة البيانات تلقائياً عند عدم وجودها.
- نقل قاعدة البيانات إلى مجلد data مع حماية .htaccess.
- تحسين واجهة لوحة التحكم والاستمارة العامة والمجموعات والإعدادات.
- إصلاح حفظ خيار الحالة الأكاديمية f_status في الإعدادات.


تحديث منع الكاش - 20260627-clearcache-3
--------------------------
تم تفعيل Clear Cache في كل خطوات النظام من خلال:
1. منع الكاش من السيرفر عبر ملف .htaccess.
2. منع كاش api.php بإرسال Headers: no-store / no-cache.
3. إضافة Meta Tags داخل كل صفحات HTML.
4. إضافة رقم إصدار للملفات المحلية مثل css/style.css و js/app.js.
5. جعل جميع طلبات fetch تستخدم رابطاً متغيراً v و _ حتى لا يتم جلب نسخة قديمة.
6. حذف Cache Storage وإلغاء Service Worker إن وجد عند فتح الصفحات وبعد عمليات الحفظ.

ملاحظة مهمة:
بعد رفع النسخة الجديدة، افتح الرابط مرة واحدة مع إضافة ?v=20260627-clearcache-3 في نهاية الصفحة، مثال:
index.html?v=20260627-clearcache-3
register.html?v=20260627-clearcache-3
