دفتر الحلقة 📖

تطبيق ويب عربي بسيط لمعلّمي حلقات القرآن، يحلّ محل دفتر المتابعة الورقي لكل طالب.

المزايا

برنامج صناعة الحافظ

• التسميع اليومي بالصفحات: لكل طالب يُسجَّل يومياً من صفحة كذا إلى صفحة كذا، والنتيجة (✅ أنجز / ❌ أخطأ / 🚫 غاب)، والآيات التي وقع فيها الخطأ (السورة والآية ووصف الخطأ). الصفحات التالية تُقترح تلقائياً حسب المقدار اليومي للطالب واتجاه حفظه، وإذا تجاوزت الأخطاء العدد المسموح (من الإعدادات) تصبح النتيجة «أخطأ» تلقائياً.
• يوم التعويض: أيام التسميع الأحد إلى الأربعاء ويوم التعويض الخميس (قابلة للتعديل). من أخطأ أو غاب يظهر في «مطلوب تعويضهم»، ويُسجَّل التعويض مربوطاً بالأيام التي يعوّضها.
• رسائل واتساب للطالب والمعلم والمشرف: عند الخطأ أو الغياب تُجهَّز الرسالة فوراً («لم يُنجز بسبب الخطأ… يلزمه التعويض يوم الخميس»)، ولكل جهة زر يفتح واتساب والرسالة جاهزة، مع خيار إرسالها إلى مجموعة. وفي الرئيسية «ملخص اليوم للمشرف».
• لوحة الأسبوع: جدول الطلاب × أيام الأسبوع بحالة كل يوم، والضغط على أي خانة يسجّلها.
• السرد الشهري: يُسجَّل كل مجلس سرد (من صفحة إلى صفحة، وعدد الأوجه، والأخطاء)، ويُجمع عدد أوجه الشهر تلقائياً ونسبته من المحفوظ.
• التقرير الشهري والختم المتوقع: أيام الإنجاز والخطأ والغياب والتعويض ونسبة الإنجاز، والأوجه المحفوظة في الشهر، ومجموع المحفوظ من 604، وتاريخ الختم المتوقع (ميلادي وهجري) بمعدل الأسابيع الأربعة الأخيرة. يُرسل لكل طالب، وملخص الشهر للمشرف.
• التقرير الشهري بالشهر الهجري (تقويم أم القرى): جدول لكل الطلاب: أين وصل في الحفظ (الصفحة والسورة)، وكم حفظ وكم سرد في الشهر، وحضوره وغيابه، ودرجته في الاختبار الشهري. يُرسل بواتساب أو يُطبع PDF. وفي آخر أيام الشهر يظهر في الرئيسية تنبيه لرصد الدرجات وإرسال التقرير.
• الاختبار الشهري: «رصد درجات الاختبار» لكل الطلاب دفعة واحدة، والدرجة الكاملة تُضبط من الإعدادات (100 افتراضياً)، ويظهر التقدير (ممتاز، جيد جداً…).
• الإحصائيات: صفحة لكل شهر، مع تصفية بحسب المعلم: نسبة الإنجاز، والأوجه المحفوظة والمسرودة، والغياب، والتعويض المتأخر، ومخطط الأوجه أسبوعياً، ومقارنة حلقات المعلمين، وتقدم كل طالب نحو الختم.
• المعلمون والمشرف: من الإعدادات (الأسماء والجوالات)، ولكل طالب معلمه ومقداره اليومي وما حفظه قبل البرنامج.
• جمع بيانات أكثر من جهاز: «استعادة» مع خيار «دمج» يضم نسخة معلم آخر إلى بياناتك دون حذف شيء.

دفتر الحلقة

