هذه الحزمة تستخدم واجهة الحضور والحفظ من الحزمة الجديدة، وتحتفظ بملفات البناء الأصلية من مشروع 2.3.6 (Capacitor وGitHub Actions والأيقونات وأدوات البناء).
- يمكن تسجيل الحضور مع نسبة رقمية من 0 إلى 100، أو تسجيل ورد/عدة أوراد وتقييم كل ورد. لا يُسمح بملء النسبة اليدوية مع إضافة أوراد في العملية نفسها.
- التقييمات المعروضة: ممتاز — 100%، جيد جدًا — 90%، جيد — 80%، مقبول — 70%، يحتاج مراجعة — 60%.
- عند استخدام الأوراد، تُحسب نسبة اليوم من متوسط تقييمات الأوراد المسجلة.
ملف Code.gs يحافظ على أسماء الأوراق العربية القديمة (الطلاب، السجلات، الدفعات، الإعدادات، لوحة التحكم، تفاصيل الطالب) ويضيف عمود «أوراد الحفظ» إلى «السجلات». بيانات الأوراد تُحفظ كـ JSON في العمود نفسه مع الحفاظ على سجل الحضور الواحد.
قبل نشر Code.gs على جدول البيانات الأساسي: خذ نسخة احتياطية من Google Sheets، ثم اختبره على نسخة. شغّل setupSpreadsheet() مرة واحدة فقط إذا كانت التهيئة مطلوبة، وتأكد من نشر إصدار Web App جديد. لا تشغّل أي عملية مسح.
راجع CAPACITOR-BUILD.md وملفات .github/workflows/ لبناء Android وiOS. أُبقيت ملفات المشروع الأصلية بدل استبدالها بملفات الحزمة المختصرة.
تم فحص صياغة JavaScript وCode.gs وسلامة الحزمة محليًا. لم يتم اختبار مزامنة حقيقية مع Google Sheets أو بناء APK/IPA في بيئة GitHub من هنا.
- واجهة التطبيق تستخدم إجراءات
pingوsyncوpullوfullPull، وهي مدعومة فيCode.gs. - بيانات الحفظ تُرسل داخل
records[].memorizationWardsوتُقرأ من عمود «أوراد الحفظ». - جرى تعديل قراءة وكتابة صفوف Google Sheets لتستخدم أسماء العناوين الفعلية بدل افتراض أن الأعمدة في ترتيب ثابت؛ هذا مهم عند إضافة أعمدة إلى جداول قديمة.
- يجب تجربة السكربت على نسخة من Google Sheets أولًا؛ لم يُختبر الاتصال بحساب Google الحقيقي من هذه البيئة.
بعد نشر Code.gs الجديد، شغّل setupSpreadsheet() يدويًا مرة واحدة من محرر Apps Script. ورقة «تفاصيل الطالب» تقرير مشتق من أوراق الطلاب والسجلات والمدفوعات؛ اختيار الطالب من الخلية B3 يعيد بناء بيانات الملف، ويعرض إحصائيات الحضور والحفظ، وأنواع الأوراد، ومتوسط تقييم الأوراد، والسور المختلفة، وآخر ورد، وملخص المدفوعات، ثم سجلًا زمنيًا مفصلًا. لا تُستخدم هذه الورقة لإدخال السجلات الأصلية.
قبل تشغيل التهيئة على جدول الإنتاج، أنشئ نسخة احتياطية من Google Sheets. الاختبارات المحلية تتحقق من صياغة الملفات فقط ولا تستبدل اختبار المزامنة على جدول حقيقي.