استمارة طلبة حوزة الشيخ المفيد — نسخة رقم 8

متطلبات الاستضافة

استضافة PHP 8.1 أو أحدث مع HTTPS. لا تحتاج إلى إنشاء قاعدة بيانات MySQL أو تثبيت مكتبات إضافية. تُحفظ طلبات الموقع في ملف خاص خارج public_html، منفصل عن قاعدة بيانات البرنامج المحلي.

الرفع إلى استضافة cPanel

  1. خذ نسخة احتياطية من ملفات الموقع الموجود قبل الرفع. فك هذه الحزمة على حاسوبك.
  2. ارفع مجلد almufid الموجود داخل public_html إلى public_html في الاستضافة. يصبح رابط الاستمارة مثل https://example.com/almufid/ . يمكنك تغيير اسم المجلد، ثم استخدام الرابط الجديد في البرنامج.
  3. ارفع مجلد almufid-registration-private إلى المجلد الرئيسي لحساب الاستضافة، بجانب public_html وخارجه. لا تضعه داخل public_html. يحتوي config.php على مفتاح الربط ومعرّف الموقع. يجب أن يستطيع PHP القراءة والكتابة داخل المجلد الخاص، وسيُنشأ state.json وstate.lock تلقائيًا.
  4. افتح رابط الاستمارة باستخدام HTTPS وتأكد من ظهور الحقول. احتفظ بنسخة من المجلد الخاص عند أخذ نسخة احتياطية من موقعك.

هيكل cPanel المعتاد: مجلد الحساب الرئيسي يحتوي public_html/almufid لملفات الصفحة، وalmufid-registration-private لملفات التخزين. عند استضافة ذات مسارات مختلفة عن هذا التنظيم، راجع حساب المجلد الخاص في bootstrap.php واجعله خارج جميع مجلدات الويب العامة.

ربط البرنامج

  1. شغّل تطبيق الشيخ المفيد نسخة رقم 8 بحساب الإدارة وافتح «الاستمارة الإلكترونية».
  2. اكتب رابط مجلد الاستمارة باستخدام HTTPS. افتح CONNECTION-SETTINGS.html محليًا وانسخ مفتاح الربط منه إلى البرنامج. لا ترفع ملف CONNECTION-SETTINGS.html داخل public_html ولا تشاركه مع الطلبة.
  3. فعّل الجلب التلقائي واحفظ الربط، ثم اضغط «جلب الآن» للتحقق. لا يلزم فتح منفذ في الراوتر أو نشر قاعدة بيانات الحاسوب.
  4. أرسل للطلبة رابط الاستمارة فقط، دون مفتاح الربط. أبقِ البرنامج والحاسوب الرئيسي والإنترنت مشغّلين ليعمل الجلب كل خمس دقائق، حتى مع إغلاق المتصفح.

طريقة الطالب

يملأ الطالب الحقول والمواد والأساتذة، ويجيب سؤال التحقق، ويوافق على الإرسال ثم يرسل الاستمارة. يحصل على رمز خاص لتعديل طلبه؛ يمكن نسخه أو حفظه بملف. لفتح طلب سابق يلصق الرمز في «تعديل طلب سابق». لا تُعرض بيانات الطلبة الآخرين ولا يحتاج الطالب إلى حساب ChatGPT. لا تُرفع المستمسكات أو الصور بهذه الاستمارة؛ تبقى ضمن البرنامج المحلي.

كيف تُجلب التحديثات؟

يُجلب كل طالب بطلب مستقل ويُحفظ بشكل مستقل. الطلب الجديد يُضاف تلقائيًا إلى سجل الطلبة. الطلب المحدّث يغيّر سجل الطالب نفسه. تمنع معرفات الطلبات تكرار السجل عند إعادة الجلب أو انقطاع الاتصال. التعديل غير المتعارض يُدمج مع التعديلات المحلية؛ إذا عُدّل الحقل نفسه في البرنامج والموقع أو ظهرت مطابقة محتملة مع طالب قديم، يظهر الطلب للمراجعة داخل البرنامج.

الموقع يحتفظ بأحدث نسخة لكل طلب. الجولة الواحدة تجلب حتى ٢٥٠ طلبًا أو نحو دقيقة من العمل؛ تُستكمل البقية في الجولة التالية. عند انقطاع الإنترنت يعاود البرنامج المحاولة في الجولة التالية دون تكرار الطلبات التي حُفظت. لا تؤثر تحديثات الموقع على الرواتب أو الملاحظات الإدارية أو الدرجات أو الحضور أو المستمسكات المحلية.

الفحص

اختُبرت ملفات PHP 8.3 فعليًا باستضافة اختبار محلية: الإرسال والتعديل ورمز المراجعة وحماية المصدر والمفتاح الخاص، ثم جلب البرنامج ودمج التحديثات ومنع التكرار ومراجعة التعارضات. يلزم إجراء «جلب الآن» بعد رفعها إلى استضافتك للتحقق من مسارات الاستضافة وHTTPS. لم تُنشر هذه الحزمة تلقائيًا على موقع عام.