• دفتر متابعة لكل طالب: تسجيل كل تسميع (حفظ جديد، مراجعة، تثبيت) بالسورة والآيات والتقدير، مع الواجب القادم وملاحظات المعلم.
• التسميع على المصحف مباشرة: يضغط الشيخ «📖 تسميع جديد» فيُفتح المصحف حيث توقف الطالب. كلما أخطأ الطالب يضغط الشيخ على الكلمة فيُسجَّل الخطأ فوراً دون أي نافذة، وضغطة ثانية تلغيه. يُختار نوع الخطأ (حفظ، تشكيل، تجويد…) من شريط أعلى المصحف، والضغط على رقم الآية يسجّل خطأً في الآية كاملة، والضغطة المطوّلة على الكلمة تفتح تفاصيلها وسجلها. وفي النهاية يضغط «إنهاء» فتظهر ورقة معبأة مسبقاً (المقطع والتقدير المقترح) ليحفظ أو يرسل التقرير مباشرة. والتسميع الذي لم يُنهَ يبقى محفوظاً لمتابعته لاحقاً.
• واجهة المصحف: صفحة كاملة بملء الشاشة بخط مجمع الملك فهد كما في مصحف المدينة (15 سطراً)، تُحمَّل صفحةً صفحة من Quran.com وتُحفظ لتعمل بعدها دون إنترنت. وإن تعذّر الاتصال يُعرض المصحف بخط Amiri Quran بالترقيم نفسه، مع عنوان السورة المزخرف ورقم الصفحة والجزء والحزب، والانتقال بين الصفحات بالسحب بالإصبع، وإخفاء الأشرطة بالضغط على فراغ الصفحة.
• ألوان الأخطاء على المصحف: أحمر ممتلئ لأخطاء التسميع الحالي، وبرتقالي للأخطاء السابقة، وأحمر مموّج للمتكرر، وأخضر لما أتقنه الطالب. والمصحف بترقيم صفحات مصحف المدينة (604 صفحات).
• تدوين الأخطاء: لكل خطأ موضعه الدقيق (السورة والآية والكلمة) ونوعه (نسيان، تشكيل، تجويد، تبديل كلمة، تردد، خلط بين الروايات…).
• كشف الأخطاء المتكررة تلقائياً: إذا أخطأ الطالب في الموضع نفسه أكثر من مرة يُعلَّم الخطأ بأنه «متكرر» (تتجاهل المقارنة التشكيل واختلاف الهمزات). وعندما يتقنه الطالب يعلّمه المعلم بـ«تم الإتقان».
• مواضع يخطئ فيها أكثر من طالب: لتنبيه الحلقة كلها عليها.
• الرواية: لكل طالب الرواية التي يقرأ بها، من روايات القرّاء العشرة (حفص، ورش، قالون، شعبة، الدوري…). تظهر في صفحته وفي تقاريره، وينبّه المصحف المعلم إذا كانت رواية الطالب غير حفص.
• ملاحظات الشيخ: في كل تسميع خانة لملاحظات الشيخ تُرسل للطالب، وخانة لملاحظة خاصة لا تُرسل. ولكل طالب تبويب «الملاحظات» يدوّن فيه الشيخ ملاحظاته المؤرخة، ويرسل ما يشاء منها بواتساب أو يجعلها خاصة.
• إرسال تقرير كل جلسة بواتساب: زر «📤 إرسال للطالب» في كل تسميع، أو «حفظ وإرسال» عند تسجيله. يرسل التقرير التسميع والتقدير والرواية وكل خطأ بموضعه ونوعه، مع التنبيه على المتكرر منها، وملاحظات الشيخ والواجب والموعد القادم. وتعرض الرئيسية تقارير اليوم التي لم تُرسل بعد، وقالب التقرير قابل للتعديل من الإعدادات.
• رسائل التذكير: رسالة جاهزة فيها موعد الحلقة القادم والواجب ومواضع الأخطاء، تُرسل بزر واحد عبر واتساب أو SMS إلى الطالب أو ولي أمره، أو تُنسخ. وقالب الرسالة قابل للتعديل من الإعدادات.
• الصفحة الرئيسية: طلاب حلقة اليوم، وطلاب حلقة الغد لتذكيرهم، والطلاب الذين عندهم أخطاء متكررة.
• يعمل دون إنترنت ويمكن تثبيته على شاشة الجوال الرئيسية.

دخول المشرف والمعلمين والطلاب من أجهزتهم (المزامنة)

عند ربط قاعدة بيانات بالمشروع تُحفظ البيانات في مكان واحد، فيدخل كل شخص من جواله برمزه:

• المشرف: يرى كل شيء، ويحدد رموز المعلمين.
• المعلم: يرى الطلاب ويسجّل لهم، وينشئ رموز الطلاب ويرسلها لهم بواتساب، ويعتمد ما سجّله الطلاب.
• الطالب: يرى صفحته وحدها (سجله، والأسبوع، والسرد، ودرجة الاختبار، وتقدمه نحو الختم)، ويسجّل تسميعه اليومي (من صفحة إلى صفحة، أنجز أو أخطأ، والآيات) وسرده، ثم يرسل التقرير للمعلم والمشرف. ويظهر ما سجّله عند الشيخ «بانتظار الاعتماد»، ويستطيع تعديله حتى يعتمده الشيخ. ولا تصله ملاحظات الشيخ الخاصة ولا بيانات غيره.

