# دليل منصة مصباح

> دليل تشغيلي بالعربية لمعلّمي ومشرِفي المساجد على منصة مصباح. يشرح الواجهة بخطوات واضحة مع أسماء الأزرار كما تظهر في المنتج.

هذا الموقع هو المرجع الرسمي لتشغيل مصباح من المستعرض. اللغة الأساسية: العربية (RTL). عند التعارض بين هذا الملف والواجهة الحيّة، اعتبر واجهة المنتج المصدر النهائي للسلوك.

إصدار المنصة الحالي: 1.3.10

## Guides

### البداية
- [كيف يعمل مصباح](https://manual.misbah.pro/start): نقطة البداية: نموذج مصباح المفاهيمي (مسجد، برنامج، حلقة، طالب، تسجيل، خطة، نشاط، نقاط)، الفرق بين قالب الخطة وخطة الطالب، أدوار المشرف والمعلّم والمستفيد، ومسار أول ثلاثين دقيقة.
- [تسجيل الدخول](https://manual.misbah.pro/login): الدخول: رقم الجوال يحدّد الحساب، ثم يُرسَل تحدٍّ (مفتاح مرور، رمز مصادقة، جهاز موثوق، رمز تحقق)، مع إلزام المشرفين بعامل حماية، ومسار منفصل للكادر باسم مستخدم.
- [دليل المعلم السريع](https://manual.misbah.pro/teacher): دليل المعلم: دخول باسم مستخدم، فتح الحلقة على تاريخ اليوم، حضور محفوظ ثم تسميع بالفعلي لا بالمطلوب، مع جدول مشكلات وحلولها وحدود صلاحية المعلّم.

### إدارة البرنامج
- [البرامج](https://manual.misbah.pro/program): البرامج: البرنامج كوعاء لدورة واحدة، متى تنشئ برنامجاً جديداً، مسارات الإنشاء الثلاثة، معالج بثماني خطوات، حالات نشط وغير نشط ومكتمل، والحفظ كقالب برنامج.
- [قوالب البرامج](https://manual.misbah.pro/program-templates): قوالب البرامج: ما تحفظه اللقطة وما لا تحفظه، قراءة بطاقة القالب (منشور/خاص، موثّق، التقييم، التثبيتات، الإصدار)، المفاضلة بين البدء من الصفر والنسخ والقالب، التثبيت ونتيجته، ثم حفظ قالبك ونشره.
- [الأداء](https://manual.misbah.pro/performance): الأداء: شاشة قراءة فقط، شريط نطاق التاريخ، بطاقات الحضور والأوجه والتقييم والإنجاز، تفصيل حسب قوالب الخطط، وقائمتا آخر الأنشطة وآخر الحضور.
- [الحلقات والمعلمون](https://manual.misbah.pro/groups): الحلقات والمعلمون: الحلقة كنطاق وصول، حضورية أو عن بُعد، حسابات المعلمين ورابط دخول الكادر، المعلمون المساعدون وصلاحية الانتهاء، ونقل الطلاب وحذف الحلقة.
- [الطلاب](https://manual.misbah.pro/students): الطلاب: الطالب سجل مسجد والتسجيل سجل برنامج، هيكلة حقول قابلة للتخصيص تقود النموذج والبحث والاستيراد، ثلاث طرق لإدخال الطلاب، وحذف التسجيل يُتلف تاريخه.
- [الحضور](https://manual.misbah.pro/attendance): الحضور: حالات بقيم من 0 إلى 200، حزم جاهزة أو حالات مخصصة، تشغيل النظام، مكافأة = قيمة الحالة ÷ 100 للسجلات اللاحقة، وتسجيل من اللوحة أو الحلقة.
- [المتابعة اليومية](https://manual.misbah.pro/activities): المتابعة اليومية: النشاط كسجل (تسميع أو مرن)، الكمية مقابل المطلوب والتقييم، ثم شاشة المشرف بفتراتها ونمطي عرضها وتصفيتها.
- [المحفظة والنقاط](https://manual.misbah.pro/wallet): المحفظة: وحدات نقاط بمعامل تحويل ووحدة افتراضية، محفظة لكل تسجيل، حركات إضافة وخصم وتعديل من مصادر النشاط والحضور والخطة واليد، وإجمالي النقاط = Σ(الرصيد × معامل التحويل).
- [التقارير](https://manual.misbah.pro/reports): التقارير: «تقرير شامل» أو «تقرير الحضور فقط»، مكوّنات الحضور والتقييم والإنجاز بأوزانها، أوزان قوالب الخطط، وملف يُنزَّل من القائمة.
- [الإشعارات](https://manual.misbah.pro/notifications): الإشعارات: معالج من ثلاث خطوات — المستلمون والقناة، تحرير الرسالة، معاينة وإرسال — مع متغيرات تُعبَّأ لكل طالب، ونطاق زمني للأنشطة، وقوالب جاهزة ومحفوظة.
- [شاشة العرض](https://manual.misbah.pro/monitor): شاشة العرض: قوالب جاهزة أو قالب مولَّد بالذكاء الاصطناعي، ترتيب بالتقدم أو بالنقاط، ألوان مستخرَجة من شعار المسجد، وعرض حيّ بملء الشاشة يتحدّث كل نصف دقيقة.

### الخطط
- [الخطط: المفهوم والأنواع](https://manual.misbah.pro/plans): نموذج الخطط في مصباح: الطبقات الخمس، الفرق بين القالب وخطة الطالب، نظام النوعين (قرآنية: ذكية وثابتة وحرة؛ مرنة: حرة وهيكل وبنود)، معنى الاكتمال لكل نوع، والقيود التي لا تتغيّر بعد الإنشاء.
- [الخطط القرآنية](https://manual.misbah.pro/quran-plans): الخطط القرآنية: اختيار النمط، ثم اتجاه الحفظ وأيام العمل والمقدار اليومي والحد الأقصى للأنشطة وسياسة التقريب وإعدادات التنقل والقفز والقواعد وتاريخ الانتهاء ووحدة النقاط.
- [الخطط المرنة](https://manual.misbah.pro/flexible-plans): الخطط المرنة: حرة وهيكل وبنود، مكتبة هياكل الخطط (جدول ونطاق رقمي)، تحرير البنود بحدودها ووحداتها، والمقدار المستهدف والتتبع التدريجي ووحدة النقاط.
- [المناهج الدراسية](https://manual.misbah.pro/curriculum): المناهج: بناء المنهج من القوالب، الخصائص المرئية وإعدادات الربط، التطبيق وإعادة التطبيق، ما يُحفظ من تقدّم الطالب وما يُعاد كتابته، والمزالق المعروفة.
- [متابعة خطط الطلاب](https://manual.misbah.pro/plan-progress): متابعة خطط الطلاب: جدول إدارة الخطط بوضعيه (قوالب ومنهج)، إضافة الخطط وربطها بالقوالب، تصحيح المواضع، التعديل والحذف الجماعيان، ومصير الخطة عند تغيّر الحلقة أو انتهاء البرنامج.
- [سلوكيات الربط](https://manual.misbah.pro/link-behaviors): سلوكيات الربط: المفهوم، الحقول المراقبة والمستهدفة، الدوال الخمس الجاهزة، السلوكيات العامة وسلوكيات المسجد، ربط السلوك بقالب وإعداداته، متى يُنفَّذ، نافذة الاختبار، والمزالق.
- [أمثلة السكربتات](https://manual.misbah.pro/behavior-scripts): أمثلة عملية لسلوكيات الربط السكربتية: قالبا البرنامج المنشوران «المسار التقليدي» و«موازنة تلقائية»، سكربتا «تثبيت» و«تحديد المستوى التلقائي» كاملين، سكربتان قصيران، وتشريح بنية أي سكربت وحالات اختباره.

### التدريس
- [الحلقات والتسميع](https://manual.misbah.pro/teaching): التدريس: الحضور يفتح التسميع، والخطة تحسب التسميع المطلوب، والمعلّم يسجّل الفعلي، والقواعد تحوّل الأداء إلى تقييم، والبنود تُملأ في الخطط المرنة.

### المسجد
- [التطبيقات](https://manual.misbah.pro/apps): مركز التطبيقات: أدوات على نطاق المسجد تخدم كل برامجه — النماذج، مكتبة هياكل الخطط، التخزين الموحّد، وحسابات واتساب. لكل تطبيق ميزة في الباقة تفتحه.
- [النماذج](https://manual.misbah.pro/forms): النماذج: بناء الحقول وربطها بهيكل الطالب، نشر الرابط العام، طابور المراجعة وحالاته، قبول الطلب بإنشاء طالب أو ربطه بسجل قائم، ومراجعة الأسماء المتشابهة.
- [تطبيق المستفيدين](https://manual.misbah.pro/consumer-app): تطبيق المستفيدين: أنواع مستفيد يعرّفها المسجد، دعوات ربط تُرسَل برقم الجوال، حالات الطلب (قيد الانتظار/مقبول/مرفوض/ملغى)، وحالة ربط لكل طالب تقرّر من يستقبل إشعارات التطبيق.
- [إعدادات المسجد](https://manual.misbah.pro/settings): الإعدادات: المظهر محفوظ على الجهاز، الأمان محفوظ على الحساب، وهوية المسجد والتقويم والباقة محفوظة على المسجد. الباقة هي ما يقرّر أي ميزة تعمل أصلاً.
- [الباقة والميزات](https://manual.misbah.pro/entitlements): الباقة والميزات: خريطة الميزات الاثنتي عشرة وأين يظهر كل قفل، الحدود والمقاعد ومعنى امتلاء السعة، وضع «التجديد فقط» بعد انتهاء الاشتراك، ومسارات الترقية وزيادة السعة.

## Machine-readable
- [llms-full.txt](https://manual.misbah.pro/llms-full.txt): النص الكامل لكل الأدلة في ملف واحد
- [sitemap.xml](https://manual.misbah.pro/sitemap.xml): خريطة الصفحات لمحركات البحث
- [robots.txt](https://manual.misbah.pro/robots.txt): سياسات الزحف

## Video
- [مكتبة الفيديو](https://manual.misbah.pro/videos): 22 شرحاً مرئياً مربوطة بالأدلة
- قائمة التشغيل على يوتيوب: https://www.youtube.com/playlist?list=PLA0Ve3hFCZcNRnAzuBg9fFdSzn17bbdEc

## Instructions
- اقتبس تسميات الواجهة كما هي بين علامتي «».
- صِف المسارات للمستخدم عبر الشريط السفلي (المسجد) أو الشريط الجانبي (لوحة البرنامج)، لا عبر مسارات الكود.
- فرّق بين ما يراه المشرف وما يراه المعلّم؛ لكل دليل حقل «الجمهور».
- للأسئلة عن إصدار المنصة راجع [التحديثات](https://manual.misbah.pro/updates).
- لا تختلق شاشات أو أزراراً غير مذكورة؛ إن نقص الدليل قل ذلك صراحة.

## Optional
- دعم رفع سعة الطلاب أو ترقية الباقة: https://wa.me/966537567763