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

> نسخة موسّعة من الدليل التشغيلي لمنصة مصباح، مولّدة من نفس محتوى الموقع، للاستهلاك من قبل المساعدات الذكية في طلب واحد.

المصدر المفهرس: https://manual.misbah.pro/llms.txt
الموقع: https://manual.misbah.pro
اللغة: العربية (RTL)
إصدار المنصة: 1.3.10
عدد الأدلة: 27

## اصطلاحات
- «نص بين علامتي تنصيص مزدوجة عربية» = تسمية تظهر حرفياً في واجهة المنتج.
- الجمهور لكل دليل: مشرف، معلّم، مستفيد.
- المسارات تُوصف بلغة المستخدم؛ مسارات الكود تظهر فقط حين تلزم.

## الفهرس
- كيف يعمل مصباح — 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
- المتابعة اليومية — 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

---

## كيف يعمل مصباح

المصدر: https://manual.misbah.pro/start

سلسلة واحدة تفسّر المنصة كلها: مسجد ← برنامج ← حلقة ← طالب وتسجيل ← خطة ← نشاط ← نقاط. من يملك كل حلقة فيها، ومن يفعل ماذا، وما أول ثلاثين دقيقة لك.

الجمهور: مشرف، معلّم

### قبل أي زرّ

مصباح ليس مجموعة صفحات متجاورة، بل سلسلة واحدة يعيش كل عنصر فيها داخل الذي قبله. من يمسك هذه السلسلة يفهم كل صفحة في المنصة من أول نظرة؛ ومن يفوّتها يظلّ يبحث عن زرّ في المكان الخطأ.

> **ملخّص سريع**
> - ما هذا؟ خريطة مفاهيم مصباح: ما كل عنصر، ولماذا وُجد، ومن يملكه.
> - لماذا يهمّك؟ أكثر أخطاء البداية ليست في الاستخدام بل في الفهم: إضافة طالب في المكان الخطأ، أو البحث عن الحضور خارج البرنامج.
> - لمن؟ مشرف، معلّم
> - الوقت المتوقّع: ١٥ دقيقة

القاعدة التي تختصر الباقي: **المسجد يملك الناس، والبرنامج يملك العمل**. الطلاب وملفاتهم والملفات والنماذج وأرقام واتساب كلها ملك المسجد وتبقى بعد كل دورة. أمّا الحلقات والتسجيلات والخطط والحضور والأنشطة والنقاط فملك برنامج بعينه، وتنتهي بانتهائه.

### السلسلة: من المسجد إلى النقاط

ثمانية عناصر مرتّبة. اقرأها بالترتيب مرة واحدة، فكل واحد منها يشرح الذي يليه.

- **١. المسجد** — حسابك كله: اشتراكه وشعاره وسجل طلابه وملفاته وأدواته المشتركة.
  وُجد ليكون الوعاء الثابت الذي تتعاقب البرامج داخله دون أن يُعاد بناء شيء.
- **٢. البرنامج** — دورة دراسية لها بداية ونهاية: الدورة الصيفية، الحلقات المسائية، برنامج النساء.
  وُجد ليفصل دورة عن دورة، فيبقى لكل واحدة حضورها وخططها وتقاريرها مستقلة.
- **٣. الحلقة** — مجموعة طلاب مع معلّم داخل برنامج واحد. تنتمي للبرنامج لا للمسجد.
  وُجدت لتقسيم البرنامج إلى وحدات تدريس حقيقية يفتح كل معلّم واحدة منها.
- **٤. الطالب** — سجل شخص واحد في **سجل المسجد**: اسمه وبيانات ملفه. لا برنامج له ولا حلقة.
  وُجد ليُكتب مرة واحدة ثم يُعاد استعماله في كل دورة بلا إدخال جديد.
- **٥. التسجيل** — الرابط بين طالب وبرنامج، وهو ما يحمل مقعده في الحلقة.
  وُجد ليستطيع طالب واحد أن يكون في برنامجين بتاريخين مختلفين دون أن يختلطا.
- **٦. الخطة** — ما يُتوقَّع من الطالب إنجازه: حفظ، مراجعة، متن، مهارة. مرتبطة بتسجيله لا باسمه.
  وُجدت ليعرف المعلّم ماذا يسمّع اليوم، ولتعرف اللوحة كم أنجز الطالب من المطلوب.
- **٧. النشاط** — سجل جلسة واحدة على خطة واحدة في يوم واحد: ما أُنجز، وكم كان المطلوب، وبأي تقدير.
  وُجد ليكون الأثر الذي تُبنى عليه التقارير والنقاط؛ بلا نشاط لا يتحرّك شيء.
- **٨. النقاط** — رصيد محفظة التسجيل، يزيد من الأنشطة ومن تسجيل الحضور ومن تعديلات يدوية.
  وُجدت لتحويل الإنجاز إلى حافز ملموس يراه الطالب وولي أمره.

> **ملاحظة:** لاحظ أثر البند الرابع والخامس: **الطالب لا يُضاف إلى برنامج، بل يُسجَّل فيه.** ولذلك تضيف الطالب من صفحة طلاب المسجد أولاً، ثم تسجّله في البرنامج. والواجهة تقولها بنفسها: “أضف الطلاب من صفحة طلاب المسجد أولًا، ثم ارجع هنا لاستيرادهم إلى هذا البرنامج.”

#### الخطة لها وجهان

أكثر ما يلتبس في المنصة أن كلمة **خطة** تدلّ على شيئين مختلفين تماماً. التفريق بينهما يحلّ نصف أسئلة الخطط:

- **قالب الخطة** — وصفة يعرّفها المشرف مرة واحدة: النطاق والمقدار وأيام العمل وقواعد التقدير ووحدة النقاط. لا تخصّ طالباً بعينه.
  وُجد ليُكتب الإعداد مرة واحدة بدل تكراره مع كل طالب — [التعريف الكامل](https://manual.misbah.pro/plans#term-plan-template).
- **خطة الطالب** — النسخة الفعلية على تسجيل طالب واحد، تحمل موضعه هو وتقدّمه هو وسجل أنشطته.
  هي ما يفتحه المعلّم في الجلسة وما تُحسب منه النقاط — [التعريف الكامل](https://manual.misbah.pro/plans#term-student-plan).

بعبارة واحدة: **القالب وصفة، وخطة الطالب طبق منها**. تعدّل القالب فتتأثر الخطط المشتقة منه؛ ويتقدّم الطالب في خطته دون أن يمسّ ذلك القالب ولا خطط زملائه.

![لوحة البرنامج مع الشريط الجانبي وأقسام التشغيل اليومية](https://manual.misbah.pro/images/start/01-program-dashboard.png)

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

**النشاط** — سجل عمل جلسة واحدة. نوعان: **تسميع** على خطة قرآنية يقاس بما تُلي من المصحف، و**نشاط مرن** على خطة غير قرآنية يقاس بوحدته الخاصة. ولكل نشاط خطة يُسجَّل عليها — لا يوجد نشاط بلا خطة.

### من يفعل ماذا

ثلاثة أدوار تلتقي حول الطالب نفسه، ولكل واحد منها بابه ومداه. اعرف مداك قبل أن تبحث عن صفحة لا تظهر لك.

*الأدوار الثلاثة*
| الدور | من أين يدخل | ما يملكه | ما لا يراه |
| --- | --- | --- | --- |
| [[مشرف المسجد]] مناسب | برقم جواله، فيصل إلى قائمة برامج المسجد. | كل شيء: البرامج والحلقات والطلاب والخطط والحضور والتقارير والنقاط والإشعارات والاشتراك. | لا شيء — وله أن يفتح صفحة التدريس ويدرّس أيضاً. |
| [[معلّم]] للعلم | باسم مستخدم وكلمة مرور من رابط دخول خاص بالمسجد. | حلقاته المسندة إليه وحدها: الحضور والتسميع والأنشطة وملفات طلابه فيها. | لوحة البرنامج كلها: الإعدادات، التقارير، الخطط، الطلاب على مستوى المسجد، والاشتراك. |
| [[مستفيد]] | من تطبيق مصباح على جواله، لا من لوحة الويب. | متابعة الطالب المرتبط به: تقدّمه وحضوره ونقاطه. | المنصة كلها؛ ليس مستخدماً في لوحة التحكم أصلاً. |

[[مستفيد]] فئتان: [[ولي أمر]] و[[طالب]]، ويستطيع المسجد أن يعرّف أنواعاً خاصة فوقهما — “أنشئ نوعاً مخصصاً (مثل «أب»، «أم»، «أخ») واربطه بفئة ولي أمر أو طالب.” — لأن “الفئة تحدد صلاحيات المستفيد في تطبيق مصباح.” التفصيل في [تطبيق المستفيدين](https://manual.misbah.pro/consumer-app).

> **ملاحظة:** **المعلّم المساعد ليس دوراً رابعاً** بل صلاحية مؤقّتة تُمنح معلّماً على حلقة ليست حلقته، ولها تاريخ انتهاء اختياري. راجع [الحلقات والمعلمون](https://manual.misbah.pro/groups).

> **نصيحة:** تسمية المشرف تختلف بين شاشة وأخرى: تجدها [[مشرف المسجد]] في أكثر المواضع، و[[مدير المسجد]] في صفحة الملف الشخصي. المقصود واحد.

### كيف تبدأ برنامجك الأول

قبل الثلاثين دقيقة قرار واحد يوفّر عليك أكثرها: من أين تبدأ البرنامج.

#### من أين تبدأ؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| برنامج من الصفر (الافتراضي) | أول برنامج في المسجد، ولا قالب يشبه ما تريد. | معالج إعداد يمرّ بك على كل قرار بالترتيب، فتفهم المنصة وأنت تبنيها. | أطول المسارات، وثماني خطوات قبل أول حلقة. |
| برنامج من قالب (الأنسب غالباً) | يوجد قالب منشور أو قالب حفظته أنت يشبه ما تريد بناءه. | بنية كاملة جاهزة: خطط ومناهج وحضور ونقاط، بلا إعداد يدوي. | بنية بلا طلاب؛ تبدأ التسجيل والتوزيع من جديد. |
| نسخ برنامج قائم (متقدّم) | فصل جديد بنفس البنية ونفس الطلاب داخل مسجدك. | المسار الوحيد الذي ينقل الطلاب وتسجيلاتهم وحلقاتهم معه. | يتطلّب برنامجاً قائماً، وينقل التقدّم مصفَّراً لا محفوظاً. |

المسارات الثلاثة كلها في صفحة إنشاء البرنامج، وتفصيلها في [قوالب البرامج](https://manual.misbah.pro/program-templates#start) و[دليل البرامج](https://manual.misbah.pro/program#create).

### أول ثلاثين دقيقة

الترتيب هنا ليس اقتراحاً بل ضرورة: كل خطوة تحتاج التي قبلها. اتبعها كما هي وستصل إلى أول جلسة تسميع مسجَّلة.

1. ادخل إلى المسجد
   أول ما تراه قائمة برامج المسجد. إن كانت فارغة ظهر “أنشئ برنامجاً جديداً أو ثبّت قالباً جاهزاً للبدء بسرعة” — [دليل الدخول](https://manual.misbah.pro/login).
2. أنشئ البرنامج
   «إنشاء برنامج» ثم اختر مسارك من القرار أعلاه. أدخل الاسم وتاريخي البداية والنهاية — [دليل البرامج](https://manual.misbah.pro/program).
3. أنشئ الحلقات وأضف المعلمين
   من «الحلقات والمعلمون»: «إضافة حلقة جديدة» لكل حلقة، و«إضافة معلم جديد» لكل معلّم ثم اربطه بحلقته. المعلّم يدخل باسم مستخدم من رابط خاص بمسجدك — [الحلقات والمعلمون](https://manual.misbah.pro/groups).
4. أضف الطلاب ثم سجّلهم
   خطوتان لا واحدة: «إضافة طالب جديد» في سجل المسجد، ثم استيرادهم إلى البرنامج من «الطلاب» داخل اللوحة، ثم توزيعهم على الحلقات — [دليل الطلاب](https://manual.misbah.pro/students).
5. عرّف الخطط وطبّقها
   ابنِ قالب خطة واحداً على الأقل — [[حفظ]] مثلاً — ثم طبّقه على تسجيلات الطلاب. لا تحاول إتقان كل الإعدادات من أول مرة — [الخطط والمناهج](https://manual.misbah.pro/plans).
6. فعّل الحضور
   اختر نظام حالات جاهزاً أو ابنِ حالاتك، وفعّله حتى يظهر للمعلّم في الحلقة — [دليل الحضور](https://manual.misbah.pro/attendance).
7. افتح الحلقة وسجّل أول جلسة
   من صفحة التدريس: الحضور أولاً ثم التسميع. هنا تتحوّل السلسلة كلها إلى أرقام حقيقية في «الأداء» — [دليل التدريس](https://manual.misbah.pro/teaching).

> **نصيحة:** الحدّ الأدنى للتشغيل: برنامج + حلقة واحدة + طلاب مسجَّلون + خطة واحدة. النقاط والإشعارات والتقارير وشاشة العرض كلها تُضاف لاحقاً من «أدوات إضافية» دون إعادة بناء شيء.

وإن كنت معلّماً لا مشرفاً فطريقك أقصر: [دليل المعلّم السريع](https://manual.misbah.pro/teacher) ثم [جلسة التدريس](https://manual.misbah.pro/teaching).

### أسئلة شائعة

**أضفت طالباً ولا أجده في البرنامج — لماذا؟**
لأن الإضافة والتسجيل عمليتان مختلفتان. الطالب أُضيف إلى سجل **المسجد**، ويلزم بعدها استيراده إلى البرنامج من صفحة «الطلاب» داخل لوحة البرنامج، ثم توزيعه على حلقة.

**ما الفرق بين الطالب والتسجيل؟**
الطالب شخص في سجل المسجد، والتسجيل هو حضوره في برنامج معيّن. طالب واحد قد يكون له ثلاثة تسجيلات في ثلاثة برامج، ولكل تسجيل حلقته وخططه ونقاطه وتاريخه المستقل.

**هل يمكن أن يكون طالب في حلقة دون تسجيل؟**
لا. مقعد الحلقة محمول على التسجيل نفسه، فلا سبيل إلى حلقة قبل التسجيل في البرنامج.

**من أين تأتي النقاط؟**
من ثلاثة مصادر: الأنشطة المسجَّلة على الخطط، وتسجيل الحضور إن كان نظام الحضور مربوطاً بوحدة نقاط، وتعديلات يدوية يجريها المشرف من المحفظة. راجع [دليل المحفظة](https://manual.misbah.pro/wallet).

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

**انتهى البرنامج — ماذا يبقى وماذا يذهب؟**
يبقى كل ما هو ملك المسجد: الطلاب وملفاتهم والملفات والنماذج وحسابات واتساب ومكتبة الهياكل. ويبقى كل ما داخل البرنامج محفوظاً للتقارير لكنه لا ينتقل من تلقائه إلى الدورة التالية — تنقله بنسخ البرنامج أو بحفظه قالباً.

---

## تسجيل الدخول

المصدر: https://manual.misbah.pro/login

لا تسأل المنصة عن كلمة مرور، بل تسأل عن رقمك ثم تختار لك أقوى إثبات متاح على جهازك — ولحسابات المشرفين إثبات دائم لا يُنزع.

الجمهور: مشرف، معلّم

### رقم ثم تحدٍّ، لا رقم ثم رمز

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

> **ملخّص سريع**
> - ما هذا؟ مدخل واحد بالجوال يختار أقوى طريقة تحقق متاحة، ومدخل منفصل للكادر باسم مستخدم.
> - لماذا يهمّك؟ حساب مشرف المسجد يفتح بيانات مئات الطلاب وأرقام أولياء أمورهم، فلا يُترك لرمز نصّي وحده.
> - لمن؟ مشرف، معلّم
> - الوقت المتوقّع: ٥ دقائق

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

**التحدّي** — سؤال أمني واحد يطرحه الخادم بعد التعرّف على حسابك: أثبِت أنك أنت. صيغته ليست ثابتة — بصمة، أو رمز من تطبيق، أو تأكيد على جهاز تملكه، أو رمز يصلك — و«طريقة أخرى» تعرض ما هو متاح لك فعلاً من هذه الصيغ.

شاشة البداية بسيطة: عنوانها “تسجيل الدخول” ووصفها “أدخل رقم جوالك للمتابعة”. أدخل «رقم الجوال» ثم «متابعة». وفي أي خطوة بعدها يعيدك «تغيير الرقم» إلى البداية، ويفتح «طريقة أخرى» قائمة البدائل.

![شاشة تسجيل الدخول مع حقل رقم الجوال وزر متابعة](https://manual.misbah.pro/images/login/01-phone.png)

### أي طريقة تستعمل؟

ما يظهر لك يقرّره الخادم، لكن **ما تُفعّله على حسابك** يقرّر ما يستطيع الخادم أن يعرضه. اقرأ هذه المفاضلة مرة، ثم فعّل ما يناسب طريقة عملك.

#### طرق إثبات الهوية
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «مفتاح المرور» (الأنسب غالباً) | تعمل من حاسوب أو جوال ثابت تملكه وحدك. | “أكد هويتك ببصمة الإصبع أو Face ID” — بلا رمز ولا انتظار ولا رسالة قد تتأخر. | مرتبط بالجهاز: تحتاج تسجيله على كل جهاز تعمل عليه. |
| «رمز التحقق» (الافتراضي) | أنت على جهاز غريب، أو لم تُسجّل شيئاً بعد. | “أدخل الرمز المرسل عبر واتساب إلى جوالك” — لا يحتاج إعداداً مسبقاً. | يعتمد على وصول الرسالة وعلى الشبكة، وهو أبطأ ما في القائمة. |
| «رمز المصادقة» | تريد بديلاً قوياً لا يحتاج شبكة ولا رسائل. | “افتح تطبيق المصادقة على جوالك (Google أو Microsoft أو Authy) وأدخل الرمز” — يعمل ولو انقطع الإنترنت عن جوالك. | يلزم تفعيله مرة واحدة على الحساب، وفقدان الجوال بلا بديل مشكلة. |

وهناك مسار رابع لا تُفعّله بنفسك بل تكسبه: «جهاز موثوق». إن كان لك جهاز سبق تأكيده، عرض عليك النظام «تأكيد الجهاز» — فتختار الرقم المطابق على ذلك الجهاز أو تُدخل الرمز الظاهر عليه، وتقرأ في هذه الأثناء “بانتظار التأكيد على الجهاز الموثوق”. وهو أسرع مسار للدخول من حاسوب غريب، بشرط أن يكون جهازك الموثوق بين يديك ومتصلاً.

قائمة «طريقة أخرى» تحمل عنواناً واحداً — “اختر كيف تريد المتابعة” — وتعرض ما هو متاح لحسابك فعلاً، والطريقة الجارية موسومة بـ“الطريقة الحالية”. وقد ترى فيها كذلك «رمز البريد» و«كلمة المرور» و«سؤال التحقق»: الأول لم يُفعَّل بعد (“التحقق عبر البريد غير مفعّل بعد.”)، والثاني مساره صفحة [دخول الكادر](https://manual.misbah.pro/login#staff)، والثالث خاص بتطبيق ولي الأمر.

> **نصيحة:** إن ألغيتَ حوار مفتاح المرور أو فشل، لا تتوقّف المحاولة: ينتقل بك النظام تلقائياً إلى الطريقة التالية المتاحة، ويبقى مفتاح المرور قائماً في «طريقة أخرى» لتعود إليه.

![تحدي الدخول بمفتاح المرور مع زر متابعة بمفتاح المرور](https://manual.misbah.pro/images/login/04-passkey-challenge.png)

![شاشة إدخال رمز التحقق مع زر تحقق وعدّاد إعادة الإرسال](https://manual.misbah.pro/images/login/02-otp.png)

![شاشة إدخال رمز تطبيق المصادقة](https://manual.misbah.pro/images/login/05-totp-challenge.png)

![شاشة تأكيد الدخول من جهاز موثوق مع الرقم المعروض](https://manual.misbah.pro/images/login/06-device-challenge.png)

![قائمة طريقة أخرى مع المسارات المتاحة للحساب](https://manual.misbah.pro/images/login/07-method-picker.png)

### الحماية الإلزامية للمشرفين

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

#### المسار الأول: مفتاح مرور

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

![صفحة تسجيل مفتاح مرور جديد مع الفوائد وزر التسجيل](https://manual.misbah.pro/images/login/03-passkey.png)

#### المسار الثاني: مصادقة ثنائية

إن تعذّر مفتاح المرور على جهازك، فالبديل ملزِم لا اختياري. تقول المنصة صراحة: “لن تتمكن من المتابعة بدون أحد الخيارين: مفتاح مرور أو مصادقة ثنائية.” وصفحة «فعّل المصادقة الثنائية» تشرح السبب: “لم يكتمل تسجيل مفتاح المرور، لذا فعّل رمزاً من تطبيق على جوالك لحماية حسابك قبل المتابعة.”

1. ثبّت تطبيق مصادقة
   “ثبّت تطبيقاً للمصادقة على جوالك، ثم امسح رمز QR أو الصق المفتاح.”
2. اربط الحساب
   امسح رمز QR، أو انسخ «المفتاح السري» بـ«نسخ المفتاح» وأدخله يدوياً في التطبيق.
3. أكّد الرمز
   “أدخل الرمز الظاهر في نفس التطبيق” — و“الرمز يتغيّر كل ~30 ثانية داخل التطبيق” — ثم «تأكيد والتفعيل».

![صفحة تفعيل المصادقة الثنائية مع رمز QR والمفتاح السري](https://manual.misbah.pro/images/login/08-enroll-totp.png)

> **لا تسقط آخر عامل:** لا يمكن إلغاء آخر مفتاح مرور ما لم تكن المصادقة الثنائية مفعّلة: “لا يمكن إلغاء آخر مفتاح مرور قبل تفعيل المصادقة الثنائية. يجب الإبقاء على أحدهما على الأقل.” والعكس صحيح تماماً عند تعطيل المصادقة الثنائية. أضِف البديل أولاً من [إعدادات الأمان](https://manual.misbah.pro/settings#security)، ثم احذف القديم.

> **نصيحة:** سجّل مفتاح مرور على جهازين لا جهاز واحد: حاسوب العمل وجوالك. ضياع جهاز واحد عندئذ مسألة إزعاج لا مسألة فقدان حساب.

### دخول الكادر — مسار آخر تماماً

المعلّم لا يدخل برقم جواله ولا يُنشئ حساباً بنفسه. له رابط خاص بالمسجد يفتح شاشة «دخول الكادر» — “اسم المستخدم وكلمة المرور” — والبيانات يسلّمها له مشرف البرنامج.

- الحقول «اسم المستخدم» و«كلمة المرور»، ثم «تسجيل الدخول».
- بعد النجاح يُفتح للمعلّم مسار «الحلقات» مباشرة، ولغيره رئيسية المسجد.
- رابط «تسجيل الدخول برقم الجوال» يعيدك إلى مسار المشرف إن فتحت الصفحة خطأً.
- كلمة المرور المؤقتة تُحوّلك فوراً إلى [تغيير كلمة المرور](https://manual.misbah.pro/login#password) قبل أي شيء.

> **ملاحظة:** رابط دخول الكادر خاص بكل مسجد، وتجده مع بيانات كل معلّم في [الحلقات والمعلمون](https://manual.misbah.pro/groups#access). ولا يخضع المعلمون لإلزام مفتاح المرور؛ فذاك خاص بحسابات مشرف المسجد ومدير النظام.

![شاشة دخول الكادر باسم المستخدم وكلمة المرور](https://manual.misbah.pro/images/login/09-staff-login.png)

وما يفعله المعلّم بعد الدخول مشروح في [الحلقات والتسميع](https://manual.misbah.pro/teaching)، وملخّصاً في [دليل المعلم](https://manual.misbah.pro/teacher).

### تغيير كلمة المرور

صفحة «تغيير كلمة المرور» تظهر في حالتين: إلزاماً حين تكون كلمتك مؤقتة — “غيّر كلمة المرور المؤقتة قبل المتابعة” — أو اختياراً حين تفتحها بنفسك: “أدخل كلمة المرور الحالية والجديدة”.

- ثلاثة حقول: الحالية، الجديدة، وتأكيدها، ثم «حفظ والمتابعة».
- الشرط: “كلمة المرور الجديدة يجب أن تكون 8 أحرف على الأقل”.
- وإن اختلف التأكيد ظهر: “كلمتا المرور غير متطابقتين”.

![شاشة تغيير كلمة المرور بحقولها الثلاثة](https://manual.misbah.pro/images/login/10-change-password.png)

أما إدارة مفاتيح المرور والمصادقة الثنائية والأجهزة المتصلة فمكانها «الإعدادات» ← «الأمان والحساب» — [التفاصيل هنا](https://manual.misbah.pro/settings#security).

### أسئلة شائعة

**لماذا اختلفت شاشة الدخول عمّا رأيته أمس؟**
لأن التحدّي ليس ثابتاً: يختاره الخادم بحسب ما هو مفعّل على حسابك وما يدعمه الجهاز الذي تستعمله الآن. افتح «طريقة أخرى» لترى بدائلك المتاحة.

**لا يصلني رمز التحقق.**
الرمز يصل عبر واتساب إلى الرقم المسجَّل على حسابك، لا برسالة نصية. تأكّد أن واتساب فعّال على ذلك الرقم، وانتظر انتهاء العدّاد ثم أعد الإرسال. وإن تكرّر التعذّر فافتح «طريقة أخرى» واستخدم مفتاح المرور أو رمز المصادقة.

**ما الفرق بين «رمز التحقق» و«رمز المصادقة»؟**
«رمز التحقق» ترسله إليك المنصة عند كل دخول. «رمز المصادقة» يولّده تطبيق على جوالك كل ثلاثين ثانية بلا إنترنت ولا رسائل، بعد أن تكون فعّلته مرة واحدة على حسابك.

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

**هل يحتاج المعلمون إلى مصادقة ثنائية؟**
لا. الإلزام يخصّ حسابات مشرف المسجد ومدير النظام. المعلمون يدخلون باسم مستخدم وكلمة مرور من رابط [دخول الكادر](https://manual.misbah.pro/login#staff).

**نسي المعلّم كلمة مروره.**
لا توجد استعادة ذاتية لحسابات الكادر. مشرف البرنامج يعيد ضبطها من [الحلقات والمعلمون](https://manual.misbah.pro/groups#access)، ثم يدخل المعلّم بكلمة مؤقتة ويغيّرها عند أول دخول.

---

## دليل المعلم السريع

المصدر: https://manual.misbah.pro/teacher

صفحة واحدة تكفي المعلّم: كيف يبدو يومه في المنصة، وما النموذج الذي يسجّل عليه، والمسار مرتّباً، وحلول ما يعترضه.

الجمهور: معلّم

### عشر دقائق، ونموذج واحد تسجّل عليه

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

> **ملخّص سريع**
> - ما هذا؟ المسار الكامل للمعلّم: الدخول، فتح الحلقة، الحضور، ثم التسميع أو النشاط.
> - لماذا يهمّك؟ لأن ما تسجّله هو مصدر تقارير المشرف وشاشة المسجد ومتابعة ولي الأمر.
> - لمن؟ معلّم
> - الوقت المتوقّع: ٥ دقائق قراءة

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

1. ادخل من رابط المسجد
   شاشة «دخول الكادر»: «اسم المستخدم» و«كلمة المرور» ثم «تسجيل الدخول». الرابط والبيانات يعطيك إياها مشرف البرنامج — [تفاصيل الدخول](https://manual.misbah.pro/login#staff).
2. افتح «الحلقات»
   شريطك السفلي فيه أيقونتان لا أكثر: «الحلقات» و«الإعدادات». وتظهر لك حلقاتك أنت وحدها.
   ![صفحة الحلقات كما يراها المعلّم مع بطاقات حلقاته](https://manual.misbah.pro/images/teacher/01-my-groups.png)
3. تأكّد من التاريخ
   الافتراضي هو اليوم. لا تغيّره إلا إن كنت تعوّض يوماً مضى.
4. سجّل الحضور ثم **احفظ**
   لكل طالب، أو «تحديد الحضور للجميع» ثم عدّل الاستثناءات. الحفظ شرط: قبله يبقى التسميع مغلقاً.
5. سجّل التسميع أو النشاط
   «تسميع جديد» ← اختر الخطة ← اقرأ النطاق المقترَح ← صحّحه إن اختلف الواقع ← أكّد ← أشّر على القواعد إن وُجدت.

> **نصيحة:** لا تؤجّل التسجيل إلى آخر الأسبوع. الحضور والتسميع يُسجَّلان بتاريخ اليوم الذي جرى فيه، والتعويض الرجعي قد يكون محدوداً بمدة يضبطها البرنامج.

### المطلوب والفعلي

التسميع المطلوب هو ما تقوله الخطة إنه ورد اليوم، وتحسبه المنصة لا أنت. والتسميع الفعلي هو ما سمّعه الطالب حقيقةً. الفرق بينهما ليس تفصيلاً محاسبياً: هو كل ما يقرؤه المشرف عن التزام هذا الطالب.

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

#### سمّعتَ للطالب مرتين في اليوم — أيّهما تختار؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «تعديل النشاط السابق» (الافتراضي) | تصحّح تسجيلاً أخطأت فيه، أو تُكمل نطاقاً أدخلته ناقصاً قبل قليل. | يبقى للجلسة سجل واحد، فلا تتضخّم عدّة أنشطة اليوم ولا تتكرّر النقاط. | يستبدل القيم القديمة، فما كان فيها يضيع. |
| «تسجيل نشاط جديد» (الأنسب غالباً) | هي جلسة مستقلة فعلاً: سمّع أول الحصة وراجع آخرها. | يحفظ الجلستين منفصلتين بتقييم لكل منهما، وهو أصدق في التقارير. | يحتسب نشاطين في اليوم، وقد يصطدم بحدّ الأنشطة اليومي إن كان مضبوطاً. |

- المقدار يُعرض بالأوجه إن زاد عن خمسة عشر سطراً، وبالأسطر دون ذلك.
- إن نبّهك الحوار بأن المقدار “أكبر بكثير من المطلوب” فراجع **موضع البداية** أولاً؛ هو مصدر الخطأ غالباً.
- للخطط غير القرآنية يُفتح مسار آخر: «تسجيل الكمية» أو «اختيار النشاط» أو تعبئة البنود.

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

### ما يعترضك، وحلّه في سطر

هذه أكثر ما يوقف المعلّم في المنصة، وكلّها يُحلّ في دقيقة أو يُحال إلى المشرف.

| ما تراه | السبب | الحل |
| --- | --- | --- |
| «تسميع جديد» معطَّل بتحفّظ | لم تُحفَظ حالة حضور الطالب لهذا اليوم. | حدّد الحالة ثم اضغط «حفظ» — التحديد وحده لا يكفي. |
| “يرجى إضافة خطط للطالب قبل تسجيل التسميع” غير مناسب | لا خطة مرتبطة بتسجيل الطالب. | اطلب من المشرف تطبيق خطة أو منهج عليه. |
| لا تظهر أدوات الحضور أصلاً للعلم | نظام الحضور غير مفعّل في البرنامج. | المشرف يفعّله من [هيكلة الحضور](https://manual.misbah.pro/attendance#structure). |
| “تم بلوغ الحد الأقصى للأنشطة لهذا اليوم” بتحفّظ | البرنامج يحدّ عدد الأنشطة اليومية. | عدّل النشاط السابق بدل إنشاء نشاط جديد. |
| طالب غير موجود في حلقتك للعلم | لم يُوزَّع عليها. | المشرف يوزّعه من [الحلقات والمعلمون](https://manual.misbah.pro/groups#groups). |
| “لا توجد حلقات معيّنة لك” غير مناسب | حسابك غير مرتبط بحلقة، أو انتهت صلاحية وصولك إليها. | المشرف يربطك أو يمدّد الصلاحية من [صلاحيات الوصول](https://manual.misbah.pro/groups#access). |
| “هذا اليوم للعرض فقط” بتحفّظ | تجاوزت مدة التعديل الرجعي المسموحة. | سجّل في يومه، أو اطلب من المشرف تسجيل التعويض. |
| تُطلب منك كلمة مرور جديدة للعلم | كلمة مرورك الحالية مؤقتة. | أكمل [تغيير كلمة المرور](https://manual.misbah.pro/login#password) ثم تابع. |

### حدود حساب المعلّم

حسابك مخصَّص للتدريس لا للإدارة، وهذا مقصود: يقلّل ما يمكن أن يُخطأ فيه، ويحفظ خصوصية بقية الطلاب.

- ترى **حلقاتك أنت** وطلابها فقط.
- تسجّل الحضور والتسميع والأنشطة، ولا تعرّف حالات الحضور ولا تنشئ الخطط.
- لا تنشئ برامج، ولا تعدّل هيكلة الطلاب، ولا ترسل إشعارات البرنامج.
- ما تسجّله يظهر فوراً للمشرف في [الأداء](https://manual.misbah.pro/performance) و[المتابعة اليومية](https://manual.misbah.pro/activities).

> **ملاحظة:** إن كنت معلّماً مساعداً على حلقة زميلك فستُوسَم بـ“معلم مساعد”، وقد يكون لوصولك تاريخ انتهاء يضعه المشرف. تفاصيل ذلك في [حدود المعلّم](https://manual.misbah.pro/teaching#access).

### أسئلة شائعة

**نسيت كلمة المرور.**
مشرف البرنامج يعيد ضبطها لك من تبويب المعلمين؛ لا توجد استعادة ذاتية لحسابات الكادر. ستدخل بكلمة مؤقتة ثم تغيّرها فوراً.

**هل أستطيع تسجيل حضور يوم مضى؟**
نعم، غيّر التاريخ في أعلى صفحة الحلقة قبل التسجيل — ما لم يحدّ البرنامج مدة التعديل الرجعي.

**سجّلت لطالب خطأً.**
افتح الخطة نفسها لليوم نفسه واختر «تعديل النشاط السابق». وللحضور غيّر الحالة ثم احفظ.

**هل أرى طلاب حلقات غيري؟**
لا. لفتح حلقة إضافية يلزم أن يربطك بها مشرف البرنامج من [الحلقات والمعلمون](https://manual.misbah.pro/groups#access).

**هل أستطيع تعديل خطة طالب؟**
لا. الخطط والمناهج من عمل المشرف. أنت تسجّل عليها، وإن رأيت أن الخطة لا تناسب الطالب فأبلغ المشرف ليعدّلها.

---

## البرامج

المصدر: https://manual.misbah.pro/program

البرنامج وعاء الدورة الدراسية: له تاريخ بداية ونهاية، وتعيش داخله الحلقات والتسجيلات والخطط والحضور والتقارير.

الجمهور: مشرف

### البرنامج وعاء الدورة

كل شيء في مصباح تقريباً يحدث **داخل برنامج**: الحلقات تنتمي إليه، والطلاب يُسجَّلون فيه، والخطط والحضور والنقاط والتقارير كلّها في نطاقه. والمسجد الواحد يشغّل عدة برامج في وقت واحد — صيفي ومسائي ونسائي — دون أن يختلط بعضها ببعض.

> **ملخّص سريع**
> - ما هذا؟ وعاء له اسم وتاريخا بداية ونهاية، تعيش داخله كل بيانات دورة دراسية واحدة.
> - لماذا يهمّك؟ فصل الدورات هو ما يجعل تقرير الصيف لا يحمل أرقام الشتاء، ويجعل خطة هذا العام تبدأ من الصفر.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة لإعداد أول برنامج

المسار: الشريط السفلي ← الرئيسية

صفحة “البرامج الدراسية” تعرض برامج المسجد بتبويبات «الكل» و«النشطة» و«غير نشطة» و«مكتملة» — والافتراضي هو «النشطة» — مع بحث و«ترتيب حسب».

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

![صفحة البرامج الدراسية في الرئيسية مع تبويبات الحالة وبطاقات البرامج](https://manual.misbah.pro/images/program/01-programs-list.png)

> **ملاحظة:** بيانات الطالب نفسها تعيش على مستوى **المسجد** لا البرنامج. يُضاف الطالب مرة، ثم يُسجَّل في البرامج التي يشارك فيها — [دليل الطلاب](https://manual.misbah.pro/students).

### متى تنشئ برنامجاً جديداً؟

هذا أكثر سؤال يتردّد عند بداية كل فصل، والجواب يُحسم بسؤال واحد: هل تريد أن تكون أرقام هذه المرحلة منفصلة عمّا قبلها؟

#### برنامج جديد، أم دورة داخل البرنامج القائم؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| برنامج جديد (الأنسب غالباً) | فصل أو دورة جديدة لها طلابها وحضورها وتقاريرها المستقلة، أو جمهور مختلف كلّياً. | تبدأ الخطط من الصفر، ولا تختلط نسب الفصل الماضي بالجديد، ويُؤرشَف القديم كما هو. | تعيد التسجيل والتوزيع وتطبيق الخطط. خفّف ذلك بـ«نسخ من برنامج» أو بقالب. |
| استمرار البرنامج القائم (الافتراضي) | التغيير داخل الدورة نفسها: حلقة تُضاف، خطة تُعدَّل، طالب يلتحق متأخراً. | يبقى تقدّم الطلاب ومحافظهم متصلاً، ولا تعيد أي إعداد. | الأرقام تراكمية؛ ولن تستطيع قول “هذه نتائج الفصل الثاني وحده”. |
| مدّ تاريخ النهاية (متقدّم) | الدورة نفسها امتدّت أسابيع إضافية ولم يتغيّر مضمونها. | أخفّ حلّ: تعديل تاريخ واحد في الإعدادات. | الخطط التي لا تاريخ نهاية لها تتبع نهاية البرنامج، فمدُّه يمدّها معه. |

> **نصيحة:** قاعدة عملية: إن كنت ستكتب في نهايتها تقريراً مستقلاً تسلّمه لجهة، فهي **برنامج**. وإن كانت مجرد مرحلة داخل تقرير أكبر، فهي تعديل داخل البرنامج القائم.

### مسارات الإنشاء الثلاثة

من قائمة البرامج اضغط «إنشاء برنامج»، فتفتح صفحة فيها “ابدأ بسرعة” بمسارين، ثم قسم “أو من قالب”.

*أي مسار تختار*
| المسار | ماذا يفعل | متى تختاره |
| --- | --- | --- |
| «من الصفر» للعلم | “إعداد البرنامج خطوة بخطوة من البداية.” — ينقلك إلى معالج الإعداد الكامل. | أول برنامج لك، أو بنية مختلفة جوهرياً عن كل ما سبق. |
| «نسخ برنامج» مناسب | “انسخ إعدادات برنامج موجود في المسجد وعدّل ما تحتاج.” | فصل جديد بالبنية نفسها — أسرع طريق للدورة الثانية. |
| «تثبيت» للعلم | يثبّت قالباً من «المنشورة» أو «قوالبي» كبرنامج جديد. | بنية معتمدة تريد تكرارها، أو منهج مسجد آخر تثق به. |

ومتى لم يوجد برنامج بعد، يقول المسار الثاني صراحة: “لا توجد برامج للنسخ منها بعد — أنشئ برنامجاً أولاً.”

![صفحة إنشاء برنامج تعرض من الصفر ونسخ من برنامج وبطاقات القوالب](https://manual.misbah.pro/images/program/02-create-hub.png)

#### قوالب البرامج

القالب “يُثبَّت الحضور، المحفظة، القوالب، المناهج، والسلوكيات تلقائياً”، ويمكنك عند التثبيت اختيار «تضمين الحلقات» — “نسخ الحلقات المعرّفة في القالب إلى البرنامج الجديد” — وتسمية البرنامج وضبط تاريخيه.

> **القالب نسخة، لا اشتراك:** تثبيت قالب يبني لك **نسخة خاصة** تملكها وتعدّلها كما تشاء. ولا تصلك تحديثات صاحبه بعد ذلك، ولا تصله تعديلاتك. فإن أردت إصداراً أحدث من قالب، ثبّته من جديد؛ ولا تنتظر أن يتحدّث برنامجك وحده. التفصيل في [قوالب البرامج](https://manual.misbah.pro/program-templates).

ولحفظ برنامجك الحالي قالباً: من «إعدادات البرنامج» قسم «قوالب البرامج» اضغط «حفظ كقالب» — “احفظ الحضور، المحفظة، القوالب، المناهج، والسلوكيات كقالب قابل لإعادة الاستخدام في مسجدك أو للنشر للعامة.” ومن رابط «مكتبة القوالب» تدير قوالبك وتنشرها.

> **تحذير:** النشر للعامة لا رجعة فيه: “النشر نهائي ولا يمكن التراجع عنه. سيصبح القالب متاحاً لجميع المساجد في تبويب القوالب المنشورة.” راجع القالب ومسمّيات حلقاته قبل النشر، فهي تصير علناً.

### معالج الإعداد بثماني خطوات

مسار «من الصفر» يمرّ بثماني خطوات: “أنشئ البرنامج ثم اربط الطلاب والنقاط والخطط والحضور والحلقات في جلسة واحدة منظّمة.” ولك أن تتخطّى ما شئت وتكمله لاحقاً من اللوحة.

1. «بيانات البرنامج»
   «اسم البرنامج الدراسي» و«تاريخ البداية» و«تاريخ النهاية المتوقع». وتاريخ النهاية ليس شكلياً: الخطط التي لا نهاية لها تنتهي بانتهاء البرنامج.
2. «استيراد الطلاب»
   جلب طلاب المسجد الموجودين إلى البرنامج — [دليل الطلاب](https://manual.misbah.pro/students#enrollment).
3. «نظام النقاط»
   إنشاء وحدات المحفظة إن كان البرنامج تحفيزياً — [المحفظة](https://manual.misbah.pro/wallet#units).
4. «قوالب الخطط»
   تأسيس ما يُتوقَّع من الطالب إنجازه — [الخطط](https://manual.misbah.pro/plans).
5. «نظام الحضور»
   تعريف الحالات وقيمها وتفعيل النظام — [الحضور](https://manual.misbah.pro/attendance#structure).
6. «إعداد الحلقات»
   إنشاء الحلقات وربط المعلمين — [الحلقات والمعلمون](https://manual.misbah.pro/groups).
7. «توزيع الطلاب»
   توزيع المسجَّلين على الحلقات؛ وطالب بلا حلقة لا يراه أي معلم.
8. «اكتمل»
   الانتقال إلى لوحة البرنامج وبدء التشغيل اليومي.

> **نصيحة:** لا تحاول إتقان كل خطوة من أول مرة. الحدّ الأدنى للتشغيل: بيانات البرنامج + حلقة واحدة + طلاب موزَّعون. وما عداه يُضبط لاحقاً من اللوحة دون إعادة إنشاء، ومن الشريط زر «إنهاء الإعداد لاحقاً».

![معالج إنشاء البرنامج مع شريط الخطوات الثماني](https://manual.misbah.pro/images/program/03-wizard-steps.png)

> **ملاحظة:** عدد البرامج محدود بباقة المسجد؛ عند بلوغ الحدّ تظهر “وصلت للحد الأقصى للبرامج المسموح بها.” راجع [الصلاحيات والباقة](https://manual.misbah.pro/entitlements).

### لوحة البرنامج

من بطاقة البرنامج تدخل لوحته، والشريط الجانبي فيها هو خريطة التشغيل اليومي.

فيديو:  https://www.youtube.com/watch?v=W0_By8bfaMA

| القسم | لماذا تفتحه | الدليل |
| --- | --- | --- |
| «الأداء» | قراءة سريعة لمؤشرات الفترة | [الأداء](https://manual.misbah.pro/performance) |
| «الحلقات والمعلمون» | الحلقات وحسابات المعلمين وصلاحياتهم | [الحلقات والمعلمون](https://manual.misbah.pro/groups) |
| «الطلاب» | التسجيل في البرنامج والتوزيع والخطط | [الطلاب](https://manual.misbah.pro/students) |
| «متابعة يومية» | ما سجّله المعلمون صفّاً صفّاً | [المتابعة اليومية](https://manual.misbah.pro/activities) |
| «الخطط» أو «المناهج» | ما يُتوقَّع من الطالب إنجازه | [الخطط](https://manual.misbah.pro/plans) |
| «الحضور» | الهيكلة والتسجيل اليومي | [الحضور](https://manual.misbah.pro/attendance) |
| «التقارير» | ملف الفترة بأوزانه | [التقارير](https://manual.misbah.pro/reports) |
| «أدوات إضافية» | المحفظة والإشعارات وشاشة العرض والإعدادات | [المحفظة](https://manual.misbah.pro/wallet) |

![الشريط الجانبي في لوحة البرنامج مع أقسام التشغيل](https://manual.misbah.pro/images/program/04-dashboard-nav.png)

### نشط وغير نشط ومكتمل

من «إعدادات البرنامج» تضبط «حالة البرنامج». الحالات الثلاث تصف مرحلة الدورة، ولكل واحدة وصفها الذي تكتبه المنصة بجانبها.

*ماذا تفعل كل حالة*
| الحالة | وصفها في المنصة | أثرها الفعلي |
| --- | --- | --- |
| [[نشط]] مناسب | “مفتوح للمشاركة” | التشغيل الكامل: المعلمون يرون حلقاته ويسجّلون فيها. |
| [[غير نشط]] بتحفّظ | “موقوف مؤقتاً” | يختفي من صفحة المعلمين فيتوقّف التسجيل، وتبقى البيانات كاملة للمشرف. |
| [[مكتمل]] للعلم | “مغلق للتعديل” | أرشفة: يختفي من صفحة المعلمين كذلك، وتُحتسب مدّته منتهية، وتبقى تقاريره وسجلاته للاطلاع. |

> **ما الذي يجري للبيانات؟:** **لا شيء.** [[غير نشط]] و[[مكتمل]] لا يحذفان طالباً ولا سجلاً ولا رصيداً: “تعطيل البرنامج يوقف استخدامه دون حذف الطلاب أو البيانات. يمكنك إعادة تفعيله لاحقاً من هذه الصفحة.” الأثر الوحيد المحسوس أن البرنامج يغادر قائمة المعلمين، فلا يستطيعون فتح حلقاته لتسجيل حضور أو تسميع. والمشرف يبقى يقرأ كل شيء ويصدر التقارير.

> **نصيحة:** الفرق العملي بين الحالتين تنظيمي: استعمل [[غير نشط]] لتوقّف مؤقت تنوي الرجوع منه — إجازة، أو تعليق أسبوعين — و[[مكتمل]] لدورة انتهت وانتقلت إلى الأرشيف. وتبويبات الصفحة الرئيسية تفصل بينهما، فيبقى المسجد مرتّباً.

#### الحذف

في قسم “منطقة الخطر” زرّ «حذف البرنامج»: “حذف البرنامج وجميع البيانات المرتبطة به. لا يمكن التراجع عن هذا الإجراء.” ويعدّد الحوار ما سيُحذف: [[سجلات الحضور]] و[[الحلقات]] و[[المشاركون]] و[[التسجيل والنشاط]].

> **الحذف لا يطلب منك كتابة شيء:** على خلاف حذف الحلقة أو الطالب، حذف البرنامج **لا يطلب عبارة تأكيد مكتوبة** — نقرتان على “نعم، احذف” وينتهي كل شيء. لذلك: لا تحذف برنامجاً انتهى، بل اجعله [[مكتمل]]. وإن كنت مضطراً إلى الحذف فاحفظه قالباً أولاً لتبقى بنيته.

![صفحة إعدادات البرنامج مع حالة البرنامج وقسم قوالب البرامج ومنطقة الخطر](https://manual.misbah.pro/images/program/05-program-settings.png)

### أسئلة شائعة

**متى أنشئ برنامجاً جديداً بدل تعديل القائم؟**
حين تريد أرقاماً مستقلة: فصل أو دورة جديدة لها تقريرها الخاص. أمّا التغيير داخل الدورة نفسها — حلقة تُضاف أو خطة تُعدَّل — فيبقى في البرنامج القائم. التفصيل في [متى تنشئ برنامجاً جديداً](https://manual.misbah.pro#when).

**جعلت البرنامج «مكتمل» — هل فقدت بياناته؟**
لا. «مكتمل» أرشفة لا حذف: التقارير والسجلات والأرصدة كلها باقية وأنت تراها. الأثر الوحيد أن البرنامج يغادر قائمة المعلمين فلا يستطيعون التسجيل فيه. وتستطيع إعادته [[نشط]] متى شئت.

**المعلمون لا يرون البرنامج في صفحتهم.**
افحص حالته أولاً: صفحة المعلم لا تعرض إلا البرامج [[نشط]]. فإن كانت الحالة صحيحة فالمشكلة في ربط المعلم بالحلقة — راجع [الحلقات والمعلمون](https://manual.misbah.pro/groups#teachers).

**هل يمكن نقل طالب بين برنامجين؟**
الطالب واحد على مستوى المسجد، وله تسجيل مستقل في كل برنامج. سجّله في البرنامج الجديد من صفحة «الطلاب» داخل لوحته؛ وتسجيله في البرنامج القديم يبقى كما هو بتاريخه وتقاريره.

**ما الفرق بين قالب البرنامج وقالب الخطة؟**
قالب البرنامج يحفظ بنية برنامج كاملة — حضور ومحفظة وقوالب ومناهج وسلوكيات — لتثبيتها برنامجاً جديداً. وقالب الخطة يحفظ مساراً دراسياً واحداً يُطبَّق على الطلاب داخل برنامج قائم.

**هل يصلني تحديث القالب الذي ثبّتُه؟**
لا. التثبيت ينسخ القالب نسخة مستقلة تملكها، فلا تصلك تعديلات صاحبه ولا تصله تعديلاتك. للحصول على إصدار أحدث ثبّته برنامجاً جديداً.

**مددت تاريخ نهاية البرنامج — هل يؤثر ذلك في الخطط؟**
نعم. الخطة التي لا تاريخ نهاية لها تنتهي بانتهاء البرنامج، فمدُّ البرنامج يمدّها معه. أمّا الخطط التي لها تاريخ نهاية خاص فلا تتأثر.

---

## قوالب البرامج

المصدر: https://manual.misbah.pro/program-templates

قالب البرنامج لقطة مجمَّدة من بنية برنامج — خططه ومناهجه ووحدات نقاطه وسلوكياته ونظام حضوره — تُثبَّت برنامجاً جديداً في دقائق، في مسجدك أو في مسجد آخر.

الجمهور: مشرف

### ما قالب البرنامج

إعداد برنامج من الصفر عمل يوم كامل: قوالب خطط، منهج، وحدات نقاط، حالات حضور، سلوكيات ربط. قالب البرنامج يجمّد هذا الإعداد كله في لقطة واحدة، فيصير إعداد البرنامج التالي — عندك أو عند مسجد آخر — دقائق معدودة.

> **ملخّص سريع**
> - ما هذا؟ القالب لقطة مجمَّدة من **بنية** برنامج: كل ما يُضبط مرة، بلا طالب ولا سجلّ ولا تقدّم.
> - لماذا يهمّك؟ المسجد الذي أتقن إعداد دورة واحدة لا يعيد إتقانه كل فصل، ولا يبدأ المسجد الجديد من الصفر.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة

المسار: الشريط السفلي ← الرئيسية ← مكتبة القوالب

- **القالب** — وعاء له اسم ووصف ووسوم وغلاف، يعيش في المسجد الذي أنشأه، ويحمل إصداراته.
  هو ما يراه الآخرون ويثبّتونه؛ الاسم والوصف هما واجهته.
- **الإصدار** — اللقطة نفسها. «رفع تحديث للقالب» ينشئ إصداراً جديداً برقم أكبر، والقديم يبقى قابلاً للتثبيت.
  تطوير القالب لا يكسر ما ثبّته الآخرون على إصدار سابق.
- **التثبيت** — إنشاء برنامج جديد في مسجدك من إصدار مختار. يُسجَّل في عدّاد القالب ويمنحك حق تقييمه.
  عدد التثبيتات هو الدليل العملي الوحيد على أن القالب مجرَّب لا مجرد فكرة.
- **منشور أم خاص** — [[خاص]] يعني مسجدك وحده يراه، و[[منشور]] يعني كل المساجد. والنشر **قرار نهائي**.
  لا يوجد زر يعيد القالب إلى الخصوصية بعد نشره.

**اللقطة** — صورة ثابتة من بنية البرنامج لحظة الحفظ. لا ترتبط بالبرنامج المصدر بعدها: تعديل البرنامج بعد الحفظ لا يغيّر اللقطة، وتعديل اللقطة غير ممكن — تُرفع إصداراً جديداً بدلاً من ذلك.

**موثّق** — وسم يمنحه المشرف العام للمنصة وحده، ووصفه في الواجهة “القوالب الموثّقة تظهر بشارة خضراء وتُفضَّل في التصفح.” لا يوجد طلب توثيق تقدّمه أنت ولا طابور مراجعة معلن.

### من الصفر، أم نسخ، أم قالب؟

صفحة «إنشاء برنامج» تعرض ثلاثة مسارات تحت عنوانين: “ابدأ بسرعة” و“أو من قالب”. الفرق بينها ليس في السرعة وحدها بل في **ما ينتقل معك**.

#### أي مسار يناسبك؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| من الصفر | أول برنامج في المسجد، أو دورة تختلف جوهرياً عن كل ما سبق. | تفهم كل خيار في المنصة لأنك اخترته بنفسك، خطوة بعد خطوة. | أطول المسارات، ومعالج الإعداد وحده ثماني خطوات. |
| نسخ من برنامج (الافتراضي) | الفصل التالي بنفس الطلاب ونفس البنية داخل مسجدك. | المسار الوحيد الذي ينقل **الطلاب** معه، ومعهم تسجيلاتهم وخططهم وحلقاتهم. | محصور في برامج مسجدك، ويتطلب برنامجاً قائماً أصلاً. |
| من قالب (الأنسب غالباً) | بنية معتمدة تريد تكرارها، أو تجربة مسجد آخر تريد البناء عليها. | بنية ناضجة كاملة — خطط ومناهج وحضور ونقاط — بلا إعداد يدوي. | بنية فقط: لا طلاب ولا تسجيلات، وتبدأ التوزيع من جديد. |

- **من الصفر** — “إعداد البرنامج خطوة بخطوة من البداية.”
- **نسخ برنامج** — “انسخ إعدادات برنامج موجود في المسجد وعدّل ما تحتاج.”
- **أو من قالب** — “اختر قالباً منشوراً أو من قوالبك المحفوظة، ثم ثبّته كبرنامج جديد في المسجد.”

> **انتبه:** **«نسخ من برنامج» ينقل الطلاب، والقالب لا ينقلهم.** النسخ يأخذ معه الحلقات والتسجيلات وخطط الطلاب — مع **تصفير التقدّم**: الاكتمال وعدد الأنشطة والمقادير المنجزة كلها تعود إلى الصفر، وسجلّ الأنشطة والمعاملات لا يُنقل أصلاً. وأرصدة النقاط خيار تحدّده أنت بين «نسخ الأرصدة» و«أرصدة جديدة».

إن لم يكن في المسجد برنامج بعد، يبقى مسار النسخ معطّلاً برسالة “لا توجد برامج للنسخ منها بعد — أنشئ برنامجاً أولاً.” وفي كل المسارات يسري حدّ الباقة على عدد البرامج: “وصلت للحد الأقصى للبرامج المسموح بها في هذه المسجد.” — راجع [الباقة والميزات](https://manual.misbah.pro/entitlements#limits).

![صفحة إنشاء برنامج تعرض من الصفر ونسخ من برنامج وقسم القوالب](https://manual.misbah.pro/images/program-templates/01-create-hub.png)

### ما تحفظه اللقطة وما لا تحفظه

هذا أهم ما يجب أن تعرفه قبل أن تثبّت قالباً أو تنشر قالبك: اللقطة تحفظ **البنية** كاملة ولا تحفظ **الناس** ولا **السجلّات**.

*محتوى اللقطة*
| العنصر | الحالة | التفصيل |
| --- | --- | --- |
| قوالب الخطط مناسب | يُحفظ | “قلب البرنامج — خطط الحفظ والمراجعة والأنشطة” بكل إعداداتها: أيام العمل، الاتجاه، مواضع البداية والنهاية، الدستور، وحدة النقاط. |
| المناهج مناسب | يُحفظ | “تجميع الخطط في مسارات تعليمية جاهزة للطلاب” مع ترتيبها وخصائصها المرئية. |
| هياكل الخطط مناسب | يُحفظ | “جداول ونطاقات للخطط المرنة المنظمة” — راجع [مكتبة الخطط](https://manual.misbah.pro/apps#library). |
| نظام الحضور مناسب | يُحفظ | “حالات الحضور والغياب جاهزة للاستخدام” بقيمها وألوانها وحالتها الافتراضية. |
| المحفظة مناسب | يُحفظ | “وحدات النقاط والمكافآت” مع معدّل التحويل والوحدة الافتراضية. |
| سلوكيات الربط مناسب | يُحفظ | “أتمتة ذكية تربط بين الخطط عند التقدم”. |
| قوالب الإشعارات بتحفّظ | يُحفظ دائماً | نصوص الرسائل تنتقل مع القالب بلا خيار استثناء — راجعها قبل النشر. |
| الحلقات للعلم | اختياري | “يمكن تضمينها عند إنشاء البرنامج” — أسماء الحلقات وحدها، بلا طلاب ولا معلمين. |
| الطلاب والتسجيلات والخطط غير مناسب | لا يُحفظ | ولا الحضور ولا الأنشطة ولا الأرصدة ولا المعلمون. لا تغادر بيانات أحد مسجدك عبر القالب. |

> **ملاحظة:** من اسم البرنامج المصدر وتاريخيه لا يُحفظ إلا الاسم ليقترح عليك اسم البرنامج الجديد؛ التواريخ تدخلها أنت عند التثبيت.

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

![صفحة تفاصيل القالب تعرض أقسام محتوى اللقطة](https://manual.misbah.pro/images/program-templates/03-snapshot-view.png)

### كيف تقرأ بطاقة قالب

المكتبة تعرض القوالب بطاقات متشابهة، وخمسة مؤشرات عليها تختصر عليك المفاضلة. ثلاثة منها تظهر أيقونة ورقماً بلا تسمية مكتوبة، فهذه ترجمتها.

- **منشور أو خاص** — من يرى القالب. [[خاص]] يعني مسجدك وحده، و[[منشور]] يعني كل المساجد في تبويب «المنشورة».
- **موثّق** — بشارة خضراء بلا نص، يضعها المشرف العام للمنصة. القوالب الموثّقة “تُفضَّل في التصفح”، ويمكن قصر التصفية عليها بخيار [[موثّقة]].
- **التقييم** — متوسّط من خمس نجوم، و[[—]] حين لا تقييم بعد. لا يقيّم القالبَ إلا مسجد **ثبّته فعلاً** وليس صاحبه، وبتقييم واحد لكل مسجد قابل للتبديل.
- **عدد التثبيتات** — كم مرة أنشأ مسجد برنامجاً من هذا القالب. المؤشر الأصدق على أنه مجرَّب.
- **رقم الإصدار** — آخر إصدار متاح، بصيغة `v3`. الرقم الأعلى يعني أن صاحبه ما زال يطوّره.

صفحة «قوالب البرامج» تفتح على تبويب «قوالبي» — “قوالبك الخاصة — راجعها أو انشرها للعامة.” — ويليه «المنشورة» — “قوالب منشورة من مساجد أخرى — ثبّت ما يناسبك.” والبحث يقبل الاسم أو الوسم، والترتيب «الأحدث» أو «الأكثر استخداماً» أو «أعلى تقييم».

> **نصيحة:** لإنشاء برنامج من قالب ابدأ من صفحة إنشاء البرنامج لا من المكتبة؛ المكتبة موضعها مراجعة قوالبك ونشرها. الواجهة تقول ذلك صراحة: “لإنشاء برنامج من قالب، استخدم صفحة إنشاء البرنامج.”

![مكتبة قوالب البرامج مع بطاقات القوالب ومؤشراتها](https://manual.misbah.pro/images/program-templates/02-gallery.png)

### تثبيت قالب

التثبيت ينتج **برنامجاً جديداً مستقلاً**، لا اختصاراً يشير إلى القالب. بعد اللحظة الأولى ينفصل البرنامج عن أصله انفصالاً تاماً.

1. افتح القالب من صفحة إنشاء البرنامج
   اضغط بطاقة القالب لتصل إلى صفحته، وراجع محتوى اللقطة كله قبل القرار.
2. اضغط «تثبيت»
   تفتح نافذة “إنشاء برنامج من القالب” ووصفها: “من القالب «…» — يُثبَّت الحضور، المحفظة، القوالب، المناهج، والسلوكيات تلقائياً.”
3. اختر الإصدار والاسم والتواريخ
   «إصدار القالب» يظهر حين يكون للقالب أكثر من إصدار. «اسم البرنامج الجديد» يأتي مقترحاً باسم القالب مع كلمة نسخة، و“يجب أن يكون تاريخ النهاية بعد تاريخ البداية.”
4. قرّر «تضمين الحلقات»
   يظهر الخيار إن كان الإصدار يحمل حلقات: “نسخ الحلقات المعرّفة في القالب إلى البرنامج الجديد” — أسماؤها فقط، فارغة من الطلاب.
5. اضغط «إنشاء البرنامج»
   تنتقل مباشرة إلى لوحة البرنامج الجديد. ما بقي عليك: [الحلقات والمعلمون](https://manual.misbah.pro/groups) ثم [الطلاب](https://manual.misbah.pro/students) ثم تطبيق [الخطط](https://manual.misbah.pro/plans).

> **نسخة لا رابط:** البرنامج الناتج **لا يبقى مرتبطاً** بالقالب. رفع صاحب القالب إصداراً جديداً بعد تثبيتك لا يصل إليك، وتعديلك في برنامجك لا يصل إليه. إن أردت التحديث فثبّت الإصدار الجديد برنامجاً آخر وانقل ما يلزم يدوياً.

> **تحذير:** قد يرفض التثبيت لسببين تظهر رسالتهما في نافذة التثبيت: “لا يوجد اشتراك نشط لهذا المسجد”، أو أن باقتك لا تتضمّن ميزة يحتاجها القالب — المناهج إن كانت اللقطة تحمل منهجاً، والمحفظة إن كانت تحمل نظام نقاط أو هياكل خطط. راجع [الباقة والميزات](https://manual.misbah.pro/entitlements).

### احفظ برنامجك قالباً ثم انشره

كل برنامج أتقنت إعداده يصلح أن يصير قالباً. الحفظ خطوة، والنشر خطوة ثانية منفصلة — ولا رجعة في الثانية.

1. افتح «إعدادات البرنامج» ثم «حفظ كقالب»
   القسم اسمه “قوالب البرامج” ووصفه “احفظ إعدادات هذا البرنامج (الحضور، المحفظة، القوالب، المناهج، السلوكيات) كقالب قابل لإعادة الاستخدام في مسجدك أو للنشر للعامة.” والخيار نفسه متاح من قائمة بطاقة البرنامج في الرئيسية.
2. املأ بيانات القالب
   «اسم القالب» مطلوب، و«الوصف» و«وسوم» اختياريان — “افصل الوسوم بفاصلة” ومثالها “حفظ، مراجعة، مبتدئ”. وحدّد «تضمين الحلقات» إن أردت أن يستطيع المثبّت نسخ أسماء حلقاتك.
3. اضغط «حفظ القالب»
   يُنشأ القالب [[خاص]] في مسجدك وحده — “بعد الحفظ يمكنك معاينة القالب ونشره للعامة من مكتبة القوالب.”
4. أضف غلافاً وراجع المحتوى
   من قسم “إدارة القالب” ارفع «غلاف القالب» — “يُعرض بنسبة 16:9 على البطاقة وصفحة التفاصيل.” بصيغة JPEG أو PNG أو WebP وحدّه ٢ ميغابايت.
5. اضغط «نشر للعامة» إن قرّرت
   يسألك: “النشر نهائي ولا يمكن التراجع عنه. سيصبح القالب متاحاً لجميع المساجد في تبويب القوالب المنشورة.”

> **راجع قبل النشر:** النشر **لا يُعكس**: لا يوجد زر يعيد القالب إلى [[خاص]]. وقبل أن تضغط، افتح معاينة اللقطة واقرأ **قوالب الإشعارات** تحديداً — نصوصها تُحفظ دائماً بلا خيار استثناء، فإن كانت رسائلك تحمل اسم مسجدك أو صياغة خاصة بأهله فستسافر مع القالب إلى كل من يثبّته.

طوّرت البرنامج بعد الحفظ؟ افتح «حفظ كقالب» مرة أخرى من البرنامج نفسه فيتحوّل إلى “رفع تحديث للقالب” ويعرض عليك انتقال الإصدار من الحالي إلى التالي. ولا يقبل النظام إصداراً بلا تغيير فعلي عن اللقطة السابقة.

![نافذة حفظ كقالب برنامج مع حقول الاسم والوصف والوسوم](https://manual.misbah.pro/images/program-templates/04-templatize.png)

### أسئلة شائعة

**هل تنتقل بيانات طلابي إلى من يثبّت قالبي؟**
لا. اللقطة تحفظ البنية وحدها: قوالب الخطط والمناهج والهياكل ونظام الحضور ووحدات النقاط والسلوكيات وقوالب الإشعارات، وأسماء الحلقات إن اخترت تضمينها. لا طلاب ولا تسجيلات ولا خطط طلاب ولا حضور ولا أنشطة ولا أرصدة ولا معلمون.

**رفع صاحب القالب إصداراً جديداً — هل يصل برنامجي؟**
لا. التثبيت ينتج نسخة مستقلة تماماً، ولا يوجد رابط يعيد التحديث إليها. تتابع الإصدارات الجديدة بنفسك من صفحة القالب.

**ما الفرق بين قالب البرنامج وقالب الخطة؟**
قالب البرنامج يحفظ بنية برنامج كاملة ويُثبَّت **برنامجاً جديداً**. وقالب الخطة يحفظ خطة دراسية واحدة ويُطبَّق على طلاب داخل برنامج قائم — راجع [الخطط والمناهج](https://manual.misbah.pro/plans). قالب البرنامج يحتوي قوالب الخطط، لا العكس.

**أخطأت ونشرت القالب — كيف أرجعه خاصاً؟**
لا يمكن. النشر إجراء نهائي في المنصة، ولا يحذف القالبَ المنشور إلا المشرف العام. اقرأ نافذة التأكيد قبل الضغط.

**لماذا لا أستطيع تقييم قالب؟**
لثلاثة أسباب: أنه قالبك أنت، أو أنه ما زال [[خاص]]، أو أن مسجدك لم يثبّته بعد. التقييم حق من جرّب، وواحد لكل مسجد يمكن تبديله لاحقاً.

**أريد نقل طلابي إلى الفصل التالي — قالب أم نسخ؟**
نسخ. «نسخ من برنامج» وحده ينقل الحلقات والتسجيلات وخطط الطلاب — مع تصفير التقدّم — ويخيّرك في أرصدة النقاط بين «نسخ الأرصدة» و«أرصدة جديدة». القالب ينقل البنية دون أحد.

---

## الأداء

المصدر: https://manual.misbah.pro/performance

شاشة القراءة الأولى في لوحة البرنامج: الحضور والأوجه والتقييم والإنجاز لفترة تختارها، ثم آخر الأنشطة وآخر سجلات الحضور.

الجمهور: مشرف

### شاشة تقرأ ولا تكتب

«الأداء» أول ما يفتح حين تدخل لوحة البرنامج، وهو الوحيد بين شاشات اللوحة الذي لا يُنشئ شيئاً ولا يُعدّل شيئاً: كل رقم فيه مشتقٌّ ممّا سجّله المعلمون في الفترة التي تختارها أنت.

> **ملخّص سريع**
> - ما هذا؟ أربع بطاقات وقائمتان تلخّصان ما جرى في البرنامج خلال فترة تحدّدها.
> - لماذا يهمّك؟ قبل أن تسأل «كيف حال البرنامج؟» تحتاج رقماً واحداً لكل بُعد، وموضعاً واحداً يكشف هل يسجّل المعلمون أصلاً.
> - لمن؟ مشرف
> - الوقت المتوقّع: دقيقتان

المسار: لوحة البرنامج ← الأداء

الصفحة مبنية على ثلاث طبقات من أعلى إلى أسفل: شريط «نطاق التاريخ» الذي يحكم كل ما تحته، ثم بطاقات المؤشرات، ثم “آخر الأنشطة” و“آخر سجلات الحضور”.

- **النطاق الزمني** — فترة واحدة تحكم كل أرقام الصفحة، من يوم واحد إلى كامل البرنامج.
  الرقم بلا فترة لا معنى له؛ ونصف الشكاوى من «أرقام غريبة» سببها نطاق منسيّ.
- **بطاقة مؤشر** — رقم مجمّع لكل الطلاب في النطاق، مع سطر وصف تحته يقول مِمَّ حُسب.
  تقرأ الاتجاه العام في ثانية دون فتح جدول.
- **آخر النشاطات** — الصفوف الخام كما سجّلها المعلمون: الطالب، الخطة، المقدار، التقييم، الوقت.
  البطاقة تقول «الرقم منخفض»، وهذه القائمة تقول “لأن حلقة فلان لم تُسجَّل”.
- **بطاقات وحدات النقاط** — بطاقة لكل وحدة نقاط في البرنامج، باسمها، تعدّ المعاملات والإيداع والسحب.
  تكشف بلا فتح [المحفظة](https://manual.misbah.pro/wallet) هل يتحرّك نظام التحفيز فعلاً.

> **ملاحظة:** بطاقة «الحضور» تختفي كلّيّاً من الصفحة إن لم يكن للبرنامج نظام حضور. غيابها ليس خللاً — راجع [هيكلة الحضور](https://manual.misbah.pro/attendance#structure).

![صفحة الأداء في لوحة البرنامج مع شريط نطاق التاريخ وبطاقات المؤشرات](https://manual.misbah.pro/images/performance/01-dashboard.png)

### ضبط نطاق التاريخ

الشريط العلوي زرّان للتاريخ: بداية الفترة ونهايتها، وبينهما أسهم تنقلك فترةً كاملة إلى الخلف أو الأمام بالطول نفسه.

افتح زر البداية لتجد “فترات جاهزة تضبط البداية والنهاية معاً، أو اختر يوماً من التقويم.” — وهي «اليوم» و«هذا الأسبوع» و«7 أيام» و«30 يوماً» و«كامل البرنامج» و«يوم واحد»، ثم تقويم تحتها تحت عنوان «من التقويم».

زر النهاية يضبط الطرف الآخر. إن ساوت النهايةُ البداية ظهر عليه “إلى نفس اليوم”، ومن داخله «حذف نهاية الفترة» يردّ العرض إلى يوم واحد. وأسفل الشريط سطر يلخّص المدى وعدد أيامه، وشارة تقول رقم الأسبوع أو مدى الأسابيع.

#### أي نطاق تختار؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| يوم واحد (الافتراضي) | المتابعة اليومية: هل سجّل المعلمون اليوم؟ | قائمتا آخر الأنشطة والحضور تصيران مرآةً مباشرة لليوم. | لا يصلح للحكم على طالب ولا معلم — يوم واحد ليس اتجاهاً. |
| أسبوع أو ٣٠ يوماً (الأنسب غالباً) | تقييم اتجاه الحلقات، أو تجهيز اجتماع دوري. | يبتلع الإجازات والغياب العارض، فيظهر الاتجاه الحقيقي. | يخفي مشكلة يوم بعينه؛ ارجع إلى اليوم عند الشكّ. |
| كامل البرنامج (متقدّم) | حصاد الدورة، أو مقارنة برنامج ببرنامج. | يعطي الصورة الكاملة من تاريخ البدء إلى اليوم. | المتوسطات تُميّع الأسابيع الضعيفة؛ للتسليم الرسمي استعمل [التقارير](https://manual.misbah.pro/reports). |

> **نصيحة:** للمقارنة العادلة لا تختر التواريخ يدوياً. اضبط النطاق مرة ثم استعمل سهمَي «الفترة السابقة (بنفس الطول)» و«الفترة التالية (بنفس الطول)»؛ فهما يضمنان تساوي عدد الأيام، ولا يُقارَن أسبوع بعشرة أيام.

بجانب الشريط زر «صورة الإحصائيات» يولّد صورة قابلة للمشاركة إمّا عن «كامل البرنامج» وإمّا عن «الفترة المحددة».

### قراءة بطاقات المؤشرات

أربع بطاقات، كلٌّ منها رقم كبير وسطر وصف تحته يقول مِمَّ حُسب. الوصف أهم من الرقم: هو ما يمنعك من قراءة صفرٍ سببه غياب التسجيل على أنه صفر سببه غياب الطلاب.

**الأوجه** — وحدة قياس الكمّ القرآنية في مصباح. المعلم يسمّع نطاقاً من الآيات، والمنصة تحسب طوله بالأسطر ثم تحوّله إلى أوجه.

> **احتساب الأوجه:** `الأوجه = مجموع الأسطر المسمَّعة ÷ 15`
> أي أنّ الوجه خمسة عشر سطراً، والناتج يُقرَّب إلى أقرب عدد صحيح. لذلك قد تظهر «الأوجه» صفراً في يوم سُمّع فيه بضع آيات فقط.

*ماذا يعرض كل مؤشر*
| البطاقة | الرقم | سطر الوصف |
| --- | --- | --- |
| «الحضور» للعلم | عدد الطلاب الحاضرين في النطاق | عدد الغائبين منهم |
| «الأوجه» للعلم | مجموع ما سُمّع محوَّلاً إلى أوجه | عدد التلاوات المسجَّلة |
| «التقييم» | متوسط درجات المعلمين للجلسات، نسبةً مئوية | عدد الخطط النشطة |
| «الإنجاز» | المنجَز مقابل المطلوب، نسبةً مئوية | عدد التلاوات المسجَّلة |

«التقييم» و«الإنجاز» هنا هما المفهومان نفساهما اللذان يشرحهما [دليل التقارير](https://manual.misbah.pro/reports#components): الأول جودة، والثاني كمّية. الفرق الجوهري أن هذه الصفحة **لا تطبّق أوزاناً** ولا تحاسب على الأيام التي مرّت بلا تسجيل، والتقرير يفعل الأمرين — ولذلك لا يتطابق الرقمان ولو وحّدت الفترة.

أسفل البطاقات قسم «تفصيل حسب قوالب الخطط» يعيد المؤشرات نفسها لكل قالب على حدة. هذا أسرع طريق للجواب عن سؤال: أي مسار يتعثّر، الحفظ أم المراجعة؟

> **ملاحظة:** النشاط الذي لا خطة له يُعرض في القوائم تحت [[بدون خطة]]، ولا يدخل في حساب الإنجاز. إن رأيت إنجازاً أقل من المتوقّع، ابدأ بمن لم تُطبَّق عليه خطة في [الخطط](https://manual.misbah.pro/plans).

### آخر الأنشطة وآخر الحضور

قائمتان أسفل البطاقات: “عرض أحدث الأنشطة للطلاب” و“عرض أحدث سجلات حضور الطلاب”. هنا تنتقل من الرقم المجمّع إلى الصفّ الخام.

جدول «آخر الأنشطة» يعرض «الطالب» و«الخطة» و«التفاصيل» و«المقدار» و«التقييم» و«الوقت»، ويمكن حصره بتبويبات «الكل» و«تسميع القرآن» و«الأنشطة المرنة». وقائمة الحضور تعرض الطالب وحالته ووقت التسجيل.

> **أسرع فحص إداري في المنصة:** افتح الأداء على «اليوم» في نهاية الدوام. قائمة أنشطة فارغة في يوم دراسي تعني أن التسجيل لم يقع، لا أن الأداء صفر — وهذا خلل يُصحَّح في يومه لا في آخر الشهر.

الحالة الفارغة صريحة: “لا توجد أنشطة متاحة لهذا اليوم” و“تحقق من تاريخ اليوم المحدد أو جرب يوماً آخر”. اقرأها حرفياً — هي تطلب منك مراجعة النطاق قبل مراجعة المعلم.

*إلى أين تذهب بعد الأداء*
| سؤالك | الوجهة |
| --- | --- |
| أي حلقة لم تسجّل، وماذا سجّل كل معلم؟ للعلم | [المتابعة اليومية](https://manual.misbah.pro/activities) |
| ملف رسمي بأوزان للتسليم والأرشفة للعلم | [التقارير](https://manual.misbah.pro/reports) |
| عرض الأرقام على شاشة كبيرة داخل المسجد | [شاشة العرض](https://manual.misbah.pro/monitor) |

### أسئلة شائعة

**المؤشرات صفر رغم وجود طلاب نشطين.**
الأرجح أن النطاق لا يشمل أيام التسجيل. اضغط «اليوم» أو وسّع النطاق إلى «30 يوماً»، ثم تأكّد من أن المعلمين يسجّلون من [الحلقات والتسميع](https://manual.misbah.pro/teaching).

**لماذا لا أرى بطاقة «الحضور» أصلاً؟**
البطاقة تظهر فقط حين يكون للبرنامج نظام حضور مُعدّ وفيه سجلات. عرّف الحالات وفعّل النظام من [هيكلة الحضور](https://manual.misbah.pro/attendance#structure).

**«الأوجه» صفر مع وجود تسميعات — كيف؟**
الوجه خمسة عشر سطراً، والناتج يُقرَّب. مجموع ما سُمّع كان أقل من نصف وجه، فقُرِّب إلى صفر. انظر عمود «المقدار» في «آخر الأنشطة» لترى القيمة الحقيقية.

**لماذا تختلف أرقام الأداء عن التقرير رغم أن الفترة واحدة؟**
الأداء يقرأ ما سُجِّل فقط وبلا أوزان. والتقرير يطبّق أوزان المكوّنات وأوزان القوالب، ويضيف إلى «المطلوب» أيام العمل التي مرّت بلا تسجيل. التفصيل في [مكوّنات التقرير](https://manual.misbah.pro/reports#components).

**هل يمكنني تعديل شيء من هذه الصفحة؟**
لا. «الأداء» شاشة قراءة فقط؛ كل تغيير يجري في مصدره: الحضور من [الحضور](https://manual.misbah.pro/attendance)، والتسميع من [الحلقات والتسميع](https://manual.misbah.pro/teaching)، والخطط من [الخطط](https://manual.misbah.pro/plans).

---

## الحلقات والمعلمون

المصدر: https://manual.misbah.pro/groups

الحلقة وحدة التدريس اليومية ونطاق وصول المعلم. هنا تنشئها وتربط بها المعلمين وتضبط صلاحياتهم ومدّتها.

الجمهور: مشرف

### الحلقة نطاق وصول قبل أن تكون مجموعة

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

> **ملخّص سريع**
> - ما هذا؟ مجموعة طلاب مع معلم مسؤول داخل برنامج واحد، وقد يكون لها معلمون مساعدون.
> - لماذا يهمّك؟ التدريس يقع في الحلقة، والصلاحيات تُمنح بها، والتقارير وشاشة العرض تُصفّى عليها.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٠ دقائق

المسار: لوحة البرنامج ← الحلقات والمعلمون

الصفحة تبويبان: «الحلقات» لإدارة الحلقات وتوزيع الطلاب، و«المعلمون» لحسابات كادر المسجد. ويمكن الوصول إلى الثاني مباشرة عبر `?tab=teachers`.

- **الحلقة** — اسم ومعلم أساسي وعدد طلاب، داخل برنامج بعينه.
  هي ما يفتحه المعلم يومياً ليسجّل الحضور والتسميع.
- **المعلم الأساسي** — صاحب الحلقة؛ يراها في صفحته ويسجّل فيها.
  مسؤولية واحدة واضحة عن كل حلقة تمنع تنازع التسجيل.
- **المعلم المساعد** — معلم آخر يُمنح وصولاً إلى الحلقة، بتاريخ انتهاء اختياري.
  البديل والمتطوّع يحتاجان وصولاً مؤقتاً لا حساباً دائماً.
- **الحلقة عن بُعد** — حلقة يُرفق بها رابط اجتماع مرئي، وتُوسم في القائمة بأيقونة.
  الحلقات المرئية تُدار بالمنطق نفسه، ويُحفظ رابطها في مكانه لا في رسائل متفرّقة.

![صفحة الحلقات والمعلمون تعرض بطاقات الحلقات مع معلميها وعدد طلابها](https://manual.misbah.pro/images/groups/01-groups-hub.png)

> **نصيحة:** إن اشتكى معلم أن طالباً “غير موجود”، ابدأ دائماً بتوزيع الحلقات لا بحساب المعلم. غياب الطالب عن أي حلقة هو السبب الأول لهذه الشكوى.

### إنشاء الحلقات

أضف حلقة من «إضافة حلقة جديدة». الحقول ثلاثة: «اسم الحلقة» و«المعلم» ومفتاح «عن بعد».

#### حلقة حضورية أم عن بُعد؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حضورية (الافتراضي) | الحلقة تنعقد في المسجد — وهي الحالة الافتراضية حين يبقى مفتاح «عن بعد» مطفأً. | لا إعداد إضافي، ويُسجَّل الحضور في مكانه طبيعياً. | لا شيء. |
| عن بُعد (متقدّم) | الحلقة تنعقد عبر اجتماع مرئي، ولك رابط ثابت لها. | يُحفظ «رابط الحلقة عن بعد» مع الحلقة، ويفتحه المشرف من بطاقتها. | **مرتبطة بباقة المسجد**: مفتاح «عن بعد» لا يعمل بدونها. |

> **الحلقات عن بُعد ميزة في الباقة:** تحريك مفتاح «عن بعد» في باقة لا تتيحها لا يغيّره، بل يفتح حواراً عنوانه “الحلقات عن بُعد” ونصّه “الحلقات عن بُعد غير متاحة في خطتك الحالية.” فإن لم تكن مشرف المسجد ظهر لك “تواصل مع مشرف المسجد لترقية الباقة.” راجع [الصلاحيات والباقة](https://manual.misbah.pro/entitlements).

الرابط يُنشأ خارج مصباح: “يرجى فتح (Zoom، Microsoft Teams، Google Meet، ...) وإنشاء رابط للحلقة ثم لصقه هنا”.

- سمِّ الحلقة بما يدلّ على المستوى أو الوقت — الاسم يظهر للمعلم وفي التقارير وعلى [شاشة العرض](https://manual.misbah.pro/monitor).
- تستطيع إنشاء حلقة أثناء اختيار الحلقة لطالب عبر «إضافة حلقة جديدة للبرنامج» دون مغادرة الشاشة.
- ومن «استيراد مجموعات» تجلب بنية حلقات من برنامج آخر بدل إعادة كتابتها.

![حوار إضافة حلقة جديدة مع اسم الحلقة واختيار المعلم ومفتاح عن بعد](https://manual.misbah.pro/images/groups/02-create-group.png)

### حسابات المعلمين

حساب المعلم يُنشئه المشرف ولا يسجّل المعلم نفسه بنفسه. الحساب على مستوى **المسجد**، ويُربط بعده بما يشاء من حلقات في البرامج.

1. أضف المعلم إلى المسجد
   من «إضافة معلم جديد»: «اسم المعلم» و«اسم المستخدم» — ثلاثة أحرف فأكثر. ويخبرك الحوار: “سيتم إنشاء كلمة مرور مؤقتة تلقائياً”.
2. اربطه بحلقاته
   معلم واحد يدرّس عدة حلقات بحساب واحد؛ لا تنشئ له حسابين.
3. سلّمه الرابط وبياناته
   من صدر التبويب انسخ رابط “تسجيل دخول المعلمين” — “يمكن للمعلمين تسجيل الدخول باستخدام الرابط المخصص. شارك هذا الرابط مع المعلمين للوصول إلى حساباتهم.” ومن عمود «حالة كلمة المرور» تنسخ الكلمة المؤقتة.
   ![تبويب المعلمين مع رابط دخول المعلمين وجدول الحسابات وحالة كلمة المرور](https://manual.misbah.pro/images/groups/03-teachers.png)
4. اطلب منه تغيير كلمته
   عمود «حالة كلمة المرور» يقول [[كلمة مرور مؤقتة]] أو [[تم تغيير كلمة المرور]]، فتعرف من لم يدخل بعد. وللمشرف «إعادة تعيين كلمة المرور» عند النسيان — راجع [دخول الكادر](https://manual.misbah.pro/login#staff).

> **انتبه:** تغيير المعلم الأساسي لحلقة يسحب وصول السابق فوراً: “* لن يستطيع {اسم المعلم} الوصول إلى هذه الحلقة بعد التغيير”. وما سجّله يبقى في البرنامج والتقارير كما هو.

### المعلمون المساعدون وصلاحية الانتهاء

لكل حلقة معلم أساسي، ولها فوق ذلك معلمون مساعدون: “اختر المعلمين ثم حدّد انتهاء الصلاحية لكل منهم عند الحاجة.” تفتح الحوار من «المساعدين» في قائمة إجراءات بطاقة الحلقة.

> **المعلمون المساعدون ميزة في الباقة:** إن لم تكن الميزة في باقتك، لم يظهر زر الإضافة أصلاً وحلّ محلّه “معلم مساعد — ترقية الباقة”، ونقره يفتح حواراً عنوانه “المعلمون المساعدون” ونصّه “إضافة معلمين مساعدين غير متاحة في خطتك الحالية.” ومع الميزة يصير الزر “+ إضافة معلم مساعد”. راجع [الصلاحيات والباقة](https://manual.misbah.pro/entitlements).

**صلاحية الانتهاء** — تاريخ يتوقّف عنده وصول المعلم المساعد إلى الحلقة تلقائياً. الانتهاء يمنع الدخول وحده — ولا يمسّ شيئاً ممّا سجّله من حضور أو تسميع.

*خيارات «صلاحية الانتهاء»*
| الخيار | متى تستعمله |
| --- | --- |
| «بدون انتهاء» | معلم مساعد ثابت طوال الدورة. |
| «ساعة» أو «3 ساعات» للعلم | دخول لحصة واحدة أو لمتابعة عاجلة. |
| «نهاية اليوم» للعلم | بديلٌ ليوم واحد عن معلم غائب. |
| «نهاية الأسبوع» للعلم | تغطية أسبوع سفر أو مرض. |
| «نهاية الشهر» للعلم | متطوّع في دورة قصيرة. |
| «تاريخ مخصص» بتحفّظ | مدّة معلومة لا تنطبق عليها الاختصارات — تختار اليوم والساعة. |

والملخّص فوق القسم يخبرك بالحالة الناتجة قبل الحفظ: “بدون انتهاء للجميع”، أو “ينتهي خلال ٣ أيام”، أو “انتهاء محدد لـ ٢ من ٣”. ولتوحيد الإعداد استعمل “نسخ إعداد {اسم المعلم} لباقي المعلمين”.

> **نصيحة:** اجعل الانتهاء المؤقت عادتك مع كل وصول غير دائم. منح وصول مفتوح ثم نسيان سحبه هو أشيع ثغرة إدارية في المساجد، والمنصة تعالجها عنك إن استعملت هذه الخيارات.

![حوار المعلمين المساعدين مع قائمة المعلمين وخيارات صلاحية الانتهاء](https://manual.misbah.pro/images/groups/04-access.png)

### نقل الطلاب وحذف الحلقة

الحلقة تتغيّر خلال الدورة: طالب يُنقل، وحلقة تُدمج، وأخرى تُحذف. وأثر كل فعل من هذه في بيانات الطالب يختلف اختلافاً كبيراً.

#### نقل طالب بين الحلقات

طريقان: تغيير الحلقة من عمود «الحلقة» في جدول [الطلاب](https://manual.misbah.pro/students#enrollment) ثم الحفظ من شريط التغييرات، أو «توزيع على الحلقات» لمجموعة محدَّدة دفعةً واحدة. والحوار الثاني يحذّرك بـ“هذا الإجراء سيقوم بتغيير مجموعات الطلاب.” ولا يقول أكثر — وهذا ما يقوله فعلاً:

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

> **نصيحة:** لأن النقل لا يفقد شيئاً، لا تتردّد في إعادة التوزيع متى احتاج المستوى ذلك. ومن «إزالة من الحلقة» تجعل الطالب [[بدون حلقة]] مؤقتاً — لكنه عندها يختفي عن كل المعلمين، فلا تتركه كذلك.

#### حذف حلقة

حذف الحلقة ليس نقلاً ولا أرشفة. إن كان فيها طلاب فُتحت أولاً شاشة التوزيع لتنقلهم، ثم يطلب منك حوار الحذف أن تكتب عبارة بحرفها: “للمتابعة، اكتب النص التالي بالضبط:”

> **عبارة التأكيد:** “نعم احذف المجموعة وجميع المعلومات المتعلقة بها نهائيا”
> ويعدّد الحوار ما سيُحذف: [[تسجيلات الطلاب في هذه المجموعة]] و[[سجلات الحضور]] و[[التسميعات]] و[[الخطط]]. أي أنّ الحذف **يُتلف تاريخ الطلاب في هذا البرنامج**، لا الحلقة وحدها.

> **ملاحظة:** ويطمئنك الحوار في المقابل: “ملاحظة: سيتم حذف المجموعة من هذا البرنامج فقط.” و“الطلاب المسجلين في هذه المجموعة لن يتم حذفهم من النظام ويمكن إضافتهم لمجموعات أخرى.” فالطالب يبقى في سجل المسجد؛ الذي يضيع هو تسجيله في هذا البرنامج بكل ما فيه.

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

### أسئلة شائعة

**كيف يحصل المعلم على حسابه؟**
تنشئه أنت من تبويب «المعلمون» باسم مستخدم، فتُولَّد كلمة مرور مؤقتة، ثم ترسل له رابط دخول المعلمين الخاص بالمسجد مع بياناته. لا يسجّل المعلم نفسه بنفسه.

**معلم واحد يدرّس حلقتين — هل أنشئ له حسابين؟**
لا. الحساب واحد على مستوى المسجد ويُربط بأكثر من حلقة، وسيرى حلقاته كلها عند الدخول.

**نقلت طالباً إلى حلقة أخرى — هل يفقد خطته وتقدّمه؟**
لا. الخطط والتقدّم والنقاط معلَّقة بتسجيل الطالب في البرنامج لا بحلقته، فتنتقل معه كاملة. وسجلات حضوره السابقة تبقى منسوبة إلى حلقته القديمة بتاريخها.

**انتهت صلاحية معلم مساعد — هل تُحذف سجلاته؟**
لا. الانتهاء يمنع الوصول فقط؛ وكل ما سجّله من حضور وتسميع يبقى في البرنامج والتقارير.

**مفتاح «عن بعد» لا يستجيب.**
الحلقات عن بُعد ميزة في الباقة، ويفتح المفتاح حوار الترقية بدل أن ينتقل. راجع [الصلاحيات والباقة](https://manual.misbah.pro/entitlements) أو تواصل مع مشرف المسجد.

**حذفت حلقة فيها طلاب — هل يمكن استرجاعهم؟**
لا يُسترجع تسجيلهم في هذا البرنامج ولا حضورهم ولا تسميعاتهم ولا خططهم. أمّا الطلاب أنفسهم فباقون في سجل المسجد، ويمكن تسجيلهم من جديد في البرنامج — لكنهم يبدؤون من الصفر.

**طالب يظهر عندي في البرنامج ولا يراه معلمه.**
الأرجح أنه [[بدون حلقة]]. افتح [الطلاب](https://manual.misbah.pro/students#enrollment) وعيّن له حلقة من عمود «الحلقة» ثم احفظ التغييرات.

---

## الطلاب

المصدر: https://manual.misbah.pro/students

الطالب يعيش على مستوى المسجد، والتسجيل يعيش داخل البرنامج. هنا تعرّف شكل بيانات الطالب، وتدخله، وتسجّله، وتعرف ما يضيع إن حذفته.

الجمهور: مشرف

### الطالب سجلّان لا سجلّ واحد

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

> **ملخّص سريع**
> - ما هذا؟ سجل طلاب على مستوى المسجد، وتسجيل لكل طالب في كل برنامج يشارك فيه.
> - لماذا يهمّك؟ الطالب يبقى سنوات ويمرّ بدورات؛ فصل بياناته عن دوراته هو ما يجعل تاريخه متصلاً وتقارير كل دورة منفصلة.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة

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

*ما الذي يعيش أين*
| البيان | مستوى المسجد | مستوى البرنامج |
| --- | --- | --- |
| الاسم والحقول المخصّصة مناسب | نعم | — |
| الحلقة للعلم | — | نعم |
| الخطط والتقدّم للعلم | — | نعم |
| سجلات الحضور والتسميع للعلم | — | نعم |
| رصيد المحفظة للعلم | — | نعم |

المسار: الشريط السفلي ← الطلاب

صفحة «الطلاب» في الشريط السفلي هي سجل **المسجد**: الإضافة والتعديل والحذف والبحث والاستيراد والتصدير وتخصيص الأعمدة. وبجانب العنوان شارة السعة مثل `40 / 600 · متاح`، وتتحوّل إلى “شبه ممتلئ” ثم “ممتلئ” كلّما اقتربت من الحدّ.

![صفحة الطلاب في المسجد قبل إضافة أي طالب مع اختصار الاستيراد](https://manual.misbah.pro/images/students/students-empty-state.png)

فيديو: شرح صفحة الطلاب https://www.youtube.com/watch?v=A72EdxeRNnA

### كيف يدخل الطالب إلى مصباح؟

ثلاثة طرق، والاختيار بينها ليس ذوقاً: هو يحدّد جودة بياناتك وكم وقتاً ستقضيه في التصحيح بعد ذلك.

#### استيراد، أم نموذج، أم إدخال يدوي؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| استيراد من ملف (الأنسب غالباً) | عندك كشف جاهز في Excel لعشرات الطلاب أو مئاتهم. | أسرع طريق لبناء السجل، مع مطابقة الأعمدة ومعاينة قبل الحفظ. | يتطلّب ضبط [الهيكلة](https://manual.misbah.pro#structure) **قبله**؛ فحقل يُضاف بعد الاستيراد يعني تعبئة يدوية لكل صف. |
| نموذج تسجيل (متقدّم) | تفتح باب التسجيل للعامة، فيملأ ولي الأمر البيانات بنفسه. | البيانات تأتي من مصدرها، وتراجعها أنت قبل قبولها — ومعها كشف تشابه الأسماء. | يحتاج بناء نموذج ومتابعة طابور المراجعة. التفصيل في [النماذج](https://manual.misbah.pro/forms). |
| إضافة يدوية (الافتراضي) | طالب أو طالبان يلتحقان في منتصف الدورة. | فوري، والتحقق يعمل أمامك حقلاً حقلاً. | لا يصلح للأعداد؛ ويفتح باب اختلاف الإملاء في الأسماء. |

> **نصيحة:** الترتيب الصحيح مرة واحدة: **الهيكلة ← الاستيراد ← التسجيل في البرنامج ← التوزيع على الحلقات**. كل انقلاب في هذا الترتيب يُترجَم عملاً يدوياً مضاعفاً.

#### من النموذج إلى طالب

طلبات النموذج لا تصير طلاباً إلا بقرارك. في طابور المراجعة تفتح الطلب فتختار بين “إنشاء طالب جديد” — “يُنشأ سجل من بيانات هذه الإجابة” — و“ربط بـ {اسم}” بسجل قائم. ومن «إضافة لبرنامج» تختار برنامجاً فيُنشأ **التسجيل** مع الطالب في خطوة واحدة.

> **مراجعة الاسم المتشابه:** حين يشبه اسمُ الطلب اسمَ سجل موجود، تُبرز المنصة ذلك — “تشابه ٨٧٪ مع السجل الحالي” — وتفصل القبول الجماعي إلى خطوتين: “أولاً: قبول {n} الواضحة” ثم “مراجعة الاسم المتشابه”. **لا تتجاوز هذه الخطوة**: قبولها بلا تدقيق ينتج طالبين لشخص واحد، فينقسم تاريخه بينهما ولا يُدمجان بعد ذلك.

### هيكلة بيانات الطالب

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

- **اتساق البيانات** — نفس الحقول والقواعد لكل الطلاب، فيقلّ الخطأ في الإدخال اليدوي والاستيراد معاً.
- **بحث وتقارير أوضح** — حقل معرَّف النوع (رقم، تاريخ، قائمة) يُصفّى ويُدقَّق، والنص الحرّ لا يُصفّى.
- **استيراد أوضح** — تعرف مسبقاً أسماء الأعمدة المتوقَّعة وكيف تُتحقَّق القيم قبل الحفظ.

تفتحها من قائمة «المزيد من الإجراءات» في أعلى صفحة الطلاب، قسم «الإعدادات» ← «تعديل هيكل الطالب». وللصفحة تبويبان: «قائمة الحقول» بكل حقل ونوعه وهل هو إلزامي، و«معاينة النموذج» ترى فيها شكل نموذج الإضافة قبل الحفظ.

![صفحة هيكلة بيانات الطالب وتبويب قائمة الحقول](https://manual.misbah.pro/images/students/students-structure-list.png)

#### إضافة حقل

زر «إضافة حقل» يعرض خيارين: «حقل جديد» تكتب مواصفاته بنفسك — الاسم والنوع و«إلزامي» و«إعدادات متقدمة» للتحقق — و«حقول جاهزة» تختار منها مجموعات معدّة مسبقاً مثل سور القرآن الكريم وحالة الحفظ والتجويد والقراءات، فتُضاف دفعة واحدة.

*أنواع الحقول*
| النوع | الاستخدام | التحقق المتاح |
| --- | --- | --- |
| نص | أسماء مخصّصة، ملاحظات قصيرة، معرّفات. | حدّ أدنى وأقصى للطول، ونمط محدّد. |
| رقم للعلم | عمر، مستوى، عدد صفحات، أي مقياس عددي. | حدّ أدنى وأقصى وخطوة. |
| تاريخ للعلم | تاريخ الانضمام، المواعيد، أي حدث زمني. | أقدم وأحدث تاريخ مسموح. |
| قائمة خيارات مناسب | قيم ثابتة محدودة: المرحلة، الفرع، الحالة. | أي قيمة خارج القائمة تُرفض. |

> **نصيحة:** فضّل «قائمة خيارات» على «نص» كلّما كانت القيم محدودة. حقلٌ نصّي للمرحلة ينتج بعد شهر ستّ صيغ لثلاث مراحل، ولا يُصفّى ولا يُجمَع في تقرير.

حقول الاسم الأساسية (الأول والأب والعائلة) مطلوبة ولا تُحذف، ولها تحقق نصّي مضمَّن. وأي حقل إضافي يمكن جعله **إلزامياً**، فلا يُقبل حفظ طالب دون تعبئته بقيمة صالحة.

> **انتبه:** تغيير نوع حقل بعد جمع بيانات فعلية قد يُفسد السجلات السابقة — تحويل نص إلى رقم مثلاً. راجع المخزون وخطّط للتصحيح قبل الحفظ.

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

### التسجيل في البرنامج

وجود الطالب في المسجد لا يضعه في أي برنامج. الخطوة التي تربطه هي **التسجيل**، وتجري من صفحة «الطلاب» داخل لوحة البرنامج.

> **ثلاثة أسماء لشاشة واحدة:** الشاشة نفسها تسمّى «الطلاب» في الشريط الجانبي، و“الطلاب المسجلون” في عنوان التبويب، و“إدارة التسجيل” في عنوان الصفحة. لا تحسبها ثلاث شاشات — هي واحدة.

ولا يوجد زرّ اسمه «تسجيل طالب». التسجيل يقع دائماً عبر «استيراد الطلاب» من سجل المسجد: “اختر طلاباً من سجلّ المسجد لتسجيلهم في «{اسم البرنامج}». الطلاب المسجّلون مسبقاً لا يظهرون هنا.” وتستطيع الاختيار من «كل الطلاب» أو من «من نموذج تسجيل» لتحصر القائمة في مقبولي نموذج بعينه.

وحين لا يوجد طلاب في المسجد أصلاً تقول الشاشة: “أضف الطلاب من صفحة طلاب المسجد أولًا، ثم ارجع هنا لاستيرادهم إلى هذا البرنامج.”

صفّ التسجيل يعرض «الطالب» و«الحلقة» — وهي قائمة تُغيَّر مباشرة لنقل الطالب — و«الخطط» و«الإجراءات». ومن شريط الإجراءات الجماعية تطبّق منهجاً أو تعيّن حلقة أو تنفّذ عمليات محفظة على عدد من الطلاب دفعة واحدة.

![جدول الطلاب المسجلين داخل البرنامج بأعمدة الطالب والحلقة والخطط](https://manual.misbah.pro/images/students/enrollments-table.png)

#### حذف التسجيل

«حذف التسجيل» في قائمة إجراءات الصف ليس إخراجاً من البرنامج مع حفظ التاريخ. هو **إتلاف** لكل ما بناه الطالب فيه.

> **ما الذي يضيع:** “أنت على وشك حذف تسجيل الطالب {الاسم} وجميع المعلومات المتعلقة به نهائياً. هذا الإجراء لا يمكن التراجع عنه.” ثم يعدّد: [[التسميعات]] و[[سجلات الحضور]] و[[الخطط]] و[[وجميع المعلومات المتعلقة به]].
> وإن كان للطالب تقدّم مسجَّل طُلبت منك عبارة “نعم احذف” مكتوبةً بالضبط، وعُطِّل زر التأكيد ثوانيَ معدودة. وإن لم يكن له تقدّم قيل لك “لا يوجد تقدم مسجل لهذا الطالب في الخطط، لذا يمكنك الحذف مباشرة.”

> **البديل الصحيح للطالب المنقطع:** لا يوجد في التسجيل حالة «منسحب». فإن انقطع طالب فلا تحذف تسجيله — اتركه كما هو. وجوده بلا نشاط يخفض نِسَب البرنامج، والعلاج أن تنقله إلى حلقة خاصة بالمنقطعين وتستثنيها من التقرير بتصفية الحلقات، لا أن تمحو تاريخه. أمّا الحذف فللتسجيل الذي وقع بالخطأ.

وحذف الطالب من **سجل المسجد** أوسع أثراً: يطلب منك كتابة “نعم احذف الطالب وجميع المعلومات المتعلقة به نهائيا”، وينبّهك إن كان مشاركاً في أكثر من برنامج: “هذا الطالب مشارك في {n} برامج. سيتم حذف جميع:” — أي أنّ تسجيلاته كلها تذهب معه.

### الاستيراد والتصدير وحدّ السعة

من قائمة «المزيد من الإجراءات» في سجل المسجد، قسم «الملفات»: «استيراد» و«تصدير».

1. اضبط [الهيكلة](https://manual.misbah.pro#structure) أولاً.
2. افتح «استيراد» وارفع ملف Excel.
3. طابق أعمدة الملف مع حقول الطالب المعرَّفة.
4. راجع المعاينة والتحقق قبل التأكيد.
5. أكّد، ثم سجّل المستوردين في البرنامج من [شاشة التسجيل](https://manual.misbah.pro#enrollment).

> **انتبه:** الاستيراد يبني سجل **المسجد** فقط. الطلاب المستوردون لا يدخلون أي برنامج حتى تسجّلهم فيه صراحة، ولا يراهم أي معلم حتى تُوزَّعوا على [الحلقات](https://manual.misbah.pro/groups#moving).

و«تصدير» يُنزّل ملف Excel بالطلاب والأعمدة التي اخترتها — مفيد للنسخ الاحتياطي ولمشاركة الكشف مع جهة خارجية.

#### حدّ السعة

الشارة بجانب العنوان تتدرّج بتدرّج الامتلاء: [[متاح]] ثم [[جيد]] ثم [[قريب من الامتلاء]] ثم [[شبه ممتلئ]] ثم [[ممتلئ]]. وعند الرفض تظهر “تم بلوغ حد مقاعد الطلاب” ومعها “زد السعة من الاشتراك لتضيف المزيد. تدفع المتبقي من الفترة فقط.”

> **ملاحظة:** الحدّ على طلاب **المسجد**، لا على كل برنامج. طالب مسجَّل في ثلاثة برامج يشغل مقعداً واحداً. راجع [الصلاحيات والباقة](https://manual.misbah.pro/entitlements) أو [إعدادات المسجد](https://manual.misbah.pro/settings#billing).

### أسئلة شائعة

**هل أضيف الطالب في كل برنامج على حدة؟**
لا. أضفه مرة واحدة في سجل المسجد، ثم سجّله في البرامج من «استيراد الطلاب» داخل لوحة كل برنامج. بياناته تبقى واحدة، وتسجيله في كل برنامج مستقل بحلقته وخططه.

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

**طالب انقطع عن الحضور — هل أحذف تسجيله؟**
لا. الحذف يمحو تسميعاته وحضوره وخططه بلا رجعة، ولا توجد حالة «منسحب» تحفظ التاريخ. اتركه، وانقله إلى حلقة خاصة إن أردت استثناءه من التقارير بتصفية الحلقات.

**ما الفرق بين حذف الطالب وحذف التسجيل؟**
حذف التسجيل يمحو تاريخ الطالب في **برنامج واحد** ويُبقي سجله في المسجد. وحذف الطالب يمحو السجل وكل تسجيلاته في كل البرامج، ويُنبّهك الحوار بعدد البرامج المشارك فيها قبل التأكيد.

**وصلت إلى حدّ عدد الطلاب — ما الحل؟**
زد السعة من الاشتراك؛ وتدفع المتبقي من الفترة الحالية فقط. البيانات القائمة تعمل طبيعياً، والممنوع هو إضافة طلاب جدد حتى تُرفع السعة.

**استوردت الطلاب ولا يراهم المعلمون.**
الاستيراد يبني سجل المسجد وحده. سجّلهم في البرنامج من «استيراد الطلاب» داخل لوحته، ثم وزّعهم على الحلقات — فالطالب [[بدون حلقة]] لا يراه أي معلم.

**قبلت طلب نموذج فصار لديّ طالبان بالاسم نفسه.**
الطلب قُبل على أنه “إنشاء طالب جديد” مع وجود سجل مشابه. لا يوجد دمج بعد الإنشاء، فالعلاج حذف السجل الأحدث ما دام بلا تاريخ. ولتجنّب تكراره، توقّف عند خطوة “مراجعة الاسم المتشابه” ولا تقبل الدفعة كاملة — راجع [النماذج](https://manual.misbah.pro/forms).

---

## الحضور

المصدر: https://manual.misbah.pro/attendance

كل حالة حضور في مصباح تحمل قيمة رقمية، ومن هذه القيمة تُحسب نسبة الالتزام في التقارير وتُمنح النقاط في المحفظة.

الجمهور: مشرف، معلّم

### الحضور رقم، لا علامة صح

نظام الحضور في مصباح ليس خانة تُعلَّم أو تُترك. كل حالة تحمل **قيمة رقمية**، وهذه القيمة هي التي تدخل في نسبة الالتزام في [التقارير](https://manual.misbah.pro/reports#components) وفي نقاط [المحفظة](https://manual.misbah.pro/wallet). لذلك يبدأ العمل من تعريف الحالات، لا من تسجيل اليوم.

> **ملخّص سريع**
> - ما هذا؟ قائمة حالات لكل منها قيمة، ونظامٌ يُفعَّل ليسجّل المعلمون عليه يومياً.
> - لماذا يهمّك؟ الانضباط لا يُقاس بـ«حضر/غاب» فقط: متأخر عشر دقائق ليس كغائب، والقيمة هي ما يفرّق بينهما في كل حساب لاحق.
> - لمن؟ مشرف، معلّم
> - الوقت المتوقّع: ١٠ دقائق للإعداد، دقيقتان يومياً

المسار: لوحة البرنامج ← الحضور

- **حالة الحضور** — اسم ولون وقيمة ووصف اختياري — مثل [[حاضر]] أو [[متأخر قليلاً]] أو [[غائب]].
  المعلم لا يخترع حالة؛ هو يختار من قائمتك، فتبقى بيانات البرنامج كلّها على مقياس واحد.
- **القيمة** — رقم من `0` إلى `200`، “القيمة 100 عادة تمثل الحضور الكامل، وقيمة 0 للغياب.”
  هي المقياس الذي تصير به «نسبة الحضور» في التقارير ونقاط المكافأة في المحفظة.
- **سجل الحضور** — صفٌّ يربط طالباً بيوم بحالة، ويمكن أن يحمل ملاحظة من المعلم.
  غياب السجل ليس غياباً — هو ببساطة «لم يُسجَّل بعد»، ولا يدخل أي حساب.
- **تشغيل النظام** — مفتاح يجعل النظام [[نشط]] أو [[معطّل]] على مستوى البرنامج كلّه.
  ما لم يكن نشطاً لا يرى المعلم أدوات التسجيل أصلاً، ولا يُنشأ تقرير حضور.

1. عرّف حالات الحضور وقيمها من «الإعدادات».
2. شغّل النظام حتى يتمكّن المعلمون من التسجيل.
3. اربط وحدة نقاط إن أردت مكافأة تلقائية.
4. سجّل يومياً من لوحة الحضور أو من داخل الحلقة.

> **ملاحظة:** يلزم [برنامج](https://manual.misbah.pro/program) قائم أولاً. ويمكن ضبط النظام كاملاً أثناء معالج إنشاء البرنامج في خطوة «نظام الحضور»، فلا تحتاج إعادته هنا.

![لوحة الحضور داخل البرنامج تعرض سجلات اليوم وعدد من هم بلا تسجيل](https://manual.misbah.pro/images/attendance/01-attendance-board.png)

### هيكلة نظام الحضور

من قائمة «إجراءات الحضور» افتح «الإعدادات»؛ عنوان الصفحة “هيكلة نظام الحضور”. فيها ثلاثة أقسام بالترتيب: «حالات الحضور»، ثم «مكافأة الحضور»، ثم «تشغيل النظام».

#### حزمة جاهزة أم حالات مخصصة؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حزمة جاهزة (الأنسب غالباً) | أول إعداد لك، أو حالات مسجدك لا تخرج عن المألوف. | ثلاث حزم مضبوطة القيم بضغطة واحدة، وتبقى متاحة في كل الباقات. | أسماء الحالات وقيمها كما هي؛ تعديلها بعد ذلك يحتاج صلاحية الحالات المخصصة. |
| حالات مخصصة (متقدّم) | لمسجدك عرف خاص: [[مستأذن]]، أو حالة مكافِئة للحضور المبكر بقيمة فوق ١٠٠. | تسمّي كل حالة وتضبط قيمتها ولونها ووصفها كما تريد. | مرتبطة بميزة «حضور مخصص» في الباقة؛ دونها يظهر الزر “إضافة حالة — ترقية الباقة”. |

> **ما الذي يقفله الاشتراك بالضبط؟:** الحزم الجاهزة تبقى قابلة للاختيار في كل الأحوال. الذي يُقفل هو **الإضافة والتعديل والحذف يدوياً**: “تعديل الحالات يدوياً غير متاح في خطتك. يمكنك اختيار أحد الأنظمة الجاهزة، والترقية تتيح الحالات المخصصة.” راجع [الفوترة والباقة](https://manual.misbah.pro/settings#billing).

#### حالات الحضور

الجدول يعرض «اسم الحالة» و«القيمة» و«الوصف» و«الإجراءات»، والقيمة تُعرض نسبةً مئوية بجانب لون الحالة. تُضاف حالة من صف «إضافة حالة جديدة» أسفل الجدول، وتُعدَّل أو تُحذف من قائمة إجراءات الصف.

في حوار الحالة: «اسم الحالة» و«الوصف (اختياري)» و«القيمة (0-200)» و«اللون». ومؤشّر القيمة يمتد من [[غائب]] عند الصفر إلى [[حاضر]] عند المئة إلى [[متميز]] عند المئتين — وهذا وحده يشرح المقياس: ما فوق المئة مكافأة، لا خطأ.

*الحزم الجاهزة وقيمها*
| الحزمة | الحالات وقيمها | مناسبة لـ |
| --- | --- | --- |
| «نظام بسيط (حاضر/غائب)» مناسب | حاضر 100 · غائب 0 | حلقة صغيرة، أو بداية سريعة تُبنى عليها لاحقاً. |
| «النظام القياسي» للعلم | حاضر 100 · متأخر قليلاً 50 · متأخر كثيراً 25 · غائب 0 | أغلب البرامج — يفرّق بين درجتي التأخير. |
| «نظام متقدم» للعلم | مبكر 120 · حاضر 100 · متأخر قليلاً 75 · متأخر 50 · متأخر كثيراً 25 · غائب 0 | برامج تكافئ الحضور المبكر وتتدرّج في التأخير. |

> **القيمة ليست زينة:** قيمة الحالة تُضرب في كل حساب لاحق: نسبة الحضور في التقرير، ونقاط المكافأة في المحفظة. حالة اسمها «متأخر» بقيمة `95` تعني عملياً أنك لا تعاقب التأخير. اضبط القيم مرة بوعي، ثم لا تعبث بها في منتصف الفصل.

![قسم حالات الحضور في صفحة هيكلة النظام مع جدول الحالات وقيمها](https://manual.misbah.pro/images/attendance/02-structure-statuses.png)

#### تعديل حالة أم حذفها؟

الفرق جوهري، والمنصة لا تشرحه في مكانها فانتبه له هنا:

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

> **الحذف لا رجعة فيه:** يسألك الحوار: “هل أنت متأكد من حذف "اسم الحالة"؟ لا يمكنك التراجع عن هذا الإجراء.” — وهو لا يخبرك بعدد السجلات المرتبطة. **إن كانت الحالة مستعملة، عدّل اسمها ولا تحذفها.**

#### إعدادان يعملان دون أن تراهما

- **الحالة الافتراضية** — يحتفظ النظام بحالة افتراضية للبرنامج، وهي **أول حالة في قائمتك**، تُختار تلقائياً دون أن يظهر لها حقل في الإعدادات. اجعل [[حاضر]] أول الترتيب حتى يكون الافتراضي هو الأشيع.
- **السماح بالملاحظات** — الملاحظات على سجل الحضور مفعّلة دائماً في البرامج التي ينشئها مصباح؛ هي ما يتيح للمعلم «إضافة ملاحظة» على سجل طالب. لا يوجد مفتاح لإيقافها.

#### تشغيل النظام

قسم «تشغيل النظام» يعرض الحالة [[نشط]] أو [[معطّل]]، ومعها سطر يشرح الأثر: “المعلمون يستطيعون تسجيل الحضور.” أو “لا يُسجَّل حضور جديد؛ السجلات السابقة تبقى للاطلاع.”

زر «تعطيل» أو «تفعيل» يفتح حواراً يعدّد الأثر صراحة. وفي التعطيل: “لن يتمكن المعلمون من تسجيل حضور جديد” و“يمكنك عرض السجلات السابقة فقط” و“يمكنك إعادة التفعيل في أي وقت”. أي أنّ التعطيل **لا يمحو شيئاً**.

![قسم تشغيل النظام يعرض الحالة نشط وزر التعطيل](https://manual.misbah.pro/images/attendance/03-activate-system.png)

### ربط الحضور بالمحفظة

قسم «مكافأة الحضور» لا يظهر إلا إذا كان للبرنامج وحدة نقاط واحدة على الأقل. هدفه أن يُمنح الطالب نقاطاً تلقائياً كلّما حُفظ له سجل حضور.

الوصف داخل القسم صريح: “اختر وحدة نقاط من محفظة البرنامج لتُمنح للطلاب وفق سياسات تلك الوحدة، أو اترك الخيار «بدون وحدة نقاط» إن لم ترد مكافأة الحضور بنقاط.”

> **نقاط المكافأة:** `نقاط المكافأة = قيمة الحالة ÷ 100`
> تُضاف بوحدة النقاط التي اخترتها. فحالة بقيمة `100` تساوي نقطة واحدة، وحالة بقيمة `120` تساوي `1.2`، والصفر لا يمنح شيئاً لأن الكمية غير الموجبة تُتجاهل.

*أمثلة على الاحتساب*
| الحالة | القيمة | النقاط الممنوحة |
| --- | --- | --- |
| مبكر مناسب | 120 | 1.2 |
| حاضر مناسب | 100 | 1.0 |
| متأخر قليلاً بتحفّظ | 50 | 0.5 |
| متأخر كثيراً بتحفّظ | 25 | 0.25 |
| غائب غير مناسب | 0 | لا تُضاف نقاط |

#### متى تُطبَّق المكافأة

- **إنشاء سجل** — تُضاف النقاط فور الحفظ، ما دامت الكمية أكبر من صفر.
- **تعديل الحالة** — يُحسب الفرق `(القيمة الجديدة − القديمة) ÷ 100` فيُضاف أو يُخصم الفارق وحده — لا تتضاعف النقاط.
- **حذف السجل** — تُستردّ النقاط التي مُنحت به.
- **بلا تسجيل** — لا سجل فلا نقاط، ولا خصم كذلك.
- **تعطيل النظام** — يمنع سجلات جديدة ومكافآت جديدة، ولا يمسّ ما في المحفظة.

> **لا تعبئة رجعية:** ربط الوحدة يسري على السجلات **اللاحقة** وحدها، ولا يمنح نقاطاً عن أيام مضت. المنصة لا تنبّهك إلى ذلك، فاربط الوحدة في أول الفصل. وإن أردت مكافأة فترة سابقة فأضفها يدوياً من [المحفظة](https://manual.misbah.pro/wallet#operations).

### التسجيل من لوحة الحضور

افتح «الحضور»، اختر اليوم، صفِّ بالحلقة أو الحالة إن لزم، ثم عيّن حالة لكل طالب. الحفظ فوري ولا يوجد زر حفظ منفصل.

1. اختر يوماً واحداً
   يمكن عرض مدى متعدد الأيام للاطلاع، لكن التسجيل يحتاج يوماً بعينه: “لتسجيل الحضور أو تعديل الجدول، يرجى اختيار يوم واحد فقط”.
2. ضيّق القائمة
   من «تصفية بحالة الحضور» اختر حالة بعينها، أو شريحة «بلا تسجيل» لعرض من لم تُحسم حالته. وفوق الجدول عدّاد: “{n} مسجّل” و“· {n} بلا تسجيل”.
3. عيّن الحالة لكل طالب
   يُحفظ التغيير فور اختياره؛ ولا يظهر في القائمة إلا ما عرّفته في الهيكلة.
   ![قائمة حالات الحضور مفتوحة على صف طالب في جدول اليوم](https://manual.misbah.pro/images/attendance/04-record-day.png)
4. أنهِ من بقي
   مجموعة “بلا تسجيل لهذا اليوم” تبقى مرجعك؛ ومن «تسجيل غير المسجلين» تطبّق حالة واحدة على الجميع دفعة واحدة — “سيتم تطبيق حالة الحضور المحددة على جميع الطلاب غير المسجلين فقط.”

**بلا تسجيل** — ليست حالةً من حالاتك، بل غياب السجل نفسه. تظهر في قائمة المعلم باسم [[غير مسجل]] وفي اللوحة والتصفية باسم [[بلا تسجيل]]. لا تُحتسب في نسبة الحضور ولا تمنح نقاطاً ولا تخصمها — وهي غير [[غائب]] التي حالةٌ اخترتها بقيمة.

> **تحذير:** حذف سجل حضور يُستردّ معه ما مُنح به من نقاط. وإن كان قصدك أن الطالب غاب فعلاً، فالصواب تعيين حالة [[غائب]] لا حذف السجل — الحذف يعني «لم يُسجَّل»، وهذا معنى مختلف تماماً في كل التقارير.

#### إشعارات الحضور

من قائمة «إجراءات الحضور» اختر «إشعارات الحضور» لإبلاغ أولياء الأمور بغياب اليوم أو بملخّصه. المستلمون يُستخرجون من سجلات اليوم المختار، والقناة إمّا واتساب وإمّا إشعار داخل التطبيق. التفصيل في [دليل الإشعارات](https://manual.misbah.pro/notifications).

### التسجيل من داخل الحلقة

المعلم لا يفتح لوحة البرنامج. هو يفتح حلقته ويسجّل الحضور في مطلع الحصة قبل التسميع، والنتيجة واحدة في الحالتين.

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

![تسجيل الحضور من داخل صفحة الحلقة كما يراه المعلم](https://manual.misbah.pro/images/attendance/05-teaching-attendance.png)

بقية حصة المعلم — التسميع والأنشطة — في [الحلقات والتسميع](https://manual.misbah.pro/teaching).

### أسئلة شائعة

**ما الفرق بين «غائب» و«بلا تسجيل»؟**
[[غائب]] حالة اخترتها أنت ولها قيمة (غالباً `0`)، وتدخل في حساب نسبة الحضور. و«بلا تسجيل» يعني أنه لا سجل أصلاً لذلك اليوم، فلا يُحتسب ولا يمنح نقاطاً. تظهر في قائمة المعلم باسم «غير مسجل».

**ربطت وحدة النقاط ولم تظهر نقاط للطلاب.**
الربط يسري على السجلات اللاحقة وحدها. سجّل حضور يوم جديد وستُضاف النقاط؛ وأيام ما قبل الربط تحتاج إضافة يدوية من [المحفظة](https://manual.misbah.pro/wallet#operations).

**عدّلت حالة طالب من غائب إلى حاضر — هل تتضاعف نقاطه؟**
لا. يُحسب الفرق بين القيمتين وحده فيُضاف أو يُخصم، فلا يتكرّر المنح.

**هل أستطيع تعطيل الحضور دون فقدان السجلات؟**
نعم. التعطيل يمنع إنشاء سجلات جديدة فقط: “يمكنك عرض السجلات السابقة فقط”. تبقى السجلات في اللوحة والتقارير، وتبقى أرصدة المحفظة كما هي، ويمكن إعادة التفعيل متى شئت.

**زر إضافة الحالة يقول «ترقية الباقة» — ماذا أفعل؟**
الحالات المخصصة ميزة في الباقة. تستطيع دون ترقية أن تختار إحدى الحزم الجاهزة الثلاث كاملةً؛ والترقية تفتح الإضافة والتعديل والحذف يدوياً. راجع [الفوترة والباقة](https://manual.misbah.pro/settings#billing).

**أريد حالة تكافئ الحضور المبكر — هل أتجاوز المئة؟**
نعم، والقيمة تصل إلى `200`. حالة بقيمة `120` تعطي في التقرير نسبةً فوق الالتزام الكامل، وتمنح `1.2` نقطة بدل نقطة. استعملها بحساب حتى لا تتضخّم نسب البرنامج.

**حذفت حالة كانت مستعملة — ماذا جرى للسجلات؟**
السجلات بقيت لكنها فقدت مرجعها، فتظهر في الجدول [[محذوف]]. لا سبيل للتراجع؛ لذلك عدّل اسم الحالة بدل حذفها متى كانت مستعملة.

---

## المتابعة اليومية

المصدر: https://manual.misbah.pro/activities

النشاط سجلٌّ يكتبه المعلم عن جلسة واحدة. هذه الصفحة تجمع ما كُتب في البرنامج كلّه ليوم أو أسبوع أو شهر.

الجمهور: مشرف

### النشاط هو وحدة العمل

كل ما يعرفه مصباح عن تقدّم الطالب مصدره سجلٌّ واحد: **النشاط**. المعلم يكتبه عن جلسة واحدة، فيتحرّك به موضع الخطة، وتُحسب منه النقاط، وتُبنى عليه نِسَب الإنجاز في اللوحات والتقارير. وهذه الصفحة هي المكان الذي تقرأ فيه تلك السجلات مجتمعة.

> **ملخّص سريع**
> - ما هذا؟ شاشة تجمع ما سجّله المعلمون في حلقات البرنامج ليوم أو أسبوع أو شهر.
> - لماذا يهمّك؟ الرقم المجمَّع في [الأداء](https://manual.misbah.pro/performance) يقول إن شيئاً ناقص؛ وهذه الصفحة تقول من الذي لم يسجّل، ولأي طالب، وفي أي خطة.
> - لمن؟ مشرف
> - الوقت المتوقّع: خمس دقائق في نهاية كل يوم

المسار: لوحة البرنامج ← متابعة يومية

- **التسميع** — نشاط قرآني: نطاق من سورة وآية إلى سورة وآية، يُسجَّل على خطة قرآنية.
  المنصة تحسب طوله بالأسطر وتحرّك به الموضع، فلا يحتاج المعلم دفتراً موازياً.
- **النشاط المرن** — نشاط غير قرآني: كمّية يدخلها المعلم على خطة مرنة، أو تعبئة بنود.
  المتون والمهارات والسلوك تُقاس كذلك، لا القرآن وحده.
- **الكمية والمطلوب** — ما أنجزه الطالب فعلاً في الجلسة، وما كانت الخطة تطلبه منه فيها.
  نسبتهما هي نصف معادلة النقاط، وهي أساس «الإنجاز» في [التقارير](https://manual.misbah.pro/reports#components).
- **التقييم** — درجة من `100` يمنحها المعلم للجلسة، تُحسب من «القواعد» إن عُرِّفت للخطة.
  هي الجودة مقابل الكمّية؛ بلا تقييم يصير برنامجك عدّاد صفحات.

الفرق بين هذه الصفحة و[الأداء](https://manual.misbah.pro/performance): الأداء يعطيك أرقاماً مجمّعة، والمتابعة اليومية تعطيك **الصفوف نفسها** — طالباً طالباً وخطةً خطة. وعنوان الصفحة يتبدّل بتبدّل الفترة: «متابعة يومية» أو «ملخص أسبوعي» أو «ملخص شهري».

![صفحة المتابعة اليومية تعرض صفوف الطلاب مع بطاقات خططهم ليوم واحد](https://manual.misbah.pro/images/activities/01-daily-overview.png)

### ماذا يحمل سجل النشاط

قبل أن تحكم على رقم في هذه الصفحة، اعرف كيف يتكوّن السجل الذي وراءه — وما الذي يكتبه المعلم بيده وما الذي تحسبه المنصة عنه.

**الكمية** — ما أنجزه الطالب في الجلسة. في التسميع **تحسبها المنصة** من نطاق الآيات بالأسطر، ولا يكتبها المعلم؛ وفي النشاط المرن يدخلها المعلم في حقل «الكمية».

**المطلوب** — ما كانت الخطة تطلبه من الطالب في تلك الجلسة. تحسبه المنصة من إعدادات الخطة، ويظهر للمعلم في شاشة التسميع بصيغة “المطلوب {عدد} سطر” مع زر «إعادة للمطلوب» إن عدّل النطاق.

*من يكتب ماذا*
| الحقل | في التسميع | في النشاط المرن |
| --- | --- | --- |
| الكمية للعلم | تحسبها المنصة من النطاق المسمَّع. | يدخلها المعلم في «الكمية». |
| المطلوب للعلم | تحسبه المنصة من إعدادات الخطة لذلك اليوم. | يساوي الكمية غالباً، وفي البنود يُشتقّ من التعبئة. |
| التقييم | خطوة مستقلة بعد النطاق، من «القواعد» أو يدوياً. | من «الأخطاء» و«التقييم النهائي» في النموذج نفسه. |

المعلم يسجّل التقييم في خطوة “تقييم النشاط”: يعدّ ما وقع من أخطاء وما استحقّ من ثناء وفق «القواعد» المعرَّفة في قالب الخطة، فتظهر “مجموع الخصم:” و“مجموع النقاط الإيجابية:” ثم “الدرجة النهائية:”. وله أن يحفظ بلا تفصيل عبر «حفظ بدون ملاحظات».

> **تعبئة البنود:** في خطط البنود لا يكتب المعلم كميةً واحدة، بل يزيد وينقص عدّاد كل بند، فيظهر “إجمالي الجلسة” ثم “الإنجاز: {الكمية} / {المطلوب}”. ولذلك تخرج الكمية والمطلوب معاً من التعبئة، ولا يُدخلان يدوياً.

> **حدّ الأنشطة اليومي:** قالب الخطة قد يحمل “الحد الأقصى للأنشطة في اليوم”. فإن بلغه الطالب رُفض تسجيل نشاط جديد عليه في اليوم نفسه، ويرى المعلم شاشة “حدث خطأ!” ونصّها “الحد الأقصى للأنشطة لهذا اليوم”. الحدّ يُضبط في [قالب الخطة](https://manual.misbah.pro/plans)، لا من هنا.

السجل بعد حفظه **يُعدَّل ولا يُحذف** من الواجهة: من «تعديل النشاط» يُضبط «تاريخ النشاط» و«المطلوب» و«التقييم (0–100)» و«ملاحظات» والنطاق. وتاريخ النشاط مهم: “يُستخدم لتجميع النشاط في يومه، حتى لو سُجّل لاحقاً.” — فالمعلم الذي يسجّل حصة أمس اليوم يضبط التاريخ فتقع الجلسة في يومها الصحيح في كل التقارير.

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

### اختيار الفترة

من قائمة «نوع العرض» تختار مدى الصفحة، وكل خيار يحمل وصفه تحته.

#### أي مدى تفتح؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| متابعة يومية (الافتراضي) | الفحص اليومي — “نشاط كل طالب في يوم واحد”. | تكشف الحلقة التي لم تسجّل اليوم، وتصحّحها في يومها. | لا تصلح للحكم على التزام طالب، فاليوم الواحد ليس اتجاهاً. |
| ملخص أسبوعي (الأنسب غالباً) | المراجعة الدورية — “مجموع الأسبوع الحالي”. | يُظهر من انقطع يومين متتاليين، وهو ما لا يظهر في اليوم الواحد. | قد يخفي يوماً واحداً فارغاً وسط أسبوع ممتلئ. |
| ملخص شهري (متقدّم) | حصاد الشهر — “مجموع الشهر الهجري/الميلادي”. | يعطي صورة الاتجاه قبل كتابة تقرير أو عقد اجتماع. | بطيء القراءة وكثيف الأرقام؛ للتسليم الرسمي استعمل [التقارير](https://manual.misbah.pro/reports). |

ومتى اخترت مدى من شريط التاريخ لا يطابق أحد هذه الخيارات، صار عنوان الصفحة «فترة مخصصة».

الحالة الفارغة تتبع المدى بدقّة: “لا توجد بيانات لهذا اليوم” أو “لا توجد بيانات لهذا الأسبوع” أو “لا توجد بيانات لهذا الشهر” أو “لا توجد بيانات لهذه الفترة”، ومعها “جرب تغيير التاريخ أو معايير التصفية”. وهي تعني **غياب التسجيل**، لا خللاً في الصفحة.

### العرض المدمج والمفصل

زرّان صغيران يبدّلان كثافة الصف: «العرض المدمج» و«العرض المفصل». والفرق بينهما فرقٌ في السؤال لا في الشكل.

- **العرض المدمج** — صفٌّ مضغوط لكل طالب — مناسب لمسح حلقة كاملة بنظرة واحدة والبحث عن الفراغات.
- **العرض المفصل** — يفتح بطاقات الخطط تحت كل طالب — مناسب لمراجعة حالة طالب بعينه أو التحقق من دقة تسجيل معلم.

صفّ الطالب يجمع: اسمه، ونسبة إنجازه في الفترة، وحلقته، وحالات حضوره مع عددها، ومجموع ما تلاه، ومجموع كل وحدة نقاط كسبها. وتحته بطاقة لكل خطة فيها “المجموع” و“التقييم” و“النطاق الإجمالي”، أو “لم يُسجَّل أي نشاط خلال هذه الفترة”.

استخدم «التصفية» لحصر العرض على حلقة واحدة أو قالب خطة واحد — وهو ما تحتاجه عند متابعة معلم بعينه أو مسار بعينه. وعدّاد التصفيات النشطة يظهر بجانب الزر، ويمسحها «مسح».

> **عادة إدارية تستحق خمس دقائق:** افتح هذه الصفحة على «متابعة يومية» في نهاية كل يوم دراسي، وصفِّ بالحلقة. غياب صفوف لحلقة كاملة يعني أن معلمها لم يسجّل — وهذا أسهل ما يُصحَّح في يومه، وأصعب ما يُصحَّح في آخر الفصل حين يصير الإنجاز منخفضاً في [التقرير](https://manual.misbah.pro/reports#components) بلا سبب حقيقي.

![صف طالب في العرض المفصل مع بطاقات خططه ومجاميعها وتقييماتها](https://manual.misbah.pro/images/activities/02-detailed-row.png)

### أسئلة شائعة

**لا توجد بيانات رغم أن الحلقة عملت اليوم.**
المعلم لم يسجّل بعد. تحقّق أن الطلاب موزّعون على حلقته وأن لهم خططاً مطبَّقة، وأن نظام الحضور مفعّل إن كان مطلوباً، ثم راجع [الحلقات والتسميع](https://manual.misbah.pro/teaching).

**المعلم يقول إن المنصة ترفض تسجيل نشاط جديد.**
الأرجح أنه بلغ “الحد الأقصى للأنشطة في اليوم” لتلك الخطة، فتظهر له “الحد الأقصى للأنشطة لهذا اليوم”. ارفع الحدّ أو اتركه فارغاً في [قالب الخطة](https://manual.misbah.pro/plans) إن كان التعدّد مقصوداً.

**سجّل المعلم حصة أمس اليوم — هل تقع في يومها؟**
نعم إن ضبط «تاريخ النشاط» عند التسجيل أو من «تعديل النشاط»؛ فالمنصة تجمّع النشاط في يومه لا في لحظة إدخاله، وكذلك تُقيَّد نقاطه في المحفظة على يوم العمل نفسه.

**كيف أحذف نشاطاً سُجّل بالخطأ؟**
الواجهة لا تتيح حذف سجل نشاط، بل تعديله. افتح «تعديل النشاط» وصحّح النطاق أو المطلوب أو التقييم؛ وتُعدَّل نقاط المحفظة بالفارق تلقائياً.

**ما الفرق بين «المقدار» في الأداء و«الكمية» هنا؟**
هما الشيء نفسه بتسميتين: ما أنجزه الطالب في الجلسة. عمود «المقدار» في قائمة آخر الأنشطة بصفحة [الأداء](https://manual.misbah.pro/performance#latest)، وحقل «الكمية» في نموذج النشاط المرن الذي يملؤه المعلم.

**لماذا لا تظهر نقاط للأنشطة المسجّلة؟**
لأن النقاط تُقيَّد على وحدة نقاط الخطة. قالب خطة بلا وحدة نقاط لا يمنح شيئاً مهما سُجّل عليه. راجع [كيف تُكتسب النقاط](https://manual.misbah.pro/wallet#earning).

---

## المحفظة والنقاط

المصدر: https://manual.misbah.pro/wallet

المحفظة عملة البرنامج الداخلية: وحدات نقاط بمعامل تحويل، ورصيد لكل طالب، وسجل حركات يبيّن مصدر كل نقطة.

الجمهور: مشرف

### النقاط عملة، لا مجاملة

النقاط في مصباح ليست وسام تشجيع يُمنح ارتجالاً. هي عملة داخلية للبرنامج: لها وحدات معرَّفة، ورصيد محفوظ لكل طالب، وسجلٌّ يبيّن مصدر كل حركة ووقتها. ولذلك تصلح أن تُصرف في جوائز أو تُعرض في ترتيب دون أن يختلف عليها أحد.

> **ملخّص سريع**
> - ما هذا؟ وحدات نقاط للبرنامج، ومحفظة لكل طالب مسجَّل فيها أرصدته وسجل حركاته.
> - لماذا يهمّك؟ الطالب يحتاج أثراً ملموساً لجهده، والمشرف يحتاج أن يكون هذا الأثر محسوباً لا مزاجياً.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة للإعداد

المسار: لوحة البرنامج ← أدوات إضافية ← المحفظة

عنوان الصفحة “المحفظة المالية”، وتعرض ملخّص البرنامج ثم «قائمة المحافظ» بأعمدة «الطالب» و«الحلقة» و«إجمالي النقاط» و«الأرصدة» و«الإجراءات». وتُنشأ المحافظ للطلاب المسجَّلين، فالمحفظة تتبع **التسجيل** في البرنامج لا الطالب في المسجد.

- **وحدة النقاط** — عملة مسمّاة داخل البرنامج — [[نقطة]] أو [[نجمة]] أو [[صفحة]] — لها أيقونة ومعامل تحويل.
  تسمية الوحدة بلغة المسجد تجعل المكافأة مفهومة للطالب، لا رقماً مجرّداً.
- **المحفظة** — رصيد لكل وحدة يخصّ تسجيل طالب واحد في برنامج واحد.
  أرصدة البرنامج الصيفي لا تختلط ببرنامج آخر، ولكل دورة حسابها.
- **الحركة** — سطر في السجل: نوعه ومقداره ووحدته ومصدره وتاريخه ورصيده بعده.
  هي حجّتك حين يقول طالب “نقاطي ناقصة” — تفتح السجل فتجد مِن أين جاءت كل نقطة.
- **الوحدة الافتراضية** — وحدة واحدة “تُحوّل إليها باقي الوحدات” لعرض رقم واحد مفهوم في القائمة.
  بدونها يرى المشرف أربعة أرصدة متفرّقة ولا يعرف أيّها أكبر.

![صفحة المحفظة المالية تعرض ملخص البرنامج وقائمة محافظ الطلاب](https://manual.misbah.pro/images/wallet/01-wallet-board.png)

> **ملاحظة:** المحفظة شرطٌ لأشياء أخرى: [الخطط المرنة](https://manual.misbah.pro/flexible-plans) و[خطط البنود](https://manual.misbah.pro/flexible-plans) لا تعمل بلا وحدة نقاط، و[مكافأة الحضور](https://manual.misbah.pro/attendance#reward) لا يظهر قسمها إلا بعد إنشاء أول وحدة.

### الوحدات ومعامل التحويل

من «إعدادات المحفظة» تفتح صفحة “إعدادات نظام النقاط”، وفيها قسمان: «وحدات النقاط» ثم «الوحدة الافتراضية للرصيد».

وصف القسم الأول: “إدارة الوحدات التي يجمعها الطلاب (صفحة، حديث، نقطة...). أضف وحدات مقترحة بضغطة واحدة أو أنشئ وحدة مخصصة.” ومعه وحدات مقترحة جاهزة تُضاف بنقرة: [[صفحة]] و[[حديث]] و[[صرة]] و[[ذهب]] و[[فضة]].

**معامل التحويل** — رقم يقول: كم تساوي نقطةٌ من هذه الوحدة بالمقياس الموحَّد. حقل إنشاء الوحدة يسمّيه «نقاط لكل تسميع» ويشرحه بـ“عدد النقاط التي يحصل عليها الطالب عند كل تسميع واحد”، بينما تعرضه بطاقة الوحدة في القائمة باسمه الحقيقي “(معدل التحويل)”. **اقرأه على أنه معامل تحويل**: وحدة معاملها `10` تعني أن نقطتها تساوي عشراً من وحدة معاملها `1`.

> **إجمالي النقاط:** `إجمالي النقاط = Σ(الرصيد × معامل التحويل)`
> ثم يُعرض هذا المجموع بالوحدة الافتراضية، أي مقسوماً على معاملها: `المعروض في القائمة = إجمالي النقاط ÷ معامل الوحدة الافتراضية`.
> والإجمالي **يُحسب عند كل قراءة ولا يُخزَّن**. أي أنّ تعديل معامل وحدة اليوم يعيد تقويم كل تاريخها — وهذا مقصود، فانتبه له قبل تعديل معامل وحدة عليها أرصدة.

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

#### الوحدة الافتراضية للرصيد

“مطلوب لعرض إجمالي الرصيد في قائمة المحافظ وبطاقة الرصيد. اختر وحدة واحدة تُحوّل إليها باقي الوحدات.” اخترها من القائمة ثم اضغط «اعتماد الوحدة الافتراضية»؛ وتظهر “معاينة العرض للطالب” قبل الحفظ. ووحدةٌ لم تُختر بعد تمنع الحفظ برسالة “اختر الوحدة الافتراضية للرصيد قبل الحفظ”.

> **نصيحة:** اجعل الوحدة الافتراضية هي الأكثر شيوعاً في برنامجك ومعاملها `1`. عندها يصير «إجمالي النقاط» عدداً حقيقياً من تلك الوحدة، ولا يحتاج أحد إلى حساب ذهني.

![قسم وحدات النقاط في إعدادات نظام النقاط مع بطاقات الوحدات ومعدل التحويل](https://manual.misbah.pro/images/wallet/02-point-units.png)

> **الحذف قبل التسمية:** الوحدة الافتراضية لا تُحذف: “لا يمكن حذف الوحدة الافتراضية. غيّر الوحدة الافتراضية أولاً من إعدادات المحفظة.” وأمّا وحدةٌ عليها أرصدة فيرفض الخادم حذفها، لكن الواجهة تكتفي بـ“فشل حذف الوحدة” دون بيان السبب. **فسمِّ وحداتك بعناية من أول يوم**؛ التعديل متاح دائماً والحذف ليس كذلك.

### الأرصدة والحركات اليدوية

من «قائمة المحافظ» حدّد طالباً أو عدة طلاب، ثم نفّذ «إضافة» أو «خصم» أو «تعديل». وكل عملية تطلب «وحدة النقاط» و«المبلغ» و«ملاحظات» قبل «تأكيد العملية».

*أنواع الحركات — والفرق الذي يغفل عنه الجميع*
| النوع | ما يفعله بالرصيد | متى تستعمله |
| --- | --- | --- |
| «إضافة» مناسب | يزيد الرصيد بالمبلغ المكتوب. | مكافأة مسابقة، أو تعويض عن نشاط خارج المنصة. |
| «خصم» بتحفّظ | ينقص الرصيد بالمبلغ المكتوب، ولا ينزل به تحت الصفر. | صرف جائزة اشتراها الطالب بنقاطه. |
| «تعديل» غير مناسب | **يجعل الرصيد يساوي المبلغ المكتوب** — لا يضيفه ولا يطرحه. | تصحيح رصيد اختلّ، أو بدء فصل جديد برصيد معلوم. |

> **«تعديل» يحدّد ولا يحرّك:** اكتب `50` في «تعديل» وأنت تظن أنك تضيف خمسين، فيصبح رصيد الطالب خمسين مهما كان قبلها. هذا أشيع خطأ في المحفظة. وللزيادة استعمل «إضافة» وللإنقاص «خصم»، ولا تلجأ إلى «تعديل» إلا حين تعرف الرقم النهائي الذي تريده.

حقل «ملاحظات» ليس زينة: إن تركته فارغاً تُسجَّل الحركة بملاحظة [[تعديل يدوي]] فحسب، وبعد شهرين لن يعرف أحد لماذا. اكتب السبب دائماً.

#### العمليات الجماعية

التحديد المتعدّد يفتح شريط “العمليات على (n):” بالأفعال الثلاثة نفسها، ويبيّن الحوار “عدد الطلاب المتأثرين:” قبل التنفيذ. والخصم الجماعي **يفشل كاملاً** إن لم يكف رصيد أحد المحدَّدين — لا يُنفَّذ جزئياً — فتظهر “حدث خطأ أثناء تنفيذ العملية” ويبقى الجميع كما كانوا.

![حوار إضافة نقاط بالجملة مع عدد الطلاب المتأثرين واختيار الوحدة والمبلغ](https://manual.misbah.pro/images/wallet/03-credit-debit.png)

#### سجل المعاملات

السجل مرتّب بالأيام، ويُصفّى بنطاق التاريخ وبنوع الحركة، ويعرض “إجمالي المعاملات” و“الصافي” و“إجمالي الإضافة” و“إجمالي الخصم” و“إجمالي التعديل”. ولكل حركة **وسم مصدر** يقول من أين جاءت.

*مصادر الحركة*
| الوسم | من أين تأتي |
| --- | --- |
| [[نشاط]] للعلم | تسميع أو نشاط مرن سجّله المعلم — [المتابعة اليومية](https://manual.misbah.pro/activities). |
| [[حضور]] للعلم | سجل حضور، بعد ربط وحدة في [مكافأة الحضور](https://manual.misbah.pro/attendance#reward). |
| [[خطة]] | أثر يخصّ خطة الطالب نفسها. |
| [[يدوي]] | إضافة أو خصم نفّذته أنت من هذه الصفحة. |
| [[تعديل]] بتحفّظ | ضبط رصيد إلى قيمة نهائية. |

> **ملاحظة:** تاريخ الحركة هو **يوم العمل** الذي تخصّه — يوم النشاط أو يوم الحضور — لا لحظة إدخالها. فمعلم يسجّل حصة أمس اليوم تُقيَّد نقاطها على أمس، ويبقى تقرير اليوم صحيحاً.

### من أين تأتي النقاط تلقائياً

أكثر النقاط لا تُمنح بيدك. هي تُحتسب من تسجيل المعلم اليومي وفق قواعد ثابتة، وهذه القواعد هي ما ينبغي أن تفهمه قبل أن تَعِد الطلاب بشيء.

> **نقاط جلسة التسميع:** `النقاط الأساسية = 0.5 × (المُنجَز ÷ المطلوب) + 0.5 × التقييم`
> `النقاط الممنوحة = النقاط الأساسية × معامل نقاط الخطة`
> فجلسة كاملة بتقييم تامّ تساوي نقطة واحدة قبل معامل الخطة. والتقييم يُردّ إلى مقياس من واحد، والمطلوب إن كان صفراً فلا نقاط.

> **نقاط الحضور:** `نقاط الحضور = قيمة حالة الحضور ÷ 100`
> شرطها أن تكون وحدة نقاط مربوطة في [هيكلة الحضور](https://manual.misbah.pro/attendance#reward). والتفصيل هناك.

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

> **خطة بلا وحدة نقاط لا تمنح شيئاً:** النقاط تُقيَّد على **وحدة الخطة**؛ فإن لم تُسنَد وحدة نقاط إلى قالب الخطة، فكل تسميع عليها يمنح **صفراً** مهما كان متقناً. هذا أول ما تفحصه حين يشتكي الطلاب أن التسميع لا يعطي نقاطاً. راجع إعداد الوحدة في [قالب الخطة](https://manual.misbah.pro/plans).

> **لا تعبئة رجعية:** ربط وحدة نقاط — بالحضور أو بقالب خطة — يسري على ما يُسجَّل **بعده**. الأيام السابقة لا تُملأ بأثر رجعي، والمنصة لا تنبّهك. إن أردت إنصاف فترة مضت فأضِف النقاط جماعياً من [الحركات اليدوية](https://manual.misbah.pro#operations) واكتب السبب في الملاحظة.

أرصدة النقاط أحد مصدرَي الترتيب في [شاشة العرض](https://manual.misbah.pro/monitor)، ويراها الطالب وولي الأمر في [تطبيق مصباح](https://manual.misbah.pro/consumer-app) إن كان الحساب مرتبطاً.

### أسئلة شائعة

**ما الفرق بين «الأرصدة» و«إجمالي النقاط»؟**
«الأرصدة» هي أرقام حقيقية لكل وحدة على حدة. و«إجمالي النقاط» رقم واحد يجمعها بعد ضرب كل رصيد في معامل وحدته، معروضاً بالوحدة الافتراضية. الأول للتفصيل، والثاني للمقارنة والترتيب.

**غيّرت معامل وحدة — هل تتغيّر أرصدة الطلاب؟**
الأرصدة نفسها لا تتغيّر، لكن «إجمالي النقاط» يُعاد حسابه فوراً لكل التاريخ لأنه يُحسب عند القراءة ولا يُخزَّن. فتعديل المعامل في منتصف الفصل يقلب ترتيب الطلاب. عدّله قبل البدء أو لا تعدّله.

**خصمت نقاطاً بالخطأ — كيف أتراجع؟**
نفّذ حركة معاكسة: «إضافة» بالمقدار نفسه والوحدة نفسها، واكتب السبب في «ملاحظات». السجل يحتفظ بالحركتين، وهذا مقصود حتى يبقى التاريخ قابلاً للمراجعة.

**كتبت في «تعديل» رقماً فانخفض رصيد الطالب — لماذا؟**
لأن «تعديل» يضبط الرصيد على الرقم الذي كتبته، لا يضيفه. استعمل «إضافة» للزيادة و«خصم» للنقصان.

**الطلاب يسمّعون ولا تظهر نقاط.**
افحص بالترتيب: هل لقالب الخطة وحدة نقاط؟ فإن لم تكن فلا نقاط أصلاً. ثم هل الوحدة الافتراضية معتمَدة؟ فبدونها لا يُعرض «إجمالي النقاط» وإن كانت الأرصدة موجودة.

**فشل حذف وحدة نقاط ولم يُذكر سبب.**
الأرجح أن عليها أرصدة، أو أنها الوحدة الافتراضية. غيّر الوحدة الافتراضية أولاً، وإن بقيت الأرصدة فانقلها بحركات يدوية قبل الحذف — أو اكتفِ بتعديل اسم الوحدة وترْكها.

**هل يرى الطالب رصيده؟**
نعم، إن كان مرتبطاً بتطبيق مصباح — راجع [تطبيق المستفيدين](https://manual.misbah.pro/consumer-app). ويمكن كذلك عرض الترتيب بالنقاط على [شاشة العرض](https://manual.misbah.pro/monitor).

---

## التقارير

المصدر: https://manual.misbah.pro/reports

التقرير لقطة محفوظة لأداء الطلاب في فترة محددة: نوعان، وثلاثة مكوّنات موزونة، وملف يبقى في القائمة للتنزيل.

الجمهور: مشرف

### ما التقرير في مصباح؟

التقرير ملفٌ يُولَّد مرة واحدة لفترة تحدّدها أنت، ثم يُحفظ في القائمة باسمه وتاريخه. هو صورةٌ ثابتة لأداء الطلاب في تلك الفترة، لا شاشةٌ تتغيّر كلّما فتحتها — ولذلك يصلح دليلاً إدارياً يُسلَّم ويُؤرشَف.

> **ملخّص سريع**
> - ما هذا؟ ملف يجمع أداء كل طالب في فترة محددة، محسوباً بأوزان تختارها أنت.
> - لماذا يهمّك؟ اللوحات تجيب عن “كيف الحال اليوم؟”، والتقرير يجيب عن “ماذا أنجزنا في الفصل الماضي؟” بصيغة تُسلَّم وتُحفَظ.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٥ دقائق للتقرير الأول

المسار: لوحة البرنامج ← التقارير

الصفحة تعرض تقارير البرنامج السابقة مرتّبة بالأشهر، مع بحث وتصفية بالحالة. وإن لم يوجد تقرير بعد: “لا توجد تقارير سابقة” و“قم بإنشاء تقرير جديد لبدء الاستخدام”.

- **التقرير** — نتيجة حساب جرى مرة واحدة على فترة محددة، محفوظة كملف في القائمة.
  أرقامه لا تتغيّر بعد اليوم، فيصلح مرجعاً في اجتماع أو تسليم.
- **المكوّنات الثلاثة** — الحضور، التقييم، الإنجاز — ثلاثة أرقام مستقلة يُبنى منها [[التقييم العام]].
  الفصل بينها يكشف أين الخلل: طالب ملتزم بالحضور ضعيف الإنجاز مشكلته في الخطة لا في الانضباط.
- **الأوزان** — أرقام تقول: كم يهمّ كل مكوّن، وكم يهمّ كل قالب خطة.
  بها يعبّر التقرير عن سياسة برنامجك بدل سياسة افتراضية واحدة لكل المساجد.
- **حالة التقرير** — [[قيد المعالجة]] أثناء التوليد، ثم [[مكتمل]] فيُتاح «تحميل التقرير»، أو [[فشل]].
  التوليد يجري على الخادم، فالحالة هي ما يخبرك أن الملف صار جاهزاً.

![قائمة تقارير البرنامج السابقة مجمّعة بالأشهر مع حالة كل تقرير](https://manual.misbah.pro/images/reports/01-reports-list.png)

> **ملاحظة:** لا يُقبل إنشاء تقرير لفترة تبدأ قبل تاريخ بدء البرنامج؛ يظهر عندها “لا يمكن إنشاء تقرير قبل بدء البرنامج”.

### أي نوع من التقارير تختار؟

في مصباح نوعان لا ثالث لهما، ويُحسمان من حوار «إنشاء تقرير جديد» قبل أي إعداد آخر.

#### «تقرير شامل» أم «تقرير الحضور فقط»؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| تقرير شامل (الافتراضي) | تريد صورة كاملة: ماذا أنجز الطالب من خططه، وكيف قُيِّم، وكم التزم بالحضور. | “يتضمن بيانات الأنشطة والخطط والحضور”، ويفتح لك [إعدادات الأوزان](https://manual.misbah.pro#weights) لضبط أهمية كل مكوّن وكل قالب. | يحتاج أن تكون الخطط مطبَّقة والتسميع مسجَّلاً، وإلا خرجت نسب الإنجاز منخفضة بلا سبب حقيقي. |
| تقرير الحضور فقط (متقدّم) | سؤالك عن الانضباط وحده: من حضر، ومن غاب، وبأي نسبة. | “يتضمن بيانات الحضور فقط لجميع الطلاب المسجلين” — أخفّ وأسرع، ولا يتأثر بحالة الخطط. | لا أوزان فيه ولا إنجاز ولا تقييم. ويُعطَّل الخيار أصلاً إن لم يكن للبرنامج نظام حضور. |

> **ملاحظة:** حين لا يحتوي البرنامج على نظام حضور، يظهر الخيار الثاني باسمه موسوماً بالسبب: “تقرير الحضور فقط (لا يوجد نظام حضور في هذا البرنامج)”، ومعه “لا يمكن إنشاء تقرير الحضور لأن البرنامج لا يحتوي على نظام حضور”. العلاج في [هيكلة الحضور](https://manual.misbah.pro/attendance#structure).

**نوع التقرير** — خيار يُحسم عند الإنشاء ولا يُعدَّل بعده — التقرير ملف مولَّد، فتغيير نوعه يعني إنشاء تقرير آخر. النوع يظهر على بطاقة التقرير في القائمة وسماً: [[شامل]] أو [[حضور]].

### الحضور والتقييم والإنجاز

ثلاث كلمات يخلط بينها أكثر المشرفين، وهي في مصباح ثلاثة حسابات مختلفة تماماً. المنصة نفسها تعرّفها في بطاقة المساعدة داخل «إعدادات الأوزان».

**الحضور** — “نسبة الحضور للطالب” — متوسط **قيم** حالات الحضور المسجَّلة له في الفترة، لا عدد أيام حضوره. حالة قيمتها 50 تُدخِل نصف يوم في المتوسط. عرّف القيم بعناية في [هيكلة الحضور](https://manual.misbah.pro/attendance#structure).

**التقييم** — “متوسط تقييمات الخطط” — الدرجة التي يمنحها المعلم للجلسة (من ١٠٠)، ممثّلةً جودة الأداء: الإتقان والضبط. لا علاقة لها بالكمية.

**الإنجاز** — “متوسط إنجازات الخطط” — الكمية المنجَزة مقسومة على الكمية المطلوبة في الفترة. لا علاقة لها بالجودة: طالب يسمّع كامل ورده بإتقان ضعيف إنجازه ١٠٠٪ وتقييمه منخفض.

> **نسبة الخطة الواحدة:** `نسبة الخطة = مجموع المُنجَز ÷ المطلوب خلال الفترة`
> و«المطلوب خلال الفترة» ليس مجموع ما طُلب في الجلسات المسجَّلة وحده، بل يضاف إليه المُقدَّر عن الأيام التي كان على الطالب أن يسمّع فيها ولم يُسجَّل له شيء: `المطلوب = المطلوب في الجلسات المسجَّلة + (أيام بلا تسجيل × متوسط المطلوب للجلسة)`.

> **اليوم الذي لم يُسجَّل يخفض الإنجاز:** هذا هو السبب الأول لشكوى “الإنجاز أقل مما أتوقّع”: التقرير يحاسب على أيام العمل التي مرّت بلا تسجيل، لا على الجلسات المسجَّلة فقط. راجع [المتابعة اليومية](https://manual.misbah.pro/activities) قبل إصدار التقرير، لا بعده.

*ماذا يقيس كل مكوّن، وأين تعالجه*
| المكوّن | يقيس | مصدره | إن كان منخفضاً |
| --- | --- | --- | --- |
| الحضور للعلم | الانضباط | سجلات [الحضور](https://manual.misbah.pro/attendance) | راجع قيم الحالات، وتحقّق أن المعلمين يسجّلون يومياً. |
| التقييم | جودة الأداء | درجة المعلم في كل جلسة | مسألة تدريس لا مسألة إعداد — ناقش المعلم. |
| الإنجاز بتحفّظ | الكمية مقابل المطلوب | خطط الطالب وأنشطته | ابحث عن أيام بلا تسجيل، أو خطة مقدارها أكبر من طاقة الحلقة. |

### إنشاء تقرير

اضغط «إنشاء تقرير» ليفتح حوار “إنشاء تقرير جديد”. الترتيب المنطقي: العنوان، ثم النوع، ثم الفترة، ثم التصفية، ثم الأوزان.

1. اكتب «عنوان التقرير»
   حتى ١٠٠ حرف. اجعله قابلاً للتمييز بعد أشهر: “أدخل عنوان التقرير (مثال: تقرير الربع الأول)”. عنوان مثل «تقرير» لن يفيدك في قائمة فيها عشرون ملفاً.
2. اختر «نوع التقرير»
   القرار محسوم في [القسم السابق](https://manual.misbah.pro#choose)، ولا يُعدَّل بعد الإنشاء.
3. حدّد الفترة
   إمّا من «اختيار سريع للتاريخ» — «آخر 7 أيام» أو «آخر 30 يوم» أو «آخر 3 أشهر» أو «كامل البرنامج» — وإمّا يدوياً من «من التاريخ» و«إلى التاريخ». يُعرض ملخّص الفترة بالتاريخ الهجري أسفل الحقلين.
4. افتح «التصفية» عند الحاجة
   “بشكل افتراضي، سيتم تضمين جميع المجموعات والقوالب في التقرير ما لم تحدد خيارات محددة”. التصفية بـ«المجموعات» تحصر التقرير في حلقات بعينها، والتصفية بـ«القوالب» تحصره في قوالب خطط بعينها — وهي متاحة في «تقرير شامل» وحده.
   ![حوار إنشاء تقرير جديد مع حقل العنوان ونوعي التقرير واختيار الفترة](https://manual.misbah.pro/images/reports/02-create-dialog.png)
5. اضبط «إعدادات الأوزان» إن لزم
   اتركها كما هي في تقريرك الأول — [التفصيل هنا](https://manual.misbah.pro#weights).
6. اضغط «إنشاء التقرير»
   يتحوّل الزر إلى “جاري التصدير...”، ثم يبدأ تنزيل الملف تلقائياً ويُضاف التقرير إلى القائمة مع إشعار “تم تصدير التقرير بنجاح”.

> **نصيحة:** التقرير الأول تجربة لا تسليم. أنشئه على «آخر 7 أيام» بأوزان افتراضية، افتح الملف، وتحقّق أن الأسماء والأرقام كما تتوقّع — ثم أنشئ تقرير الفترة الحقيقي.

### أوزان المكوّنات وأوزان القوالب

الأوزان هي ما يجعل التقرير يعبّر عن سياسة برنامجك. تفتحها من «إعدادات الأوزان» داخل حوار الإنشاء، وتظهر في «تقرير شامل» وحده. القيمة الافتراضية `1` للجميع، أي أوزان متساوية.

#### أوزان المكونات

ثلاثة حقول: «وزن الحضور» و«وزن التقييم» و«وزن الإنجاز». “حدد أهمية كل مكون في حساب التقييم العام (القيمة الافتراضية: 1)”. وكل وزن يختلف عن الافتراضي يظهر بجانبه وسم مثل [[2x]].

> **التقييم العام:** `التقييم العام = (الإنجاز × وزن الإنجاز + نسبة الحضور × وزن الحضور + (التقييم ÷ 100) × وزن التقييم) ÷ (وزن الحضور + وزن التقييم + وزن الإنجاز)`
> وحيث `نسبة الحضور = متوسط قيمة حالات الحضور ÷ 100`. المكوّنات كلّها تُردّ إلى مقياس واحد قبل الترجيح، ثم يُرتَّب الطلاب في الملف تنازلياً بحسب هذه النتيجة.

*أمثلة على سياسات الأوزان*
| سياسة البرنامج | الحضور | التقييم | الإنجاز |
| --- | --- | --- | --- |
| متوازن — الوضع الافتراضي مناسب | 1 | 1 | 1 |
| برنامج يشدّد على الانضباط للعلم | 3 | 1 | 1 |
| برنامج حفظ يقيس الكمّ للعلم | 1 | 1 | 3 |
| برنامج إتقان يقيس الجودة للعلم | 1 | 3 | 1 |
| تعطيل مكوّن بالكامل بتحفّظ | 0 | 1 | 1 |

> **لا تُصفِّر الأوزان الثلاثة:** الوزن `0` يُخرج المكوّن من الحساب، وهذا مقصود ومفيد. أما تصفيرها جميعاً فيُبطل التقييم العام، فيمنعه النظام برسالة: “يجب أن يكون وزن واحد على الأقل من المكونات (الحضور، التقييم، أو الإنجاز) أكبر من صفر”. وقبل ذلك يظهر تحذير: “جميع أوزان المكونات صفر. سيؤدي هذا إلى عدم إمكانية حساب التقييم العام.”

#### أوزان قوالب الخطط

“تحدد هذه الأوزان أهمية كل قالب خطة في حساب الإنجاز والتقييم”. الطالب في برنامج جادّ يحمل عدة خطط — حفظ ومراجعة وتثبيت — وليس من العدل أن تتساوى خطة ورد الحفظ مع خطة تلاوة خفيفة في حساب إنجازه.

> **الإنجاز والتقييم للطالب:** `الإنجاز = Σ(نسبة الخطة × وزن قالبها) ÷ Σ(أوزان القوالب)`
> `التقييم = Σ(متوسط تقييم الخطة × وزن قالبها) ÷ Σ(أوزان القوالب)`
> أي أنّ وزن القالب يدخل في الإنجاز والتقييم معاً، ولا يمسّ الحضور. قالبٌ بلا وزن مضبوط يأخذ `1`.

متى عدّلت شيئاً ظهر وسم «معدّل» على القسم وسطرٌ يقول “تم تعديل الأوزان من القيم الافتراضية”، ومعه زر «إعادة تعيين إلى الافتراضي» يردّ الجميع إلى `1`.

![قسم إعدادات الأوزان مفتوحاً يعرض أوزان المكونات الثلاثة وأوزان قوالب الخطط](https://manual.misbah.pro/images/reports/03-weights.png)

> **انتبه:** الأوزان تُحفظ **مع التقرير الذي أنشأته**، ولا تصبح إعداداً دائماً للبرنامج. تقريران على الفترة نفسها بأوزان مختلفة يعطيان ترتيبين مختلفين — لذا سجّل سياسة أوزانك في عنوان التقرير أو خارج المنصة حتى تُعاد كما هي في الفترة القادمة.

### الملف والقائمة

بعد التوليد يبقى التقرير في القائمة ببطاقة تحمل عنوانه ونطاق تاريخه ووسم نوعه، ومنها تعيد تنزيله متى شئت.

- **مكتمل** — التوليد انتهى، ويظهر «تحميل التقرير» على البطاقة.
- **قيد المعالجة** — الحساب يجري على الخادم؛ الزر معطّل حتى ينتهي. حدّث القائمة بعد قليل.
- **فشل** — تعذّر التوليد ويظهر “فشل في التصدير”. أعد الإنشاء بفترة أضيق أو بتصفية أقل.

الملف الناتج جدول بيانات يفتحه Excel أو أي برنامج جداول، صفٌّ لكل طالب فيه مكوّناته الثلاثة وتقييمه العام. ولأن الترتيب تنازلي بحسب التقييم العام، فأعلى الجدول وأسفله هما أول ما تنظر إليه.

> **الملف يبقى ثلاثة أشهر:** لكل تقرير تاريخ صلاحية على الخادم مدّته **ثلاثة أشهر** من لحظة الإنشاء؛ بعدها قد لا يعمل رابط التنزيل وإن بقيت البطاقة في القائمة. نزّل تقارير نهاية الفصل واحفظها عندك ولا تعتمد على القائمة أرشيفاً دائماً.

![بطاقة تقرير مكتمل تعرض العنوان ونطاق التاريخ ووسم النوع وزر التحميل](https://manual.misbah.pro/images/reports/04-report-card.png)

للمتابعة اليومية دون إنشاء ملف استخدم [الأداء](https://manual.misbah.pro/performance) أو [المتابعة اليومية](https://manual.misbah.pro/activities) — كلاهما شاشة حيّة تُحسب لحظة فتحها.

### أسئلة شائعة

**ما الفرق بين «تقرير شامل» و«تقرير الحضور فقط»؟**
«تقرير شامل» “يتضمن بيانات الأنشطة والخطط والحضور” ويُحسب بأوزان تختارها، و«تقرير الحضور فقط» “يتضمن بيانات الحضور فقط لجميع الطلاب المسجلين” بلا إنجاز ولا تقييم ولا أوزان. النوع يُحسم عند الإنشاء ولا يُعدَّل بعده.

**خيار «تقرير الحضور فقط» معطّل — لماذا؟**
البرنامج لا يحتوي على نظام حضور، ويقول الحوار ذلك صراحة. عرّف الحالات وفعّل النظام من [هيكلة الحضور](https://manual.misbah.pro/attendance#structure) ثم أعد المحاولة.

**لماذا نسبة الإنجاز أقل مما أتوقّع؟**
لأن الإنجاز يقسم المنجَز على المطلوب في **كامل الفترة**، فتدخل فيه أيام العمل التي لم يُسجَّل فيها شيء بمتوسط المطلوب. أيام لم يسجّلها المعلم تخفض النسبة حتى لو حضر الطالب وسمّع. راجع [المتابعة اليومية](https://manual.misbah.pro/activities) أولاً، ثم أوزان القوالب.

**ما الفرق بين «التقييم» و«الإنجاز»؟**
«التقييم» جودة: متوسط درجات المعلم للجلسات. و«الإنجاز» كمية: المنجَز مقسوماً على المطلوب. طالب يسمّع ورده كاملاً بضعف يكون إنجازه مرتفعاً وتقييمه منخفضاً، والعكس صحيح.

**هل تنطبق أوزاني على التقارير القادمة تلقائياً؟**
لا. الأوزان تُحفظ مع التقرير الذي أنشأته وحده، وتعود الحقول إلى `1` في الحوار التالي. أعِد ضبطها في كل تقرير تريد مقارنته بسابقه.

**لماذا تختلف أرقام «الأداء» عن التقرير؟**
[الأداء](https://manual.misbah.pro/performance) يحسب الفترة المختارة في شريطه العلوي بلا أوزان، والتقرير يحسب فترته الخاصة بأوزانها وتصفيتها. وحّد الفترة أولاً، وتذكّر أن التقرير وحده يحاسب على الأيام التي مرّت بلا تسجيل.

**أعددت التقرير ولم أجد الملف — أين أبحث؟**
التنزيل يبدأ تلقائياً عند اكتمال الإنشاء، فانظر في مجلد التنزيلات. وإن حجب المتصفح التنزيل، افتح بطاقة التقرير في القائمة واضغط «تحميل التقرير».

---

## الإشعارات

المصدر: https://manual.misbah.pro/notifications

رسالة واحدة تُكتب مرة، ثم تُبنى نسخة منها لكل طالب من بياناته الفعلية وتصل إلى ولي أمره عبر تطبيق مصباح أو واتساب.

الجمهور: مشرف

### رسالة واحدة، نسخة لكل طالب

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

> **ملخّص سريع**
> - ما هذا؟ معالج من ثلاث خطوات يبني رسائل مخصّصة ويرسلها عبر تطبيق مصباح أو واتساب.
> - لماذا يهمّك؟ لأن متابعة ولي الأمر هي نصف أثر الحلقة، وكتابة أربعين رسالة يدوياً مستحيلة يومياً.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة

المسار: لوحة البرنامج ← أدوات إضافية ← الإشعارات

بطاقة الأداة تصفها بـ“إدارة رسائل البرنامج والتواصل مع أولياء الأمور.”، وعنوان الصفحة “إرسال إشعار” ووصفها: “اكتب الرسالة، اختر قالباً جاهزاً عند الحاجة، ثم أرسل عبر واتساب أو تطبيق مصباح. القوالب المحفوظة خاصة بالبرنامج؛ الجاهزة متاحة دائماً دون حفظ.”

- **المتغيّر** — فراغ داخل النص على هيئة `{{اسم_الطالب}}` يُستبدل بقيمة الطالب قبل الإرسال.
  هو الفرق بين تعميم يقرؤه الناس ثم ينسونه، ورسالة تخصّ ابنهم فيقرؤونها إلى آخرها.
- **نطاق ملخص النشاط** — الفترة التي تُحسب منها متغيرات التسميع والأنشطة: هذا اليوم، أو الأسبوع، أو الشهر.
  المتغيّر نفسه يعني شيئاً مختلفاً بحسب النطاق، فهو ما يحوّل الرسالة من تقرير يومي إلى حصاد أسبوعي.
- **القالب** — نص محفوظ بمتغيراته وإعداداته النسبية، يُطبَّق في نقرة عند كل إرسال مشابه.
  الرسالة الأسبوعية تُصاغ مرة واحدة بدقة، ثم لا تُعاد صياغتها كل خميس.

> **ملاحظة:** المعالج ثلاث خطوات لا أربع: «المستلمون والقناة» ثم «تحرير الرسالة» ثم «معاينة وإرسال». المرفقات ليست خطوة مستقلة، بل زرّ داخل محرّر الرسالة.

![صفحة إرسال إشعار مع شريط الخطوات الثلاث ولوحة المستلمين](https://manual.misbah.pro/images/notifications/01-wizard.png)

### قراران قبل أن تكتب حرفاً

قبل النص نفسه يُحسَم أمران: من الجمهور الذي تخاطبه، وبأي قناة تصله. الأول يقرّر أي فلاتر تُتاح لك وأي قوالب تعمل؛ والثاني يقرّر ما يلزم من تجهيز مسبق.

#### جمهور البرنامج أم جمهور المسجد؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «طلاب برنامج» (الافتراضي) | الرسالة عن الحلقة والحضور والتسميع — أي شيء يخصّ برنامجاً بعينه. | تظهر فلاتر الحلقات والتحديد اليدوي، وتعمل القوالب المحفوظة ومتغيرات الحضور والنشاط والمحفظة كلها. | لا تصل إلى طالب غير مسجَّل في هذا البرنامج. |
| «جميع طلاب المسجد» (متقدّم) | إعلان عام للمسجد كله: موعد اختبار، أو إجازة، أو دعوة لبرنامج جديد. | يبلغ كل طالب في المسجد مهما كان برنامجه، ويكفيه البحث بالاسم أو بحقول ملف الطالب. | لا حلقات ولا تحديد يدوي ولا قوالب محفوظة، ولا متغيرات حضور ولا نشاط — لأنها بلا برنامج تُحسب منه. |

> **ملاحظة:** الوضع لا يُختار من لوحة البرنامج: فتح «الإشعارات» من داخل البرنامج يثبّت الجمهور على طلابه. اختيار الجمهور يظهر حين تفتح المعالج من [التطبيقات ← واتساب](https://manual.misbah.pro/apps#whatsapp)، تحت “اختيار الجمهور المستهدف”.

**وضع الجمهور** — قرار يسبق الفلاتر: هل مجموعة المستلمين الأصلية هي **تسجيلات** برنامج واحد، أم **طلاب** المسجد كلهم؟ الأول يفتح الحلقات والحضور والنشاط، والثاني يفتح المسجد كله ويغلق ما لا معنى له خارج برنامج.

#### تطبيق مصباح أم واتساب؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «تطبيق مصباح» (الأنسب غالباً) | أولياء الأمور مرتبطون بحساباتهم في التطبيق، والرسالة متابعة دورية لا إشعاراً عاجلاً. | “إشعار داخل التطبيق للمستفيدين المرتبطين” — مجاني، وموجّه بنوع المستفيد، ويقبل حتى عشرة مرفقات. | لا يصل إلا لمن أتمّ **الربط**؛ وتحتاج أنواع مستفيد نشطة قبل أن يُفعَّل زرّ المتابعة. |
| «واتساب» (الافتراضي) | لم يكتمل ربط أولياء الأمور بعد، أو الرسالة عاجلة وتريدها حيث ينظر الناس فعلاً. | “رسالة واتساب إلى رقم الجوال” المخزَّن في ملف الطالب — لا يحتاج المستلم أي تطبيق جديد. | يلزمه حساب واتساب مربوط وحقل جوال صحيح لكل طالب، ويقبل “مرفقاً واحداً فقط”. |

> **انتبه:** قسم واتساب في «التطبيقات» مرتبط بميزة [[واتساب]] في الباقة؛ فإن كانت خارجها ظهر: “ربط واتساب وإرسال الإشعارات غير متاح في خطتك الحالية.” وقناة التطبيق مرتبطة بميزة [[تطبيق مصباح]]. راجع [الباقات والصلاحيات](https://manual.misbah.pro/entitlements).

> **قبل أن تربط رقمك الشخصي:** تنبيه المنصة نفسها عن قناة واتساب: “هذه الخدمة ليست تابعة لواتساب ولا معتمدة منها رسمياً. احتمالية تقييد أو حظر حساب الواتساب المرتبط مرتفعة جداً.” والتوصية: “نوصي بعدم استخدام حسابك الشخصي الرئيسي، واستخدام رقم مخصص للمسجد فقط.”

### الخطوة الأولى — من يستلم، وكيف

لوحة “المستلمون” تبدأ واسعة ثم تضيّق: “افتراضياً يصل الإشعار لكل طلاب البرنامج”، والعدّاد بجوارها يعرض عدد الطلاب المطابقين لحظةً بلحظة. لا ترسل قبل أن تقرأ ذلك العدد.

#### تضييق المستلمين

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

> **رسائل التحضير في ثلاث نقرات:** إن أدرجت في الرسالة متغيّر `{{حالة_الحضور}}` أو `{{الوقت}}`، فالمستلمون لا يعودون قائمة ثابتة: يستخرجهم النظام من **سجلات الحضور** في يوم التقرير. اختر «أمس»، وصفِّ الحالة على الغياب، فتصبح الرسالة موجّهة إلى غائبي الأمس وحدهم — دون تجهيز أي قائمة يدوية.

#### تجهيز القناة

عند اختيار «تطبيق مصباح» يظهر “من يستلم في التطبيق؟” — “أنواع المستفيد الذين سيصلهم الإشعار”. أشِّر على [[أب]] وحده مثلاً، فلا تصل الرسالة إلى بقية الأنواع. وإن لم تكن هناك أنواع بعد ظهر: “لا توجد أنواع مستفيد نشطة. راجع إعدادات المسجد.”، وإن لم تؤشّر على شيء: “اختر نوعاً واحداً على الأقل”.

وعند اختيار «واتساب» تظهر مجموعة “إعدادات واتساب — الحساب وحقل رقم الجوال”: «اختر حساب واتساب» ثم «اختر حقل رقم الهاتف» من حقول [هيكلة الطالب](https://manual.misbah.pro/students#structure). زرّ الخطوة يصير «فحص والاتصال»، فيختبر الاتصال قبل أن يسمح لك بالمتابعة.

*ما يوقف الخطوة الأولى*
| ما تراه | المعنى | الحل |
| --- | --- | --- |
| “لا توجد حسابات واتساب متصلة.” غير مناسب | لا حساب مربوط بالمسجد أصلاً. | «إدارة حسابات واتساب» ثم اربط رقماً — [التطبيقات](https://manual.misbah.pro/apps#whatsapp) |
| “الحساب غير متصل. يرجى إعادة ربط الجهاز.” بتحفّظ | انقطع ارتباط الجهاز بواتساب. | أعد مسح رمز الربط من إعدادات واتساب |
| “لا توجد حقول متاحة في بنية الطالب.” غير مناسب | هيكلة الطالب بلا حقل جوال. | أضف حقل جوال في [هيكلة الطالب](https://manual.misbah.pro/students#structure) |
| “لا توجد أنواع مستفيد نشطة. راجع إعدادات المسجد.” غير مناسب | قناة التطبيق بلا أنواع مستفيد. | عرّف نوعاً من [ربط المستفيدين](https://manual.misbah.pro/consumer-app#types) |

### الخطوة الثانية — النص والمتغيرات

المحرّر صندوق نصّ عادي بميزة واحدة تغيّر كل شيء: “اكتب النص أو أرفق وسائط. اكتب `{{` لإدراج متغير.” ما إن تكتب القوسين حتى تنفتح قائمة المتغيرات المتاحة لبرنامجك — والمتاح يختلف، فبرنامج بلا نظام حضور لا يعرض متغيرات الحضور.

![محرر رسالة الإشعار وقائمة المتغيرات مفتوحة بعد كتابة قوسين](https://manual.misbah.pro/images/notifications/02-message-editor.png)

#### المتغيرات المتاحة

المتغيرات مصنَّفة كما تظهر في القائمة. تنقّل فيها بالأسهم واختر بـ`Enter`؛ والشريط السفلي يذكّرك: “↑↓ للتنقل · Enter للاختيار · Esc للإغلاق”.

*متغيرات الرسالة حسب التصنيف*
| التصنيف | المتغيرات | ما تعبّئه |
| --- | --- | --- |
| الطالب | `{{اسم_الطالب}}` · `{{الاسم_الأول}}` · `{{الاسم_المختصر}}` · `{{رابط_صفحة_الطالب}}` | الاسم بصيغه الثلاث، ورابط مباشر إلى صفحة تسجيله |
| المسجد والبرنامج | `{{اسم_المسجد}}` · `{{اسم_البرنامج}}` · `{{اسم_المجموعة}}` | السياق التنظيمي للطالب |
| الحضور | `{{حالة_الحضور}}` · `{{الوقت}}` · `{{سلسلة_الحضور}}` · `{{تاريخ_آخر_غياب}}` | حالة يوم التقرير ووقت تسجيلها، وعدد أيام الحضور المتتالية، وتاريخ آخر غياب |
| التسميع | `{{إجمالي_التسميع}}` · `{{المطلوب_للتسميع}}` · `{{إنجاز_التسميع}}` · `{{عدد_جلسات_التسميع}}` · `{{متوسط_تقييم_التسميعات}}` | المنجَز والمطلوب ونسبة الإنجاز خلال نطاق النشاط |
| الأنشطة المرنة | `{{إجمالي_كمية_الأنشطة_المرنة}}` · `{{الكمية_المطلوبة_للأنشطة_المرنة}}` · `{{إنجاز_الأنشطة_المرنة}}` · `{{متوسط_تقييم_الأنشطة_المرنة}}` | نظير متغيرات التسميع للخطط غير القرآنية |
| المحفظة | `{{رصيد_المحفظة}}` | الرصيد الحالي مع اسم الوحدة |
| التاريخ والوقت | `{{التاريخ_الميلادي}}` · `{{تاريخ_اليوم_هجري}}` | تاريخ اليوم بتوقيت الرياض، أو يوم الحضور إن حُدِّد |

> **ملاحظة:** للتسميع صيغ أدقّ حين تحتاجها: `{{إجمالي_التسميع_بالأوجه}}` و`{{إجمالي_التسميع_بالأسطر}}` و`{{المطلوب_للتسميع_بالأوجه}}`. أما `{{إجمالي_التسميع}}` فيختار الوحدة بنفسه: بالأوجه إن زاد المقدار عن خمسة عشر سطراً، وبالأسطر دون ذلك.

#### نطاق ملخص النشاط

كل متغيّر تسميع أو نشاط يسأل سؤالاً واحداً: **منذ متى؟** ما لم تُجب عنه يبقى المتغيّر أحمر في النص مع “يلزم الضبط — اضغط للاختيار”، ولا يسمح لك المعالج بالمتابعة: “اضبط نطاق النشاط عبر المتغير الأحمر في الرسالة”. اضغط المتغيّر الأحمر فتفتح لوحة “نطاق ملخص النشاط”.

*نطاقات ملخص النشاط*
| الشارة | ما تحسبه | متى تختارها |
| --- | --- | --- |
| «هذا اليوم» مناسب | “من بداية يوم التقرير حتى نهايته” | رسالة يومية بعد الحلقة مباشرة |
| «من بداية الأسبوع» مناسب | “منذ بداية الأسبوع (سبت) حتى يوم التقرير” | حصاد الخميس أو الجمعة |
| «من بداية الشهر الهجري» للعلم | “منذ غرّة الشهر الهجري حتى يوم التقرير” | برنامج يقيس بالأشهر الهجرية |
| «من بداية الشهر الميلادي» للعلم | “منذ أول الشهر الميلادي حتى يوم التقرير” | تقرير شهري لجهة تعمل بالميلادي |
| «آخر ٧ أيام» · «آخر ١٤ يوم» · «آخر ٣٠ يوم» للعلم | أيام متتالية تنتهي بيوم التقرير | متابعة متحرّكة لا ترتبط ببداية أسبوع ولا شهر |
| «مخصّص» بتحفّظ | تاريخان مطلقان لهذه الرسالة وحدها | تقرير دورة منتهية بتاريخين محدّدين |

> **لماذا «نسبي» لا «مطلق»؟:** الشارات النسبية تُحفَظ مع القالب ويُعاد حسابها عند كل إرسال: “يُحفظ نسبياً مع القالب ويُعاد حسابه عند كل إرسال.” أما التواريخ المطلقة فلا تُحفظ — “التواريخ المطلقة لا تُحفظ مع القالب.” فقالب حصاد الأسبوع المحفوظ بشارة «من بداية الأسبوع» يظلّ صحيحاً بعد سنة، وقالب محفوظ بتاريخين يشيخ في أسبوع.

إن كان النطاق يتغيّر في كل مرة فاختر «اسأل عند كل إرسال» — “لا يُحفظ نطاق — يُطلب الضبط عند كل إرسال”.

![لوحة نطاق ملخص النشاط مع شارات الأسبوع والشهر والأيام المتتالية](https://manual.misbah.pro/images/notifications/05-activity-range.png)

#### يوم التقرير

بجوار النطاق يقف “يوم التقرير” — “مرجع الحضور ونهاية نطاق ملخص الأنشطة”. اختصاراته «اليوم» و«أمس» و«أول أمس»، ومعها «اختر يوماً» لأي تاريخ آخر. تغييره يحرّك نهاية النطاق كله، لا حالة الحضور فحسب.

#### القوالب: جاهزة ومحفوظة

حوار «إدارة القوالب» يفصل بين نوعين، وهذا الفصل مقصود:

| التبويب | من كتبها | ماذا تحمل |
| --- | --- | --- |
| «محفوظة» مناسب | “قوالب أنشأها فريق البرنامج — يمكن تعديلها أو حذفها” | النص والمتغيرات **والنطاق النسبي**، وهي خاصة بهذا البرنامج |
| «جاهزة» للعلم | “قوالب افتراضية جاهزة — تطبّق النص فقط دون حفظ في البرنامج” | نصّاً فقط؛ تبدأ منه ثم تعدّله |

- الجاهزة خمسة، منها “إشعار حالة الحضور اليومي (شامل لجميع الحالات)” و“تقرير شامل لجميع المتغيرات الأساسية (مناسب لنهاية الأسبوع أو التقييم الدوري)”.
- زرّ الحفظ يقرأ «حفظ كقالب» لأول مرة، ثم «تحديث القالب» إن كنت تعدّل قالباً مطبَّقاً، ومعه «حفظ كنسخة» إن أردت الإبقاء على الأصل.
- القوالب المحفوظة لا تعمل في وضع جمهور المسجد، لأنها معلّقة على برنامج.

![حوار قوالب الرسائل بتبويبي محفوظة وجاهزة](https://manual.misbah.pro/images/notifications/04-templates.png)

وإن أردت صياغة أسرع، «بالذكاء الاصطناعي» يفتح مساراً من ثلاث نقلات: “انسخ التعليمات → الصقها في ChatGPT ونحوه مع وصفك → الصق JSON الناتج هنا.” فتُطبَّق الرسالة والفلاتر والنطاق دفعة واحدة.

### المرفقات — داخل خطوة الرسالة

المرفقات ليست خطوة رابعة في المعالج، بل زرّان في شريط أدوات المحرّر: «إرفاق» للرفع من جهازك، و«التخزين» لاختيار ملف مرفوع سابقاً في [مستودع المسجد](https://manual.misbah.pro/apps#storage).

- الأنواع المقبولة: [[صورة]] و[[فيديو]] و[[صوت]] و[[مستند]].
- حدّ الحجم واحد للجميع: “حجم الملف كبير جداً (الحد 250 ميجابايت)”.
- العدد يختلف بالقناة: “يمكنك إرفاق حتى 10 ملفات” في التطبيق، و“واتساب يدعم مرفقاً واحداً فقط”.
- «تسجيل ملاحظة صوتية» يسجّل من المتصفح مباشرة ويحتاج إذن الميكروفون، وإلا ظهر: “تعذّر الوصول إلى الميكروفون. تحقق من صلاحيات المتصفح.”

> **انتبه:** التبديل إلى واتساب بعد إرفاق عدة ملفات يُبقي الأول ويُسقط الباقي دون سؤال. اختر القناة أولاً، ثم أرفق.
> ورسالة بلا نصّ ولا مرفق لا تُرسل: “أدخل رسالة أو أرفق ملفاً”.

> **نصيحة:** الصوت أبلغ من النص في التذكير: ملاحظة صوتية من المعلّم بعشرين ثانية تُسمع كاملة، ورسالة نصية طويلة تُقرأ نصفها. والملفات الكبيرة تستهلك سعة [التخزين](https://manual.misbah.pro/apps#storage) في باقتكم، فاقتصد فيها.

### الخطوة الثالثة — اقرأها كما سيقرؤها الأب

هنا فقط ترى الرسالة بعد تعبئة المتغيرات بقيم طالب حقيقي. مجموعة “ملخص الإرسال” تقول “تحقق من العدد والقناة قبل الإرسال”، وهي ليست مجاملة: الرسالة لا تُسحب بعد خروجها.

- «معاينة حسب الطالب» تعرض نسخاً حقيقية؛ تنقّل بينها بـ«المعاينات السابقة» و«المعاينات التالية»، و«تحديث العيّنة» يجلب “عيّنة جديدة من الخادم”.
- في قناة التطبيق يفصل الملخّص ثلاثة أرقام: “طلاب في الجمهور” و“طلاب لديهم ولي مرتبط” و“مستلمون متوقعون”. الفرق بين الأول والثاني هو حجم الربط الناقص.
- زرّ الإرسال يحمل الرقم صراحة: “إرسال إلى ١٢ ولي أمر” أو “إرسال ٤٠ رسالة”.
- «السابق» يعيدك للمحرّر دون أن تفقد شيئاً من الإعداد.

> **لا تراجع بعد الإرسال:** فلتر واسع أو متغيّر خاطئ يعني رسالة خاطئة تصل إلى عشرات أولياء الأمور، ولا سبيل إلى سحبها. اقرأ معاينتين مختلفتين على الأقل، وتحقّق من العدد، ثم أرسل.

*ما يظهر بعد الضغط*
| الرسالة | المعنى |
| --- | --- |
| “نجح الإرسال” مناسب | الرسائل خرجت، ومعها عدد ما أُرسل فعلاً |
| “تحذير” بتحفّظ | نجح بعضها وفشل بعضها، مع أسماء أوّل من فشلت رسائلهم |
| “فشل إرسال الإشعارات” غير مناسب | لم يخرج شيء — راجع القناة والاتصال |
| “لا يوجد مستفيدون مرتبطون بالطلاب المحددين.” غير مناسب | قناة التطبيق بلا مستلم واحد — ابدأ من «دعوة ربط المستفيدين» |

![خطوة المعاينة مع ملخص الإرسال والرسالة بعد تعبئة المتغيرات](https://manual.misbah.pro/images/notifications/03-preview.png)

### أسئلة شائعة

**هل تصل الرسالة نفسها للجميع؟**
النص واحد، والنتيجة مختلفة: كل متغيّر يُستبدل بقيمة الطالب قبل الإرسال. استخدم «معاينة حسب الطالب» لترى الناتج الحقيقي لأكثر من طالب قبل أن ترسل.

**كيف أرسل لغائبي اليوم فقط؟**
أدرج `{{حالة_الحضور}}` في النص، ثم اضبط “يوم التقرير” على «اليوم» وصفِّ الحضور على حالة الغياب. عندئذ يستخرج النظام المستلمين من سجلات ذلك اليوم بدل الجمهور الكامل.

**المتغيّر أحمر ولا يسمح لي المعالج بالمتابعة.**
متغيرات التسميع والنشاط تحتاج نطاقاً زمنياً. اضغط المتغيّر الأحمر واختر شارة نسبية مثل «من بداية الأسبوع»، فيُعاد حسابها عند كل إرسال.

**لماذا لا تظهر متغيرات الحضور في القائمة؟**
القائمة تعرض ما يملكه برنامجك فقط: برنامج بلا نظام حضور لا يعرض متغيرات الحضور، وبرنامج بلا محفظة لا يعرض الرصيد. فعّل النظام أولاً من [هيكلة الحضور](https://manual.misbah.pro/attendance#structure) أو [المحفظة](https://manual.misbah.pro/wallet).

**ما الفرق بين قالب «جاهز» وقالب «محفوظ»؟**
الجاهز نصّ افتراضي يُطبَّق دون أن يُحفظ في البرنامج. المحفوظ من صنع فريقكم، ويحمل معه النطاق النسبي وإعدادات الإرسال، ويمكن تعديله وحذفه.

**أين أربط رقم واتساب المسجد؟**
من [التطبيقات ← واتساب](https://manual.misbah.pro/apps#whatsapp). بعد ربط الحساب يصير متاحاً في «اختر حساب واتساب» داخل المعالج. وتذكّر تنبيه المنصة: استخدم رقماً مخصّصاً للمسجد لا رقمك الشخصي.

---

## شاشة العرض

المصدر: https://manual.misbah.pro/monitor

شاشة في صدر المصلّى تقرأ ما سجّله المعلمون اليوم وتعرضه مرتّباً بالإنجاز أو بالنقاط، بألوان المسجد وخطّه.

الجمهور: مشرف

### ما الذي تراه الشاشة

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

> **ملخّص سريع**
> - ما هذا؟ عرض مباشر لنتائج البرنامج على شاشة كبيرة داخل المسجد.
> - لماذا يهمّك؟ المنافسة الظاهرة تصنع الحماس، والشاشة تحوّل السجل الإداري إلى حافز يراه الطالب وأبوه.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٠ دقائق

المسار: لوحة البرنامج ← أدوات إضافية ← شاشة العرض

بطاقة الأداة تصفها بـ“عرض مباشر لمخرجات البرنامج على الشاشات الكبيرة.”، والاستوديو يختصر المهمة في سطر: “اختر قالباً، اضبط الألوان والخط، ثم افتح العرض الحي على التلفاز.”

- **الاستوديو** — الصفحة التي تختار فيها القالب وتضبط الألوان والخط وترى معاينة حيّة.
  التجريب يجري هنا لا على شاشة المصلّى أمام الناس.
- **العرض الحيّ** — صفحة بلا قوائم ولا أزرار، تُفتح في نافذة مستقلة على جهاز الشاشة نفسه.
  التلفاز يحتاج صورة نظيفة، لا لوحة تحكّم.
- **صفّ اليوم** — سطر لكل طالب فيه اسمه وحلقته ونسبة تقدّمه وحالة حضوره ومجموع ما سمّعه.
  هو الوحدة التي تُرتَّب منها كل القوالب، فاختلافها بصريّ لا بيانيّ.

> **أي بيانات تقرأ الشاشة؟:** تقرأ الشاشة نطاق التاريخ المختار في شريط الاستوديو، وافتراضه **يوم واحد هو اليوم**. ومنه تجمع: صفوف الطلاب مرتّبة، وملخّص الحضور، وملخّص التسميع، وحركة المحفظة، وآخر الأنشطة وآخر سجلات الحضور.
> التحديث كل نصف دقيقة تقريباً، **وبشرط أن يكون اليوم المختار هو اليوم الجاري**. إن رجعت بالتاريخ إلى الأمس فالبيانات تُعرض ساكنة ولا تتجدّد.

![استوديو شاشة العرض مع شبكة القوالب والمعاينة الحيّة](https://manual.misbah.pro/images/monitor/01-studio.png)

### بالإنجاز أم بالنقاط؟

مفتاح واحد في شريط الشاشة يبدّل معنى الترتيب كلَّه على **القالب نفسه**. وهو ليس تفضيلاً بصرياً: هو إجابة عن سؤال: من المتصدّر في مسجدكم؟

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

> **كيف يُحسب كلٌّ منهما:** **تقدم** — النسبة نفسها التي تقرؤها في [الأداء](https://manual.misbah.pro/performance) عمود الإجمالي، مطبَّقة على نطاق التاريخ المختار.
> **نقاط** — **صافي** حركة وحدة النقاط الافتراضية خلال النطاق: الإضافات ناقص الخصومات مع التسويات. ليس رصيد المحفظة الكلي منذ بداية العام، بل ما كسبه الطالب في هذه الفترة.

عنوان اللوحة يتبدّل مع المفتاح فيقرأ “ترتيب الإنجاز” أو “ترتيب النقاط” — بصياغة سليمة في الحالتين. وإذا لم يكن للبرنامج وحدة نقاط افتراضية اختفى المفتاح وعاد العرض إلى التقدّم وحده.

### تسعة قوالب، ومسجدك ليس كلَّ مسجد

القوالب تسعة، تعرض البيانات ذاتها بتسع لغات بصرية. الاختيار بينها ليس ذوقاً محضاً: يحكمه بُعد الشاشة عن المصلّين وعدد الطلاب المعروضين.

*القوالب المدمجة*
| القالب | الوصف في الاستوديو | يصلح حين |
| --- | --- | --- |
| «مدار» مناسب | “داكن وحيوي — بطولة رقمية وطلاب” | القالب الافتراضي، وهو المتاح في كل باقة |
| «نور» للعلم | “هادئ ومشرق — بطاقات أداء” | قاعة مضيئة وشاشة تعكس الضوء |
| «طلاب» للعلم | “عرض كل طالب ~١٠ ثوانٍ بالتناوب” | تريد أن يرى كل طالب اسمه كبيراً ولو تأخّر دوره |
| «لوحة» للعلم | “آخر الأنشطة والحضور مباشرة” | شاشة قرب باب الحلقة يمرّ بها المعلمون |
| «أفق» للعلم | “أشرطة إنجاز — نسبة الإتمام أو صافي النقاط” | تريد المقارنة بالنِّسب لا بالأرقام |
| «نجوم» للعلم | “منصة الثلاث الأوائل ثم القائمة” | ختام أسبوع أو حفل تكريم |
| «شبكة» بتحفّظ | “بطاقات طلاب فاتحة مع الأوجه والنسبة” | شاشة قريبة وعدد طلاب متوسط |
| «شريط» بتحفّظ | “قائمة كثيفة مع مؤشرات ملوّنة” | عدد كبير من الطلاب وشاشة قريبة |
| «إيقاع» للعلم | “أوجه كبيرة + ترتيب الطلاب” | تريد إبراز كمية التسميع قبل الترتيب |

> **نصيحة:** قِس بالمسافة لا بالجمال: «شريط» و«شبكة» يعرضان طلاباً كثيرين لكنهما يحتاجان قرباً؛ و«نجوم» و«طلاب» يُقرآن من آخر القاعة.

> **تسعة قوالب… في الباقات التي تفتحها:** الباقة الأساسية تتيح قالباً واحداً هو «مدار»، وبقية البطاقات تظهر مقفلة بوسم “متاح بترقية الباقة”. ونصّ القفل صريح: “باقتك الحالية تتيح قالباً واحداً لشاشة العرض. ترقية الباقة تفتح بقية التصاميم وإنشاء قالب بالذكاء الاصطناعي.” التفاصيل في [الباقات والصلاحيات](https://manual.misbah.pro/entitlements).

أي قالب مخصّص يمكن جعله «تعيين افتراضي» للمسجد، فيُفتح تلقائياً لمن يدخل العرض الحيّ دون اختيار سابق — “يُفتح تلقائياً لمن يدخل شاشة العرض دون اختيار سابق”.

### الألوان والخط

قسم “المظهر” فيه ضبطان اثنان فقط: «الخط» و«ألوان القالب». وهما أقصر طريق إلى أن تبدو الشاشة شاشةَ المسجد لا شاشةَ منصّة.

- **الخط** — خطّان عربيان: [[إكسبو]] و[[حيّاكم]]، ومعاينتهما على كلمة “أبجد” قبل الاعتماد.
- **ألوان القالب** — لونان: «أساسي» و«ثانوي»، مع ثماني لوحات جاهزة ([[مصباح]]، [[يمني]]، [[ياقوت]]، [[فيروز]]، [[حبر]]، [[زيتون]]، [[نيلي]]، [[غابة]]) و«إعادة الافتراضي» للعودة.

> **لوحة مشتقّة من شعاركم:** إن كان لمسجدكم شعار مرفوع في [هوية المسجد](https://manual.misbah.pro/settings#mosque)، استخرج النظام منه لوحة ألوان وعرضها في المنتقي بوسم «الشعار» — “من شعار المسجد” — وطبّقها ما لم تثبّت لوحة بنفسك. رفعُ الشعار وحده يكفي لتشبه الشاشةُ المسجدَ.

> **انتبه:** ألوان الشاشة وخطّها يُحفظان **في متصفح الجهاز** لا في سجل المسجد. اضبطهما على جهاز التلفاز نفسه؛ ضبطهما على حاسوبك لا ينتقل إلى الشاشة.

![منتقي ألوان القالب والخط داخل استوديو شاشة العرض](https://manual.misbah.pro/images/monitor/02-brand.png)

### قالب من صنعكم

إن لم يناسبكم أيٌّ من التسعة، فبإمكانكم توليد قالب خاص: المنصة تسلّمكم موجّهاً مكتوباً، تعطونه لأي وكيل ذكاء اصطناعي، فيسألكم سبعة أسئلة عن المناسبة والكثافة والمزاج والحركة، ثم يخرج ملف HTML واحداً تلصقونه هنا.

1. «الإعداد» — سمِّ القالب
   “اسم يظهر في الاستوديو وعند اختيار العرض الحي.” وهنا أيضاً خيار “جعله افتراضياً للمسجد”.
2. «التوليد» — خذ الموجّه ثم الصق الناتج
   “نزّل الموجّه أو انسخه. الوكيل يسأل سبعاً ثم يولّد HTML يعمل في تقدم ونقاط. الصق المستند الكامل هنا.” والمحرّر يطمئنك بـ“يبدو مستنداً كاملاً” أو ينبّهك بـ“يتوقع مستنداً يبدأ بـ html”.
   ![خطوة التوليد في معالج القالب المخصّص مع زرّي نسخ الموجّه ولصق الناتج](https://manual.misbah.pro/images/monitor/04-custom-wizard.png)
3. «الحفظ» — راجع واحفظ
   “يُرفع الملف ويُربط بالمسجد — يمكنك تعيينه افتراضياً.”

> **انتبه:** الناتج الناقص يُرفض: “الصق مستند HTML كاملاً يبدأ بـ `<!DOCTYPE html>`”. وعلى القالب أن يعمل في وضعَي الترتيب معاً — التقدّم والنقاط — لأن المفتاح يبقى متاحاً للمشغّل.

القوالب المخصّصة تُحرَّر لاحقاً بـ«تحرير بالـ AI» وتُحذف بـ«حذف القالب» — والحذف نهائي: “لا يمكن التراجع عن هذا الإجراء.”

### تشغيل الشاشة في المصلّى

«فتح العرض الحي» يفتح نافذة بلا قوائم على جهاز الشاشة. بعد خمس ثوانٍ من السكون يختفي الشريط والمؤشّر معاً، فلا يبقى على الجدار إلا العرض.

1. سجّل الدخول على جهاز الشاشة
   العرض الحيّ **ليس رابطاً عاماً**: يفتحه حساب من حسابات المسجد. سجّل الدخول مرة على جهاز التلفاز، ويفضَّل [بمفتاح مرور](https://manual.misbah.pro/login#methods) كي لا يُطلب رمز عند كل تشغيل.
2. اضبط القالب والألوان على ذلك الجهاز
   المظهر محفوظ في متصفح الجهاز، فاضبطه حيث ستُعرض الشاشة لا على حاسوبك.
3. افتح العرض الحيّ ثم «ملء الشاشة»
   الشريط يحمل منتقي القالب ومفتاح الترتيب وزرّ التاريخ. للخروج «إنهاء ملء الشاشة»، وللعودة إلى الاستوديو «إغلاق».
4. اتركه مفتوحاً
   لا حاجة إلى تحديث الصفحة: البيانات تتجدّد وحدها ما دام اليوم المعروض هو اليوم.

> **أسماء على جدار يراه الجميع:** كل القوالب تعرض أسماء الطلاب، ولا يوجد مفتاح لإخفائها أو اختصارها. قبل تعليق الشاشة في مكان يمرّ به غير أهل الحلقة، تأكّد أن إظهار الأسماء مقبول عند أولياء الأمور، واحرص أن تكون أسماء الطلاب في [بيانات الطلاب](https://manual.misbah.pro/students) بلا أرقام تواصل ولا ملاحظات خاصة.
> وتذكّر أن الترتيب علنيّ: الطالب الأخير في القائمة يرى موضعه كما يراه الجميع. اختر «نجوم» أو «طلاب» إن أردت إبراز المتقدّمين دون فضح المتأخرين.

*رسائل تظهر على الشاشة*
| ما تراه | المعنى |
| --- | --- |
| “بانتظار البيانات…” للعلم | القالب حُمِّل ولم تصله الدفعة الأولى بعد |
| “لا يوجد طلاب لهذا اليوم.” بتحفّظ | لا سجلات في التاريخ المختار — لم يسجّل المعلمون بعد، أو التاريخ خاطئ |
| “تعذر تحميل القالب؛ عرض القالب الافتراضي.” غير مناسب | تعذّر جلب ملف القالب المخصّص، فرجع العرض إلى «مدار» |

![العرض الحي بملء الشاشة مع ترتيب الطلاب ونسب الإنجاز](https://manual.misbah.pro/images/monitor/03-live.png)

### أسئلة شائعة

**الشاشة تعرض ❝لا يوجد طلاب لهذا اليوم.❞**
لا سجلات في التاريخ المختار. تأكّد أن المعلمين سجّلوا الحضور والتسميع، أو وسّع النطاق من زرّ التاريخ في شريط الشاشة.

**البيانات لا تتحدّث وحدها.**
التحديث التلقائي يعمل فقط حين يكون اليوم المعروض هو اليوم الجاري. إن كنت ترجع بالتاريخ إلى يوم مضى فالعرض ساكن بطبيعته.

**هل أستطيع فتح الشاشة على تلفاز بلا تسجيل دخول؟**
لا. العرض الحيّ صفحة داخل حساب المسجد ولا يوجد رابط عام له. سجّل الدخول مرة واحدة على جهاز الشاشة واترك الجلسة قائمة.

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

**لماذا لا أرى خيار الترتيب بالنقاط؟**
لأن البرنامج بلا وحدة نقاط افتراضية. عرّفها من [المحفظة](https://manual.misbah.pro/wallet)، فيظهر المفتاح.

**هل لكل برنامج شاشة مختلفة؟**
نعم، القالب يُختار داخل لوحة البرنامج. ويمكن كذلك تعيين قالب مخصّص افتراضياً للمسجد، فيُفتح ما لم تختر غيره.

---

## الخطط: المفهوم والأنواع

المصدر: https://manual.misbah.pro/plans

الخطة هي ما يُنتظر من الطالب إنجازه وما يُقاس عليه. هذه الصفحة تشرح الطبقات الخمس، والفرق بين قالب الخطة وخطة الطالب، والأنواع الستة ومتى تختار كلاً منها.

الجمهور: مشرف

### ما الخطة، ولماذا يقوم عليها البرنامج

تعيش حلقة التحفيظ على سؤالين يتكرّران كل يوم: ماذا يسمّع هذا الطالب اليوم؟ وكم أنجز من مقرّره؟ الخطة هي الجواب المكتوب عن السؤالين، ومنها تُشتقّ جلسة التسميع والنقاط والتقارير.

> **ملخّص سريع**
> - ما هذا؟ الخطة مسارٌ محدَّد يلتزم به الطالب: من أين يبدأ، وكم يُنجز في الجلسة، ومتى ينتهي.
> - لماذا يهمّك؟ بغيرها يعمل المعلّم بذاكرته، ولا تجد اللوحة رقماً تقيس عليه تقدّم الطالب.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة

المسار: لوحة البرنامج ← الخطط / المناهج

قبل أي إعداد، افصل بين شيئين يتشابه اسمهما ويختلف دورهما اختلافاً كاملاً: **قالب الخطة** و**خطة الطالب**. أكثر أخطاء الإعداد شيوعاً تنشأ من الخلط بينهما.

- **قالب الخطة** — وصفة مكتوبة مرة واحدة: الاسم، أيام العمل، المقدار، الاتجاه، الحدود، وحدة النقاط، القواعد. لا يخصّ طالباً، ولا يحمل موضعاً ولا تقدّماً ولا نقاطاً.
  يُكتب مرة فيخدم أربعين طالباً، ويوحّد معايير الحلقة بدل أن يجتهد كل معلّم في ضبطها.
- **خطة الطالب** — النسخة الحيّة المرتبطة بتسجيل طالب واحد. لها موضعها الحالي، ونسبة إنجازها، وعدد أنشطتها، وتاريخ انتهائها، ورصيدها من النقاط.
  هي ما يفتحه المعلّم في التسميع، وما تقرأ منه التقارير، وما يتغيّر يوماً بعد يوم.

*قالب الخطة وخطة الطالب، وجهاً لوجه*
| الوجه | قالب الخطة | خطة الطالب |
| --- | --- | --- |
| صاحبها للعلم | البرنامج — لا طالب لها | تسجيل طالب واحد في البرنامج |
| الموضع الحالي | لا يوجد | سورة وآية، أو صفّ في الهيكل، يتحرّك بعد كل تسميع |
| الإنجاز وعدد الأنشطة | لا يوجد | يتراكمان مع كل جلسة |
| أين تراها للعلم | قسم القوالب في صفحة الخطط | جدول «إدارة الخطط» وتبويب الخطط في ملف الطالب |
| أثر التعديل مناسب | لا يمسّ الخطط القائمة ما لم تطلب ذلك صراحةً | يمسّ طالباً واحداً فقط |
| أثر الحذف غير مناسب | «حذف القالب» يُبقي الخطط، و«حذف القالب والخطط» يمحوها معه | يُفقد سجلّ تقدّم ذلك الطالب نهائياً |

**قالب الخطة** — تعريف مسارٍ واحد داخل البرنامج (حفظ، مراجعة، تثبيت، تلاوة…) بإعداداته الافتراضية وروابطه. يُنشأ من قسم القوالب في صفحة الخطط، ولا يحمل تقدّم أحد. راجع [الخطط القرآنية](https://manual.misbah.pro/quran-plans) و[الخطط المرنة](https://manual.misbah.pro/flexible-plans).

**خطة الطالب** — نسخة حيّة من قالب (أو خطة أُنشئت للطالب مباشرة) مرتبطة بتسجيله، تحمل موضعه ونسبة إنجازه وعدد أنشطته. تُدار من [متابعة خطط الطلاب](https://manual.misbah.pro/plan-progress).

> **خطة أُنشئت للطالب مباشرة:** تستطيع إضافة خطة إلى طالب واحد دون قالب، لكن الواجهة تنبّه: “إنشاء خطة مباشرة للطالب تمنع من التعديل الجماعي للخطة لاحقاً عن طريق صفحة الخطط”. اربطها بقالب إن أردت أن تشملها التعديلات الجماعية.

![صفحة بناء الخطط داخل لوحة البرنامج مع قسم القوالب](https://manual.misbah.pro/images/plans/01-plans-hub.png)

### الطبقات الخمس، من الأعلى إلى الطالب

ينحدر كل ما تراه في صفحة الخطط من سلسلة واحدة. متى استقرّت هذه السلسلة في ذهنك، صار كل زرّ في مكانه المفهوم.

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

> **ملاحظة:** لا يحمل الطالب أكثر من خطة واحدة من القالب نفسه في التسجيل الواحد. لهذا السبب لا تتضاعف الخطط عند إعادة تطبيق المنهج، وإنما تُحدَّث — راجع [المناهج](https://manual.misbah.pro/curriculum).

### المستوى الأول من الاختيار: قرآنية أم مرنة

يبدأ إنشاء أي قالب بشاشة «اختر نوع الخطة»، وفيها بطاقتان لا ثالث لهما. هذا الاختيار يقرّر بقية الإعدادات كلها، ولا سبيل إلى الرجوع عنه بعد الحفظ.

#### أي عائلة تناسب المسار الذي تبنيه؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| خطة قرآنية (الافتراضي) | المسار رحلة في المصحف: حفظ أو مراجعة أو تثبيت أو تلاوة، يُقاس بالأسطر ويُحدَّد بسورة وآية. | يتقدّم الموضع وحده بعد كل تسميع، ويحسب المحرّك المقدار المطلوب واللازم، فلا يمسك المعلّم دفتراً موازياً. | مقيّدة بترتيب المصحف؛ لا تصلح لمتنٍ ولا لسلوك ولا لمهارة. |
| خطة مرنة (متقدّم) | المسار كل ما ليس مصحفاً: متون، أحاديث، مهارات، آداب الجلسة، أو أي عدٍّ إلى هدف. | تقيس ما تشاء بوحدة نقاط من اختيارك، وتبني هيكلاً مرتّباً أو قائمة بنود تُملأ كل جلسة. | تتطلّب باقةً تفتح خاصية المحفظة، وتحتاج وحدة نقاط جاهزة قبل حفظ القالب. |

وصف البطاقتين في الواجهة: “خطة لحفظ القرآن الكريم أو مراجعة الأجزاء” للأولى، و“خطة لأي نوع من الأنشطة باستخدام وحدات النقاط” للثانية.

> **الخطط المرنة مقفلة في بعض الباقات:** إن لم تفتح باقة المسجد خاصية المحفظة، ظهرت بطاقة «خطة مرنة» بقفل ووصفٍ بديل: “متاح بترقية الباقة — المحفظة والخطط المرنة”. ورسالة القفل نفسها: “المحفظة والخطط المرنة غير متاحة في خطتك الحالية”. راجع [ما تفتحه الباقة](https://manual.misbah.pro/entitlements).

![شاشة اختيار نوع الخطة ببطاقتي خطة قرآنية وخطة مرنة](https://manual.misbah.pro/images/plans/06-type-main-selector.png)

### المستوى الثاني: النمط داخل كل عائلة

لكل عائلة ثلاثة أنماط معروضة في الواجهة، فالمجموع ستة قرارات حقيقية. النمط يقرّر من يحدّد المقدار: أنت، أم المحرّك، أم المعلّم في الجلسة.

#### أنماط الخطة القرآنية

#### متى تختار كل نمط قرآني؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حصة ذكية (الأنسب غالباً) | حين تملك هدفاً ومهلة: “ختم جزء عمّ قبل نهاية الفصل”. تحدّد أنت البداية والنهاية والتاريخ، ويوزّع المحرّك الباقي. | تعلن النتيجة لا السرعة، وتُعيد الخطة توزيع ما تبقّى تلقائياً إن تأخّر الطالب. ووصفها في الواجهة: “يتم حساب الكمية تلقائياً بناءً على الأيام المتبقية”. | تُسوّي الأيام؛ فإن كان ورد المسجد الورقي متفاوت المقادير، خالفته. ومدى طويل مع موعد قريب يُنتج مقداراً يومياً قاسياً بلا تنبيه. |
| حصة ثابتة (الافتراضي) | حين تكون قاعدة الحلقة مقداراً يومياً: نصف وجه، وجه، أربعة أوجه. | أبسط ما يعمل، وأدقّ ما يطابق الأوراد الورقية، وأكثر الأنماط ضبطاً في إعدادات القفز والتقريب. | لا تعرف نهايةً تسعى إليها؛ يبقى الطالب سائراً حتى ينتهي تاريخ الخطة. |
| حصة حرة (متقدّم) | حين لا تريد الحكم على المقدار أصلاً: تلاوة نافلة، أو أسبوعان أوّلان لطالب جديد قبل تحديد مستواه. | بلا إعداد يُذكر، ومع ذلك يتحرّك الموضع ويُسجَّل ما قُرئ وتُمنح النقاط. ووصفها: “الطالب يحدد الكمية في كل جلسة”. | لا تُنتج نسبة إنجاز البتّة، فلا تظهر في التقارير التي تقيس الإنجاز. |

#### أنماط الخطة المرنة

#### متى تختار كل نوع مرن؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حرة (الافتراضي) | حين تريد مساراً يمنح نقاطاً بلا هدف ولا ترتيب: “خطة مرنة بدون هيكل محدد”. | يسجّل المعلّم مقداراً في كل جلسة ويُترجم إلى نقاط، دون بناء أي هيكل. | لا موضع ولا صفوف؛ فلا يجيب عن سؤال “أين وصل الطالب؟”. |
| هيكل (الأنسب غالباً) | حين يكون المقرّر قائمةً مرتّبةً معروفة سلفاً: أبواب متن، أو قائمة سور، أو أحاديث مرقّمة. | يمشي الطالب في صفوف الهيكل واحداً بعد واحد، ويُحسب الهدف من الهيكل تلقائياً. والهيكل نفسه يُعاد استخدامه في كل برامج المسجد. | يلزم بناء الهيكل في «مكتبة الخطط» أولاً، وتعديله يمسّ كل برنامج يستعمله. |
| بنود (متقدّم) | حين يتكرّر التقييم نفسه كل جلسة: حضر مبكراً، أحضر المصحف، عدد الأخطاء. ووصفها: “بنود تُسجَّل في كل جلسة”. | بطاقةُ تقييمٍ واحدة تُملأ في كل حصة، لكل بند وزنه ووحدة نقاطه، وبعض البنود تخصم لا تمنح. | لا تكتمل أبداً بحكم التصميم، ومعرّفات بنودها خاصة بكل خطة، فلا تُقارن بند طالب ببند طالب آخر إحصائياً. |

> **ملاحظة:** نوعان إضافيان — [[خطة رقمية]] و[[نطاق منظم]] — موجودان في النظام ولا تعرضهما شاشة الاختيار. غير أنّك تصل إلى [[نطاق منظم]] من الباب الخلفي: اختر «هيكل» ثم اختر هيكلاً من نوع [[نطاق رقمي]]، فيتحوّل القالب إليه من تلقاء نفسه.

![قائمة قوالب الخطط مع تبويبات الكل وخطط القرآن والخطط المرنة](https://manual.misbah.pro/images/plans/02-templates.png)

### ما معنى أن تكتمل الخطة

كلمة “الإنجاز” لا تعني الشيء نفسه في كل نوع، والفرق ليس تفصيلاً تجميلياً: رقمان متشابهان في لوحتين قد يُحسبان بقاعدتين مختلفتين.

> **الحصة الثابتة تُقاس بالتقويم لا بالمصحف:** `الإنجاز = (عدد الجلسات المسجَّلة + ١) ÷ عدد أيام العمل بين إنشاء الخطة وتاريخ انتهائها × ١٠٠`
> أي أنّ الخطة الثابتة تبلغ المئة حين يستوفي الطالب حصص التقويم، لا حين يبلغ آخر المصحف.

> **الحصة الذكية تُقاس بالمسافة:** `الإنجاز = ١٠٠ − (الأسطر المتبقية ÷ أسطر المدى كاملاً) × ١٠٠`
> وهي وحدها التي يعني إنجازها “كم بقي من المادة”.

> **الخطط المرنة تُقاس بالهدف:** `الإنجاز = المقدار المتراكم ÷ المقدار المستهدف`، وسقفه واحد صحيح.
> وفي خطط الهيكل يُحسب المقدار المستهدف تلقائياً: مجموع نقاط صفوف الجدول، أو `(نهاية النطاق − بدايته) ÷ الزيادة` في النطاق الرقمي.

*متى تُعدّ الخطة مكتملة*
| النمط | معنى الإنجاز | متى تكتمل |
| --- | --- | --- |
| حصة ذكية مناسب | نسبة ما أُنجز من المدى | ببلوغ آية النهاية |
| حصة ثابتة بتحفّظ | نسبة أيام العمل المستهلَكة | باستنفاد التقويم، أو ببلوغ طرف المصحف في بطاقة الخطة |
| حصة حرة للعلم | صفر دائماً | لا تكتمل إلا بإنهاء يدوي |
| حرة وهيكل مرنان مناسب | المتراكم ÷ المستهدف | ببلوغ المقدار المستهدف |
| بنود | لا يوجد | لا تكتمل أبداً بحكم التصميم |

> **عدّادان مختلفان في الحصة الثابتة:** تحسب نسبة الإنجاز أيامَ التقويم، بينما تَعدّ بطاقةُ الخطة الخطةَ [[مكتملة]] حين يبلغ الموضع الناس ٦ نزولاً أو الفاتحة ٧ صعوداً. فإن سجّل الطالب جلسات أكثر مما أتاحه التقويم، تجاوزت النسبة المئة وهي ما تزال في وسط المصحف.

وحالات بطاقة الخطة في ملف الطالب: [[نشطة]] و[[قريبة الانتهاء]] و[[متأخرة]] و[[مكتملة]]، وتنتقل الخطة إلى تبويب «منتهية» بعد تجاوز تاريخ انتهائها.

### قيود لا تتغيّر، وأذونات تفتحها الباقة

قراران في هذه الصفحة لا رجعة فيهما، وبابان لا يفتحهما إلا اشتراك المسجد. اعرفهما قبل أن تبني عشرة قوالب.

> **نوع الخطة لا يتغيّر بعد الإنشاء:** تقول الواجهة صراحةً: “نوع الخطة محدد مسبقاً ولا يمكن تغييره عند التعديل”، و“ملاحظة: لا يمكن تغيير نوع الخطة بعد الإنشاء”. إن أخطأت النمط، أنشئ قالباً جديداً وانقل الطلاب إليه؛ ولا سبيل إلى تحويل قالب ثابت إلى ذكي.

> **نوع الهيكل كذلك:** في «مكتبة الخطط»: “ملاحظة: لا يمكن تغيير نوع الهيكل بعد الإنشاء” — فالجدول يبقى جدولاً والنطاق الرقمي يبقى نطاقاً.

*ما تفتحه الباقة في نطاق الخطط*
| الخاصية | ما تفتحه | نصّ القفل |
| --- | --- | --- |
| المحفظة والخطط المرنة بتحفّظ | بطاقة «خطة مرنة» ووحدات النقاط التي تقوم عليها | “المحفظة والخطط المرنة غير متاحة في خطتك الحالية” |
| المناهج بتحفّظ | إنشاء المناهج وتعديلها وتطبيقها على التسجيلات | “إنشاء وتعديل المناهج غير متاح في خطتك الحالية” |

القوالب القرآنية وحدها تعمل في كل الباقات. راجع [ما تفتحه الباقة](https://manual.misbah.pro/entitlements) لمعرفة باقتك الحالية.

### مصطلحات تتكرّر في بقية الأدلة

هذه الكلمات تعود في كل صفحة من صفحات الخطط، وتحيل إليها الأدلة الأخرى مباشرة.

**الموضع الحالي** — النقطة التي بلغها الطالب داخل خطته: سورة وآية في الخطط القرآنية، وصفٌّ من الهيكل في الخطط المرنة التدريجية. يحرّكه التسميع، ويصحّحه [جدول متابعة الخطط](https://manual.misbah.pro/plan-progress).

**المنهج** — اختيار مرتّب من قوالب الخطط مع تجاوزات لكل مستوى، يُطبَّق على تسجيلات الطلاب دفعةً واحدة. راجع [المناهج الدراسية](https://manual.misbah.pro/curriculum).

**وحدة النقاط** — عملة داخل البرنامج لها اسم وأيقونة ومعامل تحويل. كل خطة مرنة تدفع إلى وحدة، والخطة التي لا وحدة لها لا تمنح شيئاً. راجع [المحفظة والنقاط](https://manual.misbah.pro/wallet).

**هيكل الخطة** — جدول صفوف أو نطاق رقمي يملكه المسجد ويُعاد استخدامه عبر برامجه، يمشي فيه الطالب صفاً بعد صف. يُبنى في «مكتبة الخطط» — راجع [الخطط المرنة](https://manual.misbah.pro/flexible-plans).

**سلوك الربط** — قاعدة تنقل أثر التغيّر من خطة إلى أخرى للطالب نفسه، مثل أن يدفع تقدّم الحفظ حدَّ المراجعة. راجع [سلوكيات الربط](https://manual.misbah.pro/link-behaviors).

**القواعد** — قائمة مخالفات وإجادات لكل منها قيمة، يختارها المعلّم أثناء التسميع فتُعدّل درجة التقييم. راجع [الخطط القرآنية](https://manual.misbah.pro/quran-plans).

### أسئلة شائعة

**ما الفرق عملياً بين تعديل القالب وتعديل خطة طالب؟**
تعديل القالب يغيّر الوصفة التي تُبنى منها الخطط الجديدة، ولا يمسّ الخطط القائمة ما لم تختر «تعديل القالب والخطط» أو يكن القالب داخل منهج فتُزامَن خططه. أما تعديل خطة طالب فيقتصر أثره على ذلك الطالب وحده.

**أخطأت في اختيار النمط — هل أغيّره؟**
لا. النمط ونوع الخطة يُثبتان عند الإنشاء. أنشئ قالباً جديداً بالنمط الصحيح، طبّقه على الطلاب، ثم احذف القالب القديم أو أوقفه بتاريخ انتهاء.

**لماذا تجاوزت نسبة الإنجاز مئة بالمئة؟**
لأنّ الخطة ثابتة، ونسبتها تُقاس بأيام العمل لا بالمصحف. فإذا سجّل المعلّم جلسات أكثر مما أتاحه التقويم، تجاوز البسطُ المقام. راجع قسم معنى الاكتمال.

**لماذا تظهر بطاقة «خطة مرنة» مقفلة؟**
لأنّ باقة المسجد لا تفتح خاصية المحفظة، والخطط المرنة تقوم على وحدات النقاط. راجع [ما تفتحه الباقة](https://manual.misbah.pro/entitlements).

**لماذا تغيّر عنوان الصفحة من «بناء الخطط» إلى «المناهج الدراسية»؟**
يتبدّل العنوان بمجرّد إنشاء أول منهج، لأنّ المناهج تصير نقطة الدخول الطبيعية وتتقدّم في ترتيب الصفحة. راجع [المناهج الدراسية](https://manual.misbah.pro/curriculum).

---

## الخطط القرآنية

المصدر: https://manual.misbah.pro/quran-plans

الأنماط الثلاثة للخطة القرآنية — ذكية وثابتة وحرة — ثم كل إعداد في القالب: ماذا يفعل، ومتى تغيّره، وما الذي ينكسر إن أخطأته.

الجمهور: مشرف

### الخطة القرآنية: رحلة في المصحف تُقاس بالأسطر

يقيس المصحف في مصباح بالأسطر لا بالصفحات: الوجه خمسة عشر سطراً، ونصف الوجه سبعة ونصف. كل ما تضبطه في القالب — المقدار والإزاحة والحزمة — يُترجَم إلى أسطر قبل أن يلمس آيةً واحدة.

> **ملخّص سريع**
> - ما هذا؟ قالب الخطة القرآنية يصف رحلةً في المصحف: من أين تبدأ، وبأي اتجاه تمضي، وكم تقطع في الجلسة، وأين تقف.
> - لماذا يهمّك؟ بضبطه مرةً يعرف كل معلّم ماذا يسمّع، ويتحرّك موضع الطالب وحده بعد كل جلسة.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٢٠ دقيقة

المسار: لوحة البرنامج ← الخطط ← إنشاء قالب خطة ← خطة قرآنية

- **موضع البداية** — السورة والآية اللتان تنطلق منهما الخطة. مرساةٌ ثابتة لا مؤشّر متحرّك.
  تصحيح موضع طالب لا يغيّر بدايته، ولهذا يستطيع النظام أن يعرف متى عاد إلى نقطة الصفر.
- **الموضع الحالي** — الآية التالية التي ينتظرها المعلّم من الطالب. يتقدّم تلقائياً بعد تسجيل التسميع.
  هو ما يفتح عليه المعلّم جلسة التسميع، ولا يُصحَّح إلا من جدول متابعة الخطط.
- **حدود التنقل** — ممرٌّ لا يخرج عنه الموضع: حدٌّ أعلى وحدٌّ أدنى، أو نطاق مستثنى يمرّ الطالب حوله.
  بها تحصر المراجعة فيما حفظه الطالب فعلاً، فلا تسبق مراجعتُه حفظَه.
- **المقدار المطلوب** — ما تطلبه الخطة في الجلسة الواحدة: رقم تكتبه أنت في الحصة الثابتة، ويحسبه المحرّك في الذكية.
  نسبة ما أنجزه الطالب إلى ما طُلب منه هي نصف معادلة النقاط.

> **ملاحظة:** لا يكتب المعلّم مقداراً ولا مطلوباً في التسميع؛ يحدّد المدى الذي قرأه فحسب، ويحسب النظام الرقمين من عدد أسطر المدى. راجع [الحلقات والتسميع](https://manual.misbah.pro/teaching).

### من يحدّد المقدار: أنت، أم المحرّك، أم المعلّم

هذا هو السؤال الوحيد الذي تفصل فيه أنماط الخطة القرآنية الثلاثة، وعليه يترتّب كل إعداد بعده.

#### متى تختار كل نمط؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حصة ذكية (الأنسب غالباً) | تعرف نقطة النهاية والموعد: ختمة، أو إنهاء جزء قبل رمضان، أو مراجعة مدى محدّد قبل الاختبار. | تكتب البداية والنهاية والتاريخ فقط، ويوزّع المحرّك المسافة على الأيام المتبقية، ويعيد التوزيع كلما تأخّر الطالب. | تُسوّي المقادير، فتخالف الأوراد الورقية المتفاوتة. ومدىً طويل بموعد قريب يُنتج حصةً يومية قاسية بلا إنذار. |
| حصة ثابتة (الافتراضي) | قاعدة الحلقة مقدار يومي معلوم: نصف وجه، وجه، أربعة أوجه. | تطابق الأوراد الورقية مطابقةً دقيقة متى ضُبط المقدار وسياسة التقريب، وهي وحدها التي تفتح «إعدادات القفز». | لا نهاية تسعى إليها؛ يمضي الطالب حتى ينتهي تاريخ الخطة أو يبلغ طرف المصحف. |
| حصة حرة (متقدّم) | لا تريد الحكم على المقدار: تلاوة نافلة، أو مرحلة مؤقّتة حتى يتبيّن مستوى الطالب. | بلا إعداد يُذكر؛ يتحرّك الموضع، ويُسجَّل ما قُرئ، وتُمنح النقاط على التقييم. | لا تُنتج نسبة إنجاز، ولا تكتمل إلا بإنهاء يدوي، ونقاطها تعتمد على التقييم وحده. |

> **كيف تُحسب نقاط جلسة التسميع:** `النقاط = (٠٫٥ × المقدار ÷ المطلوب + ٠٫٥ × التقييم المعياري) × النقاط الممنوحة`
> جلسةٌ تامّة المقدار تامّة التقييم تساوي نقطةً واحدة قبل ضربها في «النقاط الممنوحة». وفي الحصة الحرة يساوي المطلوبُ المقدارَ دائماً، فلا يبقى إلا التقييم.

> **تحذير:** نمط الخطة يُثبَّت عند الإنشاء: “نوع الخطة محدد مسبقاً ولا يمكن تغييره عند التعديل”. راجع [الخطط: المفهوم والأنواع](https://manual.misbah.pro/plans#limits).

![اختيار نمط الخطة القرآنية بين حصة ذكية وحصة ثابتة وحصة حرة](https://manual.misbah.pro/images/quran-plans/01-mode-selector.png)

### إنشاء قالب قرآني خطوة بخطوة

المثال التالي يبني قالب حفظ للمبتدئين في برنامج [[برنامج الحفظ — الفصل الدراسي الأول ١٤٤٨هـ]]: نصف وجه يومياً من الناس صعوداً.

1. افتح صفحة الخطط واضغط «إنشاء قالب»
   يظهر الزر في رأس قسم القوالب. وإن كان البرنامج خالياً من القوالب، فالزر البديل «إنشاء أول قالب».
2. اختر «خطة قرآنية» ثم النمط
   للمثال: «حصة ثابتة»، لأنّ قاعدة الحلقة مقدار يومي معلوم.
3. اكتب اسم الخطة
   تقترح الواجهة أربعة أسماء جاهزة: «حفظ» و«مراجعة» و«تثبيت» و«تلاوة»، أو اكتب اسماً خاصاً.
   الاسم ليس زينة: هو ما يراه المعلّم في قائمة خطط الطالب، وما تُعنون به أعمدة جدول المتابعة.
4. اضبط «اتجاه الحفظ» وموضع البداية
   للمثال: «الناس»، وموضع البداية الناس ١.
   ![اختيار اتجاه الحفظ بين الفاتحة والناس](https://manual.misbah.pro/images/quran-plans/02-direction.png)
5. حدّد «المقدار اليومي» و«أيام العمل»
   للمثال: نصف وجه، وخمسة أيام من الأحد إلى الخميس.
   ![حقل المقدار اليومي بوحدة الوجه إلى جانب منتقي أيام العمل](https://manual.misbah.pro/images/quran-plans/03-amount-weekdays.png)
6. راجع الإعدادات المتقدّمة عند الحاجة
   «سياسة التقريب» و«إعدادات التنقل» و«إعدادات القفز» و«القواعد» — مشروحة في القسم التالي. الافتراضات تعمل، والتعديل لغرض.
7. اضغط «حفظ القالب»
   لا يُنشئ الحفظ خطةً لأحد. القالب وصفة حتى تطبّقه — إمّا داخل [منهج](https://manual.misbah.pro/curriculum) أو بإضافته إلى الطلاب من [متابعة خطط الطلاب](https://manual.misbah.pro/plan-progress).

![نافذة إنشاء قالب خطة قرآنية بأقسامها الكاملة](https://manual.misbah.pro/images/plans/03-template-editor.png)

> **نصيحة:** لنقل قوالب برنامج سابق بدل إعادة بنائها، استخدم «استيراد قوالب» من قائمة «المزيد»: “استيراد قوالب من برامج أخرى”.

### كل إعداد: ماذا يفعل، ومتى تغيّره

الإعدادات مرتّبة هنا بترتيب أثرها: ما يمسّ كل جلسة أولاً، ثم ما يمسّ حالات بعينها.

#### اتجاه الحفظ

خياران: «الفاتحة» “من الفاتحة نزولاً إلى الناس”، و«الناس» “من الناس صعوداً إلى الفاتحة”. يظهر الاتجاه في بطاقة القالب أيضاً بصيغة “من الناس إلى الفاتحة”.

> **الصعود يعكس السور لا الآيات:** الاتجاه الصاعد لا يقرأ المصحف من آخره آيةً آية. يقرأ السورة من أولها إلى آخرها، ثم ينتقل إلى السورة التي قبلها. فالمسار الفعلي: النبأ ٣٨ ← ٣٩ ← ٤٠ ← المرسلات ١ ← ٢…
> ومن أراد “الرجوع بالأجزاء” — جزء ٣٠ كاملاً ثم جزء ٢٩ — لا يعبّر عنه الاتجاه وحده؛ يحتاج اتجاهاً نازلاً مع حدود تنقل مثبّتة على الجزء و[سلوك ربط](https://manual.misbah.pro/link-behaviors) يحرّك الحزمة.

#### أيام العمل

“حدد الأيام المطلوبة لهذه الخطة. سيتم توزيع الخطة على هذه الأيام فقط”. أيام العمل ليست تزييناً للجدول: منها يُحسب عدد الأيام النشطة في «تاريخ الانتهاء»، وعليها يقوم مقام نسبة الإنجاز في الحصة الثابتة. إسقاط يوم يرفع النسبة اليومية لا العكس.

#### المقدار اليومي

يظهر في الحصة الثابتة وحدها. تكتب رقماً وتختار وحدة القياس: [[سطر]] أو [[وجه]]، والوجه خمسة عشر سطراً. والقيم السريعة: نصف وجه، وجه، وجه ونصف، وجهان، ثلاثة أوجه، أربعة أوجه، ثمانية أوجه.

> **انتبه:** المقدار يُخزَّن بالأسطر، بينما تعدّ أكثر الأوراد الورقية بالأوجه والصفحات. وتقدير “الوجه = ١٥ سطراً” يعيد إنتاج نحو ٩٧٪ من أيام الورد الورقي؛ والباقي فرقُ وحدةٍ لا يعالجه أي ضبط.

#### الحد الأقصى للأنشطة في اليوم

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

#### سياسة التقريب

“بعد حساب مقدار الحصة بالأسطر، قد يُقرَّب موضع النهاية إلى أقرب سورة أو صفحة إن كان الفرق بسيطًا.” وأوضح منه: “المحرك يصل لآية تقريبية بالأسطر، ثم قد يقرّبها لنهاية صفحة أو سورة.”

*أي سياسة تناسب وحدة العدّ عندك*
| الخيار | ما يفعله | متى تختاره |
| --- | --- | --- |
| «السلوك الافتراضي» للعلم | “نفس تقريب النظام الحالي: نهاية السورة ثم الصفحة عند الحاجة.” | ابدأ به ما لم يكن عندك ورد ورقي تطابقه |
| «دقيق — بدون تقريب» مناسب | “يتوقف عند الموضع المحسوب بالأسطر كما هو، بلا تقريب.” | المسجد يعدّ بالآيات، أو الخطة تتبع جدولاً يحتاج موضعاً مطابقاً للمقدار تماماً |
| «أقرب نهاية صفحة» مناسب | “إن كان الفرق بسيطًا، أوقف عند آخر آية في الصفحة.” | المسجد يعدّ بالأوجه والصفحات — وهي الحالة الأشيع |
| «أقرب نهاية سورة» للعلم | “إن كان الفرق بسيطًا، أوقف عند آخر آية في السورة.” | حلقات صغار السنّ في قصار السور |
| «سورة ثم صفحة» و«صفحة ثم سورة» | يجرّب أحد الطرفين أولاً ثم الآخر. | حين تريد ترتيباً صريحاً بدل السلوك الافتراضي |
| «التقريب الكلاسيكي» | “نفس الافتراضي، محفوظ صراحةً على الخطة.” | حين تريد تثبيت السلوك على الخطة كي لا يتبدّل بتبدّل الافتراضات |

> **اختيار السياسة الخطأ يفسد كل يوم:** قياسٌ على ورد ورقي يعدّ بالصفحات أعطى: «أقرب نهاية صفحة» يوماً واحداً مخالفاً من ٦٠٣، و«التقريب الكلاسيكي» ستة عشر يوماً، و«دقيق — بدون تقريب» **٦٠٣ من ٦٠٣**. فالسياسة تتبع وحدة العدّ عند المسجد، لا الذوق.

وتحت «خيارات ترتيب إضافية» يقع «ضبط حدود التقريب»: “اختياري — متى يُسمح بالتقريب وما أقصى فرق مقبول”. فيه «أقصى فرق أسطر» — “لا تُقرَّب النهاية إن تجاوز الفرق هذا العدد من الأسطر” — و“أقصى نسبة من مقدار الحصة (%)”، ومعناها “مثال: 20 تعني ألا يتجاوز فرق التقريب خُمس مقدار الحصة”، إضافة إلى “التقريب عند تجاوز الآية”.

![قسم سياسة التقريب بخياراته الستة وضبط حدود التقريب](https://manual.misbah.pro/images/quran-plans/06-advance-settings.png)

#### إعدادات التنقل

هنا تحصر الخطة في ممرٍّ من المصحف. “تسمح هذه الإعدادات بتخصيص سلوك التنقل في القرآن”، وفيها ثلاثة مفاتيح.

- **تجاهل رؤوس السور** — “استثناء رأس السورة (الاسم والبسملة) من حساب الأسطر”. مفعّل يعني “رؤوس السور غير محسوبة”، ومعطّل يعني “رؤوس السور محسوبة”. فعّله إن كان ورد المسجد يعدّ أسطر الآيات وحدها.
- **عدد التكرارات** — “عدد المرات التي سيتم فيها تكرار النطاق المحدد بعد إكماله” — “0 = بدون تكرار، 1+ = عدد مرات التكرار”. يفيد في التثبيت على جزء قبل الانتقال منه.
- **تحديد نطاق التنقل** — مفعّل يعني “التنقل مقيد بالنطاق المحدد”، ومعطّل يعني “التنقل في القرآن كاملاً”. وله وضعان: «نطاق محدد» — “حدّد من وإلى للتنقل ضمن النطاق فقط” — و«وضع الاستثناء» — “حدّد من وإلى للجزء المستثنى؛ التنقل في كامل القرآن ما عدا هذا النطاق”. والحدود نفسها مشمولة في الحالتين.

> **انتبه:** موضع البداية والنهاية والموضع الحالي كلها ملزَمة بالممرّ. فإن ضيّقت الحدود على خطةٍ موضعُها خارجها، رفض النموذج الحفظ ونبّهك إلى “موضع البداية … يقع خارج النطاق المحدد” وطلب تعديل الموضع أو حذف الحدود.

![إعدادات التنقل المتقدمة مع تحديد نطاق ومعاينة المرور](https://manual.misbah.pro/images/quran-plans/05-navigation-settings.png)

#### إعدادات القفز

خاصٌّ بالحصة الثابتة، ويجيب عن سؤال: “حدد طريقة القفز بعد إكمال الحصة اليومية”.

*خياران لا ثالث لهما*
| الخيار | ماذا يحدث غداً | متى تستعمله |
| --- | --- | --- |
| «بناءً على آخر تقدم» مناسب | “سيتم البدء من آخر موضع توقف عند الطالب في الحصة السابقة” — الموضع يمضي إلى الأمام. | الحفظ المتتابع، وهو الوضع الطبيعي |
| «تثبيت الموضع» بتحفّظ | يعود الطالب إلى بداية المدى نفسه في كل جلسة، فلا يتحرّك الموضع بعد التسميع. | التثبيت على مقطع بعينه حتى يُتقنه الطالب، أو مسار يحرّكه [سلوك ربط](https://manual.misbah.pro/link-behaviors) لا التسميع |

وتحت «قفز مقدار محدد» يظهر حقل «مقدار القفز»: “سيتم قفز مقدار ثابت من الأسطر/الصفحات بعد الانتهاء من الحصة. اختر صفر لتثبيت الموضع دون قفز.” والمهمّ: “المقدار المتخطى لا يُحتسب ضمن إنجاز الطالب”.

![إعدادات القفز بين الاستكمال من آخر موضع وقفز مقدار محدد](https://manual.misbah.pro/images/quran-plans/04-jump-settings.png)

#### القواعد

«القواعد» قائمةٌ من المخالفات والإجادات، لكل واحدة اسم وقيمة. يفتحها المعلّم أثناء التسميع فيعدّ ما وقع، فتتحرّك درجة التقييم أمامه لحظةً بلحظة: “الدرجة الكلية” ثم “مجموع الخصم” و“مجموع النقاط الإيجابية” ثم “الدرجة النهائية”.

> **أثر القواعد على التقييم:** `التقييم = ١٠٠ − (مجموع الخصومات − مجموع النقاط الإيجابية)`
> والتقييم نصف معادلة النقاط، فالقواعد تمسّ رصيد الطالب فعلاً لا عرضاً. وتُحفظ تفاصيل ما وقع مع النشاط، فتظهر في بطاقة النشاط لاحقاً.

*النماذج السريعة الجاهزة في «إضافة سريعة»*
| المجموعة | البنود وقيمها |
| --- | --- |
| «الخصومات» غير مناسب | خطأ ٥، نسيان ٣، شك ٢٫٥، لحن جلي ١٫٥، تردد ١، لحن خفي ٠٫٥ |
| «النقاط الإيجابية» مناسب | تجويد ممتاز ٥، حسن الصوت ٣، إتقان المخارج ٢٫٥، تحسين ملحوظ ٢، حفظ متقن ١٫٥، مشاركة فعالة ١ |

> **نصيحة:** ابدأ بخمس قواعد لا بخمس عشرة. القائمة الطويلة تُبطئ المعلّم في الحلقة، وتُنتج تقييمات متباينة بين معلّم وآخر.

![قسم القواعد بالنماذج السريعة للخصومات والنقاط الإيجابية](https://manual.misbah.pro/images/quran-plans/07-constitutions.png)

#### تاريخ الانتهاء

“حدد تاريخ انتهاء الخطة، أو اختر تاريخ نهاية البرنامج مباشرة”. وإن تركته فارغاً ورثت الخطة نهاية البرنامج: تعرض الواجهة “مع نهاية البرنامج” و“تنتهي الخطة مع نهاية البرنامج”. ويعرض القسم “عدد الأيام النشطة” محسوبةً من أيام العمل، وتستطيع أن تكتب عدد الأيام فيُشتقّ منه التاريخ: “سيتم حساب تاريخ الانتهاء بناءً على عدد الأيام النشطة المحددة”.

> **انتبه:** بعد التاريخ لا تقبل الخطة نشاطاً جديداً، ويرفض النظام التسجيل برسالة “لقد انتهت هذه الخطة بالفعل”. وتنتقل الخطة إلى تبويب «منتهية» في ملف الطالب، ويبقى سجلّها كما هو.

![قسم تاريخ الانتهاء مع خيار نهاية البرنامج وعدد الأيام النشطة](https://manual.misbah.pro/images/quran-plans/08-end-date.png)

#### وحدة النقاط والنقاط الممنوحة

«وحدة النقاط» هي “وحدة النقاط المخصصة لمكافأة الأنشطة في هذه الخطة”، و«النقاط الممنوحة» معاملٌ يُضرب في ناتج المعادلة لكل “تسميع كامل”. وتترك الحقل على “بدون وحدة نقاط” إن لم ترد لهذه الخطة أثراً في المحفظة.

> **ملاحظة:** الخطة القرآنية تعمل بلا وحدة نقاط، لكنّها حينئذ لا تمنح شيئاً. راجع [المحفظة والنقاط](https://manual.misbah.pro/wallet).

### أسئلة شائعة

**غيّرت المقدار اليومي في القالب — هل تتغيّر خطط الطلاب؟**
لا يتغيّر شيء بمجرّد الحفظ. إن أردت سريان التغيير على القائمين فاستخدم «تعديل القالب والخطط»، وإن كان القالب داخل منهج فحفظ المنهج يزامن خططه المرتبطة. راجع [المناهج الدراسية](https://manual.misbah.pro/curriculum).

**لماذا لا يظهر «المقدار اليومي» في قالبي؟**
لأنّ النمط ليس «حصة ثابتة». في «حصة ذكية» يحسب المحرّك المقدار من المسافة الباقية وعدد الأيام، وفي «حصة حرة» يحدّده المعلّم في كل جلسة.

**أريد المراجعة ألا تتجاوز ما حفظه الطالب — كيف؟**
لا تضبط ذلك يدوياً في كل خطة. اربط قالب المراجعة بقالب الحفظ بسلوك يجعل حدّ المراجعة يتبع موضع الحفظ. راجع [سلوكيات الربط](https://manual.misbah.pro/link-behaviors).

**المعلّم يقول إنّ النظام رفض تسجيل التسميع — ما السبب؟**
ثلاثة أسباب مرتّبة بالاحتمال: انتهاء تاريخ الخطة، أو بلوغ “الحد الأقصى للأنشطة في اليوم”، أو خروج المدى المقروء عن حدود التنقل.

**الورد الورقي عندنا يطابق أيامه تماماً — أي إعداد أضبط؟**
«حصة ثابتة» بمقدار موافق للورد، مع «سياسة التقريب» المطابقة لوحدة العدّ: «أقرب نهاية صفحة» لمن يعدّ بالأوجه، و«دقيق — بدون تقريب» لمن يعدّ بالآيات.

---

## الخطط المرنة

المصدر: https://manual.misbah.pro/flexible-plans

كل ما ليس مصحفاً: متون وأحاديث ومهارات وآداب الجلسة. الأنواع الثلاثة — حرة وهيكل وبنود — ومكتبة الهياكل ووحدات النقاط التي تقوم عليها.

الجمهور: مشرف

### الخطة المرنة: قياسٌ بوحدة تختارها أنت

لا يقتصر عمل الحلقة على المصحف. المتون تُحفظ، والأحاديث تُعدّ، وآداب الجلسة تُقوَّم. الخطة المرنة هي الوعاء الذي يقيس هذا كلّه بوحدة نقاط يسمّيها المسجد بنفسه.

> **ملخّص سريع**
> - ما هذا؟ خطةٌ لا ترتبط بالمصحف، تُسجَّل عليها أنشطة بمقدارٍ يُترجَم إلى نقاط في محفظة الطالب.
> - لماذا يهمّك؟ لأنّ نصف ما يُقاس في الحلقة ليس آياتٍ: متن، سلوك، حضور مبكر، عدد أخطاء.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٢٠ دقيقة

المسار: لوحة البرنامج ← الخطط ← إنشاء قالب ← خطة مرنة

- **وحدة النقاط** — عملة البرنامج: اسم وأيقونة ومعامل تحويل. كل خطة مرنة تدفع إلى وحدة واحدة.
  بلا وحدة لا تصلح الخطة المرنة أصلاً — النموذج يرفض الحفظ ويطلب منك إنشاء وحدة أولاً.
- **هيكل الخطة** — جدول صفوف مرتّب أو نطاق رقمي، يملكه المسجد ويُعاد استعماله في كل برامجه.
  المتن يُكتب مرة واحدة على مستوى المسجد، ثم يستعمله كل برنامج بلا إعادة بناء.
- **البند** — سطر في بطاقة تقييم تُملأ كل جلسة: له اسم وحدّ أدنى وحدّ أقصى وقيمة قد تكون سالبة.
  يحوّل الملاحظات المتناثرة عن الأدب والانضباط إلى رقم يدخل المحفظة.
- **التتبع التدريجي** — مؤشّرٌ يتذكّر آخر صفٍّ أنجزه الطالب في الهيكل، فيبدأ من بعده في الجلسة التالية.
  هو ما يجعل خطة المتن تجيب عن سؤال “أين وصل الطالب؟” لا عن “كم جمع؟” فقط.

> **انتبه:** الخطط المرنة مرتبطة بخاصية المحفظة في الباقة. إن كانت مقفلة ظهرت بطاقة «خطة مرنة» بقفل، ورسالتها: “المحفظة والخطط المرنة غير متاحة في خطتك الحالية”. راجع [ما تفتحه الباقة](https://manual.misbah.pro/entitlements).

### أي نوع مرن تختار

بعد اختيار «خطة مرنة» يظهر عنوان «نوع الخطة المرنة» وتحته ثلاث بطاقات. الفرق بينها ليس في الشكل بل في السؤال الذي تجيب عنه الخطة.

#### متى تختار كل نوع؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| حرة (الافتراضي) | تريد تسجيل مقدارٍ ومكافأته دون ترتيبٍ ولا هدف: “خطة مرنة بدون هيكل محدد”. | أسرع ما يُنشأ: وحدة نقاط واسم وأيام عمل، ثم يسجّل المعلّم مقداراً في كل جلسة. | لا موضع ولا صفوف، فلا تعرف أين بلغ الطالب ولا ما بقي عليه. |
| هيكل (الأنسب غالباً) | المقرّر قائمة مرتّبة معروفة سلفاً: أبواب متن، قائمة سور، أحاديث مرقّمة. “خطة منظمة بهيكل من المكتبة”. | يمشي الطالب في الصفوف واحداً بعد واحد، ويُحسب «الهدف» من الهيكل تلقائياً، والهيكل نفسه مشترك بين البرامج. | يلزمك بناء الهيكل في «مكتبة الخطط» أولاً، وتعديله يمسّ كل برنامج يستعمله. |
| بنود (متقدّم) | يتكرّر التقييم نفسه في كل جلسة: “بنود تُسجَّل في كل جلسة” — حضر مبكراً، أحضر المصحف، عدد الأخطاء. | بطاقة تقييم واحدة بأوزان دقيقة، وبنودٌ تخصم كما تمنح، وكل بند قد يدفع إلى وحدة نقاط مختلفة. | لا تكتمل أبداً، ولا يتحرّك لها موضع، ومعرّفات بنودها خاصة بكل خطة فلا تُقارَن بين الطلاب إحصائياً. |

> **ملاحظة:** تحمل بطاقة «بنود» شارة «جديد»، وقد لا تظهر في بعض المساجد لأنها مربوطة بمفتاح تشغيل تدريجي. فإن لم تجدها وكنت تحتاجها، راجع الدعم.

> **باب خلفي إلى نوعٍ رابع:** اختيار «هيكل» ثم انتقاء هيكل من نوع [[نطاق رقمي]] يحوّل القالب إلى [[نطاق منظم]] من تلقاء نفسه، ويُحسب هدفه بقسمة طول النطاق على الزيادة. فانتبه إلى نوع الهيكل قبل اختياره، لا إلى اسمه وحده.

![اختيار نوع الخطة المرنة بين حرة وهيكل وبنود](https://manual.misbah.pro/images/flexible-plans/01-flexible-type.png)

### مكتبة الخطط: الهياكل التي يملكها المسجد

الهياكل لا تعيش داخل البرنامج بل داخل المسجد. تجدها في مركز التطبيقات تحت «مكتبة الخطط»: “إنشاء وإدارة الخطط المرنة القابلة لإعادة الاستخدام عبر جميع البرامج”.

المسار: التطبيقات ← مكتبة الخطط

*نوعا الهيكل*
| النوع | ما يحويه | كيف يُحسب الهدف | مثال |
| --- | --- | --- | --- |
| «جدول» مناسب | “قائمة مرتبة من العناصر مع عناوين ونقاط” — لكل صفٍّ عنوان ومحتوى اختياري ونقاط. | مجموع نقاط الصفوف | «متن تحفة الأطفال» بأبوابه |
| «نطاق رقمي» للعلم | “نطاق من الأرقام بقيمة بداية ونهاية وخطوة” — «بداية النطاق» و«نهاية النطاق» و«الزيادة (الحد الأدنى للخطوة)». | طول النطاق مقسوماً على الزيادة | الأحاديث من ١ إلى ١٠٠، عشرة في الجلسة |

1. افتح «مكتبة الخطط» من التطبيقات
   الهياكل مشتركة بين برامج المسجد كلها — هذه ميزتها وخطرها معاً.
2. أنشئ هيكلاً واختر نوعه
   “ملاحظة: لا يمكن تغيير نوع الهيكل بعد الإنشاء”. اختر «جدول» لقائمة أسماء، و«نطاق رقمي» لتسلسل أرقام.
3. أضف الصفوف
   في الجدول: «إضافة عنصر» لكل صف، مع “عنوان العنصر” و“المحتوى أو الوصف (اختياري)” و«النقاط». والنقاط هي وزن الصف في حساب الإنجاز.
   في النطاق الرقمي: البداية والنهاية والزيادة، وتعرض المعاينة “عدد الخطوات المحتملة”.
4. استعمله من قالب الخطة
   ارجع إلى صفحة الخطط، أنشئ قالباً مرناً من نوع «هيكل»، ثم اختره من “اختر هيكلاً من المكتبة”.

> **تحذير:** تعديل هيكل تستعمله برامج قائمة يغيّر أرضية القياس تحتها. أنشئ نسخةً بـ«نسخ» وعدّل النسخة إن كان التغيير جوهرياً، ولا تعبث بصفوف هيكل يمشي عليه طلاب.

![مكتبة الخطط في التطبيقات تعرض هياكل من نوع جدول ونطاق رقمي](https://manual.misbah.pro/images/flexible-plans/04-library.png)

### خطة البنود: بطاقة تقييم تُملأ كل جلسة

البنود ليست قائمة مهامّ تُشطب مرة واحدة، بل استمارةٌ يعيد المعلّم ملأها في كل حصة. لهذا لا تكتمل خطة البنود أبداً، ولا يتحرّك لها موضع.

*حقول البند في محرّر «البنود»*
| الحقل | ما يعنيه | ملاحظة |
| --- | --- | --- |
| «اسم البند» للعلم | ما يقرؤه المعلّم في الجلسة. | اكتبه بصيغة قابلة للحكم الفوري: «أحضر المصحف» لا «الانضباط». |
| «خيار» أو «عدد» للعلم | شكل التقييم: مربّع اختيار أو رقم. | «خيار» يعني حداً أقصى واحداً؛ يُترك للمعلّم أن يضع علامةً أو يتركها. |
| «الحد الأدنى» و«الحد الأقصى» بتحفّظ | المدى المقبول لقيمة البند. | قيمة خارج المدى تُرفض برسالة تسمّي البند وحدّيه. |
| قيمة الوحدة غير مناسب | ما تساويه الوحدة الواحدة من البند في المقدار. | **رقم مُوقَّع**: السالب يخصم. بند «أخلّ بالأدب» بقيمة سالبة يقتطع فعلاً. |
| «الوحدة» | وحدة النقاط التي يدفع إليها البند. | تركها على “بدون نقاط” يجعل البند للمتابعة فقط: يدخل في المقدار ولا يصل إلى المحفظة. |

> **كيف تُحسب الجلسة في خطة البنود:** `المقدار = مجموع (قيمة البند المسجَّلة × قيمة وحدته)`
> `المطلوب = مجموع (الحد الأدنى × قيمة الوحدة) للبنود الموجبة وحدها`
> وتُحتسب صافيات كل وحدة نقاط على حدة، فيُقيَّد الموجب منها إضافةً والسالب اقتطاعاً في المحفظة.

> **ثلاث خصائص تُفاجئ أول مرة:** بندٌ حدُّه الأقصى واحد يُعرض مربّعَ اختيار، وتركه فارغاً مقبولٌ ولو كان حدّه الأدنى واحداً.
> «النقاط الممنوحة» لا أثر لها في خطة البنود: الوزن في البنود نفسها.
> جلسةٌ كلّها خصومات تُنتج مقداراً سالباً، وهذا سلوك مقصود لا خلل.

> **ملاحظة:** يشترط النظام أن يكون للبرنامج نظام نقاط بوحدة رئيسية، وإلا رُفض تسجيل البنود برسالة “تعذر تحديد وحدة النقاط الرئيسية للبرنامج”. راجع [المحفظة والنقاط](https://manual.misbah.pro/wallet).

مثال «بنود الجلسة» في «جامع النور»: حضر مبكراً ‎+١‎، أحضر المصحف ‎+١‎، أخلّ بالأدب ‎−٢‎، عدد الأخطاء من صفر إلى عشرة بقيمة ‎−٠٫٥‎ للخطأ.

![محرّر البنود مع أسماء البنود وحدودها ووحدات نقاطها](https://manual.misbah.pro/images/flexible-plans/03-checklist-items.png)

### الهدف والتتبع والنقاط

ما تبقّى من حقول القالب المرن قليل، لكنّ كلَّ واحدٍ منها يغيّر معنى الرقم الذي تقرؤه في التقارير.

- **وحدة النقاط** — “اختر وحدة النقاط التي ستُستخدم في هذه الخطة”. إلزامية في «حرة» و«هيكل»؛ ورسالة الرفض عند تركها: “يجب اختيار وحدة النقاط”. أمّا خطة البنود فوحدتها في كل بند على حدة.
- **النقاط الممنوحة** — معاملٌ يُضرب في مقدار النشاط لكل “وحدة مسجَّلة”. اتركه واحداً ما لم ترد ترجيح مسارٍ على آخر.
- **الهدف** — المقدار الذي يُقاس عليه الإنجاز، واسمه في تجاوزات المنهج «المقدار المستهدف». في «هيكل» يظهر بشارة “محسوب تلقائياً” ووصفه “الهدف محسوب تلقائياً من الهيكل المختار”؛ وفي «حرة» هو “حدد الهدف الإجمالي للخطة (اختياري)”.
- **التتبع التدريجي** — “تتبع تقدمي (تسجيل الموقع الحالي)”، واسمه في تجاوزات المنهج «تصاعدي». “عند التفعيل، سيتم تسجيل الموقع الحالي في الهيكل تلقائياً”، و“ملاحظة: التتبع التقدمي مفعّل تلقائياً للخطط المنظمة”.
- **أيام العمل وتاريخ الانتهاء والقواعد** — تعمل في الخطط المرنة كما تعمل في القرآنية — راجع [الخطط القرآنية](https://manual.misbah.pro/quran-plans#settings). على أنّ «القواعد» لا تظهر في خطة البنود لأنّ الخصم فيها من عمل البنود نفسها.

> **قواعد التسجيل في الخطة التدريجية:** حين يكون التتبع التدريجي مفعّلاً في خطة جدول، يشترط النظام أن يطابق المقدار المسجَّل مجموع نقاط الصفوف التي أُنجزت من بعد الموضع الحالي إلى الصف المختار، وإلا رفض التسجيل: “يجب أن يطابق المبلغ مجموع نقاط الصفوف المسجّلة”.
> ولا يقبل النظام تسجيل صفٍّ قبل الموضع الحالي: “لا يمكن تسجيل نشاط قبل الموضع الحالي في الخطة التدريجية”. لتصحيح موضع رجعي استخدم [متابعة خطط الطلاب](https://manual.misbah.pro/plan-progress).

![اختيار هيكل الخطة من المكتبة مع حقل الهدف المحسوب تلقائياً](https://manual.misbah.pro/images/flexible-plans/02-structure-picker.png)

![قسم النقاط في القالب المرن بوحدة النقاط والنقاط الممنوحة](https://manual.misbah.pro/images/flexible-plans/05-point-unit.png)

### أسئلة شائعة

**النموذج يرفض حفظ القالب ويطلب وحدة نقاط — ماذا أفعل؟**
أنشئ وحدة واحدة على الأقل من إعدادات نظام النقاط ثم عد. تقول الواجهة: “قوالب الخطط المرنة ترتبط بوحدة نقاط من نظام المحافظ. أنشئ وحدة نقاط واحدة على الأقل من إعدادات النظام، ثم عد إلى هذه الصفحة لإكمال القالب.” راجع [المحفظة والنقاط](https://manual.misbah.pro/wallet).

**قائمة الهياكل فارغة — لماذا؟**
لأنّ المسجد لم يبنِ هيكلاً بعد. الهياكل تعيش في «مكتبة الخطط» داخل التطبيقات لا داخل البرنامج، وتقول الواجهة: “هذا النوع من القوالب يحتاج إلى هيكل من مكتبة الخطط في المسجد”.

**خطة البنود لا تصل إلى مئة بالمئة أبداً — هل هذا خلل؟**
لا. خطة البنود لا تكتمل بحكم التصميم؛ هي مسار متابعة مستمرّ لا مقرّر ينتهي. استعمل «هيكل» إن أردت مقرّراً له نهاية.

**أريد بنداً يُتابَع ولا يمنح نقاطاً — كيف؟**
اترك حقل «الوحدة» في ذلك البند على “بدون نقاط”. سيدخل البند في مقدار الجلسة ولن يصل إلى محفظة الطالب.

**هل أستعمل هيكلاً من المكتبة أم قالباً داخل البرنامج؟**
هما طبقتان لا بديلان: الهيكل يصف المقرّر (صفوف المتن)، والقالب يصف كيف يُدرَّس (الأيام والوحدة والهدف). المتن الواحد يُكتب في المكتبة مرة، ثم يستعمله قالبٌ في كل برنامج.

---

## المناهج الدراسية

المصدر: https://manual.misbah.pro/curriculum

المنهج مستوىً لا كتاب: اختيارٌ مرتّب من قوالب الخطط مع تجاوزات لكل مستوى، يُطبَّق على عشرات التسجيلات دفعة واحدة — وإعادة تطبيقه تكتب في خطط الطلاب.

الجمهور: مشرف

### المنهج: مستوى كامل في كائن واحد

حين يكبر البرنامج تتحوّل المسألة من “كيف أضبط خطة” إلى “كيف أضبط خمس خطط لأربعين طالباً دون أن أكرّرها ألف مرة”. المنهج هو جواب هذا السؤال.

> **ملخّص سريع**
> - ما هذا؟ المنهج اختيارٌ مرتّب من قوالب الخطط، مع قيمٍ تتجاوز بها القالبَ لهذا المستوى بعينه.
> - لماذا يهمّك؟ يختصر خمس خطط في أربعين طالباً إلى عملية واحدة، ويجعل “المستوى الأول” شيئاً يمكن تعديله في مكان واحد.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٥ دقيقة

المسار: لوحة البرنامج ← المناهج

قبل أن تمضي، احفظ التفرقة: **قالب الخطة** وصفةٌ بلا طالب، و**خطة الطالب** نسخةٌ حيّة تحمل موضعه وإنجازه. المنهج طبقةٌ بينهما: يختار القوالب ويضبط قيمها، ثم يُنتج خطط الطلاب. راجع [قالب الخطة](https://manual.misbah.pro/plans#term-plan-template) و[خطة الطالب](https://manual.misbah.pro/plans#term-student-plan).

- **المنهج** — قائمة مرتّبة من قوالب الخطط، لا يتكرّر فيها القالب مرتين، لها اسم ووصف.
  الترتيب هو ترتيب ظهور الخطط أمام المعلّم والطالب.
- **الخصائص المرئية** — القيم التي يتجاوز بها المنهجُ القالبَ: سورة البداية، المقدار اليومي، أيام العمل، وحدة النقاط…
  بها يصير القالب الواحد صالحاً لكل المستويات: القالب واحد، والقيم تختلف من منهج إلى منهج.
- **إعدادات الربط** — تجاوزات لإعدادات سلوكيات الربط المعرَّفة في القالب، لهذا المستوى وحده.
  مستوى المبتدئين يراجع حزمةً بحجم وجهين، والمتقدّمون بحجم جزء — والسلوك واحد.
- **التطبيق** — العملية التي تحوّل المنهج إلى خطط حقيقية على تسجيلات الطلاب المحدَّدين.
  حتى تُطبّقه يبقى المنهج ورقاً: لا خطة ولا موضع ولا نقطة.

> **المنهج ليس كتاباً:** الاسم يوحي بوثيقة مقرّر، والواقع أنّه **مستوى**: الطبيعي أن يكون لكل مستوى أو جزء أو سرعةٍ منهجٌ مستقلّ — «منهج المبتدئين»، «منهج الحفّاظ»، «مسار المراجعة».

> **انتبه:** المناهج مرتبطة بخاصية في الباقة؛ ورسالة القفل: “إنشاء وتعديل المناهج غير متاح في خطتك الحالية”. راجع [ما تفتحه الباقة](https://manual.misbah.pro/entitlements).

> **لماذا تبدّل اسم الصفحة؟:** قبل إنشاء أول منهج يكون عنوان الصفحة «بناء الخطط» ووصفها “أنشئ قوالب الخطط ثم جمّعها في منهج جاهز للتطبيق على الطلاب.”، وبعده يصير «المناهج الدراسية» ووصفها “إدارة مجموعات الخطط والخصائص المرئية لكل منهج.” وهما صفحة واحدة لا صفحتان، وأي رابط قديم إلى مسار المناهج يعيد توجيهك إليها.

### متى تحتاج منهجاً أصلاً

ليس كل برنامج يحتاج مناهج. كلّما قلّ عدد الطلاب وتشابهت مساراتهم، قلّت فائدة الطبقة الزائدة.

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

### بناء منهج وضبط قيمه

المثال: «منهج المبتدئين» في برنامج [[برنامج الحفظ — الفصل الدراسي الأول ١٤٤٨هـ]]، يجمع قالبَي «حفظ» و«مراجعة» بمقدارٍ مخفّض وبداية في جزء عمّ.

1. تأكّد من جاهزية القوالب أولاً
   المنهج لا يُنشئ قوالب، وإنما يجمعها. ابنِ [قوالبك القرآنية](https://manual.misbah.pro/quran-plans) و[المرنة](https://manual.misbah.pro/flexible-plans) قبل أن تفتح حوار المنهج.
2. اضغط «إضافة منهج جديد»
   يفتح الحوار بوصفه: “قم بتعريف اسم المنهج والخطط التابعة له والخصائص المرئية.”
3. اكتب اسماً يدلّ على المستوى
   الحقل «اسم المنهج» بمثاله “مثال: المنهج الدراسي للتجويد”، و«الوصف (اختياري)» بـ“وصف مختصر لأهداف المنهج”.
   سمِّه بالمستوى لا بالمحتوى: «منهج المبتدئين» أوضح من «جزء عمّ».
4. أضف القوالب من «إضافة خطة جديدة»
   لا يُقبل تكرار القالب: “لا يمكن تكرار نفس القالب أكثر من مرة في المنهج”، ولا يُقبل منهج خالٍ: “الرجاء إضافة خطة واحدة على الأقل”.
   حين تستنفد القوالب يتبدّل نصّ الزر إلى “تم إضافة جميع القوالب المتاحة لهذا المنهج”.
5. رتّب الصفوف واضبط قيم كل قالب
   لكل صف مقبض «اسحب لإعادة الترتيب»، وحقل «عنوان مخصص (اختياري)» يغيّر ما يراه الطالب دون أن يمسّ اسم القالب، وزر «إزالة من المنهج».
   ومن الصف نفسه تفتح «الخصائص المرئية» و«إعدادات الربط».
   ![صف قالب داخل المنهج مع العنوان المخصص والخصائص المرئية وإعدادات الربط](https://manual.misbah.pro/images/curriculum/02-entry-row.png)
6. اضغط «إنشاء المنهج»
   وعند تعديل منهج قائم يصير الزر «حفظ التغييرات» — وهنا يبدأ الأثر الحقيقي، فاقرأ القسم التالي قبل أن تضغطه على برنامج فيه بيانات.

*الخصائص التي يمكن تجاوزها لكل قالب*
| المجموعة | الخصائص |
| --- | --- |
| مشتركة للعلم | «الاسم»، «الوصف»، «النوع»، «أيام العمل»، «تاريخ الانتهاء» |
| قرآنية مناسب | «اتجاه الحفظ»، «سورة البداية»، «آية البداية»، «الوضع»، «المقدار اليومي»، «سورة النهاية»، «آية النهاية»، «إعدادات التنقل»، «سياسة التقريب»، «وحدة النقاط»، «القواعد» |
| مرنة مناسب | «نوع الخطة»، «المقدار المستهدف»، «تصاعدي»، «وحدة النقاط»، «القواعد» |

> **نصيحة:** خاصيةٌ لم تتجاوزها تبقى موروثةً من القالب. لا تملأ كل الحقول لمجرّد أنّها معروضة: كلّما قلّت التجاوزات، انتقل تحسينُ القالب إلى كل المناهج تلقائياً.

![حوار إضافة منهج جديد باسمه ووصفه وقائمة قوالبه](https://manual.misbah.pro/images/curriculum/01-curriculum-dialog.png)

### التطبيق وإعادة التطبيق: ما يتغيّر وما يبقى

هذا أخطر قسم في نطاق الخطط كلّه. التطبيق يكتب في خطط طلاب حقيقيين، وإعادة التطبيق تكتب فيها مرة أخرى — فاعرف بالضبط ما الذي تكتبه.

1. افتح صفحة الطلاب داخل البرنامج
   المنهج يُطبَّق على **تسجيلات** لا على أسماء.
2. حدّد الطلاب ثم افتح «إجراءات»
   يعرض الزر عدد المحدَّدين بين قوسين.
3. اختر «تطبيق منهج»
   يشرح الحوار ما سيقع: “اختر المنهج الذي ترغب في تطبيقه على الطلاب المحددين. سيتم تحديث الخطط الحالية أو إنشاء خطط جديدة بناءً على المنهج المختار.”
4. اضغط «تطبيق المنهج»
   لكل طالب: يُنشأ ما ينقص من الخطط، ويُحدَّث ما هو قائم، وتُعطَّل الخطط التي خرج قالبها من المنهج.
   ![حوار تطبيق منهج على الطلاب المحددين](https://manual.misbah.pro/images/curriculum/03-apply.png)

#### قاعدة واحدة تختصر الباب

> **ما تكتبه إعادة التطبيق وما لا تمسّه:** `إعادة التطبيق تُعيد كتابة إعدادات الخطة، ولا تُعيد كتابة إنجاز الطالب.`
> فالمقدار والاتجاه والحدود وأيام العمل ووحدة النقاط والاسم كلها تُحدَّث. أمّا الموضع الحالي ونسبة الإنجاز وعدد الأنشطة والمقدار المتراكم فتبقى كما هي.

*ماذا يحدث لخطة قائمة عند إعادة التطبيق*
| الحقل | المصير | لماذا |
| --- | --- | --- |
| الموضع الحالي ونسبة الإنجاز وعدد الأنشطة مناسب | يبقى كما هو | إنجاز الطالب ملكه، لا يمحوه إعداد |
| المقدار والاتجاه والحدود وأيام العمل ووحدة النقاط والاسم للعلم | يُحدَّث من القالب والمنهج | هذا هو الغرض من المزامنة |
| «تاريخ الانتهاء» بتحفّظ | يُكتب دائماً، ويُمحى إن لم يكن له قيمة | وهذا ما **يعيد تنشيط** خطة عُطِّلت سابقاً حين يرجع قالبها إلى المنهج |
| إعدادات سلوكيات الربط على الخطة غير مناسب | تُستبدل بالكامل | أي ضبطٍ يدوي لإعدادات الربط على خطة طالب **يضيع** عند أول مزامنة |
| موضع خطةٍ لم يُسجَّل عليها شيء بعد للعلم | يُعاد إلى بداية المنهج الجديدة | إصلاحٌ آمن: من لم يسمّع بعدُ لا يخسر شيئاً |

وعند نجاح الحفظ تظهر رسالة صريحة: “تم حفظ التغييرات وتحديث الخطط المرتبطة بنجاح” — وهي إقرارٌ بأنّ خطط الطلاب تغيّرت، لا مجرّد تأكيد حفظ.

#### قالب خرج من المنهج

> **انتبه:** إزالة قالب من المنهج ثم إعادة التطبيق **لا تحذف** خطط الطلاب المبنية عليه. تُعطَّل: يُضبط تاريخ انتهائها على الأمس، ويُفكّ ارتباطها بالمنهج. يبقى سجلّ التقدّم كاملاً، وتتوقّف الخطة عن قبول أنشطة جديدة فحسب.

> **تعديل قالب داخل منهج يزامن خطط الطلاب:** هذا أخطر إجراء في المنتج: حفظ **قالب خطة** يبحث النظام عن كل منهج يحويه، ويُجري مزامنة كاملة لخطط طلابه. فتعديلٌ ظننتَه محلياً يُعيد كتابة إعدادات عشرات الخطط الحيّة في لحظة.
> وحذف القالب يُخرجه من كل منهج ثم يزامن، فتُعطَّل الخطط اليتيمة على النحو الموصوف أعلاه.
> القاعدة العملية: عدّل القوالب خارج أوقات الحلقة، وعلى برنامج تجريبي أولاً إن كان التعديل جوهرياً.

![بطاقة منهج تعرض قوالبه وقيم كل قالب وعدد طلابه](https://manual.misbah.pro/images/plans/04-curriculum.png)

### مزالق معروفة

ثلاثة مواضع تُنتج أعطالاً صامتة: لا رسالة خطأ، وإنما أرقام لا تشبه ما تتوقّع.

> **إعادة ترتيب روابط القالب تُبدّل معنى تجاوزات الربط:** تجاوزات «إعدادات الربط» في المنهج مرتبطة بترتيب الروابط داخل القالب لا بأسمائها. فإن أعدت ترتيب روابط القالب، صار كل تجاوز يشير إلى رابط آخر دون أي تنبيه.
> قبل إعادة الترتيب: افتح «إعدادات الربط» في كل منهج يستعمل القالب، وسجّل القيم، ثم أعِد ضبطها بعده. راجع [سلوكيات الربط](https://manual.misbah.pro/link-behaviors).

> **تغييرات غير محفوظة في بطاقة المنهج:** تعديل القيم داخل بطاقة المنهج لا يسري حتى تحفظ، وتعرض البطاقة شارة “تغييرات غير محفوظة”. ومغادرة الصفحة قبل الحفظ تُسقط التعديل كلّه.

> **الحذف لا رجعة فيه:** حذف المنهج نهائي: “هذا الإجراء لا يمكن التراجع عنه”. ولا تُحذف خطط الطلاب معه، لكنّها تفقد ارتباطها بالمنهج، فلا تشملها مزامنته بعد ذلك. وإن أردت نسخةً للتجربة فاستعمل «نسخ المنهج».

### أسئلة شائعة

**طبّقت المنهج مرتين — هل تضاعفت خطط الطالب؟**
لا. لا يحمل الطالب أكثر من خطة واحدة من القالب الواحد في تسجيله، فالتطبيق الثاني يُحدّث القائم بدل أن ينشئ نسخة ثانية.

**نقلت طالباً من «منهج المبتدئين» إلى منهج أعلى — ماذا يحدث لتقدّمه؟**
طبّق المنهج الجديد عليه. الخطط المشتركة بين المنهجين تُحدَّث إعداداتها ويبقى موضعها وإنجازها، والخطط التي لا يحويها المنهج الجديد تُعطَّل بتاريخ انتهاء ويبقى سجلّها.

**عدّلت قالباً ففوجئت بتغيّر خطط الطلاب — لماذا؟**
لأنّ القالب داخل منهج. حفظ القالب يستدعي مزامنة كاملة لكل منهج يحويه. إن أردت تعديلاً لا يمسّ القائمين، أنشئ قالباً جديداً بدل تعديل القديم.

**ضبطت إعدادات سلوك ربط على خطة طالب بعينه ثم اختفت — ما السبب؟**
إعدادات الربط على خطة الطالب تُستبدل بالكامل في كل مزامنة. اضبطها في القالب أو في «إعدادات الربط» داخل المنهج، لا على الخطة مباشرة.

**هل يلزمني منهج لأضيف خطة لطالب واحد؟**
لا. تستطيع إضافة خطة من قالب مباشرة إلى تسجيل الطالب من [متابعة خطط الطلاب](https://manual.misbah.pro/plan-progress). المنهج للعمل الجماعي والمستويات.

---

## متابعة خطط الطلاب

المصدر: https://manual.misbah.pro/plan-progress

جدول «إدارة الخطط»: تُضيف الخطط إلى التسجيلات، وتصحّح المواضع، وتعدّل جماعياً — وتعرف ما يحدث للخطة عند نقل الطالب أو انتهاء البرنامج أو حذف القالب.

الجمهور: مشرف

### حيث يلتقي الإعداد بالواقع

لا يسير أربعون طالباً على خطٍّ واحد مهما أُحكم الإعداد: ينقطع طالب أسبوعين، ويُنقل آخر بين الحلقات، ويسجّل معلّم جلسةً على الخطة الخطأ. هذه الصفحة هي المكان الذي تُصلَح فيه هذه الفروق.

> **ملخّص سريع**
> - ما هذا؟ جدولٌ يعرض طلاب البرنامج صفوفاً وخططهم أعمدة، فتقرأ مواضعهم وتعدّلها وتضيف إليهم خططاً وتحذفها.
> - لماذا يهمّك؟ لأنّ الخطة إعدادٌ حتى تصل إلى تسجيل طالب، ولأنّ المواضع تحتاج تصحيحاً بعد كل انقطاع أو نقل.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٠ دقائق

المسار: لوحة البرنامج ← الخطط ← المزيد ← إدارة الخطط

تذكّر التفرقة الأساسية: **قالب الخطة** وصفةٌ لا تخصّ أحداً، و**خطة الطالب** نسخةٌ حيّة لها موضعها وإنجازها. كل ما في هذه الصفحة يقع على خطط الطلاب لا على القوالب. راجع [قالب الخطة](https://manual.misbah.pro/plans#term-plan-template) و[خطة الطالب](https://manual.misbah.pro/plans#term-student-plan).

- **التسجيل** — ارتباط طالب المسجد ببرنامج بعينه. الخطط تتعلّق به لا بالطالب ولا بالحلقة.
  لهذا يحتفظ الطالب بخططه كاملةً حين يُنقل من حلقة إلى أخرى داخل البرنامج نفسه.
- **جدول إدارة الخطط** — شبكة الطلاب × الخطط، تُقرأ وتُحرَّر في مكانها، ولها وضعان: حسب القوالب أو حسب المنهج.
  هو الموضع الوحيد الذي ترى فيه مستوى البرنامج كلّه في شاشة واحدة.
- **تصحيح الموضع** — كتابة السورة والآية اللتين بلغهما الطالب فعلاً، دون تسجيل نشاط ولا منح نقاط.
  التصحيح إصلاحٌ إداري لا جلسة تسميع، فلا يجوز أن يدخل المحفظة.

> **ملاحظة:** أمّا تسجيل ما سمّعه الطالب اليوم فليس من عمل هذه الصفحة؛ ذاك يقع في الحلقة. راجع [الحلقات والتسميع](https://manual.misbah.pro/teaching) و[المتابعة اليومية](https://manual.misbah.pro/activities).

### ثلاثة مداخل، ولكل واحد مجاله

الشاشة نفسها تُفتح من ثلاثة أبواب، والخطأ الشائع أن يستعمل المشرف الباب الضيّق لعمل واسع فيقضي ساعةً فيما يكفيه دقيقتان.

#### أي مدخل تستعمل؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| جدول القوالب (الافتراضي) | تريد مقارنة مواضع الطلاب في قالب واحد أو عدّة قوالب: “اختر قالباً أو أكثر وعدّل موضع الطلاب وخصائص خططهم.” | تختار القوالب من قائمة «القوالب»، وتصفّي بين «أي» — “الطلاب الذين لديهم قالب واحد على الأقل من المحددة” — و«جميع» — “الطلاب الذين لديهم كل القوالب المحددة”. | لا يعرض بنية المستوى، فلا ترى أي طالب على أي منهج. |
| جدول المنهج (الأنسب غالباً) | البرنامج يعمل بالمناهج وتريد رؤية مستوى كامل: “عدّل موضع كل طالب وخصائص خططه حسب المنهج.” | عمودٌ لكل خطة في المنهج، فتلمح الطالب الشاذّ عن مستواه في نظرة. | لا يعرض إلا طلاب ذلك المنهج؛ ومن لم يُطبَّق عليه المنهج لا يظهر أصلاً. |
| ملف الطالب (متقدّم) | الشأن يخصّ طالباً واحداً: حالة خاصة، أو خطة إضافية، أو مراجعة سجلّه. | تبويب «الخطط» يفصل «نشطة» عن «منتهية»، ويعرض لكل خطة موضعها ونسبتها ومدّتها الباقية. | طالبٌ واحد في كل مرة — لا يصلح لعمل جماعي. |

> **ملاحظة:** إن كانت الصفحة خاليةً فالسبب مذكور فيها: “لا توجد قوالب خطط بعد” أو “لا توجد مناهج بعد” مع زرٍّ يأخذك إلى الإنشاء. وإن ظهر “لا توجد تسجيلات بهذه القوالب” فالقوالب موجودة ولم تُطبَّق على أحد بعد.

![جدول إدارة الخطط يعرض الطلاب صفوفاً وخططهم أعمدة](https://manual.misbah.pro/images/plans/05-progress-manager.png)

### كيف تصل الخطة إلى الطالب

ثلاث طرق تُنتج خطة لطالب، وتختلف في ما يمكنك فعله بها بعد ذلك اختلافاً يستحقّ الانتباه.

*طرق إنشاء خطة لطالب*
| الطريقة | من أين | ما تُنتجه |
| --- | --- | --- |
| تطبيق منهج مناسب | صفحة الطلاب ← «إجراءات» ← «تطبيق منهج» | خطط المنهج كاملةً لكل طالب محدَّد، مرتبطةً بالمنهج فتشملها مزامنته |
| إضافة من قالب للعلم | صفحة الطلاب ← «إجراءات» ← «إضافة خطة»، أو من ملف الطالب | خطة واحدة مرتبطة بالقالب، يشملها التعديل الجماعي ولا تشملها مزامنة المنهج |
| إنشاء مباشر للطالب غير مناسب | ملف الطالب ← «إضافة خطة» دون اختيار قالب | خطة يتيمة: “إنشاء خطة مباشرة للطالب تمنع من التعديل الجماعي للخطة لاحقاً عن طريق صفحة الخطط” |

> **ربط خطة قائمة بقالب:** الخطة اليتيمة ليست حكماً نهائياً: افتحها واختر لها قالباً، فيسألك النظام «اختر نوع الربط» بين «ترقية الخطة» — “تغيير جميع خصائص الخطة لتطابق القالب” — و«ربط فقط» — “الحفاظ على الخطة كما هي وربطها بالقالب فقط”.
> و«ترقية الخطة» تعرض «معاينة التغييرات» أولاً، فتحدّد ما تريد تطبيقه منها وحده ثم تضغط «تطبيق التغييرات المحددة».

### تصحيح المواضع والتعديل الجماعي

التعديل هنا نوعان: تصحيح فردي في خلية الجدول، وتعديل جماعي يمرّ على كل خطط قالب بضغطة واحدة.

1. افتح الجدول واختر القالب أو المنهج
   يمكنك ضبط ما يُعرض من «الأعمدة» حتى تركّز على الحقل الذي تصحّحه.
2. اضغط خلية «الموضع الحالي» للطالب
   يفتح حوارٌ يسأل “حدد السورة والآية التي وصل إليها الطالب”، ويعرض معاينة الموضع قبل الحفظ.
   ![حوار تعديل الموضع الحالي بالسورة والآية ومعاينة الموضع](https://manual.misbah.pro/images/plan-progress/03-position-editor.png)
3. عدّل ما تحتاج ثم احفظ
   يعدّ الجدول تعديلاتك ويعرضها بصيغة “تغيير غير محفوظ” حتى تحفظ، فيؤكّد “تم تحديث … خطة بنجاح”.

#### التعديل الجماعي من القالب

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

> **«تعديل القالب والخطط» لا رجعة فيه:** يقول الحوار: “سيتم تطبيق التغييرات على جميع الخطط المرتبطة بهذا القالب.” ويعرض “عدد الخطط المتأثرة”، ثم يحذّر: “هذا الإجراء لا يمكن التراجع عنه.”
> اقرأ العدد قبل التأكيد؛ فهو أصدق ما في الشاشة.

#### الحذف الجماعي

> **تحذير:** «حذف خطط» من «إجراءات» في صفحة الطلاب: “سيتم حذف الخطط المختارة وجميع سجلات التقدم المرتبطة بها نهائياً”، ولا يتمّ إلا بعد كتابة “نعم احذف” بالضبط.
> وإن أردت إيقاف خطة دون محو تاريخها، فاضبط «تاريخ الانتهاء» على الأمس بدل الحذف.

![حوار حذف الخطط بالجملة مع اختيار القوالب وتأكيد نصّي](https://manual.misbah.pro/images/plan-progress/05-bulk-delete.png)

### ماذا يحدث للخطة حين يتغيّر ما حولها

أكثر أسئلة الدعم في هذا الباب تدور حول حدثٍ وقع في مكان آخر: نُقل الطالب، انتهى البرنامج، حُذف القالب. هذا جدول الأجوبة.

*الحدث وأثره في خطة الطالب*
| الحدث | ما يحدث للخطة | ما تفعله أنت |
| --- | --- | --- |
| نقل الطالب بين الحلقات مناسب | لا شيء. الخطة متعلّقة بتسجيله في البرنامج لا بحلقته، فتنتقل معه بموضعها وإنجازها كاملين. | لا شيء |
| انتهاء البرنامج بتحفّظ | الخطة التي لا تاريخ انتهاء لها ترث نهاية البرنامج، فتصير منتهية وترفض أي نشاط جديد. | مدّد البرنامج، أو اكتب تاريخ انتهاء صريحاً على الخطة |
| «حذف القالب» للعلم | “حذف هذا القالب لن يؤثر على الخطط التي تم إنشاؤها باستخدامه مسبقاً” — تبقى الخطط وتفقد ارتباطها. | لا شيء، ما لم ترد حذفها هي أيضاً |
| «حذف القالب والخطط» غير مناسب | يُمحى القالب وكل خطط طلابه وسجلّاتها معه. | تحقّق من العدد المعروض قبل التأكيد |
| إخراج القالب من المنهج بتحفّظ | تُعطَّل الخطط بتاريخ انتهاءٍ في الأمس ويُفكّ ارتباطها بالمنهج، ويبقى سجلّ التقدّم. | أعِد القالب إلى المنهج وطبّقه لتُستأنف الخطة |
| حذف تسجيل الطالب غير مناسب | تذهب خططه وسجلّاته معه. | صدّر ما تحتاجه من تقارير قبل الحذف |

> **الخطة المنتهية:** بعد تاريخ الانتهاء تنتقل الخطة إلى تبويب «منتهية» في ملف الطالب، ويُرفض تسجيل التسميع عليها برسالة “لقد انتهت هذه الخطة بالفعل”. وهذا أشيع سبب لشكوى المعلّم أنّ “النظام لا يقبل التسميع” في أول أسبوع من فصل جديد.

![تبويب الخطط في ملف الطالب بتبويبي نشطة ومنتهية](https://manual.misbah.pro/images/plan-progress/04-enrollment-plans.png)

![جدول إدارة الخطط في وضع المنهج بعمود لكل خطة فيه](https://manual.misbah.pro/images/plan-progress/02-curriculum-table.png)

### أسئلة شائعة

**صحّحت موضع طالب — هل يحصل على نقاط؟**
لا. تصحيح الموضع إجراء إداري لا ينشئ نشاطاً ولا يمسّ المحفظة ولا عدد الأنشطة. النقاط تأتي من تسجيل التسميع في الحلقة وحده.

**طالب انقطع شهراً ثم عاد — ماذا أفعل بخطته؟**
صحّح موضعه إن لزم، وراجع «تاريخ الانتهاء»: خطته الثابتة تحسب إنجازها بأيام العمل، فالانقطاع يخفض نسبته وإن لم يتغيّر موضعه. مدّد التاريخ إن أردت أن يُكمل مقرّره.

**لماذا لا يظهر طالب في جدول المنهج؟**
لأنّ المنهج لم يُطبَّق على تسجيله بعد. تقول الشاشة: “طبّق المنهج على التسجيلات من صفحة الطلاب.”

**أريد إيقاف خطة دون فقد سجلّها — كيف؟**
اضبط «تاريخ الانتهاء» على تاريخ ماضٍ. تتوقّف الخطة عن قبول الأنشطة وتنتقل إلى «منتهية»، ويبقى كل ما سُجِّل عليها.

**نقلت طالباً إلى حلقة أخرى فاختفت خططه — هل هذا ممكن؟**
لا يحدث ذلك بسبب النقل؛ الخطط معلّقة بالتسجيل لا بالحلقة. راجع ما إذا كان الطالب سُجِّل من جديد في البرنامج بدل نقله، أو طُبِّق عليه منهج آخر أخرج قوالبه السابقة.

---

## سلوكيات الربط

المصدر: https://manual.misbah.pro/link-behaviors

قاعدةٌ تراقب خطةً وتكتب في أخرى للطالب نفسه: بها يتبع التثبيت الحفظ، ولا تتجاوز المراجعة ما حُفظ. الدوال الجاهزة، والسكربتات، وكيفية ربطها بالقوالب واختبارها.

الجمهور: مشرف

### لماذا تحتاج خطةٌ أن تعرف بخطةٍ أخرى

في أي حلقة جادّة لا يعمل الطالب على مسار واحد: يحفظ الجديد، ويثبّت ما قرب، ويراجع ما بعد. وهذه المسارات الثلاثة ليست مستقلّة — موضع كلٍّ منها مشتقٌّ من موضع الحفظ. سلوك الربط هو الذي يجعل هذا الاشتقاق يقع من تلقاء نفسه.

> **ملخّص سريع**
> - ما هذا؟ قاعدةٌ تراقب حقولاً في خطة، فإذا تغيّرت كتبت قيماً في خطةٍ أخرى للطالب نفسه.
> - لماذا يهمّك؟ بغيرها يضبط المشرف مواضع المراجعة والتثبيت لكل طالب يدوياً بعد كل جلسة — وهو عملٌ لا يُطاق فوق عشرة طلاب.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٢٥ دقيقة

المسار: لوحة البرنامج ← الخطط ← المزيد ← سلوكيات الربط

الصورة في سطر واحد: **يتغيّر شيء في خطة المصدر ← يعمل السلوك ← تُكتب قيمٌ في خطة الهدف**. والمصدر والهدف خطّتان للطالب نفسه، لا لطالبين.

- **السلوك** — القاعدة نفسها: اسمٌ ووصف، وقائمة حقول يراقبها، وقائمة حقول يُسمح له بالكتابة فيها، وآلية عمل (دالة جاهزة أو سكربت).
  يُكتب مرة على مستوى المسجد أو المنصة، ثم يُستعمل في عشرات القوالب بإعدادات مختلفة.
- **الربط** — السطر الذي يوصل السلوك بقالبين: قالب المرجع (المصدر) والقالب الذي تحرّره (الهدف)، مع إعداداته.
  السلوك وحده لا يفعل شيئاً؛ الربط هو ما يشغّله. والإعدادات تُضبط في الربط لا في السلوك.
- **الحقول المراقبة** — ما إذا تغيّر أيقظ السلوك: الموضع الحالي، المقدار اليومي، اتجاه الحفظ، عدد الأنشطة، نسبة الاكتمال…
  بها تُقلّل تشغيل السلوك إلى ما يعنيه فعلاً، فلا يُستدعى عند كل حفظ للخطة.
- **الحقول المستهدفة** — ما يُسمح للسلوك بكتابته في خطة الهدف. وما خرج عن القائمة يُهمَل بلا خطأ.
  سياجُ أمانٍ يمنع سلوكاً مكتوباً بعجلة من تخريب حقول لم يُقصد مسّها.

> **خاصيةٌ عالية الأثر:** سلوك الربط يكتب في خطط طلاب حقيقيين بلا مراجعة بشرية. لا تفعّل سلوكاً على برنامج فيه بيانات قبل أن تجرّبه في نافذة الاختبار، وعلى طالب واحد.

![صفحة سلوكيات الربط بقسمي السلوكيات العامة وسلوكيات المسجد](https://manual.misbah.pro/images/link-behaviors/01-behaviors-page.png)

### متى تحتاج سلوكاً أصلاً

أكثر ما يُطلب في هذا الباب تحلّه إعداداتُ الخطة وحدها. والقاعدة: لا تبنِ سلوكاً قبل أن تتأكّد أنّ حدود التنقل والمقدار لا تكفيان.

#### إعدادات، أم دالة جاهزة، أم سكربت؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| بلا سلوك (الافتراضي) | كل خطة مستقلّة عن الأخرى، أو يمكن التعبير عن العلاقة بحدود تنقل ثابتة ومقدار. | أقلّ ما يُعطب: لا شيء يعمل في الخلفية، وكل قيمة مكتوبة أمامك في القالب. | المواضع المشتقّة تُضبط يدوياً، ولا تتحرّك مع تقدّم الطالب. |
| دالة نظام (الأنسب غالباً) | العلاقة من النوع المعتاد: المراجعة تتبع الحفظ، أو التثبيت خلفه بمسافة، أو المدى محصور في الجزء الجاري. | خمس دوال جاهزة مجرَّبة، لا كود فيها ولا صيانة، وإعداداتها حقول تملؤها بالأرقام أو بالقيم السريعة. | تفعل ما صُمّمت له فحسب؛ ولا شرط فيها ولا تكيّف مع مستوى الطالب. |
| سكربت مخصص (متقدّم) | القاعدة مشروطة أو تكيّفية: مقدارٌ يُشتقّ من متوسط تسميعات الطالب، أو اتجاهٌ يتغيّر بالتقييم، أو مسافةٌ محسوبة بمعامل. | تكتب القاعدة كما هي بالضبط، وتعرضها على المشرف بحقول إعداد عربية يملؤها بلا كود. | كودٌ يعمل على بيانات حيّة، يحتاج اختباراً وصيانة. راجع [أمثلة السكربتات](https://manual.misbah.pro/behavior-scripts). |

> **السؤال الفاصل:** قبل أن تبني شيئاً اسأل: **هل يمكن توليد كل يوم من أيام الورد بقاعدة وبضعة أرقام؟** إن كان الجواب نعم، فالورد قابل للتوليد، وتحلّه إعدادات الخطة ودالة جاهزة على الأكثر. وبناء جدول أيام لِما هو في حقيقته معادلةٌ خطأٌ مكلف معروف.

### دوال النظام الخمس

تشحن المنصة خمس دوال في مجموعتين: «التقدّم والحدود» و«الحزم». هذه أسماؤها كما تظهر، وما تكتبه كلٌّ منها بالضبط.

*دوال النظام، وما تكتبه في خطة الهدف*
| الدالة | المجموعة | ماذا تكتب | إعداداتها |
| --- | --- | --- | --- |
| «نسخ الموضع الحالي» للعلم | التقدّم والحدود | تنسخ الموضع الحالي من المصدر إلى الهدف، ولا تمسّ الحدود ولا غيرها. | الإزاحة بالأسطر، والتراجع للخلف |
| “ضبط حد التنقل من الموضع الحالي” مناسب | التقدّم والحدود | تضبط حدّاً واحداً — بداية النطاق أو نهايته — على موضع المصدر، وتعيد ضبط ما خرج عن الحدود الجديدة. | الحدّ المراد تحديثه، والإزاحة، والتراجع للخلف |
| “مزامنة حدود التنقل مع التقدّم” مناسب | التقدّم والحدود | تطابق ممرَّ الهدف مع تقدّم المصدر، وتزامن الاتجاه، وتعيد الموضع إلى بداية النطاق إن خرج عنه. | مزامنة اتجاه التنقل مع الخطة المصدر |
| «الحزمة النشطة» بتحفّظ | الحزم | تعزل حزمةً واحدة حول الموضع: البداية أول آية في الحزمة التي يقع فيها التقدّم، والنهاية آخر آية أُنجزت فعلاً — **لا** نهاية الجزء. | حجم الحزمة بالأسطر، ومزامنة الاتجاه |
| «حزم تراكمية» مناسب | الحزم | تثبّت البداية عند أول الخطة وتمدّ النهاية مع التقدّم — “كلّ ما قرأ منذ البداية”. | حجم الحزمة، ومزامنة الاتجاه، وإنهاء النطاق عند نهاية الحزمة |

> **لا تحسب الأسطر بيدك:** حقلا الإزاحة وحجم الحزمة يُكتبان بالأسطر، لكنّ الواجهة تعرض قيماً سريعة: وجه (١٥)، وجهان، ثلاثة أوجه، نصف جزء، جزء واحد، جزآن، ثلاثة أجزاء — ويضيف حقل الحزمة: عشر، عشران، ثلاثة أعشار، خمسة أجزاء.

#### قاموس ما يقوله المسجد

*من عبارة المشرف إلى الإعداد*
| ما يقوله المشرف | معناه عملياً | ما تضبطه |
| --- | --- | --- |
| «حفظ» للعلم | مسار التقدّم الأصلي — الجديد الذي يُحفظ. | يكون هو المصدر المراقَب غالباً |
| «تثبيت» مناسب | تسميع آخر جلسات الحفظ — نافذةٌ تمشي خلف الحفظ بمسافة. | «نسخ الموضع الحالي» بإزاحةٍ وتراجع للخلف |
| «مراجعة» مناسب | مراجعة كل ما حُفظ، ولا تتجاوز موضع الحفظ أبداً. | “ضبط حد التنقل من الموضع الحالي” على نهاية النطاق، أو «حزم تراكمية» |
| “من بداية الجزء حتى مكان الحفظ” للعلم | المدى = بداية الجزء الجاري ← موضع الحفظ. | «الحزمة النشطة» |
| “الموضع ثابت لا يتحرك بعد التسميع” بتحفّظ | يعود المؤشّر إلى بداية المدى في كل جلسة. | «إعدادات القفز» على «تثبيت الموضع» — وهذا **إعداد خطة لا سلوك** |

> **قاعدتان ذهبيتان وتحذير:** **المراجعة:** المصدر حفظ، والهدف مراجعة، وحدّ النهاية يتبع الحفظ حتى لا تخرج المراجعة عمّا حُفظ.
> **التثبيت:** المصدر حفظ، والهدف تثبيت، والموضع = موضع الحفظ ناقص النافذة، بالاتجاه نفسه.
> وضبط الحدود **لا يثبّت المؤشّر**. إن أردت أن يعود الطالب إلى بداية المدى في كل جلسة، فاضبط «إعدادات القفز» في الخطة أيضاً.

> **لا توجد دالة «مضاعف»:** قاعدة “التثبيت أربعة أضعاف مقدار الحفظ” لا تنجزها أي دالة جاهزة؛ هي سكربت. راجع [أمثلة السكربتات](https://manual.misbah.pro/behavior-scripts) — وفيها السكربت المنشور نفسه.

> **الحزمة ليست جزءاً بالضبط:** تُقاس الحزم بالأسطر، والأجزاء الحقيقية ليست متساوية الأسطر. فـ“بداية الجزء” تنحرف حتى ‎−٤٣‎ سطراً — نحو ثلاث صفحات — عند الجزء الثلاثين. وأفضل ضبطٍ مقيس هو حجم حزمة يقارب ‎٣٠٠٫٣‎ سطر، فيهبط الانحراف إلى نصف صفحة تقريباً.

### كيف يعمل السلوك فعلاً: الربط

السلوك قاعدة معلّقة في الهواء حتى تربطه. والربط يعيش على **قالب الهدف** لا على المصدر — أي على القالب الذي ستُكتب فيه القيم.

1. افتح «سلوكيات الربط» وتفقّد المتاح
   الصفحة قسمان: «سلوكيات عامة» — “متاحة لجميع المساجد — للاستخدام في روابط القوالب” — و«سلوكيات المسجد» — “سلوكيات أنشأها مسؤولو مسجدك — يمكنك استخدامها وتعديلها”.
   أنشئ سلوكاً بنفسك فقط إن لم يكفك المتاح.
2. إن أنشأت سلوكاً: اضبط «آلية العمل»
   “اختر دالة نظام جاهزة أو اكتب سكربت JavaScript مخصصاً”. تبويبان: «دوال النظام» — “سلوكيات جاهزة” — و«سكربت مخصص».
   وفي حالة السكربت تحدّد بنفسك «الحقول المراقبة (المصدر)» — “عند تغيّر هذه الحقول في خطة المصدر يُنفَّذ السلوك.” — و«الحقول المستهدفة (الهدف)» — “الحقول التي يحدّثها السكربت في خطة الهدف.”
   ![نموذج السلوك عند تبويب دوال النظام مع الحقول المراقبة والمستهدفة](https://manual.misbah.pro/images/link-behaviors/02-behavior-form.png)
3. افتح قالب الهدف واذهب إلى «السلوكيات»
   في قالب المراجعة مثلاً، لا في قالب الحفظ. وهنا الملاحظة التي تحسم الالتباس: “السلوك يحدّد ماذا يحدث؛ الإعدادات في كل صف تخص هذا الربط فقط — يمكنك استخدام نفس السلوك بقيم مختلفة.”
4. اضغط «إضافة سلوك» واملأ الصف
   عمود «السلوك» يختار القاعدة، وعمود «قالب المرجع» يختار المصدر. وترك المرجع فارغاً يعني “هذا القالب (تلقائياً)” — أي أنّ الخطة تراقب نفسها.
   “عند تشغّل خطط المرجع، يُنفَّذ السلوك على خطط الطلاب المرتبطة بهذا القالب.”
   ![قسم السلوكيات داخل قالب خطة بصفّ ربط واحد وإعداداته](https://manual.misbah.pro/images/link-behaviors/03-template-links.png)
5. اضبط «إعدادات السلوك» في الصف نفسه
   الحقول التي يعلنها السلوك تظهر هنا بأسمائها العربية: عدد الأيام، حجم الحزمة بالأسطر، الإزاحة، مزامنة الاتجاه… وهي خاصةٌ بهذا الربط وحده.
   ولك أن تتجاوزها لمستوىً بعينه من «إعدادات الربط» داخل [المنهج](https://manual.misbah.pro/curriculum).
6. احفظ القالب، ثم جرّب على طالب واحد
   سجّل جلسة تسميع على خطة المصدر، ثم افتح خطة الهدف وتحقّق من أنّ ما تغيّر هو ما توقّعت.

> **من أين تأتي قيمة الإعداد:** `قيمة الإعداد = افتراض السلوك ← ثم إعداد الربط في القالب ← ثم إعداد الخطة نفسها`
> أي أنّ الأخير يغلب. والمنهج يكتب القيم المؤثِّرة على خطط الطلاب عند التطبيق.

### متى يعمل السلوك، وبأي ترتيب

معرفة لحظة التنفيذ تفسّر أكثر ما يبدو غريباً: لماذا تغيّرت خطةٌ لم يلمسها أحد، ولماذا لم تتغيّر أخرى بعد تعديل يدوي.

*المناسبات التي تُشغّل السلوكيات*
| المناسبة | ما يحدث |
| --- | --- |
| تسجيل نشاط أو تعديله أو حذفه مناسب | يتحرّك موضع المصدر، فتعمل كل السلوكيات التي تراقب حقلاً تغيّر. |
| تعديل يدوي على خطة للعلم | المعاملة نفسها: يُقارن ما قبل بما بعد، وتُشغَّل السلوكيات المعنيّة بما تغيّر. |
| إنشاء الخطة أو إعادة تطبيق المنهج بتحفّظ | حدثٌ خاص: تعمل السلوكيات المراقِبة **ولو لم يتغيّر حقل واحد** — وبه تُوضع الحدود والمواضع في أول يوم. |
| انتشار من سلوك آخر بتحفّظ | كتابة السلوك في الهدف قد توقظ سلوكاً يراقب ذلك الهدف، فتتسلسل السلاسل. |
| تعطيل خطة عند إخراج قالبها من المنهج | لا تُشغَّل السلوكيات؛ التعطيل لا يُعامَل معاملة الإنشاء. |

- تُنفَّذ روابط القالب **بترتيبها في القائمة**، وتُدمج مخرجاتها، ثم تُحفظ الخطة مرة واحدة.
- ثم تتكرّر العملية للقوالب التي تراقب الهدف — بكشفٍ للدورات وحدٍّ أقصى للعمق، فلا تدور السلسلة على نفسها إلى ما لا نهاية.
- وفشل سلوك في فرع لا يُسقط بقية الفروع: يُسجَّل الخطأ ويمضي الباقي.
- والسكربت لا يكتب إلا الحقول المعلنة في «الحقول المستهدفة (الهدف)»؛ وما عداها **يُهمَل في صمت**.

> **انتبه:** السلوك يعمل داخل صندوق محكم: تنفيذ متزامن، ومهلة نصف ثانية، وبلا وصول إلى الشبكة ولا إلى مكتبات خارجية. سكربتٌ ثقيل يتوقّف ولا يكتب شيئاً.

### نافذة الاختبار قبل أن تمسّ طالباً

لكل سلوك زرّ «اختبار» يفتح نافذةً تشغّله على خططٍ وهمية تصفها أنت، وتقارن مخرجاته بما تتوقّعه، دون أن يمسّ بياناتٍ حقيقية.

- **دالة النظام** — تبدّل الدالة المختبَرة مؤقّتاً لترى الفرق قبل الحفظ. وتُعلَّم بشارة “معدّل” ما دامت مخالفةً للمحفوظ.
- **إعدادات السلوك (للاختبار)** — “هذه القيم لا تُحفظ على السلوك؛ تحاكي إعدادات ربط القالب عند التشغيل.” — أي أنّها تقوم مقام ما ستكتبه في صف الربط.
- **السكربت** — محرّرٌ تعدّل فيه الكود وتجرّبه فوراً، ومعه «استعادة السكربت» و«استعادة الكل» للرجوع إلى المحفوظ.
- **الحقول المراقبة والمستهدفة** — تعدّلها للتجربة أيضاً، ويعرض العنوان عددها: كم حقلاً مراقباً وكم هدفاً.
- **حالات الاختبار** — تلصق فيها مصفوفة `testCases` بصيغة JSON، فتُشغَّل حالةً حالة ويظهر لكل واحدة [[نجح]] أو [[فشل]] مع “المتوقع مقابل الفعلي”.

وشكل الحالة ثابت: `name` للوصف، و`input` وفيه `updatedFields` و`oldPlan` و`updatedPlan` و`targetPlan`، ثم `expectedOutput` يُقارَن بما يكتبه السلوك مقارنةً دقيقة. اكتفِ بحقول الخطة التي يقرؤها السكربت فعلاً، واجعل الحالات ثلاثاً: حالة ناجحة، وحالة لا يعمل فيها السلوك، وحالة حدّية.

> **ملاحظة:** الترتيب المطلوب: **احفظ السلوك أولاً، ثم الصق حالات الاختبار**. وتقول الواجهة: “الصق مصفوفة testCases فقط. عند استخدام السكربت المحفوظ يُرسل behaviorId؛ عند تعديل السكربت يُرسل السكربت والحقول دون behaviorId.”
> وزرّ نسخ النتائج يضع تقريراً في الحافظة: “نتائج الاختبار في الحافظة — الصقها للوكيل الذكي”.

![نافذة اختبار السلوك بحالات الاختبار ونتائج النجاح والفشل](https://manual.misbah.pro/images/link-behaviors/04-test-modal.png)

### مزالق ومواضع طلب الدعم

هذه أعطالٌ صامتة: لا رسالة خطأ، وإنما خططٌ لا تتصرّف كما تتوقّع.

> **ترتيب الروابط مفتاحُ إعداداتها:** إعدادات الربط تُخزَّن على خطة الطالب بترتيب الروابط لا بأسمائها. فإن أعدت ترتيب صفوف «السلوكيات» في القالب، أو أدرجت صفاً في الوسط، صارت كل الإعدادات تشير إلى روابط أخرى.
> بعد أي تعديل على قائمة الروابط: أعِد تطبيق المناهج المستعملة، وتحقّق من قيم «إعدادات الربط» فيها.

> **المزامنة تمسح الضبط اليدوي:** إعدادات السلوك المكتوبة على خطة طالب بعينه تُستبدل بالكامل في كل مزامنة منهج. اضبطها في القالب أو في المنهج، لا على الخطة.

> **حقلٌ خارج القائمة لا يُكتب ولا يُشتكى منه:** إن كتب سكربتٌ حقلاً لم يُعلَن في «الحقول المستهدفة (الهدف)»، أُهمل بلا خطأ. فإذا “لم يفعل السلوك شيئاً” فأول ما تُراجعه قائمة الحقول المستهدفة.

> **سكربت منقوص أخطر من سكربت خطأ:** لصق سكربت مقتطع، أو تحرير إعدادات ربطٍ على خطة حيّة بيدك، هما أشيع طريقتين لكسر إعدادٍ كان يعمل.

#### متى تطلب الدعم بدل أن تبني

بعض المساجد تملك ورداً ورقياً يحدّد لكل يومٍ من→إلى صريحة، ومراجعتُه غير مشتقّة من حفظه أصلاً: قد يكون الحفظ في السجدة والمراجعة في الناس. لا مقدارٌ ولا نافذةٌ ولا حزمةٌ تعبّر عن هذا، والحلّ المعتمد فيه حزمة جدول تُبنى من الورق وتُدار بسكربت.

- تفاوتُ مقدار الحفظ اليومي بلا نمط.
- مدى المراجعة لا علاقة له بموضع الحفظ.
- الجدول لا ينضغط في بضعة أرقام، بل يحتاج عشرات الكيلوبايتات.

> **ملاحظة:** إن اجتمعت هذه العلامات الثلاث فالورد جدولُ أيام لا معادلة، وهذا موضع مراجعة الدعم بدل الاجتهاد. وإن تخلّفت واحدة منها، فالغالب أنّ إعدادات الخطة ودالةً جاهزة تكفيان.

### أسئلة شائعة

**أضفت السلوك ولم يحدث شيء — لماذا؟**
راجع أربعة أمور بالترتيب: هل الربط على قالب **الهدف** لا المصدر؟ وهل الصف مفعّل؟ وهل الحقل الذي تغيّر مذكور في «الحقول المراقبة (المصدر)»؟ وهل الحقل الذي تريد كتابته مذكور في «الحقول المستهدفة (الهدف)»؟

**أين أضبط قيم السلوك: في السلوك أم في الربط؟**
في الربط. السلوك يعلن الحقول وقيمها الافتراضية فقط: “قيم الإعدادات تُضبط عند ربط السلوك بقالب، وليس هنا.” ولتخصيص مستوى بعينه استخدم «إعدادات الربط» في المنهج.

**هل يمكن لسلوك أن يشغّل سلوكاً آخر؟**
نعم. كتابة السلوك في خطة الهدف قد توقظ سلوكاً يراقب تلك الخطة، فتتكوّن سلسلة. والنظام يكشف الدورات ويحدّ العمق، لكن السلسلة الطويلة تصعّب تتبّع ما غيّر ماذا.

**حذفت سلوكاً فما مصير الروابط التي تستعمله؟**
يحذّرك النظام أنّ السلوك مستخدم في عدد من الروابط، و“سيؤدي الحذف إلى تعطيل هذه الروابط”. عطّل الصفوف أو استبدل السلوك قبل الحذف.

**أريد التثبيت أربعة أضعاف مقدار الحفظ — أي دالة تفعل ذلك؟**
لا شيء من الدوال الجاهزة. هذه قاعدةُ سكربت، وهي منشورة جاهزة في قالب برنامج «المسار التقليدي». راجع [أمثلة السكربتات](https://manual.misbah.pro/behavior-scripts).

---

## أمثلة السكربتات

المصدر: https://manual.misbah.pro/behavior-scripts

سلوكيات الربط المكتوبة بسكربت، من مادة منشورة تعمل في مساجد حقيقية: «المسار التقليدي» و«موازنة تلقائية» بقوالبهما وروابطهما وسكربتاتهما كاملةً، مع حالات اختبار جاهزة.

الجمهور: مشرف

### حين لا تكفي الدوال الجاهزة

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

> **ملخّص سريع**
> - ما هذا؟ سلوك ربطٍ آليتُه كودٌ صغير يعمل في صندوق محكم، يقرأ خطتي المصدر والهدف ويعيد ما يُكتب في الهدف.
> - لماذا يهمّك؟ لأنّ القواعد المشروطة والتكيّفية لا تعبّر عنها الدوال الجاهزة، ولأنّ المنصة تنشر سكربتات جاهزة يستعملها مسجدك اليوم.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٣٠ دقيقة

هذه الصفحة **أمثلة لا مرجع لغة**. اقرأ [سلوكيات الربط](https://manual.misbah.pro/link-behaviors) أولاً لتفهم المصدر والهدف والحقول المراقبة والمستهدفة؛ ثم عُد إلى هنا لترى القواعد مكتوبةً بالفعل.

- **قالب البرنامج المنشور** — نسخة مجمّدة من برنامج كامل تنشرها المنصة أو مسجد آخر: قوالبه ومناهجه وسلوكياته معاً.
  أسرع طريق إلى إعدادٍ صحيح: تثبّت القالب فيصلك السكربت مربوطاً مضبوطاً بلا أن تكتب سطراً.
- **السلوك السكربتي** — دالة واحدة اسمها `onPlanChanged` تستقبل ما تغيّر وتعيد `{ updates }`.
  كل السكربتات التالية على هذا الشكل، فمتى قرأت واحداً قرأتها كلها.
- **حقول الإعداد** — مصفوفة `configFields` يعلنها السكربت، فتظهر للمشرف حقولاً عربية في صف الربط.
  بها يعدّل المشرف قاعدةً بلا كود: يكتب ثلاثة بدل أربعة في «عدد الأيام» فيتغيّر سلوك عشرات الخطط.
- **حالات الاختبار** — مصفوفة `testCases` تصف خططاً وهمية وما يُتوقَّع أن يكتبه السكربت عليها.
  هي الفرق بين تجربةٍ على الورق وتجربةٍ على أربعين طالباً.

> **السكربت يكتب في خطط حقيقية:** لا مراجعة بشرية بين ما يعيده السكربت وبين خطة الطالب. وسكربتٌ خطأ يزيح مواضع عشرات الطلاب في ثوانٍ، ولا توجد زرّ تراجع.
> الترتيب الآمن: **احفظ السلوك ← شغّل حالات الاختبار ← اربطه بقالب في برنامج تجريبي ← جرّب على طالب واحد ← ثم انشره**.

### أي مثال يناسب مسجدك

الأمثلة التالية ليست تمارين: اثنان منها قالبان منشوران مثبَّتان في مساجد، والثالث أدوات صغيرة تُركَّب على ما عندك.

#### من أين تبدأ؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| المسار التقليدي (الأنسب غالباً) | تريد البنية المعتادة: حفظ وتثبيت ومراجعة، بمقدارٍ يحدّده المشرف لكل مستوى. | قالب منشور مثبَّت أكثر من تسعين مرة، بأربعة مناهج جاهزة للسرعات: وجه، نصف وجه، وجه ونصف، وجهان. | يفترض أنّك تعرف مستوى الطالب مسبقاً وتضعه في المنهج المناسب. |
| موازنة تلقائية (متقدّم) | لا تعرف مستوى الطلاب، وتريد أن يستنتجه النظام من أول تسميعاتهم ثم يوازن المسارات الثلاثة بلا تدخّل. | “إنشاء برنامجك في دقيقتين”: تبدأ الخطط الثلاث حرّة، ثم يحوّلها السكربت إلى ثابتة بمقدارٍ مقيس من أداء الطالب نفسه. | يحتاج تسميعات أولى نظيفة؛ وقراءات متذبذبة تؤخّر التسكين. ولا يظهر للمشرف قرارٌ يراجعه قبل وقوعه. |
| سكربتات مساعدة (الافتراضي) | بنيتك قائمة وتريد إضافة قاعدة واحدة: تحديد مقدار من متوسط التسميعات، أو قلب الاتجاه بالتقييم. | قصيرة يسهل فهمها وتعديلها، وتُركَّب على قالبٍ موجود دون إعادة بناء البرنامج. | تفعل شيئاً واحداً؛ ودمج عدّة قواعد يحتاج انتباهاً لترتيب الروابط. |

> **نصيحة:** القالبان المنشوران يُثبَّتان عند إنشاء برنامج جديد من مسار «أو من قالب». والتثبيت **نسخ لا اشتراك**: تصير النسخة ملكك تعدّلها كما تشاء، ولا يصلك تحديث صاحبها بعدها. راجع [قوالب البرامج](https://manual.misbah.pro/program-templates).

### المثال الأول: «المسار التقليدي»

قالب برنامج موثّق مثبَّت ثلاثاً وتسعين مرة، وصفه: “نظام متكامل يدمج بين الحفظ، التثبيت، والمراجعة مع ميزة الربط التلقائي”. وقاعدته الأساسية معلنة في وصفه: “التثبيت يتبع مسار الحفظ ولا يتجاوزه أبداً”.

#### المشكلة التي يحلّها

في الحلقة التقليدية يسمّع الطالب ثلاثة أشياء كل يوم: جديدَه، وما قرب منه، وما بعد. وموضع التثبيت ليس اختياراً مستقلاً، بل مسافةٌ خلف الحفظ تتحرّك معه. فإن ضبطه المشرف يدوياً، لزمه أن يعيد ضبطه لكل طالب بعد كل جلسة — وهذا ما يجعل الحلقة تتوقّف عن استعمال النظام بعد أسبوعين.

#### القاعدة بالعربية

> **قاعدة التثبيت:** `موضع التثبيت = موضع الحفظ − (عدد الأيام × مقدار الحفظ اليومي)`
> `مقدار التثبيت اليومي = عدد الأيام × مقدار الحفظ اليومي`
> ونهاية مدى التثبيت تقف عند الآية التي تسبق موضع الحفظ، فلا يسبق التثبيتُ الحفظَ أبداً.

*الجدول التوضيحي المنشور مع القالب*
| الحالة | مقدار الحفظ اليومي | موضع الحفظ | التأخير | موضع بدء التثبيت |
| --- | --- | --- | --- | --- |
| المثال الأول للعلم | وجه واحد | الوجه ١٠ | ٤ أوجه | الوجه ٦ |
| المثال الثاني للعلم | وجهان | الوجه ٢٠ | ٨ أوجه | الوجه ١٢ |
| بعد التسميع مناسب | وجهان | الوجه ٢٢ | ٨ أوجه | الوجه ١٤ |

#### قوالب الخطط الثلاثة

*ما في القالب المنشور*
| القالب | النمط | المقدار | إعدادات القفز | وحدة النقاط |
| --- | --- | --- | --- | --- |
| حفظ مناسب | حصة ثابتة صعوداً من الناس | سطر واحد — قيمةٌ يُفترض أن يتجاوزها المنهج | بناءً على آخر تقدم | ذهب |
| تثبيت للعلم | حصة ثابتة صعوداً | ٦٠ سطراً — يعيد السكربت حسابها | قفز مقدار محدد بخمسة عشر سطراً | فضة |
| مراجعة | حصة ثابتة صعوداً | ٣٠ سطراً | بناءً على آخر تقدم | بلا وحدة |

> **ملاحظة:** لاحظ أنّ مقدار قالب «حفظ» سطرٌ واحد. ليس خطأً: المناهج الأربعة هي التي تحدّد السرعة — «وجه» يكتب ١٥ سطراً، و«نصف وجه» ٧٫٥، و«وجه ونصف» ٢٢٫٥، و«وجهان» ٣٠ — والقالب مجرّد وعاء. راجع [المناهج الدراسية](https://manual.misbah.pro/curriculum).

#### كيف رُبطت السلوكيات

```jsonc
// قالب «تثبيت» — يراقب قالب «حفظ» (الفهرس 0)
{
  "watchedTemplateIndex": 0,
  "behaviorIndex": 0,
  "enabled": true
}

// قالب «مراجعة» — يراقب قالب «حفظ» بدالة نظام جاهزة
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "ربط الحد الأعلى",
  "enabled": true
}
```
*روابط القوالب كما هي في القالب المنشور — الفهرس 0 هو قالب «حفظ»*

قالب «حفظ» بلا روابط: هو المصدر لا الهدف. وقالب «تثبيت» يربط سكربت «تثبيت» بالحفظ. وقالب «مراجعة» يستعمل دالة نظام جاهزة اسمها المنشور «ربط الحد الأعلى»، ووصفها: “يقوم هذا السلوك بمراقبة تقدم أو الموضع الحالي للخطة المراقبة ويقوم بتحديث الحد الأعلى أو الحد الأدنى للخطة المستهدفة” — أي أنّ المراجعة لا تحتاج سكربتاً أصلاً.

#### السلوك: الحقول والإعداد

- **الحقول المراقبة** — `progress` و`amount` و`direction` — أي موضع الحفظ ومقداره واتجاهه.
- **الحقول المستهدفة** — `progress` و`amount` و`direction` و`startSurah` و`startAya` وحدّا التنقل `navigationSettings.upperBound` و`navigationSettings.lowerBound` و`mode`.
- **حقل الإعداد الوحيد** — «عدد الأيام» (`MULTIPLIER`)، رقم، افتراضه أربعة وأدناه واحد. وهو ما يضبطه المشرف في صف الربط أو في «إعدادات الربط» داخل المنهج.

#### السكربت كاملاً

```js
/**
 * link-behavior-config
 * watched: progress, amount, direction
 * target: progress, amount, direction, startSurah, startAya, navigationSettings.upperBound, navigationSettings.lowerBound, mode
 */
function onPlanChanged(input) {
    if (input.updatedPlan.type !== "quran" || input.targetPlan.type !== "quran") {
        return { updates: {} };
    }

    var updates = {};
    var dir = Number(input.updatedPlan.direction) || 1;

    // 1. مزامنة الاتجاه: التأكد من مطابقة اتجاه الهدف لمصدر التغيير
    if (input.targetPlan.direction !== dir) {
        updates.direction = dir;
    }

    var fullMushafNav = buildNavSettings(null);

    // 2. جلب قيمة التكوين الخاصة بـ "عدد الأيام" من الإعدادات
    var MULTIPLIER = (typeof config !== "undefined" && config && config.MULTIPLIER !== undefined)
                     ? Number(config.MULTIPLIER)
                     : 4;

    var hifzAmount = Number(input.updatedPlan.amount) || 15;

    // 3. مزامنة المقدار: مقدار الهدف = عدد الأيام × مقدار المصدر
    var targetAmount = MULTIPLIER * hifzAmount;
    if (!Number.isFinite(targetAmount) || targetAmount < 1) {
        return { updates: {}, errors: ["مقدار التثبيت غير صالح"] };
    }
    if (Number(input.targetPlan.amount) !== targetAmount) {
        updates.amount = targetAmount;
    }

    var newHifzPos = {
        sura: input.updatedPlan.progress.currentSurah,
        aya: input.updatedPlan.progress.currentAya
    };

    var currentTathbeetPos = {
        sura: input.targetPlan.progress.currentSurah,
        aya: input.targetPlan.progress.currentAya
    };

    var finalTathbeetPos = currentTathbeetPos;
    var forceReposition = false;

    var prevVerseObj = mushaf.previousVerse(newHifzPos, dir, fullMushafNav);
    var endBoundPos = prevVerseObj ? { sura: prevVerseObj.sura, aya: prevVerseObj.number } : newHifzPos;

    var minAllowedDist = MULTIPLIER * hifzAmount;
    var maxAllowedDist = (MULTIPLIER + 1) * hifzAmount;

    var isOut = mushaf.isOutOfBounds(currentTathbeetPos, dir, {
        upperBound: dir === 1 ? fullMushafNav.upperBound : endBoundPos,
        lowerBound: dir === 1 ? endBoundPos : fullMushafNav.lowerBound
    });

    if (isOut) {
        forceReposition = true;
    } else {
        var currentDist = mushaf.calculateLines(currentTathbeetPos, newHifzPos, dir, fullMushafNav);
        if (currentDist < minAllowedDist || currentDist > maxAllowedDist) {
            forceReposition = true;
        }
    }

    if (forceReposition) {
        var targetRes = mushaf.reverseNavigate({
            from: newHifzPos,
            lines: minAllowedDist,
            direction: dir,
            settings: fullMushafNav
        });
        if (!targetRes || !targetRes.verse) {
            return { updates: {}, errors: ["تعذر حساب موضع التثبيت"] };
        }

        finalTathbeetPos = {
            sura: targetRes.verse.sura,
            aya: targetRes.verse.number
        };

        updates.progress = {
            currentSurah: finalTathbeetPos.sura,
            currentAya: finalTathbeetPos.aya
        };
    }

    var isTargetFirst = finalTathbeetPos.sura < endBoundPos.sura ||
                       (finalTathbeetPos.sura === endBoundPos.sura && finalTathbeetPos.aya <= endBoundPos.aya);

    var newUpper = isTargetFirst ? { sura: finalTathbeetPos.sura, aya: finalTathbeetPos.aya } : { sura: endBoundPos.sura, aya: endBoundPos.aya };
    var newLower = isTargetFirst ? { sura: endBoundPos.sura, aya: endBoundPos.aya } : { sura: finalTathbeetPos.sura, aya: finalTathbeetPos.aya };

    var oldUpper = input.targetPlan.navigationSettings && input.targetPlan.navigationSettings.upperBound;
    var oldLower = input.targetPlan.navigationSettings && input.targetPlan.navigationSettings.lowerBound;

    if (!oldUpper || oldUpper.sura !== newUpper.sura || oldUpper.aya !== newUpper.aya) {
        updates["navigationSettings.upperBound"] = newUpper;
    }
    if (!oldLower || oldLower.sura !== newLower.sura || oldLower.aya !== newLower.aya) {
        updates["navigationSettings.lowerBound"] = newLower;
    }

    var keys = getDirectionalBoundKeys(dir);
    var startBound = keys.startBound === "upperBound" ? newUpper : newLower;
    if (Number(input.targetPlan.startSurah) !== startBound.sura) {
        updates.startSurah = startBound.sura;
    }
    if (Number(input.targetPlan.startAya) !== startBound.aya) {
        updates.startAya = startBound.aya;
    }

    // تحويل حرّة/ديناميكية → ثابتة؛ لا يُستدعى إن كانت ثابتة أصلاً
    var modeTrans = undefined;
    if (input.targetPlan.mode !== "static") {
        var r = PlanConverter.toStatic(input.targetPlan, {
            amount: targetAmount,
            reason: "sync:tathbeet-made-static",
            progress: {
                currentSurah: finalTathbeetPos.sura,
                currentAya: finalTathbeetPos.aya
            },
            startSurah: startBound.sura,
            startAya: startBound.aya,
            direction: dir,
            navigationSettings: { upperBound: newUpper, lowerBound: newLower }
        });
        if (!r.ok) {
            return { updates: {}, errors: r.errors };
        }
        modeTrans = r.modeTransition;
    }

    if (Object.keys(updates).length === 0 && !modeTrans) {
        return { updates: {} };
    }

    var output = { updates: updates };
    if (modeTrans) {
        output.modeTransition = modeTrans;
    }
    return output;
}
```
*سكربت «تثبيت» المنشور على مستوى المنصة، بتعليقاته العربية*

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

> **تفصيلان يستحقّان الانتباه:** لا يقلب السكربت `direction` ليتأخّر عن الحفظ؛ يرجع بالاتجاه نفسه. فقلب الاتجاه يغيّر مسار الطالب في المصحف لا موضعه فحسب.
> و`mode` لا يُكتب داخل `updates` أبداً؛ التحويل يمرّ عبر `PlanConverter` ويعود في `modeTransition`. وهذا شرطٌ لا اختيار أسلوب.

#### حالة اختبار للبداية

مخرجات هذا السكربت تعتمد على حساب المصحف، فابدأ بالحالة التي لا تحتاج حساباً — خطة ليست قرآنية يجب ألا يكتب فيها شيئاً — ثم أضف حالةً حقيقية بعد أن تقرأ ما كتبه فعلاً في نافذة الاختبار.

#### متى تختاره

- حين يكون عندك ثلاثة مسارات معتادة، ويحدّد المشرف السرعة بنفسه لكل مستوى.
- حين تريد نتيجةً يمكن شرحها للمعلّم في جملة: “التثبيت خلف الحفظ بأربعة أيام”.
- ولا تختره إن كان مدى مراجعتك غير مشتقٍّ من الحفظ أصلاً — تلك حالة الورد الورقي، وموضعها الدعم.

![بطاقة قالب البرنامج المسار التقليدي في مكتبة القوالب](https://manual.misbah.pro/images/behavior-scripts/01-template-card.png)

### المثال الثاني: «موازنة تلقائية»

قالب موثّق مثبَّت إحدى وعشرين مرة، وصفه: “برنامج يتيح لك إنشاء برنامجك في دقيقتين فقط؛ ليتولى تلقائياً معادلة مسارات الحفظ والتثبيت والمراجعة دون أي تدخل إداري، مع تحديد مستوى الطالب بدقة عالية”.

#### المشكلة التي يحلّها

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

#### القاعدة بالعربية

> **قاعدة تحديد المستوى:** `المقدار اليومي = المتوسط الحسابي للتلاوات القريبة من الوسيط`
> يُجمَع مقدار كل تسميع، فإذا بلغ عددها «عدد التلاوات للمراقبة» حُسب الوسيط، واستُبعد كل ما خرج عن ±«نسبة التفاوت المقبولة». فإن بقي **ستون بالمئة** من القراءات على الأقل داخل النطاق، عُدّ الأداء مستقرّاً وحُوّلت الخطة إلى ثابتة بمتوسط ما بقي مقرَّباً.
> وإن لم يستقرّ، حُذفت أقدم قراءة وانتُظرت تلاوة جديدة — نافذةٌ متدحرجة لا رفضٌ نهائي.

#### قوالب الخطط وروابطها

*الفرق الجوهري عن المسار التقليدي*
| القالب | النمط عند الإنشاء | من يراقب ماذا | وحدة النقاط |
| --- | --- | --- | --- |
| حفظ مناسب | حصة حرة صعوداً من الناس | **يراقب نفسه** بسلوك «تحديد المستوى التلقائي» | ذهب |
| تثبيت للعلم | حصة حرة | يراقب «حفظ» بسلوك «تثبيت» و«عدد الأيام» ثلاثة | فضة |
| مراجعة بتحفّظ | حصة حرة | رابطان: «ربط الحد الأعلى» على «حفظ»، و«تحديد المستوى التلقائي» على نفسها | فضة |

```jsonc
// قالب «حفظ» (الفهرس 0) — يراقب نفسه
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "تحديد المستوى التلقائي",
  "enabled": true,
  "config": { "observationCount": 2, "tolerancePercent": 10 }
}

// قالب «تثبيت» (الفهرس 1) — يراقب «حفظ»
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "تثبيت",
  "enabled": true,
  "config": { "MULTIPLIER": 3 }
}

// قالب «مراجعة» (الفهرس 2) — رابطان
{
  "watchedTemplateIndex": 0,
  "platformBehaviorId": "ربط الحد الأعلى",
  "enabled": true,
  "config": { "syncDirection": true }
}
{
  "watchedTemplateIndex": 2,
  "platformBehaviorId": "تحديد المستوى التلقائي",
  "enabled": true,
  "config": { "observationCount": 2, "tolerancePercent": 10 }
}
```
*روابط القوالب الثلاثة — لاحظ الرابط الذي يشير إلى فهرس قالبه نفسه*

> **خطةٌ تراقب نفسها:** الرابط الذي يجعل `watchedTemplateIndex` مساوياً لفهرس القالب نفسه ليس خطأً: هو الطريقة التي يقرأ بها السلوك تسميعات الخطة ذاتها ليعدّل مقدارها. وفي الواجهة تصل إلى هذا بترك «قالب المرجع» فارغاً، فيظهر “هذا القالب (تلقائياً)”.

#### السلوك: الحقول والإعداد

- **الحقول المراقبة** — `progress` و`numberOfActivities` — يكفي أن يسجَّل نشاط جديد.
- **الحقول المستهدفة** — `amount` و`mode`، إضافةً إلى مفاتيح `metadata` التي يخزّن فيها القراءات المتراكمة.
- **عدد التلاوات للمراقبة** — `observationCount` — افتراضه خمسة، وقالب «موازنة تلقائية» يخفضه إلى اثنين ليسكّن الطالب بسرعة.
- **نسبة التفاوت المقبولة (±%)** — `tolerancePercent` — افتراضه عشرة. كلّما رفعته قبِلت قراءاتٍ أبعد عن الوسيط، فاستقرّ المقدار أسرع وأقلّ دقة.

#### السكربت كاملاً

```js
/**
 * link-behavior-config
 * watched: progress, numberOfActivities
 * target: amount, metadata, mode
 */function onPlanChanged(input) {
  if (input.changeKind !== "activity") return { updates: {} };
  if (input.trigger.action !== "created") return { updates: {} };

  var meta = input.targetPlan.metadata || {};

  if (meta.evaluationDone) return { updates: {} };

  var updates = {};
  var modeTrans = undefined;

  // التأكد من أن الخطة حرة أثناء التقييم
  if (input.targetPlan.mode !== "free") {
     var freeResult = PlanConverter.toFree(input.targetPlan, { reason: "adaptive:evaluation-phase" });
     if (freeResult.ok) modeTrans = freeResult.modeTransition;
  }

  var amounts = meta.recitationAmounts || [];
  var currentAmount = input.trigger.activity.amount;

  if (currentAmount > 0) amounts.push(currentAmount);

  if (amounts.length < config.observationCount) {
    updates["metadata.recitationAmounts"] = amounts;
    var out = { updates: updates };
    if (modeTrans) out.modeTransition = modeTrans;
    return out;
  }

  // حساب الوسيط
  var sorted = amounts.slice().sort(function(a, b) { return a - b; });
  var mid = Math.floor(sorted.length / 2);
  var median = sorted.length % 2 !== 0 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2.0;

  var tolerance = config.tolerancePercent / 100.0;
  var minAccepted = median * (1 - tolerance);
  var maxAccepted = median * (1 + tolerance);

  var validAmounts = [];
  var sum = 0;
  for (var i = 0; i < amounts.length; i++) {
    if (amounts[i] >= minAccepted && amounts[i] <= maxAccepted) {
      validAmounts.push(amounts[i]);
      sum += amounts[i];
    }
  }

  // --- شرط الاستقرار الجديد ---
  // يجب أن يكون 60% على الأقل من القراءات (3 من 5) ضمن النطاق المقبول
  var requiredStableCount = Math.ceil(config.observationCount * 0.6);
  
  if (validAmounts.length < requiredStableCount) {
      // القراءات متذبذبة! نحذف أقدم قراءة وننتظر تلاوة جديدة (Rolling Window)
      amounts.shift(); 
      updates["metadata.recitationAmounts"] = amounts;
      var pendingOut = { updates: updates };
      if (modeTrans) pendingOut.modeTransition = modeTrans;
      return pendingOut;
  }

  // القراءات مستقرة! نحسب المتوسط ونحول الخطة
  var average = sum / validAmounts.length;
  var finalAmount = Math.round(average); 

  var staticResult = PlanConverter.toStatic(input.targetPlan, {
    amount: finalAmount,
    reason: "adaptive:evaluation-finished"
  });

  if (!staticResult.ok) return { updates: {}, errors: staticResult.errors };

  updates["metadata.recitationAmounts"] = null;
  updates["metadata.evaluationDone"] = true;

  return {
    updates: updates,
    modeTransition: staticResult.modeTransition
  };
}
```
*سكربت «تحديد المستوى التلقائي» المنشور على مستوى المنصة*

> **نصيحة:** لاحظ الحارس الأول: `metadata.evaluationDone`. متى سُكِّن الطالب توقّف السكربت عن العمل إلى الأبد على تلك الخطة. فإن أردت إعادة تقييم طالب، امحُ هذا المفتاح من بيانات خطته — وهذا تدخّلٌ متقدّم لا يُجرى إلا بعلم.

#### حالات اختبار جاهزة

```json
[
  {
    "name": "لا يعمل إلا مع نشاط جديد",
    "input": {
      "changeKind": "manual",
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "mode": "free", "metadata": {} }
    },
    "expectedOutput": {}
  },
  {
    "name": "يخزّن أول تلاوة ولا يحوّل الخطة بعد",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "amount": 15 } },
      "updatedFields": ["progress", "numberOfActivities"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "mode": "free", "metadata": {} }
    },
    "expectedOutput": { "metadata.recitationAmounts": [15] }
  }
]
```
*الصقها في «حالات الاختبار» بعد حفظ السلوك*

#### متى تختاره

- حين يدخل الطلاب دفعةً واحدة ولا وقت لتقدير مستوى كل واحد.
- حين يقبل المسجد أن يقرّر النظام المقدار بدل المشرف.
- ولا تختره إن كانت سرعات المستويات مقرّرةً في ورقٍ معتمد — عندئذٍ المناهج أصدق من القياس.

### سكربتان قصيران يُركَّبان على ما عندك

ليس كل سكربت خمسة آلاف حرف. هذان مثالان منشوران لا يتجاوز أحدهما صفحةً، ويصلحان قاعدةً تبني عليها سكربتك الأول.

#### «التقييم التكيفي لمستوى الطالب»

وصفه المنشور: “يقوم السلوك بتحليل أول 4 جلسات تسميع للطالب تلقائياً، مع استبعاد النتائج الشاذة، لتحديد متوسط أداء الطالب واعتماده كمقدار يومي مقترح للخطة”. يراقب `totalGainedAmount` وحده، ويكتب `amount` وحده، وحقل إعداده «عدد التسميعات المطلوبة» افتراضه أربعة.

> **شرط التقارب:** `(أكبر التسميعات − أصغرها) ≤ ٠٫٤ × متوسطها`
> فإن تحقّق، اعتُمد المتوسط مقرَّباً مقداراً يومياً ورُفعت راية الانتهاء. وإلا انتُظرت جلسة أخرى.

```js
/**
 * link-behavior-config
 * watched: totalGainedAmount
 * target: amount, metadata.initialRecitations, metadata.hasDeterminedLevel, metadata.lastTotalGained
 */function onPlanChanged(input) {
  if (input.updatedPlan.type !== "quran") return { updates: {} };
  
  var meta = input.targetPlan.metadata || {};
  if (meta.hasDeterminedLevel) {
    return { updates: { "metadata.lastTotalGained": input.updatedPlan.totalGainedAmount } };
  }

  var gained = input.updatedPlan.totalGainedAmount - (meta.lastTotalGained || 0);
  if (gained <= 0) return { updates: {} };

  var recitations = meta.initialRecitations || [];
  recitations.push(gained);
  
  var updates = {
    "metadata.lastTotalGained": input.updatedPlan.totalGainedAmount,
    "metadata.initialRecitations": recitations
  };

  var targetCount = (typeof config !== 'undefined' && config.targetSessions !== undefined) ? config.targetSessions : 4;

  // التحقق من التقارب فقط عند الوصول للعدد المطلوب أو أكثر
  if (recitations.length >= targetCount) {
    // نأخذ آخر 4 تسميعات للتحقق من تقاربها
    var lastFour = recitations.slice(-targetCount);
    var min = Math.min.apply(null, lastFour);
    var max = Math.max.apply(null, lastFour);
    var sum = 0;
    for (var k = 0; k < lastFour.length; k++) sum += lastFour[k];
    var avg = sum / lastFour.length;

    // شرط التقارب: الفرق بين الأكبر والأصغر لا يتجاوز 40% من المتوسط (قابل للتعديل)
    if ((max - min) <= (avg * 0.4)) {
      updates.amount = Math.round(avg);
      updates["metadata.hasDeterminedLevel"] = true;
    }
  }

  return { updates: updates };
}
```
*سكربت «التقييم التكيفي لمستوى الطالب»*

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

#### «تحديد الإتجاه»

أقصر مثال مفيد: يراقب الموضع، ويكتب `direction` وحده، وبلا حقول إعداد. يقرأ تقييم الجلسة، فإن كان ضعيفاً قلب المسار صعوداً نحو قصار السور، وإن كان ممتازاً قلبه نزولاً.

```js
/**
 * link-behavior-config
 * watched: progress
 * target: direction
 */

function onPlanChanged(input) {
  // التأكد من أن التغيير ناتج عن نشاط مسجل
  if (input.changeKind !== "activity" || input.trigger.action !== "created") {
    return { updates: {} };
  }

  var act = input.trigger.activity;

  // التأكد من وجود تقييم للنشاط
  if (typeof act.rating !== "number") {
    return { updates: {} };
  }

  var currentDirection = input.targetPlan.direction;
  var newDirection = currentDirection;

  // تقييم 90 أو أقل (خصم 10 فأكثر) -> من الناس للفاتحة
  if (act.rating <= 90) {
    newDirection = -1;
  } 
  // تقييم 107 أو أعلى (زيادة 7 فأكثر) -> من الفاتحة للناس
  else if (act.rating >= 107) {
    newDirection = 1;
  }

  // تحديث الاتجاه فقط إذا كان هناك تغيير فعلي
  if (newDirection !== currentDirection) {
    return { updates: { direction: newDirection } };
  }

  return { updates: {} };
}
```
*سكربت «تحديد الإتجاه»*

```json
[
  {
    "name": "تقييم ضعيف يقلب الاتجاه صعوداً",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "rating": 85 } },
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "direction": 1 }
    },
    "expectedOutput": { "direction": -1 }
  },
  {
    "name": "تقييم متوسط لا يغيّر شيئاً",
    "input": {
      "changeKind": "activity",
      "trigger": { "action": "created", "activity": { "rating": 100 } },
      "updatedFields": ["progress"],
      "oldPlan":     { "id": "w", "type": "quran" },
      "updatedPlan": { "id": "w", "type": "quran" },
      "targetPlan":  { "id": "t", "type": "quran", "direction": 1 }
    },
    "expectedOutput": {}
  }
]
```
*حالتا اختبار لـ«تحديد الإتجاه»*

> **انتبه:** التقييم في مصباح ليس من مئة فحسب: مئةٌ تعني بلوغ المطلوب، وما فوقها أداءً أفضل من المتوقّع. ولهذا يستعمل السكربت العتبتين ٩٠ و١٠٧ لا ٥٠ و٩٠. راجع [القواعد وأثرها في التقييم](https://manual.misbah.pro/quran-plans#settings).

> **تحذير:** سكربتٌ يغيّر اتجاه الحفظ يقلب مسار الطالب في المصحف كلّه، لا موضعه فقط. لا تفعّله على برنامج قائم قبل أن تجرّبه على تسجيل واحد وتقرأ أثره في [جدول متابعة الخطط](https://manual.misbah.pro/plan-progress).

### تشريح أي سكربت: القالب الذي لا يتغيّر

كل سكربت في هذه الصفحة — ومنها الخمسة آلاف حرف — مبنيٌّ على الهيكل نفسه. متى عرفت أجزاءه الأربعة، صرت تقرأ أي سلوك وتحكم عليه.

```js
/**
 * link-behavior-config
 * watched: progress
 * target: progress, navigationSettings.lowerBound
 */
const configFields = [
  {
    "id": "sessionWindow",
    "name": "عدد جلسات الحفظ الأخيرة",
    "type": "number",
    "required": false,
    "default": 3,
    "validation": { "min": 1 }
  }
];

function onPlanChanged(input) {
  if (input.updatedPlan.type !== "quran") return { updates: {} };
  if (!input.updatedFields.includes("progress")) return { updates: {} };

  // أسطر التأخير = عدد الجلسات × مقدار جلسة الحفظ
  var offset = config.sessionWindow * (input.updatedPlan.amount || 15);
  return COPY_PROGRESS({ positionOffset: offset, stepBackward: true });
}
```
*الهيكل المطلوب: تعليق الإعداد، ثم حقول الإعداد، ثم الدالة*

*الأجزاء الأربعة*
| الجزء | وظيفته | قاعدة لا تُخالَف |
| --- | --- | --- |
| تعليق `link-behavior-config` بتحفّظ | يعلن الحقول المراقبة والمستهدفة، فتؤشّرها الواجهة تلقائياً. | يجب أن يذكر **كل** مفتاح يكتبه السكربت، وإلا أُهمل عند التشغيل. |
| `configFields` بتحفّظ | يعرّف حقول المشرف العربية وقيمها الافتراضية. | الاسم `configFields` حرفياً، وما بعد المساواة JSON صارم بلا تعليقات ولا فاصلة زائدة، ولكل حقل قيمة افتراضية. |
| `onPlanChanged(input)` مناسب | الدالة التي تعمل عند كل تغيّر مراقَب. | تبدأ بحُرّاس: نوع الخطة، ونوع التغيير، وهل الحقل المعني ضمن ما تغيّر. |
| `testCases` للعلم | حالات تُلصق في نافذة الاختبار، ولا تُحفظ مع السلوك. | حالةٌ ناجحة، وحالةٌ لا يعمل فيها السلوك، وحالةٌ حدّية — ثلاثٌ تكفي. |

#### ماذا يصل إلى الدالة

- **input.changeKind** — سبب التشغيل: `activity` لنشاط، أو `manual` لتعديل يدوي، أو `link_propagation` لانتشار من سلوك آخر، أو `land` عند إنشاء الخطة أو إعادة تطبيق المنهج.
- **input.updatedFields** — ما تغيّر في المصدر. وقد تكون فارغة في حالة `land` — والسلوك يعمل رغم ذلك، فاحترس من حارسٍ يعتمد عليها وحدها.
- **input.oldPlan وinput.updatedPlan** — خطة المصدر قبل التغيير وبعده.
- **input.targetPlan** — الخطة التي ستُكتب فيها المخرجات.
- **input.trigger.activity** — حين يكون السبب نشاطاً: `amount` و`requiredAmount` و`rating`، ومع التسميع مواضع البداية والنهاية.
- **config** — قيم حقول الإعداد بعد دمجها: الافتراضات، ثم إعداد الربط في القالب، ثم إعداد الخطة نفسها.

#### ماذا تعيد الدالة

- `{ updates: {} }` تعني: لا شيء يتغيّر. وهي الجواب الصحيح في أكثر الاستدعاءات.
- `updates` تقبل المفاتيح المعلنة في `target` وحدها، ومنها مفاتيح `metadata.*` لحفظ الحالة.
- `errors` مصفوفة رسائل تُسجَّل حين يتعذّر الحساب.
- `modeTransition` هو **الطريق الوحيد** لتغيير نمط الخطة، ولا يأتي إلا من `PlanConverter`.

> **حدودٌ لا تتجاوزها:** الصندوق متزامن، ومهلته نصف ثانية، ولا `import` فيه ولا وصول إلى الشبكة؛ والمتاح `Math` و`JSON` و`Array` و`Object` فقط.
> وبيانات `metadata` محدودة: عشرون مفتاحاً على الأكثر، والمصفوفة عشرون عنصراً، والمجموع ثمانية كيلوبايتات، وبلا تعشيش.
> وحدّا التنقل ليسا بدايةً ونهاية بالمعنى الدلالي: الأعلى أسبق في ترتيب المصحف والأدنى أتأخر، ومَن منهما البداية يقرّره الاتجاه.

> **نصيحة:** تعرض نافذة الاختبار زرّاً يكتب “نتائج الاختبار في الحافظة — الصقها للوكيل الذكي”، والواجهة نفسها تتيح نسخ دليل كتابة السكربتات كاملاً: “انسخ الدليل والصقه في الوكيل، ثم الصق السكربت والاختبارات هنا.” وهذه أسرع طريقة عملية إلى سكربت صحيح.

![محرّر سكربت السلوك مع تعليق الإعداد وحقول الإعداد المولّدة](https://manual.misbah.pro/images/behavior-scripts/02-script-editor.png)

### أسئلة شائعة

**هل أحتاج أن أكتب سكربتاً لأستفيد من هذه الأمثلة؟**
لا. «المسار التقليدي» و«موازنة تلقائية» قالبا برنامج منشوران: أنشئ برنامجاً من قالب فيصلك كل شيء مربوطاً. ولا تحتاج الكود إلا إن أردت تعديل القاعدة نفسها.

**عدّلت رقماً في السكربت فتوقّف عن العمل — ما أوّل ما أفحصه؟**
تعليق `link-behavior-config` في أعلى السكربت. إن كتبت مفتاحاً غير مذكور في سطر `target` أُهمل في صمت بلا رسالة خطأ.

**كيف أغيّر مسافة التثبيت من أربعة أيام إلى ثلاثة؟**
لا تمسّ السكربت. غيّر قيمة «عدد الأيام» في صف الربط داخل قالب «تثبيت»، أو في «إعدادات الربط» داخل المنهج إن أردت قيمةً لمستوى بعينه.

**ما الفرق بين سلوك عام وسلوك مسجد؟**
السلوك العام تنشره المنصة ويتاح لكل المساجد للاستعمال في روابط القوالب، وسلوك المسجد ينشئه مسؤولوه ويعدّلونه محلياً. والقوالب المنشورة تشير إلى السلوكيات العامة بمعرّفاتها، فتصلك مع القالب.

**هل يمكنني نسخ سكربت من هنا ولصقه كما هو؟**
نعم، السكربتات هنا كاملة كما تعمل. والشرط أن تلصقه كاملاً — فالسكربت المقتطع أخطر من الخطأ الصريح — وأن تُعلن حقوله المراقبة والمستهدفة كما في تعليقه، ثم تجرّبه في نافذة الاختبار قبل ربطه.

---

## الحلقات والتسميع

المصدر: https://manual.misbah.pro/teaching

ما يفعله المعلّم في حلقته: يفتحها على تاريخ اليوم، يسجّل الحضور فيُفتح له التسميع، ثم يوثّق ما سُمِّع فعلاً — فيتقدّم موضع الخطة وحده.

الجمهور: معلّم، مشرف

### الحلقة سلسلة، لا شاشات متفرّقة

كل ما يسجّله المعلّم في عشر دقائق هو أصل ما يقرؤه المشرف في تقاريره وما يظهر على شاشة المصلّى. والترتيب مقصود: الحضور يفتح التسميع، والتسميع يحرّك موضع الخطة، وموضع الخطة هو ما يقيس به البرنامج إنجاز الطالب.

> **ملخّص سريع**
> - ما هذا؟ صفحة الحلقة: قائمة طلابها ليوم بعينه، وأزرار تسجيل الحضور والتسميع والأنشطة.
> - لماذا يهمّك؟ لأن التسجيل اللحظي الدقيق أرخص بكثير من محاولة تذكّر ما جرى بعد أسبوع.
> - لمن؟ معلّم
> - الوقت المتوقّع: ١٠ دقائق لكل حلقة

المسار: الشريط السفلي ← الحلقات ← البرنامج ← الحلقة

فيديو: الحلقة https://www.youtube.com/watch?v=Qam84bN36XE

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

المعلّم يفتح «الحلقات» من الشريط السفلي فيرى حلقاته وحدها. وترويسة الحلقة تقول “إدارة حلقة {الاسم} ومتابعة تقدمهم”، وتحتها “قائمة الطلاب والخطط” مع شريط التاريخ. غيّر التاريخ لتعوّض يوماً سابقاً، وتنبّه إن قرأت “عرض ملخص للفترة — للقراءة فقط” أو “هذا اليوم للعرض فقط — تجاوزت مدة التعديل المسموحة”.

![صفحة الحلقة مع شريط التاريخ وبطاقات الطلاب وخططهم](https://manual.misbah.pro/images/teaching/01-group-board.png)

### لماذا يسبق الحضور التسميع؟

ليس هذا ترتيباً شكلياً. سجلّ الحضور هو ما يثبت أن للطالب جلسة اليوم أصلاً، وعليه تُعلَّق أنشطته، ومنه تُمنح نقاط الحضور إن كانت مربوطة بالمحفظة. ولذلك يبقى زرّ «تسميع جديد» معطَّلاً بتلميح “يجب تسجيل الحضور أولاً” حتى تُحفَظ الحالة.

1. بطاقة الطالب تفتح على الحضور مباشرة
   إن لم يُسجَّل حضوره بعد، فالبطاقة تبدأ بمنتقي الحالة دون أن تبحث عنه — فالجواب واحد على كل حال.
2. الحالات ليست اختيارك
   هي المعرَّفة في [هيكلة الحضور](https://manual.misbah.pro/attendance#structure) على مستوى البرنامج. وإن لم يكن للبرنامج نظام حضور، اختفى الشرط كلّه وفُتح التسميع مباشرة.
3. أسرِع بـ«تحديد الحضور للجميع»
   طبّق حالة واحدة على الجميع ثم عدّل الاستثناءات، أو استعمل «غير المسجلين» لتضع حالة لمن بقي فقط.
4. احفظ
   **هذه هي الخطوة التي يغفل عنها الناس.** الحالة المعروضة على الشاشة لا تفتح التسميع ما لم تُحفَظ فعلاً؛ اضغط «حفظ» حتى يزول تنبيه “لا توجد تغييرات”.

> **انتبه:** «تراجع» يطرح سؤالاً صريحاً: “هل أنت متأكد من تجاهل جميع التغييرات غير المحفوظة؟ لن يمكن استرجاعها.” وهو يمسح تعديلات الجلسة كلها لا حالة طالب واحد.

ومع الحالة يمكن إضافة ملاحظة — سبب تأخّر أو عذر غياب — فتظهر في سطر تحت اسم الطالب وفي تقارير الحضور.

#### كيف تسجّل حضور عشرين طالباً؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «تحديد الحضور للجميع» (الأنسب غالباً) | الغالبية حاضرون والغياب استثناء معدود. | حالة واحدة على الجميع في نقرة — “سيتم تطبيق حالة الحضور المحددة على جميع الطلاب.” — ثم تعدّل الاستثناءات. | تكتب [[حاضر]] على غائب إن نسيتَ تعديله، فراجع القائمة قبل الحفظ. |
| «غير المسجلين» (الافتراضي) | بدأت بتسجيل بعضهم ثم انقطعت، أو تأخّر قوم فسجّلتهم متفرّقين. | يطبّق الحالة على من بقي فقط — “سيتم تطبيق حالة الحضور المحددة على ٦ طالب غير مسجل فقط.” — فلا يمسّ ما سجّلته بيدك. | لا يظهر إلا حين يجتمع مسجَّلون وغير مسجَّلين معاً. |
| تعيين فردي (متقدّم) | الحالات متفرّقة: حاضر ومتأخّر ومستأذن في حلقة واحدة. | أدقّ ما يكون، ويتيح إضافة ملاحظة مع كل حالة. | أبطأ، ويزداد بطؤه كلما كبرت الحلقة. |

![تحديد حالة الحضور لطلاب الحلقة مع زر الحفظ](https://manual.misbah.pro/images/teaching/02-mark-attendance.png)

### من أين يأتي «المطلوب»؟

حين تفتح حوار التسميع تجد النطاق محسوباً سلفاً. هذا الرقم ليس تقديراً عاماً، بل ناتج حساب يجري في متصفحك على خطة هذا الطالب وحده — ويختلف باختلاف نوع الحصة.

*المطلوب بحسب نوع الحصة القرآنية*
| نوع الحصة | كيف يُحسب المطلوب |
| --- | --- |
| [[حصة ثابتة]] للعلم | المقدار اليومي المكتوب في الخطة كما هو — لا قسمة ولا تعديل. |
| [[حصة ذكية]] مناسب | ما بقي من الخطة مقسوماً على أيام العمل المتبقية حتى تاريخ الانتهاء، مجبوراً لأعلى. |
| [[حصة حرة]] | لا مطلوب أصلاً؛ يفتح الحوار على تحديد النطاق ويسجّل المعلّم ما جرى. |

> **حساب الحصة الذكية:** `المطلوب اليوم = ⌈ الأسطر المتبقية إلى نهاية الخطة ÷ أيام العمل المتبقية ⌉`، وبحدٍّ أدنى سطر واحد.
> وأيام العمل المتبقية تُعدّ من اليوم إلى تاريخ انتهاء الخطة، ولا تحسب إلا الأيام التي وسمتها الخطة أيام عمل. ولذلك يرتفع المطلوب من نفسه كلما تأخّر الطالب، وينخفض كلما سبق — دون أن يعدّل أحد شيئاً.

ثم يمرّ الرقم بمرحلتين أخريين قبل أن يصير آيةً على الشاشة: **تقييد بالحدود** — فلا يتجاوز النطاق حدود التنقّل المسموحة في الخطة — ثم **تقريب** بحسب سياسة الخطة، فقد يُمدّ المقدار قليلاً ليقف عند نهاية صفحة أو نهاية سورة بدل أن ينقطع في وسط الكلام.

> **ملاحظة:** لهذا قد ترى المطلوب ٤٫٥ أوجه اليوم و٤ أوجه غداً على الخطة نفسها. إعدادات المقدار والاتجاه وأيام العمل والتقريب كلها في [قالب الخطة القرآنية](https://manual.misbah.pro/quran-plans#settings) بيد المشرف، لا بيد المعلّم.

والمقدار يُعرض بوحدتين: بالأوجه إن زاد عن خمسة عشر سطراً، وبالأسطر دون ذلك.

### تسجيل التسميع

«تسميع جديد» يفتح حواراً من ثلاث محطات: «اختيار خطة للطالب» ثم «تسجيل التسميع» ثم «تقييم النشاط». وإن لم تكن للطالب خطط ظهر: “يرجى إضافة خطط للطالب قبل تسجيل التسميع” — وذلك عمل المشرف لا المعلّم.

1. اختر الخطة
   الحوار يفصل “الخطط النشطة” عن “الخطط المكتملة”، ويسم ما سُجِّل اليوم بـ“تم التسميع لهذا اليوم”. وفتح خطة مسجَّلة يعرض خيارين: «تسجيل نشاط جديد» أو «تعديل النشاط السابق».
2. اقرأ النطاق المقترَح
   الحوار يعرض “سمّع الطالب من … إلى …” مع مجموع الأسطر، ويضيف “· المطلوب …” حين يختلف الاثنان.
3. صحّح النطاق إن اختلف الواقع
   «سمّع مقداراً مختلفاً» أو «تعديل النطاق» يفتحان منتقيَي «من» و«إلى» بـ«السورة» و«الآية»، ويعيدك «إعادة للمطلوب» إلى الاقتراح الأصلي.
4. أكّد
   الزرّ يحمل المقدار صراحة — “تأكيد تسميع ٤٫٥ أوجه” — ثم تظهر “تم تسجيل التسميع بنجاح!”

> **سجّل ما جرى لا ما كان ينبغي:** الفرق بين المطلوب والفعلي هو بالضبط ما تقرؤه التقارير نسبةَ إنجاز. تسجيل المطلوب عن طالب لم يُتمّه يرفع النسبة اليوم ويُفسد الخطة غداً: الموضع يقفز إلى ما لم يحفظه الطالب، فيُبنى ورد الغد على أساس خاطئ.

> **انتبه:** إن أدخلت مقداراً يزيد كثيراً على المطلوب نبّهك الحوار: “هذا أكبر بكثير من المطلوب — تحقّق من البداية”، وطلب إقراراً صريحاً: “نعم، الطالب سمّع … فعلاً”. اقرأ التنبيه ولا تمرّ عليه — غالباً يكون موضع البداية هو الخطأ.

#### تسميع يعبر حدود التنقّل

بعض الخطط لها حدود تنقّل: جزء بعينه أو مدى محدّد يدور فيه الطالب. فإذا بلغ النطاق آخر الحدّ وعاد إلى أوّله، لم يعد سطراً واحداً متصلاً، فيُنبّهك الحوار: “النطاق يعبر حدود التنقل وينقسم إلى جزأين” ويعرض “الجزء الأول” و“الجزء الثاني” منفصلين. وهذا وصفٌ لما حدث لا سؤالٌ يُطلب منك جوابه؛ أكّد كالمعتاد.

![حوار تسجيل التسميع مع النطاق والمقدار وزر التأكيد](https://manual.misbah.pro/images/teaching/03-recitation-flow.png)

### من أين تأتي الدرجة؟

لا يوجد في مصباح حقل يكتب فيه المعلّم درجة من مئة. الدرجة **تُشتقّ**: تبدأ من مئة، ثم تنقص بما تؤشّر عليه من أخطاء وتزيد بما تؤشّر عليه من مزايا. وإن لم يعرّف البرنامج قواعد، حُفِظ النشاط بمئة كاملة.

**القواعد** — قائمة أخطاء ومزايا يعرّفها البرنامج على قالب الخطة — خطأ، نسيان، لحن جليّ، تجويد ممتاز — لكل منها وزن. يؤشّر المعلّم على ما لاحظه، فتتحوّل الملاحظات إلى درجة محسوبة بدل انطباع عام.

> **معادلة الدرجة:** `الدرجة = ١٠٠ − مجموع الخصومات + مجموع النقاط الإيجابية`
> كل قاعدة لها وزن يعرّفه المشرف في [إعدادات قالب الخطة](https://manual.misbah.pro/quran-plans#settings)، وتُضرَب في عدد مرات تأشيرك عليها. فخطأان في تلاوة واحدة يُخصمان مرتين لا مرة.

شاشة «تقييم النشاط» تعرض كل قاعدة بوسم “- ٥ درجة” أو “+ ٣ درجة”، ومعها زرّا زيادة ونقص لعدد المرات. وأسفلها ملخّص صريح: “الدرجة الكلية:” ثم “مجموع الخصم:” ثم “مجموع النقاط الإيجابية:” ثم “الدرجة النهائية:” بلون يتدرّج من الأحمر إلى الأخضر.

- الزرّ يقرأ «حفظ التقييم» إن أشّرت على شيء، و«حفظ بدون ملاحظات» إن لم تؤشّر.
- عدد مرات كل قاعدة يُحفَظ مع النشاط، فيراه المشرف لاحقاً مفصَّلاً لا مجموعاً.
- التقييم يدخل في حساب [[التقييم]] في [التقارير](https://manual.misbah.pro/reports) و[الأداء](https://manual.misbah.pro/performance)، بوزن يضبطه المشرف.

> **نصيحة:** القواعد أداة تربوية قبل أن تكون حسابية: حين يرى الطالب أن الخصم كان [[لحن جليّ]] لا ضعفاً عاماً، عرف ما يصلحه غداً. أشّر على ما لاحظته فعلاً، وتجنّب تحويل كل جلسة إلى محاسبة.

![شاشة تقييم النشاط مع القواعد وملخص الدرجة النهائية](https://manual.misbah.pro/images/teaching/05-constitution.png)

### ما ليس تسميعاً

[الخطط غير القرآنية](https://manual.misbah.pro/flexible-plans) — متون، مهارات، سلوكيات — تُسجَّل من الزرّ نفسه، لكن الحوار يسلك مساراً آخر: «اختيار النشاط» أو «تسجيل الكمية» بدل نطاق المصحف.

#### خطة بكمية

تُدخل «الكمية» فحسب، ويذكّرك الحقل بالحدود إن وُجدت — “(من ١ إلى ١٠ بزيادة ١)” — ويعرض جانبه وحدة النقاط والتقدّم الحالي. وعند النجاح: “تم تسجيل النشاط وتحديث رصيد الطالب”.

#### خطة بهيكل

الخطة ذات الهيكل تعرض صفوفها مرتّبة، ويُوسم الصف المتوقّع بـ“المقترح”. تستطيع تسجيل صف واحد أو عدّة صفوف دفعة واحدة — “كل صف نشاط مستقل — يُجمَّع في إرسال واحد” — ويعرض الملخّص “مجموع هذه الأنشطة” و“النقاط المكتسبة” قبل التأكيد.

#### خطة ببنود

[خطة البنود](https://manual.misbah.pro/flexible-plans#checklist) أقرب إلى قائمة مراجعة يملؤها المعلّم في كل جلسة. وشكل كل بند يحدّده المشرف: بندٌ حدّه الأقصى واحد يظهر مربّع اختيار، وما زاد يظهر عدّاداً بزرّي زيادة ونقص.

- البند الذي له حدّ أدنى يُوسم بـ“مطلوب”.
- البند الذي لا يمنح نقاطاً يُوسم بـ“للمتابعة فقط”، وغيره يعرض ما يمنحه أو يخصمه لكل مرة.
- أسفل الشاشة “إجمالي الجلسة” يجمع صافي النقاط لكل وحدة، ومعه “الإنجاز: … / …”.
- الزرّ «حفظ البنود»، ولا تمرّ خطة البنود بشاشة القواعد أصلاً.

> **كيف يُحسب إنجاز خطة البنود:** `المنجَز = مجموع (قيمة البند × ما يمنحه البند)` لكل البنود، بما فيها السالبة.
> `المطلوب = مجموع (الحد الأدنى × ما يمنحه البند)` للبنود التي تمنح نقاطاً موجبة وحدها.
> ولذلك قد يكون “الإنجاز” أكبر من مئة بالمئة إن تجاوز الطالب الحدود الدنيا، وقد ينزل إن غلبت البنود السالبة.

![شاشة تعبئة بنود الخطة المرنة مع العدّادات وإجمالي الجلسة](https://manual.misbah.pro/images/teaching/06-checklist-fill.png)

![حوار تسجيل نشاط مرن بكمية ووحدة نقاط](https://manual.misbah.pro/images/teaching/04-flexible-activity.png)

> **ملاحظة:** قد يحدّ البرنامج عدد الأنشطة في اليوم؛ فإن بلغته ظهر: “تم بلوغ الحد الأقصى للأنشطة لهذا اليوم (٣)”. الحدّ يمنع الإنشاء لا التعديل، فعدّل النشاط السابق بدل إنشاء جديد.

### ما يراه المعلّم ومتى ينقطع

حساب المعلّم مخصَّص للتدريس لا للإدارة، ووصوله إلى الحلقة قد يكون **مؤقّتاً** بطبيعته.

- يرى حلقاته وحدها وطلابها؛ لا حلقات زملائه ولا بقية طلاب المسجد.
- يسجّل الحضور والتسميع والأنشطة، ولا يعرّف حالات الحضور ولا ينشئ خططاً.
- المعلّم المساعد على حلقة غيره يُوسَم في القائمة بـ“معلم مساعد”.
- ما يسجّله يظهر فوراً للمشرف في [الأداء](https://manual.misbah.pro/performance) و[المتابعة اليومية](https://manual.misbah.pro/activities) وعلى [شاشة العرض](https://manual.misbah.pro/monitor).

> **صلاحية تنتهي بموعدها:** حين يربط المشرف معلّماً مساعداً بحلقة، يستطيع أن يضع لوصوله «صلاحية الانتهاء»: ساعة، أو ثلاث ساعات، أو نهاية اليوم، أو نهاية الأسبوع، أو نهاية الشهر، أو تاريخاً مخصّصاً — أو “بدون انتهاء”.
> وحين تنقضي المدة تختفي الحلقة من قائمته بلا إنذار ولا رسالة تشرح السبب؛ يقرأ فقط “لا توجد حلقات معيّنة لك” و“لم تُسند إليك أي حلقة بعد. تواصل مع إدارة المسجد لتعيينك على مجموعة.” فإن حدث ذلك لمعلّم يدرّس فعلاً، فالسبب غالباً انتهاء صلاحيته لا خطأ في حسابه — ويمدّدها المشرف من [صلاحيات الوصول](https://manual.misbah.pro/groups#access).

### أسئلة شائعة

**زرّ «تسميع جديد» معطَّل.**
لم تُحفَظ حالة حضور الطالب لهذا اليوم. حدّد الحالة ثم اضغط «حفظ» — التحديد وحده على الشاشة لا يكفي — وسيُفتح الزرّ فوراً.

**سمّع الطالب أقل من المطلوب، هل أسجّل المطلوب؟**
لا. سجّل ما جرى فعلاً. موضع الخطة يتقدّم بالفعلي، فتسجيل المطلوب يقفز بالموضع إلى ما لم يحفظه الطالب ويُفسد ورد الغد.

**لماذا تغيّر المطلوب اليوم عن أمس؟**
إن كانت الحصة [[حصة ذكية]] فالمطلوب يُعاد حسابه كل يوم: ما بقي من الخطة مقسوماً على أيام العمل المتبقية. تأخُّر يوم يرفع نصيب بقية الأيام، والعكس بالعكس.

**أين أضع درجة الطالب؟**
لا تُكتب الدرجة مباشرة. أشّر على القواعد في شاشة «تقييم النشاط»، فتُحسب الدرجة من مئة بعد الخصومات والإضافات. وإن لم يكن للخطة قواعد، حُفِظ النشاط بمئة.

**سجّلت لطالب خطأً — كيف أصحّح؟**
افتح الخطة نفسها لليوم نفسه واختر «تعديل النشاط السابق». وللحضور غيّر الحالة ثم احفظ.

**اختفت حلقة كنت أدرّسها.**
غالباً انتهت صلاحية وصولك إليها، فهي قد تُمنح بمدة محدّدة. راجع مشرف البرنامج ليمدّدها من [صلاحيات الوصول](https://manual.misbah.pro/groups#access).

**هل أستطيع تسجيل يوم مضى؟**
نعم، غيّر التاريخ في أعلى الصفحة. إلا أن بعض البرامج تحدّ مدة التعديل الرجعي، وحينها تقرأ “هذا اليوم للعرض فقط — تجاوزت مدة التعديل المسموحة”.

---

## التطبيقات

المصدر: https://manual.misbah.pro/apps

أدوات تعيش على مستوى المسجد لا داخل برنامج واحد: النماذج، مكتبة الخطط، التخزين، وربط واتساب. كل تطبيق منها تفتحه ميزة في الباقة.

الجمهور: مشرف

### نطاق المسجد لا نطاق البرنامج

أكثر ما تعمله في مصباح يخصّ برنامجاً واحداً: حلقاته وطلابه وخططه وحضوره. أربع أدوات تخرج عن هذه القاعدة، فتُعرَّف مرة واحدة وتخدم برامج المسجد كلها، ومكانها “مركز التطبيقات”.

> **ملخّص سريع**
> - ما هذا؟ مركز التطبيقات يجمع الأدوات التي يملكها المسجد كله: النماذج، مكتبة هياكل الخطط، التخزين، وحسابات واتساب.
> - لماذا يهمّك؟ ما يتكرّر في كل برنامج — هيكل خطة، ملف، رقم واتساب، نموذج تسجيل — يُعرَّف هنا مرة واحدة بدل نسخة في كل دورة.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٠ دقائق

المسار: الشريط السفلي ← التطبيقات

عنوان الصفحة “مركز التطبيقات”، ووصفها “واجهة موحدة للتحكم في جميع الأدوات الإضافية التي تساعدك في إدارة المسجد بذكاء وفعالية.” ويعلوها تنبيه ثابت: “تساعدك التطبيقات في تنظيم المحتوى، التواصل السريع، وإدارة الملفات في مكان واحد. ترقبوا المزيد من التطبيقات قريباً!”

- **نطاق المسجد** — ما تعرّفه هنا يبقى قائماً بعد انتهاء البرنامج، ويظهر في البرنامج التالي دون إعادة بناء.
  الدورة تنتهي كل فصل، أما رقم واتساب المسجد ومكتبة هياكله فتبقى.
- **التطبيق** — أداة مستقلة لها صفحتها وبياناتها، تدخلها من بطاقتها في المركز بزر «دخول التطبيق».
  فصل الأدوات عن لوحة البرنامج يبقي التشغيل اليومي خفيفاً.
- **قفل الباقة** — كل بطاقة مربوطة بميزة في الاشتراك. إن لم تفتحها باقتك ظهرت عليها [[مقفل]] وتحوّل زرها إلى «ترقية الباقة».
  القفل يشرح غياب الأداة بدل أن تختفي البطاقة فتظنّها غير موجودة.

*التطبيقات الأربعة والميزة التي تفتح كلاً منها*
| التطبيق | ما يقدّمه | الميزة التي تفتحه | التفصيل |
| --- | --- | --- | --- |
| «النماذج» للعلم | “إنشاء نماذج تسجيل واستبيانات وجمع الإجابات من الجمهور بشكل منظم” | `forms` | [دليل النماذج](https://manual.misbah.pro/forms) |
| «مكتبة الخطط» للعلم | “إنشاء وإدارة الخطط المرنة القابلة لإعادة الاستخدام عبر جميع البرامج” | `wallet` | [الخطط المرنة](https://manual.misbah.pro/flexible-plans) |
| «التخزين» للعلم | “إدارة الملفات والتخزين السحابي الموحد للمسجد” | `storage` | [أدناه](https://manual.misbah.pro/apps#storage) |
| «واتساب» بتحفّظ | “ربط حسابات واتساب لإرسال إشعارات الحضور والتواصل مع أولياء الأمور” | `whatsapp` | [أدناه](https://manual.misbah.pro/apps#whatsapp) |

> **ملاحظة:** «مكتبة الخطط» لا تفتحها ميزة باسمها بل ميزة `wallet` نفسها التي تفتح الخطط المرنة — لأن الهيكل في المكتبة لا معنى له بغير خطة مرنة تستعمله. راجع [الباقة والميزات](https://manual.misbah.pro/entitlements).

![مركز التطبيقات في مصباح مع بطاقات النماذج والمكتبة والتخزين وواتساب](https://manual.misbah.pro/images/apps/01-apps-hub.png)

**نطاق المسجد** — مستوى أعلى من البرنامج. الطلاب والملفات وهياكل الخطط وحسابات واتساب والنماذج كلها ملك المسجد، بينما الحلقات والتسجيلات والخطط والحضور ملك برنامج بعينه. راجع [كيف يعمل مصباح](https://manual.misbah.pro/start#chain).

### النماذج

النماذج تفتح باب التسجيل لمن هم خارج المنصة: ولي أمر يملأ استمارة من رابط عام، فتصل الإجابة إلى طابور مراجعة عندك، ومنه تصير طالباً في سجل المسجد.

هذا التطبيق أكبر من فقرة، ولذلك أُفرد له دليل كامل: **[دليل النماذج](/forms)** — بناء الحقول، نشر الرابط، طابور المراجعة، ومعالجة الاسم المتشابه.

> **نصيحة:** إن لم يكن في المسجد نموذج منشور، تتبدّل بطاقة «النماذج» في المركز: يظهر عليها وسم [[أنشئ نموذجك]] ووصف “لا يوجد نموذج يستقبل طلبات الآن. أنشئ نموذجاً لفتح باب التسجيل.” وهو تذكير لا خطأ.

### مكتبة الخطط

المكتبة تحفظ **الهيكل** وحده: قائمة البنود أو النطاق الرقمي الذي تقيس عليه، بلا طالب ولا تواريخ ولا نقاط. الخطة المرنة في البرنامج هي التي تستعير هذا الهيكل وتعطيه معنى.

وصف الصفحة: “إنشاء وإدارة هياكل قابلة لإعادة الاستخدام لاستخدامها في خطط البرامج. هياكل مشتركة عبر جميع برامج المسجد.”

- **هيكل الجدول** — قائمة مرتّبة من العناصر، لكل عنصر عنوان ووصف اختياري وعدد نقاط.
  “مثالية لفصول الكتب، أجزاء القرآن، أو مراحل الحفظ المنظمة.”
- **النطاق الرقمي** — بداية ونهاية وزيادة — يقيس ما يُعدّ عدّاً لا ما يُذكر بالاسم.
  أوجه، صفحات، دروس مرقّمة: لا حاجة لكتابة مئة بند يدوياً.
- **الاستعارة لا النسخ** — الخطة المرنة في البرنامج تشير إلى هيكل المكتبة، فتعديل الهيكل يبلغ كل من يستعمله.
  ميزة حين تصحّح خطأ في بند، ومخاطرة حين تغيّر ترتيب البنود في منتصف الفصل.

#### أين أعرّف الهيكل؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| قالب داخل البرنامج (الافتراضي) | الهيكل يخصّ هذه الدورة وحدها، أو ما زلت تجرّبه ولم يستقرّ. | تعديله لا يخرج من البرنامج، فلا تخشى أثراً في مكان لا تراه. | الدورة القادمة تبدأ من صفحة بيضاء، وتعيد بناءه من جديد. |
| هيكل في المكتبة (الأنسب غالباً) | المتن أو الكتاب أو سلّم المراحل يتكرّر كل فصل وفي أكثر من برنامج. | تعريف واحد للمسجد كله، وتصحيحه مرة واحدة يصلح كل ما يستعمله. | أثره واسع؛ غيّره بين الدورات لا في وسط دورة قائمة. |
| استيراد من قالب (متقدّم) | تبدأ من هيكل جاهز ثم تعدّله، أو تنقل هيكلاً طويلاً من ملف. | «استيراد من قالب» و«توسيع الهيكل بـ JSON» يختصران إدخال مئات البنود. | تحتاج صيغة صحيحة، وإلا رُفض الإدخال برسالة قراءة بيانات. |

1. افتح «مكتبة الخطط» من المركز
   القائمة تعرض هياكل المسجد مع «عرض الشبكة» أو «عرض القائمة» للتنقّل بينها.
2. اضغط «إنشاء هيكل خطة جديد»
   سمِّ الهيكل، ثم اختر بين «إعدادات الجدول» و«إعدادات النطاق الرقمي» — وهذا الاختيار هو الفارق الحقيقي بين النوعين.
3. أدخل العناصر
   في الجدول: «عنوان العنصر» لكل بند مع “المحتوى أو الوصف (اختياري)”. وفي النطاق: بدايته ونهايته والزيادة، على أن تكون “بداية النطاق يجب أن تكون أقل من النهاية” وأن تكون الزيادة أكبر من صفر.
4. احفظ ثم استعمله في البرنامج
   بعد “تم إنشاء الهيكل بنجاح” يصير الهيكل متاحاً لخطط البرامج المرنة — طريقة الربط في [دليل الخطط المرنة](https://manual.misbah.pro/flexible-plans).

> **انتبه:** **ترتيب العناصر جزء من معناها.** إعادة ترتيب بنود هيكل تستعمله خطط قائمة تنقل التقدّم المسجَّل إلى بنود أخرى. رتّب الهيكل قبل تطبيقه، وأضف في آخره لا في وسطه بعد أن يبدأ الطلاب.

![مكتبة الخطط تعرض هياكل المسجد القابلة لإعادة الاستخدام](https://manual.misbah.pro/images/apps/04-library-structures.png)

### التخزين

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

وصف الصفحة: “ملفات المسجد في مكان واحد. اسحب أي ملف إلى الصفحة لإضافته — الرفع بعد المراجعة فقط.” أي أن السحب يهيّئ الملف ولا يرفعه؛ الرفع يقع بعد أن تراجع اسمه وفئته.

- **الفئة** — تصنيف تختاره أو تتركه — “اختر فئة (اختياري)” — ويصير أداة تصفية لاحقاً مع «جميع الفئات» و«بدون فئة».
- **نوع الملف** — تصفية جاهزة: [[صور]] و[[مستندات]] و[[وسائط]] و[[جداول]] و[[أخرى]]، ومعها «إظهار كل الملفات».
- **البيانات الوصفية** — أزواج «المفتاح» و«القيمة» تضيفها للملف حين لا يكفي اسمه للتعريف به.
- **المساحة** — مقياس الاستهلاك، ووصفه “حجم الملفات الأصلية فقط — معاينات الصور لا تُحتسب”، ويظهر تحته المتبقّي من السعة.

> **ما الذي يُحتسب عليك:** المستهلك = مجموع أحجام الملفات الأصلية وحدها. المعاينات المصغّرة التي تولّدها المنصة للصور **لا تدخل** في الحساب، فالرقم الذي تراه هو ما رفعته أنت لا ما أنتجته المنصة.

> **ملاحظة:** السعة كلها بند في الباقة (ميزة `storage` وحدّ بالجيجابايت). عند الاقتراب من الحد يتلوّن مؤشر “المساحة”، والزيادة تمرّ من [الباقة والميزات](https://manual.misbah.pro/entitlements#limits). وللملف الواحد حدّ مستقل: “حجم الملف كبير جداً (الحد 250 ميجابايت)”.

تصل إلى هذا المستودع من خارج صفحته أيضاً: عند إرفاق وسائط في [الإشعارات](https://manual.misbah.pro/notifications#message) يظهر «التخزين» بجوار «إرفاق»، فيختار ملفاً مرفوعاً سابقاً بدل رفعه من جديد.

![صفحة التخزين مع بطاقة المساحة وقائمة ملفات المسجد](https://manual.misbah.pro/images/apps/05-storage.png)

### ربط واتساب

«تطبيق واتساب» [[تجريبي]] يربط رقم واتساب يملكه المسجد ليصير قناة إرسال في [الإشعارات](https://manual.misbah.pro/notifications). الرقم ملك المسجد لا البرنامج، فيخدم كل البرامج بعد ربطه مرة واحدة.

وصف الصفحة: “أرسل إشعارات، رسائل تذكير، وتنبيهات مباشرة إلى الطلاب وأولياء الأمور عبر الواتساب الخاص بالمسجد.”

> **تنبيه مهم:** الواجهة نفسها تصرّح بأن هذه الخدمة **غير رسمية** من واتساب وليست تابعة له ولا معتمدة منه، وأن احتمالية تقييد الحساب المرتبط أو حظره **مرتفعة جداً**. وتوصي صراحة بعدم استخدام حسابك الشخصي الرئيسي، وباستخدام رقم مخصّص للمسجد.
> خذ التوصية على ظاهرها: احجز شريحة للمسجد، ولا تربط رقماً يعتمد عليه أحد في حياته اليومية.

1. افتح «واتساب» ثم «إضافة حساب واتساب»
   عند أول مرة تستقبلك شاشة فارغة: “ابدأ بربط أول حساب واتساب”. سمِّ الحساب باسم يدلّ عليه — “مثال: واتساب المسجد”.
2. أكمل الربط بمسح الرمز
   افتح واتساب على الجوال الذي يحمل رقم المسجد وامسح الرمز المعروض، حتى تظهر “تم ربط حساب واتساب بنجاح”.
3. اضغط «التحقق من الاتصال»
   الرد إمّا “حساب واتساب متصل ويعمل بشكل صحيح” وحينها تظهر الحالة [[الاتصال فعّال]]، وإمّا “حساب واتساب غير متصل. قد تحتاج لإعادة ربط الحساب.” وحينها تعيد المسح.
4. استعمله في الإشعارات
   بعد الربط يصير الحساب خياراً في قناة واتساب داخل [معالج الإشعارات](https://manual.misbah.pro/notifications#audience).

> **انتبه:** عدد الحسابات محدود بالباقة: “تم الوصول للحد الأقصى من الحسابات المسموح بها في باقتك الحالية”. وإن ظهرت الحالة [[الحساب غير متصل]] فراجع جوال الرقم — خروج الجهاز من الشبكة يقطع القناة وإن بقي الحساب قائماً في المنصة.

![صفحة تطبيق واتساب مع قائمة الحسابات وحالة الاتصال](https://manual.misbah.pro/images/apps/03-whatsapp.png)

### أسئلة شائعة

**لماذا بعض بطاقات المركز مقفلة؟**
لأن باقة المسجد لا تتضمّن ميزتها. البطاقة تبقى ظاهرة ليُعرف أن الأداة موجودة، وعليها [[مقفل]] وزرها «ترقية الباقة». تفصيل كل ميزة وما تفتحه في [الباقة والميزات](https://manual.misbah.pro/entitlements).

**ما الفرق بين هيكل في المكتبة وقالب خطة في البرنامج؟**
الهيكل قائمة أو نطاق مجرّد على مستوى المسجد، والقالب خطة كاملة داخل برنامج واحد لها تواريخ ووحدة نقاط وأيام عمل. القالب قد يستعير هيكلاً من المكتبة، والعكس غير وارد.

**هل تُحذف ملفات التخزين مع انتهاء البرنامج؟**
لا. المستودع ملك المسجد ولا يتبع دورة البرنامج، فالملفات تبقى بعد انتهائه وتظهر في البرنامج التالي.

**ربطت واتساب ثم انقطع بعد أيام — ما السبب؟**
الربط يعتمد على جوال يحمل الرقم ويبقى متصلاً. خروج الجهاز من الشبكة، أو تسجيل خروج الجلسات من داخل واتساب، أو تقييد من واتساب نفسه — كلها تقطع الاتصال. اضغط «التحقق من الاتصال» ثم أعد المسح.

**أين أجد النماذج؟**
من البطاقة الأولى في مركز التطبيقات، وشرحها كاملاً في [دليل النماذج](https://manual.misbah.pro/forms).

---

## النماذج

المصدر: https://manual.misbah.pro/forms

نموذج التسجيل يفتح باب الحلقة لمن هم خارج المنصة: رابط عام يملؤه ولي الأمر، وطابور مراجعة عندك يحوّل الطلب إلى طالب في سجل المسجد.

الجمهور: مشرف

### باب التسجيل

كل طالب في مصباح أدخله أحد بيده. النموذج يقلب الاتجاه: ولي الأمر هو من يُدخل البيانات من رابط عام، وأنت تراجع وتقرّر. يوفّر عليك الإدخال، ويحفظ لك حقّ القرار كاملاً.

> **ملخّص سريع**
> - ما هذا؟ نموذج تسجيل عام بحقول تحدّدها، ينشر برابط واحد، وتصل إجاباته إلى طابور مراجعة عندك.
> - لماذا يهمّك؟ فتح باب دورة جديدة بلا نموذج يعني رسائل واتساب متفرّقة وإدخالاً يدوياً لعشرات الأسماء.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٢٠ دقيقة

المسار: التطبيقات ← النماذج

- **النموذج** — مجموعة حقول لها عنوان ووصف وصورة ومدة قبول، تعيش على مستوى المسجد لا داخل برنامج.
  نموذج واحد يخدم كل برامجك، والبرنامج يُختار لحظة القبول لا لحظة النشر.
- **الحقل** — سؤال واحد له نوع: [[نص]] أو [[رقم]] أو [[تاريخ]] أو [[قائمة خيارات]]، وقد يكون [[إلزامي]] أو [[فريد]].
  النوع ليس شكلاً بل تحقّقاً: الرقم يمنع الحروف، والتاريخ يمنع الصيغ العشوائية.
- **ربط حقول الطالب** — خريطة تقول: إجابة هذا الحقل تُكتب في هذا الحقل من ملف الطالب.
  هي الفرق بين نموذج يملأ سجل المسجد وحده، ونموذج يترك لك النسخ واللصق.
- **طابور المراجعة** — قائمة الإجابات الواردة وقراراتها. لا يصير أحد طالباً إلا بقرار منك.
  “اقبل الطلب لإنشاء طالب أو ربطه بسجل موجود، أو ارفضه. الحالات تُحدَّث فوراً بعد كل قرار.”

**الرابط العام** — عنوان النموذج كما يفتحه من لا حساب له في مصباح، وصيغته `/forms/{رقم النموذج}`. لا يطلب تسجيل دخول ولا يكشف شيئاً من بيانات المسجد سوى ما وضعته أنت في النموذج.

> **ملاحظة:** النماذج ميزة في الباقة (`forms`). إن كانت باقتك لا تتضمّنها فتحلّ محلّ الصفحة شاشة قفل نصّها “النماذج والاستبيانات غير متاحة في خطتك الحالية.” — راجع [الباقة والميزات](https://manual.misbah.pro/entitlements).

![قائمة نماذج المسجد مع بطاقة نموذج التسجيل للفصل الجديد](https://manual.misbah.pro/images/forms/01-forms-list.png)

### بناء النموذج

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

1. اضغط «إنشاء نموذج»
   تفتح نافذة “نموذج جديد”: “أنشئ نموذجاً يعبّئه أولياء الأمور للالتحاق بالحلقة، ثم شاركه برابط واحد.” أدخل «عنوان النموذج» — ومثاله “مثال: نموذج تسجيل برنامج الحفظ” — واختر النوع.
   النوع [[طلب تسجيل]] هو “يجمع الاسم ويتيح قبول الطلاب في الحلقة”، وهو الوحيد المتاح الآن؛ [[استبيان]] معطّل بوسم “(قريباً)”.
2. راجع الحقول الأساسية
   كل نموذج تسجيل يبدأ بثلاثة حقول عليها وسم [[أساسي]]: «الاسم الأول» و«اسم الأب» و«اسم العائلة». **لا تُحذف ولا تُعدَّل**، فهي ما يبني اسم الطالب في السجل.
3. أضف بقية الحقول
   «إضافة حقل» يفتح مسارين: «حقل جديد» تكتبه بنفسك، أو «حقول جاهزة» — “اختر حقولاً معدّة مسبقاً بتحقق من الصحة.” وفيها «رقم جوال ولي الأمر» و«الصف الدراسي» و«مستوى الحفظ» و«عدد الأجزاء المحفوظة» وغيرها، كلها بتحقّق مضبوط سلفاً.
   وتظهر أيضاً صفوف باهتة بوسم [[هيكل الطالب]]: “الصفوف الباهتة من هيكل الطالب — انقر لإضافتها.” وهي أسرع طريق لنموذج يطابق سجلّك.
4. اضبط ربط حقول الطالب
   القسم يشرح نفسه: “كل حقل في النموذج، وأين تُكتب إجابته في ملف الطالب.” الحقول المضافة من هيكل الطالب تُربط تلقائياً، والحقول التي كتبتها بنفسك تحتاج اختياراً — أو [[بدون ربط]] إن كانت للاطلاع فقط.
5. اضبط إعدادات النموذج
   «فترة القبول» — “اترك الحقول فارغة لفتح النموذج بدون قيود زمنية” — و«الحد الأقصى للإجابات» الذي “يتوقف قبول الإجابات عند بلوغ هذا العدد”، و«تخصيص المظهر» لضبط ما يراه الجمهور.

> **أصلح الربط قبل النشر:** إن كان في الربط خلل منعك النظام من النشر: “لا يمكن نشر النموذج قبل إصلاح ربط الحقول الخاطئ.” ويتحوّل زر التأكيد إلى «إصلاح الربط». والسبب في التحذير نفسه: “أصلح ربط الحقول قبل النشر أو قبول الإجابات حتى لا تُكتب بيانات في الحقل الخطأ.”

![محرّر النموذج مع جدول الحقول والحقول الأساسية](https://manual.misbah.pro/images/forms/02-form-editor.png)

### النشر ومشاركة الرابط

للنموذج ثلاث حالات، والانتقال بينها هو كل ما تملكه من تحكّم في باب التسجيل: افتحه، وأغلقه، وأعد فتحه.

*حالات النموذج*
| الحالة | ماذا تعني | ما تستطيعه فيها |
| --- | --- | --- |
| [[مسودة]] | غير منشور ولا رابط له. | تعديل كل شيء. “احفظ التغييرات ثم انشر النموذج لجمع الإجابات”. |
| [[منشور]] مناسب | “النموذج منشور ومتاح للجمهور” ويستقبل الإجابات. | مشاركة الرابط، ومراجعة الطلبات، والإغلاق متى شئت. |
| [[مغلق]] بتحفّظ | “النموذج مغلق ولا يقبل إجابات جديدة”. | مراجعة الإجابات السابقة فقط؛ لا تعديل ولا قبول جديد — و«إعادة فتح النموذج» يعيده. |

1. اضغط «نشر النموذج»
   من قائمة إجراءات النموذج. التأكيد يقول: “بعد النشر لن تتمكن من تعديل الحقول. تأكد من صحة الإعدادات وربط حقول الطالب قبل المتابعة.”
2. انسخ الرابط وشاركه
   «نسخ الرابط العام» أو «فتح الرابط العام» من القائمة نفسها، أو من الشريط الأخضر الذي يعرض العنوان كاملاً. الزرّ يتحوّل إلى “تم نسخ الرابط” لحظات ثم يعود.
3. تابع الطلبات
   عند وصول طلبات يظهر شريط “{العدد} إجابة قيد المراجعة” بوسم [[يتطلب إجراء]]، ومعه «مراجعة الإجابات».
4. أغلق الباب حين تكتفي
   «إغلاق النموذج» — “لن يقبل النموذج إجابات جديدة بعد الإغلاق.” والإغلاق ليس نهائياً: “سيصبح النموذج منشوراً مجدداً ويقبل إجابات جديدة” بعد «إعادة فتح النموذج».

> **انتبه:** نافذة النشر أشدّ من الواقع: تعديل الحقول يبقى ممكناً بعد النشر فعلاً، والذي يجمّد النموذج حقاً هو **الإغلاق** — “لا يمكن تعديل نموذج مغلق”. ومع ذلك عامل النشر كأنه نهائي: تغيير الحقول ونموذجك يستقبل الطلبات يجعل الإجابات القديمة والجديدة غير متجانسة.

> **نصيحة:** لا يوجد في المنصة حذف لنموذج ولا لإجابة. ما يخرج من طابورك يخرج بقرار [[مرفوض]] لا بمحو، ويبقى قابلاً للمراجعة لاحقاً. فكّر في الإغلاق بديلاً عن الحذف.

### طابور المراجعة

الإجابة الواردة ليست طالباً بعد. هي طلب في طابور، ولك فيه ثلاثة قرارات لا رابع لها: أنشئ طالباً جديداً، أو اربطه بسجل قائم، أو ارفض.

#### ما قرارك في هذا الطلب؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| إنشاء طالب جديد (الافتراضي) | الاسم لا يطابق أحداً في سجل المسجد، أو الاقتراحات أسماء متشابهة لأشخاص مختلفين. | “يُنشأ سجل من بيانات هذه الإجابة” وتُكتب حقوله وفق الربط الذي ضبطته. | إن كان الطالب مسجّلاً فعلاً صار له سجلّان، وتوزّع تاريخه بينهما. |
| ربط بسجل قائم (الأنسب غالباً) | طالب قديم يعيد التسجيل في دورة جديدة، أو أخ لطالب سبقه فاختلط الاسم. | تاريخ الطالب يبقى متّصلاً، ويمكنك تحديث حقول سجلّه من الإجابة الجديدة. | يلزم تحقّق بصري: ربط بسجل خطأ يخلط بيانات طالبين. |
| رفض الطلب | طلب مكرّر، أو خارج شروط الالتحاق، أو بيانات غير جادّة. | “لن يُنشأ طالب من هذه الإجابة، ويمكنك الرجوع إليها لاحقاً من قائمة المرفوضة.” | لا يصل صاحب الطلب إشعار بالرفض؛ التواصل معه مسؤوليتك. |

1. افتح «الإجابات»
   الطابور يفتح على [[قيد المراجعة]] تلقائياً حين توجد طلبات معلّقة، وتنتقل بين التصفيات [[الكل]] و[[مقبولة]] و[[مرفوضة]] من الشريط.
2. اختر إجابة واقرأها
   اللوحة اليمنى تعرض «الإجابات» كاملة، والأسماء الثلاثة مجموعة تحت “الاسم”. الحقل الذي لم يُملأ يظهر بوسم [[لم يُجب]].
3. اختر إجراء القبول
   قسم “اختر إجراء القبول” يعرض بطاقتين: «إنشاء طالب جديد» أو ربط بالطالب المقترح مع نسبة التشابه. وإن لم يظهر السجل المطلوب فابحث عنه بالاسم الأول من الرابط أسفل البطاقات.
4. حدّد البرنامج إن أردت
   «إضافة لبرنامج» اختياري: [[بدون برنامج]] يكتفي بإنشاء الطالب في سجل المسجد، واختيار برنامج ينشئ له **تسجيلاً** فيه أيضاً. والحلقة لا تُسأل هنا — توزّعها لاحقاً من [الطلاب](https://manual.misbah.pro/students).
5. احسم القرار
   زر القبول يتغيّر نصّه بحسب اختيارك، ثم ينتقل الطابور إلى الإجابة التالية من تلقائه. وللدفعات الكبيرة حدّد عدة إجابات ثم «مراجعة وقبول المحددة».

> **ملاحظة:** القبول ينشئ **طالباً** دائماً، وينشئ **تسجيلاً** فقط إن اخترت برنامجاً. الفرق بينهما في [كيف يعمل مصباح](https://manual.misbah.pro/start#chain): الطالب ملك المسجد، والتسجيل يربطه ببرنامج بعينه.

![طابور مراجعة الإجابات مع لوحة تفاصيل الطلب وقرارات القبول](https://manual.misbah.pro/images/forms/03-review-queue.png)

### مراجعة الاسم المتشابه

التسجيل العام يولّد تكراراً حتماً: الأب يسجّل ابنه مرتين، والإخوة تتشابه أسماؤهم، والطالب القديم يعود بالاسم نفسه. المنصة تكشف هذا قبل أن يدخل سجلّك.

الكشف يعمل على **الأسماء** لا على الجوال، وبمقارنة ذكية تتجاهل التشكيل، وتوحّد الهمزات والألفات، وتهمل أدوات النسب `بن` و`ابن` و`ال`. فاسم `عبد الإله سامي الغامدي` واسم `عبدالاله سامي الغامدي` عند النظام اسم واحد.

- **إجابة مشابهة سابقة** — طلبان على النموذج نفسه بالاسم نفسه. تظهر “تشابه {النسبة}٪ مع {العدد} إجابة على هذا النموذج — قارنها قبل القبول.” وزر «قارن الإجابات» يضع الطلبين جنباً إلى جنب.
- **طالب مقترح للربط** — الاسم يقارب سجلاً قائماً في المسجد، فتظهر بطاقة ربط مع “تشابه {النسبة}٪ مع السجل الحالي”، وتُرفَق “بيانات متطابقة” حين تتفق بقيّة الحقول أيضاً.
- **تحديث بيانات الطالب** — عند الربط تُعرض فروق الحقول: “السهم إلى قيمة الإجابة. أزل التحديد لإبقاء السجل كما هو.” فتختار ما يُحدَّث وما يبقى.

#### الدفعات: الواضح أولاً ثم المتشابه

حين تقبل دفعة عبر «مراجعة وقبول المحددة» تقسمها المنصة خطوتين: [[الواضح]] ثم [[المتشابه]]. الأولى “{العدد} جاهزة للقبول” — “هذه الإجابات ليس لها توأم في الدفعة. اقبلها ثم نراجع الأسماء المتشابهة.” والثانية عنوانها “مراجعة الاسم المتشابه” ووصفها “السجلات المسجّلة للمقارنة فقط. اختر قراراً من قائمة كل إجابة.”

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

> **نصيحة:** بعض القرارات تُختار تلقائياً بوسم “اختير تلقائياً” حين يكون التطابق عالياً في الاسم والبيانات معاً. الوسم دعوة للتحقّق السريع لا إعفاء منه — امرر عليها قبل التطبيق.

![خطوة مراجعة الاسم المتشابه مع جدول مقارنة الإجابات](https://manual.misbah.pro/images/forms/04-similar-names.png)

### أسئلة شائعة

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

**لماذا لا يستقبل نموذجي أي إجابات؟**
غالباً لأنه ما زال [[مسودة]]، أو أُغلق، أو انتهت «فترة القبول»، أو بلغ «الحد الأقصى للإجابات». وصفحة النموذج تعلن ذلك للزائر: “قد يكون النموذج مغلقاً أو غير منشور”.

**هل أحذف نموذجاً أو إجابة؟**
لا يوجد حذف في المنصة لا للنماذج ولا للإجابات. أغلق النموذج ليتوقف عن الاستقبال، وارفض الإجابة لتخرج من الطابور مع بقائها في قائمة [[مرفوضة]].

**هل يصل ولي الأمر إشعار بقبول طلبه؟**
لا يُرسَل إشعار تلقائي عند القبول ولا عند الرفض. ما يراه المرسِل هو رسالة الإرسال وحدها: “تم إرسال إجابتك بنجاح” ثم “شكراً لمشاركتك”. أبلغهم من [الإشعارات](https://manual.misbah.pro/notifications) بعد اكتمال المراجعة.

**قبلت طلباً ونسيت اختيار البرنامج — ماذا أفعل؟**
لا شيء ضاع. الطالب صار في سجل المسجد، وسجّله في البرنامج من صفحة [الطلاب](https://manual.misbah.pro/students) مثل أي طالب آخر.

**أضفت حقلاً بعد وصول إجابات — هل تتأثر القديمة؟**
الإجابات القديمة تبقى كما وردت، ويظهر الحقل الجديد فيها فارغاً بوسم [[لم يُجب]]. لذلك اضبط الحقول قبل النشر ما استطعت.

---

## تطبيق المستفيدين

المصدر: https://manual.misbah.pro/consumer-app

المستفيد هو من يتابع الطالب من خارج الإدارة: أبوه أو أمه أو الطالب نفسه. هنا تعرّف أنواعهم، وتدعوهم بأرقام جوالاتهم، وتتابع من أتمّ الربط ومن لم يُتمّه.

الجمهور: مشرف، مستفيد

### من هو «المستفيد»؟

حلقة القرآن لا تنتهي عند باب المسجد. المستفيد في مصباح هو الشخص الذي يتابع الطالب من خارج الإدارة — أبوه غالباً، أو أمه، أو الطالب نفسه — ويحمل في جيبه تطبيقاً يريه ما سُجِّل اليوم. وما لم يُربَط حسابه بسجل الطالب، فهو بالنسبة للمنصة غير موجود.

> **ملخّص سريع**
> - ما هذا؟ دعوة أولياء الأمور والطلاب إلى تطبيق مصباح، وربط حساباتهم بسجلات الطلاب.
> - لماذا يهمّك؟ الربط هو ما يحوّل التسجيل الإداري إلى متابعة أسرية، وهو شرط قناة الإشعار داخل التطبيق.
> - لمن؟ مشرف
> - الوقت المتوقّع: ٢٠ دقيقة

فيديو: تطبيق مصباح https://www.youtube.com/watch?v=0G9RSvn2I9Q

المسار: الطلاب ← ربط المستفيدين

- **المستفيد** — شخص له حساب في تطبيق مصباح، يُعرَّف عندكم برقم جواله لا باسمه.
  الرقم هو ما يصل إليه الدعوة، وهو ما يميّز أباً عن أب في مسجد فيه عائلات متشابهة الأسماء.
- **الرابط** — علاقة بين مستفيد وطالب، تحمل **نوع المستفيد** وصلاحيته.
  الربط لا التسجيل هو ما يفتح للأب بيانات ابنه، ويغلق عنه بيانات غيره.
- **نوع المستفيد** — تسمية يضعها المسجد — أب، أم، أخ — تُصنَّف تحت فئة ولي أمر أو طالب.
  هو ما يتيح لاحقاً مخاطبة الآباء وحدهم في [الإشعارات](https://manual.misbah.pro/notifications#audience).

الصفحة نفسها تصف مهمّتها: “متابعة الروابط الفعلية وطلبات الدعوة للمستفيدين عبر تطبيق مصباح.” وسطر الملخّص أعلاها يقرأ حالة المسجد كلها في نظرة: “من أصل ١٢٠ طالب · ٨٤ مرتبط · ٣٦ بدون ربط · ٩١ مستفيد · ٧ طلب معلق”.

> **انتبه:** الصفحة كلها مرتبطة بميزة [[تطبيق مصباح]] في الباقة؛ فإن كانت خارجها ظهرت بدل المحتوى: “دعوات تطبيق مصباح وربط أولياء الأمور غير متاحة في خطتك الحالية.” راجع [الباقات والصلاحيات](https://manual.misbah.pro/entitlements).

![صفحة ربط المستفيدين مع سطر الملخص وتبويبي الطلاب والطلبات](https://manual.misbah.pro/images/consumer-app/01-links-hub.png)

### الأنواع قبل الدعوات

قبل أي دعوة يحتاج المسجد قائمة أنواع خاصة به. النوع ليس حلية: هو الوسم الذي ستخاطب به الناس لاحقاً، فلا تصل رسالة موجّهة للآباء إلى الإخوة الصغار.

لا توجد صفحة مستقلة للأنواع: تُنشَأ من داخل منتقي النوع نفسه بـ«إضافة نوع مستفيد جديد». حوار “إضافة نوع مستفيد” يشرح المطلوب: “أنشئ نوعاً مخصصاً (مثل «أب»، «أم»، «أخ») واربطه بفئة ولي أمر أو طالب.”

- **اسم النوع** — الاسم كما تريده أنت — “مثال: أب، أم، أخ”. والشرط الوحيد: “اسم النوع يجب أن يكون حرفين على الأقل”.
- **الفئة** — تصنيف النوع تحت [[ولي أمر]] أو [[طالب]]. والواجهة صريحة في أثره: “الفئة تحدد صلاحيات المستفيد في تطبيق مصباح.”

#### ولي أمر أم طالب؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| [[ولي أمر]] (الافتراضي) | المتابِع بالغ مسؤول عن الطالب: أب، أم، أخ كبير، وصيّ. | يرى تقدّم من يتابعه ويستقبل إشعارات المتابعة الدورية. | يحتاج رقم جوال خاصاً به لا رقم الطالب. |
| [[طالب]] (متقدّم) | الطالب نفسه كبير ويملك جوالاً، وتريده أن يتابع خطته بيده. | يرفع مسؤولية الطالب عن حفظه، ويقلّل وساطة المعلّم في السؤال عن الورد. | صلاحيته في التطبيق تختلف عن صلاحية ولي الأمر، فلا تُغني عنها. |

> **ملاحظة:** الأنواع تُضاف ولا تُحذف من هذه الشاشة، وكل نوع جديد يولد نشطاً ومتاحاً فوراً. اختر الأسماء بعناية أول مرة، وأبقِها قليلة ومفهومة — ثلاثة أنواع أنفع من عشرة.

![حوار إضافة نوع مستفيد مع حقلي اسم النوع والفئة](https://manual.misbah.pro/images/consumer-app/04-consumer-type.png)

### كيف يصير المستفيد مرتبطاً

المسار باتجاه واحد: المسجد يدعو برقم الجوال، والمستفيد يقرّر في التطبيق. لا يستطيع أحد من الإدارة أن يقبل عن المستفيد أو يرفض عنه؛ غاية ما تملكه هو سحب الدعوة ما دامت معلّقة.

1. اختر الطلاب
   دعوة واحدة من صفحة الطالب، أو دعوة جماعية لطلاب محدّدين أو لنتيجة تصفية أو لجميع طلاب المسجد. الدفعة الواحدة تتّسع لمئة دعوة، وما زاد يُقسَّم تلقائياً.
2. «حقل الجوال والنوع»
   اختر الحقل الذي يحمل رقم المستفيد في [هيكلة الطالب](https://manual.misbah.pro/students#structure) — “اختر الحقل الذي يحتوي رقم جوال المستفيد في ملف كل طالب.” — ثم نوع المستفيد لهذه الدفعة، ثم نصّ الدعوة الذي يراه المستلم.
3. «مراجعة الطلاب»
   الشاشة تفرز قبل الإرسال: “جاهز للإرسال” و“بدون رقم صالح” و“مستبعد يدوياً”. أرقام فارغة أو غير سعودية تُرفض برسالتَي “رقم الجوال فارغ” و“رقم جوال غير صالح”.
4. «معاينة وإرسال»
   الملخّص يقول كم دعوة ستخرج ولأي نوع، ثم “سيستلم المستفيد الإشعار في تطبيق مصباح.”
   ![معالج الدعوة الجماعية عند خطوة مراجعة الطلاب مع حالات الأرقام](https://manual.misbah.pro/images/consumer-app/02-invite.png)

> **نظّف أرقام الجوال قبل الحملة:** أكبر سبب لفشل حملة ربط ليس التطبيق، بل حقل جوال نصفه فارغ أو مكتوب بصيغ مختلفة. افتح [الطلاب](https://manual.misbah.pro/students) وصحّح الحقل مرة واحدة، ثم أرسل — أهون من متابعة أربعين دعوة لم تصل.

> **ملاحظة:** لطالب واحد يمكن إرسال أكثر من دعوة بأنواع مختلفة: دعوة للأب ودعوة للأم. هذا بالضبط ما يتيح لاحقاً توجيه إشعار لنوع دون آخر.

### متابعة ما بعد الإرسال

تبويب «طلبات الدعوة» يتابع كل دعوة على حدة، وتبويب «الطلاب والروابط» يجيب عن السؤال الأهم إدارياً: كم طالباً عندنا بلا مستفيد واحد؟

*حالات طلب الدعوة*
| الحالة | المعنى | ماذا تملك |
| --- | --- | --- |
| [[قيد الانتظار]] بتحفّظ | أُرسلت الدعوة ولم يتصرّف فيها المستفيد بعد. | «إلغاء» الطلب وحده |
| [[مقبول]] مناسب | أتمّ المستفيد الربط، وصار يرى الطالب ويستقبل إشعاراته. | لا شيء — الرابط قائم |
| [[مرفوض]] غير مناسب | رفض المستفيد الطلب من التطبيق. | أعد الدعوة بعد التأكد من الرقم |
| [[ملغى]] | سحبت الإدارة الطلب — “أُلغي طلب ربط المستفيد بنجاح”. | أعد الإرسال متى شئت |

وعلى مستوى الطالب تظهر حالة واحدة صريحة: [[مرتبط]] أو [[غير مرتبط]]، ومعها شارة تعدّ طلباته المعلّقة. توسيع الصف يعرض “الروابط النشطة:” و“طلبات الدعوة قيد الانتظار:” ومنه تدعو مستفيداً إضافياً أو تلغي طلباً.

> **نصيحة:** قبل أي حملة إشعارات عبر التطبيق، افتح هذه الصفحة واقرأ رقم “بدون ربط”. الإرسال إلى غير المرتبطين لا يصل ولا يُنبِّهك أحد، وستظن أن الرسالة وصلت.

![جدول طلبات الدعوة بحالات مختلفة](https://manual.misbah.pro/images/consumer-app/03-requests.png)

### ما يراه المستفيد وما لا يراه

تطبيق مصباح ليس نسخة مصغّرة من لوحة الإدارة. هو نافذة ضيّقة ومقصودة الضيق: يرى صاحبها من ارتبط بهم فقط.

- يرى الطلاب المرتبطين بحسابه — لا طلاب الحلقة ولا طلاب المسجد.
- يستقبل إشعارات البرنامج الموجّهة إلى نوعه عبر قناة “إشعار داخل التطبيق للمستفيدين المرتبطين”.
- لا يسجّل حضوراً ولا تسميعاً ولا يعدّل خطة؛ التسجيل من عمل المعلّم في [الحلقة](https://manual.misbah.pro/teaching).
- لا يرى أرقام تواصل بقية الطلاب ولا بيانات أولياء أمورهم.

> **ملاحظة:** حدود ما يعرضه التطبيق تتبع «الفئة» التي صنّفت بها النوع — “الفئة تحدد صلاحيات المستفيد في تطبيق مصباح.” — وتفصيل شاشات التطبيق نفسه خارج نطاق هذا الدليل لأنه تطبيق مستقل عن لوحة الإدارة.

### أسئلة شائعة

**ولي الأمر لم تصله الدعوة.**
ابدأ من الرقم: تحقّق أنه صحيح في ملف الطالب، وأنه الحقل الذي اخترته في خطوة «حقل الجوال والنوع». ثم اقرأ حالة الطلب — إن كانت [[قيد الانتظار]] فالدعوة خرجت ولم يتصرّف فيها بعد.

**هل يستطيع المشرف قبول الطلب نيابة عن ولي الأمر؟**
لا. القبول والرفض يقعان في التطبيق من صاحب الحساب نفسه. الإدارة تملك الإلغاء ما دام الطلب معلّقاً، وإعادة الإرسال بعده.

**أب وأم لنفس الطالب — هل أرسل دعوتين؟**
نعم، بنوعَي مستفيد مختلفين. هذا ما يتيح لاحقاً توجيه الإشعار إلى الآباء وحدهم أو الأمهات وحدهن.

**هل يرى ولي الأمر بيانات طلاب آخرين؟**
لا. الرابط يخصّ الطالب أو الطلاب المرتبطين بحسابه فقط.

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

**لماذا لا تظهر لي صفحة «ربط المستفيدين» أصلاً؟**
لأن ميزة [[تطبيق مصباح]] خارج باقتكم. ستقرأ بدلها “دعوات تطبيق مصباح وربط أولياء الأمور غير متاحة في خطتك الحالية.”

---

## إعدادات المسجد

المصدر: https://manual.misbah.pro/settings

ثلاث دوائر في صفحة واحدة: ما يخصّ جهازك، وما يخصّ حسابك، وما يخصّ المسجد كله — ومعها الباقة التي تفتح مزايا المنصة أو تغلقها.

الجمهور: مشرف، معلّم

### ثلاث دوائر لا دائرة واحدة

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

> **ملخّص سريع**
> - ما هذا؟ مركز واحد للمظهر والأمان وهوية المسجد والتقويم والاشتراك.
> - لماذا يهمّك؟ لأن كل إعداد هنا يغيّر ما يراه شخص آخر أو ما تستطيع المنصة فعله أصلاً.
> - لمن؟ مشرف، معلّم
> - الوقت المتوقّع: ١٠ دقائق

المسار: الشريط السفلي ← الإعدادات

وصف الصفحة نفسه يلخّص الثلاث: “خصّص تجربتك، أمّن حسابك، وأدر إعدادات المسجد من مكان واحد.”

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

*من يملك ماذا*
| الإعداد | أين يُحفظ | من يتأثر |
| --- | --- | --- |
| «المظهر» للعلم | متصفح هذا الجهاز | أنت وحدك على هذا الجهاز |
| «الأمان والحساب» مناسب | حسابك | أنت على كل أجهزتك |
| «هوية المسجد» بتحفّظ | سجل المسجد | كل من يفتح صفحات المسجد العامة |
| «الوقت والتقويم» للعلم | تفضيل العرض | قراءة التواريخ في كل الشاشات |
| «الاشتراك والفواتير» بتحفّظ | اشتراك المسجد | ما تستطيع المنصة فعله أصلاً |

> **ملاحظة:** مجموعة «إعدادات المسجد» لا تظهر للمعلّم ولا لمن ليس مشرفاً على المسجد؛ يرى «التفضيلات» و«الوقت والتقويم» و«الجلسة» فقط.

![صفحة الإعدادات مع مجموعتي التفضيلات وإعدادات المسجد](https://manual.misbah.pro/images/settings/01-settings-hub.png)

### المظهر

مجموعة «التفضيلات» تقود إلى «المظهر» — “تغيير المظهر والألوان”. ووصف الصفحة نفسها: “نمط الإضاءة ولون المصباح على هذا الجهاز. التغييرات تُطبَّق فوراً.”

- **نمط الإضاءة** — [[الفاتح]] — “ورق هادئ للعمل النهاري”، و[[الداكن]] — “فحم دافئ للعمل الليلي”. الوصف المختصر: “الفاتح للورق، والداكن لليل.”
- **لون السمة** — “ضوء المصباح في الأزرار والتركيز والحالات النشطة.” لون واحد يسري على كل عناصر التفاعل.

المعاينة الجانبية تعرض الأزرار والشارات والحقول بالإعداد الجديد قبل أن تعتمده، وتحتها سطر صريح: “يُحفظ المظهر على هذا الجهاز فوراً”.

> **ملاحظة:** لا زرّ حفظ هنا ولا مزامنة. افتح المنصة من جوالك بعد ضبط المظهر على الحاسوب، وستجد الإعداد الافتراضي من جديد — اضبطه مرة على كل جهاز تعمل عليه.

![صفحة المظهر مع نمط الإضاءة وألوان السمة والمعاينة](https://manual.misbah.pro/images/settings/02-appearance.png)

### الأمان والحساب

«الأمان والحساب» — “راجع الأجهزة المتصلة، سجّل مفتاح مرور، وفعّل المصادقة الثنائية لحماية حسابك.” ثلاث بطاقات تحمي مدخل المسجد كله، لأن حساب المشرف يفتح بيانات مئات الطلاب.

- **مفتاح المرور** — “دخول آمن ببصمة الإصبع أو Face ID”. مرتبط بالجهاز، فسجّله على كل جهاز تستعمله بانتظام. التوصية في الواجهة: “يُنصح بتسجيله لتأمين الدخول وتقليل الاعتماد على الرمز النصي وحده”.
- **المصادقة الثنائية** — “رمز متغيّر من تطبيق على جوالك — حماية إضافية بعد تسجيل الدخول.” لا تحتاج شبكة ولا رسالة، فهي المسار الاحتياطي حين يتعذّر الجهاز الأساسي.
- **الأجهزة والجلسات** — “الأجهزة المتصلة بحسابك. إنهاء جلسة يسجّل الخروج من ذلك الجهاز فوراً.” راجعها بعد كل جهاز أعرته أو بعته.

> **لا تُسقِط آخر عامل حماية:** حسابات مشرف المسجد ومدير النظام يلزمها عامل واحد على الأقل. محاولة إلغاء آخر مفتاح مرور تُرفض برسالة صريحة: “لا يمكن إلغاء آخر مفتاح مرور قبل تفعيل المصادقة الثنائية. يجب الإبقاء على أحدهما على الأقل.” سجّل البديل أولاً، ثم احذف القديم — [تفاصيل التسجيل](https://manual.misbah.pro/login#enroll-mfa).

![صفحة الأمان والحساب مع بطاقات مفتاح المرور والمصادقة الثنائية والأجهزة](https://manual.misbah.pro/images/settings/03-security.png)

### هوية المسجد والعنوان

مجموعة «إعدادات المسجد» — “هوية المسجد، هيكلية الطلاب، والاشتراك” — يراها مشرف المسجد وحده. أولها «هوية المسجد»: “الشعار والعنوان الظاهران للطلاب عند تصفح النماذج العامة.”

- «الشعار الحالي» — شعار المسجد. يظهر في الشريط الجانبي وعلى صفحة الحلقة و[النماذج العامة](https://manual.misbah.pro/apps#forms)، ومنه تُشتقّ ألوان [شاشة العرض](https://manual.misbah.pro/monitor#brand). إن لم تُرفع صورة، تظهر علامة مصباح بدلاً منها.
- «عنوان المسجد» — “المدينة والحي ورابط الخرائط”.
- «بيانات التواصل» — ما يصل إلى المستفيد حين يحتاج إليكم.
- «هيكلية الطالب» — “تعديل معلومات الطلاب”؛ شرحها في [دليل الطلاب](https://manual.misbah.pro/students).

> **انتبه:** رفع الشعار وتخصيص الهوية مرتبطان بميزة [[الهوية والشعار]] في الباقة. إن كانت خارج باقتكم فسيظهر: “رفع شعار المسجد وتخصيص الهوية غير متاح في خطتك الحالية.”

![صفحة هوية المسجد مع الشعار الحالي والعنوان وبيانات التواصل](https://manual.misbah.pro/images/settings/04-mosque-identity.png)

### الوقت والتقويم

«الوقت والتقويم» — “يؤثر على عرض التواريخ في كل النظام”، و“اختر نظام التقويم لعرض وإدخال التواريخ في النظام”. الاختيار لا يغيّر البيانات المخزّنة، بل يغيّر لغة قراءتها وإدخالها في كل شاشة.

#### هجري أم ميلادي؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| «التقويم الهجري» (الأنسب غالباً) | يتحدث المعلمون وأولياء الأمور بالتاريخ الهجري، وترتبط الدورات برمضان والإجازات الشرعية. | تُقرأ التقارير وشاشة العرض بالتقويم الذي يألفه الحي، فلا يترجم أحد في رأسه. | بدايات الأشهر قد تفارق ما اعتاده من يخطّط بالميلادي. |
| «التقويم الميلادي» (الافتراضي) | يرتبط البرنامج بالفصل الدراسي الرسمي أو بجهة تطلب تقارير ميلادية. | يطابق تواريخ المدارس والجهات الداعمة دون تحويل. | يبتعد عن لغة الحلقة اليومية في كثير من المساجد. |

> **نصيحة:** اضبطه مرة واحدة في بداية التشغيل. تغييره بعد شهور يقلب صيغة التواريخ في الحضور والتقارير و[شاشة العرض](https://manual.misbah.pro/monitor) معاً، فيربك من حفظ مواعيده بالصيغة السابقة.

بجواره مجموعة «الجلسة» لتسجيل الخروج من هذا الجهاز.

### الباقة تقرّر ما تستطيع المنصة فعله

«الاشتراك والفواتير» — “حالة الاشتراك والتجديد وسجل المدفوعات” — ليست صفحة محاسبة فحسب. الباقة تحمل قائمة مزايا مفعّلة، وكل ميزة مغلقة تعني زرّاً لا يستجيب في مكان بعيد تماماً عن هذه الصفحة.

- **الباقة** — اشتراك المسجد: عدد المقاعد، ومدة الفترة، وقائمة المزايا المفعّلة.
  هي الجواب الوحيد عن سؤال يتكرّر في كل مسجد: لماذا لا يعمل هذا الزرّ عندنا؟
- **الميزة المقفلة** — قدرة موجودة في المنتج لكنها غير مفعّلة في باقتكم؛ الضغط عليها يفتح حواراً باسم الميزة وسبب القفل.
  القفل واجهة مهذّبة لا خطأ: النص يسمّي الميزة، والزر «عرض الاشتراك» ينقل مشرف المسجد إلى الترقية مباشرة.
- **الحدّ الرقمي** — سقف عددي لا مفتاح تشغيل: المقاعد، والمعلمون، وحسابات واتساب، وسعة التخزين، والبرامج.
  الميزة قد تكون مفتوحة ويمنعك الحدّ وحده، فرسالة الخطأ تختلف عن رسالة القفل.

خريطة المزايا كاملة — وأثر كل واحدة على الشاشات — في [دليل الباقات والصلاحيات](https://manual.misbah.pro/entitlements#features). وهذا ملخّصها كما تسمّيها الواجهة:

*مزايا الباقة وأين يظهر أثرها*
| الميزة | ما تفتحه | أين تلاحظ غيابها |
| --- | --- | --- |
| [[واتساب]] للعلم | ربط حساب واتساب وإرسال الإشعارات عبره. | قناة واتساب في [معالج الإشعارات](https://manual.misbah.pro/notifications#choices) |
| [[تطبيق مصباح]] للعلم | دعوات الربط وحسابات أولياء الأمور. | [ربط المستفيدين](https://manual.misbah.pro/consumer-app#link) وقناة إشعار التطبيق |
| [[المحفظة والخطط المرنة]] للعلم | وحدات النقاط والأرصدة والخطط غير القرآنية. | [المحفظة](https://manual.misbah.pro/wallet) و[الخطط المرنة](https://manual.misbah.pro/flexible-plans) |
| [[المناهج]] للعلم | تجميع القوالب في منهج يُطبَّق دفعة واحدة. | [المناهج](https://manual.misbah.pro/curriculum) |
| [[النماذج]] للعلم | نماذج التسجيل العامة واستقبال الطلبات. | [النماذج](https://manual.misbah.pro/apps#forms) |
| [[التخزين]] للعلم | رفع الملفات والوسائط. | مرفقات الإشعارات وملفات [التطبيقات](https://manual.misbah.pro/apps#storage) |
| [[الهوية والشعار]] للعلم | شعار المسجد وتخصيص الهوية. | [هوية المسجد](https://manual.misbah.pro/settings#mosque) وألوان شاشة العرض |
| [[شاشات مخصصة]] للعلم | بقية قوالب شاشة العرض وبناء قالب بالذكاء الاصطناعي. | [استوديو شاشة العرض](https://manual.misbah.pro/monitor#templates) |
| [[حضور مخصص]] للعلم | تعريف حالات حضور خاصة بدل الأنظمة الجاهزة. | [هيكلة الحضور](https://manual.misbah.pro/attendance#structure) |
| [[الحلقات عن بُعد]] للعلم | وسم الحلقة بأنها عن بُعد. | [إنشاء الحلقة](https://manual.misbah.pro/groups#groups) |
| [[المعلمون المساعدون]] للعلم | ربط أكثر من معلّم بالحلقة الواحدة. | [صلاحيات الوصول](https://manual.misbah.pro/groups#access) |
| [[إدارة مشرفي المسجد]] للعلم | إضافة مشرفين آخرين للمسجد ذاتياً. | لا شاشة لها بعد داخل المسجد — يتولّاها الدعم |

> **ملاحظة:** صيغة رسالة القفل واحدة في كل مكان: عنوانها اسم الميزة، ونصّها “… غير متاح في خطتك الحالية.”، وأزرارها «حسناً» و«عرض الاشتراك». ومن ليس مشرفاً على المسجد يقرأ بدلها: “تواصل مع مشرف المسجد لترقية الباقة.”

لرفع المقاعد أو ترقية الباقة افتح «الاشتراك والفواتير»، أو تواصل مع الدعم عبر [واتساب](https://wa.me/966537567763).

### أسئلة شائعة

**غيّرت المظهر ولم يتغيّر على جوالي.**
المظهر يُحفظ في متصفح كل جهاز على حدة ولا يُزامَن مع الحساب. اضبطه مرة على كل جهاز تعمل عليه.

**زميلي مشرف ولا يرى «إعدادات المسجد».**
المجموعة تظهر لمشرف المسجد ومدير النظام فقط. المعلّم ومن دونهما يرون «التفضيلات» و«الوقت والتقويم» و«الجلسة».

**لماذا يظهر زرّ ثم يفتح حوار قفل بدل أن يعمل؟**
الميزة خارج باقتكم. عنوان الحوار هو اسم الميزة، ونصّه “… غير متاح في خطتك الحالية.” افتح «عرض الاشتراك» للترقية، أو راجع [دليل الباقات والصلاحيات](https://manual.misbah.pro/entitlements).

**هل تغيير التقويم يعدّل تواريخ سُجّلت سابقاً؟**
لا. البيانات تبقى كما هي؛ ما يتغيّر هو صيغة عرضها وإدخالها في كل الشاشات.

**أين أرفع شعار المسجد؟**
من «الإعدادات» ثم «هوية المسجد». الشعار يظهر للطلاب وأولياء الأمور في النماذج العامة، وتُشتقّ منه ألوان شاشة العرض.

---

## الباقة والميزات

المصدر: https://manual.misbah.pro/entitlements

باقة المسجد تقرّر أمرين: أي ميزات تُفتح، وكم من كل شيء تملك. هنا خريطة الميزات الاثنتي عشرة، ومعنى المقاعد والحدود، وما يحدث عند انتهاء الاشتراك.

الجمهور: مشرف

### ما الذي تشتريه الباقة

حين يختفي زرّ من الواجهة أو يظهر رمادياً، السبب في الغالب ليس خطأ ولا صلاحية ناقصة: باقة المسجد لا تتضمّن تلك الميزة. الباقة تبيعك شيئين مختلفين — **ميزات** تُفتح أو تُقفل، و**حدوداً** تُعدّ وتُستهلك.

> **ملخّص سريع**
> - ما هذا؟ اشتراك المسجد يحدّد الميزات المفتوحة والحدود القصوى للطلاب والبرامج والمعلمين والتخزين والإشعارات.
> - لماذا يهمّك؟ أكثر أسئلة “لماذا لا أجد هذا الزر؟” جوابها هنا، لا في دليل الميزة نفسها.
> - لمن؟ مشرف
> - الوقت المتوقّع: ١٠ دقائق

المسار: الشريط السفلي ← الإعدادات ← الاشتراك والفواتير

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

> **ملاحظة:** **القفل تُنفّذه الخوادم لا الواجهة.** بينما تُحمّل بيانات الاشتراك تظهر الواجهة مفتوحة، ثم يُرفض الطلب من الخادم إن لم تكن الميزة مشمولة. فلا تستنتج من ظهور زر لحظةً أن الميزة متاحة.

**الاستحقاق** — الصورة النهائية لما يملكه المسجد الآن: الميزات المفتوحة، والحدود، وعدد المقاعد، وتاريخ انتهاء الفترة الحالية. تُحسب من الباقة المشتركة ومن أي سعة إضافية اشتريتها فوقها.

### الميزات الاثنتا عشرة

هذه كل الميزات التي تفصلها الباقة. لكل واحدة اسم يظهر لك في رسالة القفل، وموضع واحد أو أكثر تراها فيه مقفلة.

*الميزة، وما تفتحه، وأين تراها مقفلة*
| الميزة | ما تفتحه | موضع القفل | الدليل |
| --- | --- | --- | --- |
| [[المحفظة والخطط المرنة]] `wallet` للعلم | نظام النقاط كاملاً، والخطط المرنة، ومكتبة هياكل الخطط. | بطاقة «خطة مرنة» عند اختيار نوع الخطة تصير “متاح بترقية الباقة — المحفظة والخطط المرنة”، و«مكتبة الخطط» تُقفل بكاملها. | [المحفظة](https://manual.misbah.pro/wallet) · [التطبيقات](https://manual.misbah.pro/apps#library) |
| [[المناهج]] `curriculum` للعلم | إنشاء المناهج وتعديلها وتطبيقها دفعة واحدة. | زر إضافة المنهج يبقى ظاهراً، فإذا ضغطته فُتحت رسالة “إنشاء وتعديل المناهج غير متاح في خطتك الحالية.” | [الخطط والمناهج](https://manual.misbah.pro/plans) |
| [[النماذج]] `forms` للعلم | نماذج التسجيل العامة وطابور مراجعتها. | صفحة النماذج كلها تُستبدل بشاشة قفل: “النماذج والاستبيانات غير متاحة في خطتك الحالية.” | [النماذج](https://manual.misbah.pro/forms) |
| [[التخزين]] `storage` للعلم | رفع الملفات ومستودع المسجد، واختيار ملف من التخزين داخل النماذج والإشعارات. | صفحة التخزين تُقفل بكاملها، ويختفي خيار الاختيار من التخزين عند رفع صورة في نموذج. | [التطبيقات](https://manual.misbah.pro/apps#storage) |
| [[واتساب]] `whatsapp` للعلم | ربط أرقام واتساب وإرسال الإشعارات منها. | صفحة واتساب تُقفل: “ربط واتساب وإرسال الإشعارات غير متاح في خطتك الحالية.” | [التطبيقات](https://manual.misbah.pro/apps#whatsapp) · [الإشعارات](https://manual.misbah.pro/notifications) |
| [[تطبيق مصباح]] `consumerApp` للعلم | دعوة أولياء الأمور وربط حساباتهم بالطلاب. | صفحة ربط المستفيدين تُقفل، وزر الربط في صفحة الطلاب يفتح “دعوات تطبيق مصباح وربط أولياء الأمور غير متاحة في خطتك الحالية.” | [تطبيق المستفيدين](https://manual.misbah.pro/consumer-app) |
| [[حضور مخصص]] `attendanceCustom` بتحفّظ | إنشاء حالات حضور خاصة بك وتعديلها وحذفها. | الأنظمة الجاهزة تبقى متاحة، وزر إضافة الحالة يصير “إضافة حالة — ترقية الباقة”. | [الحضور](https://manual.misbah.pro/attendance) |
| [[شاشات مخصصة]] `monitorCustom` بتحفّظ | بقيّة تصاميم شاشة العرض، وإنشاء قالب بالذكاء الاصطناعي. | “باقتك الحالية تتيح قالباً واحداً لشاشة العرض.” وبقيّة القوالب عليها “متاح بترقية الباقة”، والاختيار يعود تلقائياً إلى القالب المضمّن. | [شاشة العرض](https://manual.misbah.pro/monitor) |
| [[الحلقات عن بُعد]] `remoteGroups` بتحفّظ | تعليم الحلقة بأنها عن بُعد وربطها برابط اجتماع. | مفتاح «عن بعد» في نافذة الحلقة يفتح “الحلقات عن بُعد غير متاحة في خطتك الحالية.” بدل أن يعمل. | [الحلقات والمعلمون](https://manual.misbah.pro/groups) |
| [[المعلمون المساعدون]] `teachingAssistants` بتحفّظ | منح معلّم آخر صلاحية العمل في حلقة ليست حلقته. | زرّ إضافة المساعد يصير “معلم مساعد — ترقية الباقة”. | [الحلقات والمعلمون](https://manual.misbah.pro/groups) |
| [[الهوية والشعار]] `branding` | رفع شعار المسجد وتخصيص الهوية. | كل مسارات رفع الشعار وقصّه وحذفه تفتح “رفع شعار المسجد وتخصيص الهوية غير متاح في خطتك الحالية.” | [إعدادات المسجد](https://manual.misbah.pro/settings) |
| [[إدارة مشرفي المسجد]] `mosqueAdminSelfServe` | إدارة مشرفي المسجد من داخل المسجد نفسه. | رسالة القفل: “إدارة مشرفي المسجد غير متاحة في خطتك الحالية.” وعدد المشرفين محكوم بحدّ مستقل. | [إعدادات المسجد](https://manual.misbah.pro/settings) |

نافذة القفل واحدة في كل المواضع: عنوانها اسم الميزة، ونصّها سطر واحد يشرح ما ينقص، وزرّها «عرض الاشتراك» — أو «حسناً» لإغلاقها. وإن لم تكن مشرفاً ظهر لك بدل الزر: “تواصل مع مشرف المسجد لترقية الباقة.”

> **نصيحة:** الأساسيات لا تُقفل أبداً: الدخول، البرامج، الحلقات، الطلاب والتسجيلات، الخطط القرآنية، تسجيل الحضور نفسه، الأنشطة، الأداء، والتقارير. ما تقفله الباقة هو ما فوق ذلك.

![نافذة ميزة مقفلة تعرض اسم الميزة ورسالة الترقية](https://manual.misbah.pro/images/entitlements/02-feature-lock.png)

### الحدود والمقاعد

الحدّ لا يشبه الميزة: لا ينبّهك بقفل، ولا يمنعك من شيء… حتى تبلغه. عندها يتوقّف زرّ الإضافة وحده، وتبقى كل بياناتك وكل ما هو قائم يعمل كما هو.

*الحدود التي تراها في الواجهة*
| الحدّ | ما يعدّه | أين يظهر |
| --- | --- | --- |
| [[مقاعد الطلاب]] للعلم | عدد طلاب المسجد كلهم، لا طلاب برنامج واحد. | شارة في صفحة الطلاب تعرض العدد والسقف وحالة الامتلاء. |
| [[البرامج]] للعلم | عدد البرامج في المسجد. | عند الإنشاء أو النسخ أو تثبيت قالب: “وصلت للحد الأقصى للبرامج المسموح بها في هذه المسجد.” |
| [[المعلمون]] للعلم | حسابات المعلمين في المسجد. | عند إضافة معلّم جديد أو استيراد دفعة. |
| [[مشرفو المسجد]] للعلم | حسابات المشرفين. | عند إضافة مشرف جديد. |
| [[حسابات واتساب]] للعلم | الأرقام المربوطة. | “تم الوصول للحد الأقصى من الحسابات المسموح بها في باقتك الحالية”. |
| [[التخزين]] للعلم | مجموع أحجام الملفات الأصلية بالجيجابايت. | بطاقة “المساحة” في صفحة التخزين، وتتلوّن كلما اقتربت. |
| حدّ الإشعارات بتحفّظ | عدد عمليات الإرسال في اليوم وفي الأسبوع. | عند الإرسال: “تم بلوغ الحد اليومي للإشعارات ({العدد}). أعد المحاولة غداً.” ومثله للأسبوع. |

> **كيف تُقرأ شارة سعة الطلاب:** الشارة في صفحة الطلاب تعرض `العدد الحالي / السقف` ثم كلمة حالة: [[متاح]] ثم [[جيد]] عند بلوغ ثلاثة أرباع السقف، ثم [[قريب من الامتلاء]] حين يتبقّى عشرة أو أقل، ثم [[شبه ممتلئ]] حين يتبقّى خمسة أو أقل، ثم [[ممتلئ]]. وإن كانت باقتك بلا سقف للطلاب ظهرت [[غير محدود]].
> راقبها قبل فتح باب التسجيل: نموذج مفتوح على مسجد ممتلئ يجمع طلبات لا تستطيع قبولها.

عند بلوغ أي حدّ يظهر تنبيه موحّد: “تم بلوغ حد {اسم الحدّ} ({المستهلك} / {السقف})” ومعه “زد السعة من الاشتراك لتضيف المزيد. تدفع المتبقي من الفترة فقط.” وزرّ «زيادة السعة» ينقلك مباشرة إلى نافذة شراء الكمية.

#### بلغت حدّاً — ماذا تفعل؟
| الخيار | اختره حين | ما تكسبه | ما يكلّفك |
| --- | --- | --- | --- |
| زيادة السعة (الأنسب غالباً) | الميزات مفتوحة وينقصك عدد فقط: مقاعد أو معلمون أو برامج أو تخزين. | تزيد ما تحتاجه وحده وتبقى على باقتك، وتُفعَّل فور الدفع. | لا تفتح ميزة مقفلة؛ الكمّية شيء والميزة شيء آخر. |
| تغيير الباقة | تحتاج ميزة مقفلة — مثل المحفظة أو المناهج أو واتساب — لا مجرّد كمّية أكبر. | تفتح الميزة وترفع الحدود القصوى معاً. | “التغيير يسري من التجديد القادم دون رسوم اليوم.” فلا يفتح لك شيئاً هذه اللحظة. |
| مراجعة الاستهلاك | السقف معقول لكن الاستهلاك متضخّم: ملفات قديمة، أو حسابات معلمين لم تعد تعمل. | لا تكلفة، ونتيجة فورية. | حلّ مؤقّت لا يصلح حين يكون النمو حقيقياً. |

![شارة سعة الطلاب في صفحة الطلاب تعرض العدد والسقف](https://manual.misbah.pro/images/entitlements/03-capacity.png)

### ماذا يحدث عند الانتهاء

انتهاء الاشتراك لا يحذف شيئاً ولا يعطّل الحسابات. تدخل المنصة وضع **التجديد فقط**: يُغلق كل شيء إلا ما يلزم للدفع وتسجيل الدخول.

الانتقال لا يقع لحظة انتهاء الفترة: للمسجد **مهلة سبعة أيام** بعد تاريخ الانتهاء يعمل فيها كل شيء كالمعتاد، ثم يبدأ وضع التجديد فقط.

*من يرى ماذا في وضع التجديد فقط*
| من | ما يحدث | النص الذي يراه |
| --- | --- | --- |
| المشرف بتحفّظ | يُنقل إلى صفحة الاشتراك من أي صفحة يفتحها، ويستطيع الدفع والتجديد وتغيير الباقة. | “اشتراك المسجد منتهٍ أو غير نشط. يرجى تجديد الاشتراك للمتابعة.” |
| المعلّم غير مناسب | يُمنع من كل شيء ولا يستطيع الدفع. | “انتهى اشتراك المسجد” ومعه “تواصل مع مشرف المسجد لتجديد الاشتراك واستعادة الوصول.” |
| ولي الأمر في تطبيق مصباح مناسب | يحتفظ بالاطلاع على أبنائه المرتبطين. | لا رسالة — التطبيق يعمل كما هو. |

صفحة «الاشتراك والفواتير» تعرض “الاشتراك الحالي” بحالته — [[نشط]] أو [[قيد الانتظار]] أو [[متأخر الدفع]] أو [[ملغي]] أو [[منتهي]] — ومعها تاريخ البداية وتاريخ الانتهاء وعدد الأيام المتبقية. ويظهر تنبيه التجديد قبل الانتهاء بأيام، بعنوان “الاشتراك ينتهي قريباً جداً” أو “حان وقت التجديد” وزرّ «تجديد الاشتراك».

- **تجديد الاشتراك أو ادفع الفاتورة** — المسار المعتاد. وإن فشل آخر خصم ظهر “فشل آخر دفع” ومعه «ادفع الآن» و“حدّث البطاقة أو ادفع الآن لتجنب توقف الخدمة.”
- **تغيير الباقة** — ترقية أو تخفيض، ومعه تحديد عدد المقاعد ومدّة الفوترة. يسري من التجديد القادم لا اليوم.
- **زيادة السعة** — شراء كمّية إضافية داخل الباقة الحالية، وتُفعَّل فور الدفع.
- **إدارة الاشتراك** — قسم مطوي يضمّ وسيلة الدفع و“سجل المدفوعات” و«إلغاء التجديد» — والأخير “يوقف الاستمرار بعد نهاية الفترة الحالية.” ويمكن التراجع عنه قبل ذلك التاريخ.

> **انتبه:** عدد المقاعد لا ينزل تحت عدد طلابك الحاليين: “مسجّل لديك {العدد} طالب — المقاعد لا تقل عن هذا العدد.” فإن أردت تقليص المقاعد في التجديد القادم فراجع سجل الطلاب أولاً.

![صفحة الاشتراك والفواتير مع بطاقة الاشتراك الحالي وتاريخ الانتهاء](https://manual.misbah.pro/images/entitlements/01-billing.png)

### أسئلة شائعة

**أرى الزر ثم يُرفض الإجراء — لماذا؟**
لأن الواجهة تبقى مفتوحة ريثما تصل بيانات الاشتراك، بينما القرار الحقيقي عند الخادم. إن تكرّر ذلك فالميزة غير مشمولة في باقتك حتى لو ظهر زرّها لحظة.

**انتهى الاشتراك — هل أفقد بياناتي؟**
لا. لا يُحذف طالب ولا سجل حضور ولا تسجيل ولا خطة. يتوقّف الوصول فقط، ويعود كل شيء كما تركته فور التجديد. وللمسجد مهلة سبعة أيام بعد تاريخ الانتهاء قبل أن يتوقّف شيء أصلاً.

**ما الفرق بين «زيادة السعة» و«تغيير الباقة»؟**
زيادة السعة تشتري كمّية أكبر من شيء مفتوح أصلاً — مقاعد، معلمين، برامج، تخزين، حسابات واتساب — وتُفعَّل فور الدفع. وتغيير الباقة يفتح ميزات مقفلة ويرفع السقوف، ويسري من التجديد القادم.

**لماذا لا أستطيع تثبيت قالب برنامج معيّن؟**
لأن لقطة القالب تحتاج ميزة لا تتضمّنها باقتك: المناهج إن كان القالب يحمل منهجاً، والمحفظة إن كان يحمل نظام نقاط أو هياكل خطط. الرسالة تظهر داخل نافذة التثبيت — راجع [قوالب البرامج](https://manual.misbah.pro/program-templates#install).

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

**هل يُحسب طلاب كل برنامج على حدة؟**
لا. المقاعد تعدّ طلاب **المسجد**، والطالب المسجّل في ثلاثة برامج يشغل مقعداً واحداً — لأن الطالب ملك المسجد والتسجيل هو ما يربطه بالبرنامج. راجع [كيف يعمل مصباح](https://manual.misbah.pro/start#chain).

---

## مكتبة الفيديو
- شرح منصة مصباح (1 د): مقدمة قصيرة تعرّف بالمنصة وما الذي تغطّيه بقية السلسلة. — https://www.youtube.com/watch?v=mov9ThcLQTI — الدليل: https://manual.misbah.pro/start
- صفحة البرامج (5 د): قائمة برامج المسجد، إنشاء برنامج جديد، والانتقال إلى لوحة البرنامج. — https://www.youtube.com/watch?v=JvVq5806VfQ — الدليل: https://manual.misbah.pro/program
- محتويات البرنامج (1 د): جولة في أقسام لوحة البرنامج من الشريط الجانبي. — https://www.youtube.com/watch?v=W0_By8bfaMA — الدليل: https://manual.misbah.pro/program
- صفحة الأداء (2 د): قراءة مؤشرات الأداء والرسوم البيانية في واجهة البرنامج. — https://www.youtube.com/watch?v=sM_bhr3_ePI — الدليل: https://manual.misbah.pro/performance
- صفحة المعلمين (2 د): إضافة المعلمين، ربطهم بالحلقات، وضبط صلاحياتهم. — https://www.youtube.com/watch?v=HF2PGH-yA_g — الدليل: https://manual.misbah.pro/groups
- الحلقة (1 د): نظرة سريعة على صفحة الحلقة كما يراها المعلم. — https://www.youtube.com/watch?v=Qam84bN36XE — الدليل: https://manual.misbah.pro/teaching
- الحلقات والتسميع (5 د): تدفق الحصة كاملاً: الحضور ثم التسميع ثم الأنشطة المرنة. — https://www.youtube.com/watch?v=Hb8yaLeJp4E — الدليل: https://manual.misbah.pro/teaching
- صفحة الطلاب (3 د): إدارة طلاب المسجد: الإضافة، الحقول المخصّصة، والاستيراد. — https://www.youtube.com/watch?v=A72EdxeRNnA — الدليل: https://manual.misbah.pro/students
- صفحة الطلاب داخل البرنامج (3 د): تسجيل الطلاب في البرنامج ومتابعة ملف كل طالب. — https://www.youtube.com/watch?v=oyUiIfxceuk — الدليل: https://manual.misbah.pro/students
- الخطط العامة (3 د): مبدأ الخطط في مصباح والفرق بين القالب والخطة والمنهج. — https://www.youtube.com/watch?v=WZQbz7NpAZY — الدليل: https://manual.misbah.pro/plans
- الخطط القرآنية (6 د): بناء خطة حفظ ومراجعة بالمصحف: النطاق، الوحدة، والتوزيع. — https://www.youtube.com/watch?v=slUwmNbdS0A — الدليل: https://manual.misbah.pro/quran-plans
- الخطط المرنة (2 د): خطط غير قرآنية: متون، مهارات، وأنشطة يحدّدها المعلم. — https://www.youtube.com/watch?v=tnCdZV-safI — الدليل: https://manual.misbah.pro/flexible-plans
- الحضور (3 د): هيكلة حالات الحضور، تشغيل النظام، والتسجيل اليومي. — https://www.youtube.com/watch?v=Y5WSxl7ehhI — الدليل: https://manual.misbah.pro/attendance
- التقارير (4 د): إنشاء تقرير، ضبط الأوزان، وقراءة النتائج وتصديرها. — https://www.youtube.com/watch?v=Vxge9VEuuEQ — الدليل: https://manual.misbah.pro/reports
- التحفيزي (3 د): نظام النقاط والمحفظة وربطه بالحضور والتسميع. — https://www.youtube.com/watch?v=r3VTb8BVoRs — الدليل: https://manual.misbah.pro/wallet
- رسائل التحضير وربط الواتساب (5 د): إشعارات الحضور عبر واتساب وربط رقم المسجد. — https://www.youtube.com/watch?v=wY8sXsE7ItE — الدليل: https://manual.misbah.pro/notifications
- التطبيقات (6 د): مركز التطبيقات: النماذج، المكتبة، الملفات، وواتساب. — https://www.youtube.com/watch?v=qjmNoo494Co — الدليل: https://manual.misbah.pro/apps
- نموذج تقديم الطلاب (5 د): بناء نموذج تسجيل عام واستقبال الطلبات ومراجعتها. — https://www.youtube.com/watch?v=rJT5H7vLMy4 — الدليل: https://manual.misbah.pro/forms
- تطبيق مصباح (2 د): تطبيق المستفيدين: ما الذي يراه الطالب وولي الأمر. — https://www.youtube.com/watch?v=0G9RSvn2I9Q — الدليل: https://manual.misbah.pro/consumer-app
- ربط المستفيدين بالتطبيق (3 د): دعوة أولياء الأمور وربط حساباتهم بالطلاب ومراجعة الطلبات. — https://www.youtube.com/watch?v=E_9_QofFJwc — الدليل: https://manual.misbah.pro/consumer-app
- شاشة العرض (2 د): تشغيل شاشة العرض المباشر داخل المسجد وضبط ما يظهر عليها. — https://www.youtube.com/watch?v=sqXLFkUrdBg — الدليل: https://manual.misbah.pro/monitor
- مميزات الشهر (4 د): جولة على آخر ما أُضيف إلى المنصة. — https://www.youtube.com/watch?v=7EGLhGt61h4 — الدليل: https://manual.misbah.pro/updates

قائمة التشغيل: https://www.youtube.com/playlist?list=PLA0Ve3hFCZcNRnAzuBg9fFdSzn17bbdEc