التفعيل (مرة واحدة):

1. في لوحة Vercel افتح المشروع ← Storage ← Create Database ← اختر Upstash (Redis، الخطة المجانية) ← Connect بالمشروع.
2. من Deployments أعد النشر (Redeploy) ليقرأ المشروع إعدادات قاعدة البيانات.
3. افتح التطبيق من جهاز المشرف ← الإعدادات ← ☁️ تفعيل المزامنة، وأنشئ رمز المشرف. تُرفع بيانات هذا الجهاز.
4. في الإعدادات اكتب رمز دخول لكل معلم وأرسله له، ومن «رموز دخول الطلاب» أنشئ رمز كل طالب وأرسله.
5. إذا كان عند معلم بيانات سابقة في جواله، فعند دخوله برمزه أول مرة تُضاف إلى البيانات المشتركة.

يبقى التطبيق يعمل دون إنترنت، وتُرسل التعديلات عند عودة الاتصال (☁️ في أعلى الشاشة: متزامن، ⏳ جارٍ، ⚠️ غير متصل). ودون قاعدة بيانات يعمل التطبيق محلياً على كل جهاز كما كان.

الخادم دالة واحدة في api/sync.js تتحقق من الرمز وصلاحياته في كل طلب.

التشغيل

لا يحتاج التطبيق إلى خادم ولا إلى تثبيت أي شيء، فهو ملفات HTML وCSS وJavaScript فقط.

• محلياً: python3 -m http.server ثم افتح http://localhost:8000.
• على Vercel (موصى به): من vercel.com/new اختر «Import» لهذا المستودع، واترك الإعدادات كما هي (Framework Preset: Other، بلا أمر بناء)، ثم Deploy. بعدها كل تحديث يُرفع إلى المستودع ينشره Vercel تلقائياً على الرابط نفسه خلال دقيقة تقريباً. إعدادات التخزين المؤقت في vercel.json.
• أو GitHub Pages: فعّله من Settings → Pages واختر الفرع.
• افتح الرابط من الجوال واختر «إضافة إلى الشاشة الرئيسية» ليعمل كتطبيق.

ملاحظات

• دون المزامنة تُحفظ البيانات في متصفح الجهاز نفسه (localStorage)، فصدّر نسخة احتياطية بانتظام.
• التذكير يجهّز الرسالة ويفتح واتساب أو تطبيق الرسائل، ثم يضغط المعلم «إرسال». الإرسال الآلي الكامل دون تدخل يحتاج إلى خادم وخدمة رسائل مدفوعة (مثل WhatsApp Business API).

مصادر نص المصحف

• عند الاتصال بالإنترنت: صفحات المصحف وخطوطها (QPC v2) من Quran.com عبر واجهتها البرمجية، وترقيم الصفحات ترقيمها.

• نص القرآن بالرسم العثماني (رواية حفص): موسوعة القرآن الكريم QuranEnc، عبر حزمة quran-json (رخصة CC BY-SA 4.0).

• تخطيط الصفحات والأسطر (15 سطراً) وفق مصحف المدينة طبعة 1441هـ: ملفات الصفحات في حزمة quran-qcf4 (رخصة MIT لبيانات الصفحات). لم تُضمَّن خطوط QCF4 لأن رخصتها لا تسمح بإعادة توزيعها.

• بدايات الأجزاء وأرباع الأحزاب: حزمة quran-meta (رخصة MIT).

• خط المصحف: Amiri Quran (رخصة SIL OFL 1.1، انظر fonts/OFL.txt).

الملفان quran-data.js وmushaf-lines.js مولَّدان آلياً من هذه المصادر بأدوات مجلد tools/ ولا يُعدَّلان يدوياً. تتحقق أداة الأسطر من أن كل كلمات النص (77,428 كلمة) موضوعة في أسطرها بالترتيب دون نقص. وهو بترميز خط مجمع الملك فهد للتنوين المتتابع (U+0656 وU+0657 وU+065E)، فيحوّله التطبيق عند العرض إلى رموز يونيكود القياسية (U+08F0 إلى U+08F2) التي يدعمها خط Amiri Quran.