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

سؤالان مختلفان لا يُخلطان: الدور يقول إلى أي ارتفاع يصل الحساب في المنصة، والصلاحية تقول «وهل يفعل هذا الشيء بعينه». وخلطهما هو ما كان يضطر الوحدة إلى ترقية مرشد إلى مشرف عام لمجرد أن يرصد درجة.
| الدور | يبدأ بـ | ما لا يملكه |
|---|---|---|
| مالك النظام (root) | كل شيء، ولا يُقيَّد أبدًا | — وهو طريق العودة إن أُغلق كل شيء |
| المشرف العام | كل الصلاحيات؛ ومالك النظام وحده من ينزع منها | — |
| المرشد الأكاديمي | عمل يومه: طلابه، الدرجات رصدًا وتصحيحًا، الجلسات والنماذج، مراجعة التسجيل، الإنذارات، وقرار المقاصة | إدارة المنصة، وتعديل نتيجة في فصل مغلق، وإغلاق الفصل، وبيانات الطالب نفسها، والنسخ الاحتياطي، وسجل النظام |
| الطالب | لا صلاحيات إطلاقًا | وصوله إلى سجله هو، محكوم بالنطاق لا بمنحة |
المفتاح المجال.الفعل: المجال شاشة، والفعل عملية عليها — فمنح صلاحية قرارٌ عن العمل لا عن الواجهة البرمجية. وثلاث قواعد تُقرأ معه:
appointments.remind ليس «تعديلًا» مكررًا، وgrades.amend ليس «تعديلًا» أكبر، وsemesters.close ليس «تعديل فصل». كلٌّ قرار مختلف فله مفتاح مختلف.أول ما يفتح: أعداد الطلاب والمرشدين، والطلاب بلا مرشد، والمواعيد القادمة، والإنذارات المفتوحة، وطلبات التسجيل المنتظرة، ومتابعات مستحقة. ولكل رقم رابط يفتح الشاشة التي يخصها مفلترة عليه.
وتحتها رسمان: توزيع الطلاب على شرائح المعدل، وحِمل كل مرشد مرتَّبًا من الأثقل. ويمكن عرض اللوحة لفصل سابق من مُنتقي الفصل أعلاها.

| الشاشة | ما تضبطه |
|---|---|
| البرامج | البكالوريوس، المكثف… ولكل برنامج عدد مستوياته وإجمالي ساعاته، وحدود ساعات الفصل إن أردت تخصيصها |
| الأقسام | القسم يتبع برنامجًا واحدًا، والطالب يتبع قسمًا — ومن القسم تُعرف لائحته |
| المقررات | الكود والاسم والساعات والنهاية العظمى والصغرى والمتطلبات السابقة واللائحة التي يخصها |
| الخطط | مقررات البرنامج موزّعة على المستويات والفصول، ونوع كل مقرر: إجباري، اختياري كلية، اختياري جامعة |
لكل مقرر نهاية عظمى (١٠٠ غالبًا) ونهاية صغرى هي درجة نجاحه (٦٠ في لائحة التمريض). والنهاية الصغرى ليست تزيينًا: الطالب الذي ينزل عنها راسب مهما كان التقدير الذي تعطيه حدود اللائحة لدرجته. وتأتي كلها مع استيراد اللائحة.

صفحة «المستويات» تعرض مستويات كل برنامج بأسمائها. المستوى الجديد يُضاف في آخر البرنامج، ويمكن إعادة تسميته دون أن يتأثر من عليه من طلاب. ولا يُحذف إلا آخر مستوى، وبشرط أن يكون فارغًا.
في كلية التمريض: المستوى الثاني بـ٢٨ ساعة، والثالث بـ٥٨، والرابع بـ٨٨، وسنة الامتياز بـ١٤٨.
وتُكتب هذه الأرقام في موضعين، والأسبق هو اللائحة:
| أين | متى تستعمله |
|---|---|
| اللوائح ← «بداية كل مستوى» | حين تختلف اللوائح: لائحة جديدة تفتح المستوى الثاني عند ٣٠ وقديمة تفتحه عند ٢٨، والدفعتان في برنامج واحد وعلى مستويات واحدة. وهي تَغلِب على أرقام البرنامج لطلابها. |
| المستويات ← «الساعات المطلوبة للترقية» | الأصل، حين تكون اللوائح كلها متفقة. وتُستعمل لكل لائحة لم تُكتب فيها الأرقام — وهذا حال كل لائحة ما لم تُملأ. |
ثلاثة أشياء لا تفعلها الترقية التلقائية: لا تُنزِّل أحدًا (الدرجة التي تُصحَّح فتنقص الساعات تصحيحٌ لا تنزيل)، ولا تُخرّج أحدًا (التخرج يحتاج الاختياري والمعدل إلى جانب الساعات، وهو قرار)، ولا تعمل أصلًا والمفتاح مغلق: «رفع المستويات تلقائيًا حسب الساعات المجتازة» في الإعدادات، وهو مفتوح افتراضيًا.
وفي صفحة الأتمتة مهمة «رفع المستويات» تمرّ على كل الطلاب مرة واحدة — ليوم تُدخل فيه الحدود أول مرة والدرجات موجودة بالفعل.
اللائحة هي القواعد التي يُحاكَم بها الطالب: سُلَّم تقديراته، وحدود درجاته، وحد نجاحه، وحدود ساعاته، وقاعدة المقرر المُعاد، وشروط تخرجه.
| الحقل | معناه |
|---|---|
| سُلَّم التقديرات | الحرف ونقاطه: A+ = ٤، A = ٣٫٧٥ … F = ٠ |
| حدود الدرجات | من أي درجة يبدأ كل تقدير (أدناه) |
| حد النجاح بالنقاط | أقل نقاط يُعدّ عندها المقرر ناجحًا |
| حدّا الإنذار والملاحظة | المعدلان اللذان يصدر عندهما الإنذار والتصعيد |
| مدى الساعات | الحد الأدنى والأقصى لساعات الفصل — وهو الأعم، يغلبه ما هو أخص (أدناه) |
| المقرر المُعاد | كل المحاولات تُحتسب، أو أفضلها، أو آخرها |
| شروط التخرج | الساعات، وأقل معدل، وعدد اختياري الكلية واختياري الجامعة |
جدول في نموذج اللائحة: الحرف، ومن أي درجة يبدأ من ١٠٠. والدرجة تأخذ أول حدٍّ تبلغه قراءةً من الأعلى: ٨٧ مع «A من ٨٥» تعني A.
ويمكن ترك الجدول فارغًا إن كانت اللائحة تُدخل التقدير بحرفه ولا تُحوّل الدرجات — وعندها لا تُقبل درجة رقمية بلا حرف.
اللائحة تُربط بالأقسام التي تحكمها. ولائحة لا تحكم قسمًا واحدًا تظهر بتنبيه أحمر «لا تحكم أي قسم» لأنها لا تصل إلى أحد. واللائحة الافتراضية وحدها يصح ألا تحكم شيئًا: هي ما يقع عليه الطالب الذي لا لائحة لقسمه.
عدد الساعات المسموح به في الفصل يُسأل عنه أربع جهات، والأضيق التي تذكر رقمًا هي التي تُطبَّق:
وكل خانة من هذه الخانات — الأدنى والأقصى معًا — تقبل ٠ بمعنى «مفتوح»: ٠ في الأقصى تعني بلا سقف (ما يناسب سنة الامتياز التي تُؤخذ كاملة)، و٠ في الأدنى تعني بلا أرضية فلا يُطالَب أحد بحد أدنى. وتظهر في الشاشات كلمة «مفتوح» لا الرقم ٠.
وكل خانة تُترك فارغة فتعني «لا رأي لي، اسأل الأوسع». واللائحة الجديدة تبدأ بـ٠ إلى ٢١: بلا حد أدنى — لأن الأرضية قرار يرفض تسجيلًا فلا تُفرض دون أن تكتبها الوحدة عمدًا — وسقف ٢١ ساعة كما تقول لائحة التمريض.
وفي شاشة تسجيل الطالب تظهر بجوار الرقم عبارة تقول من أين جاء: «حدّ مستواك» أو «حدّ خاص بك». و«ساعات الفصل لهذا الطالب» تظهر في ملفه مباشرة، فيرى المرشد أن له استثناءً دون فتح نافذة التعديل.
كل مقرر ينتمي إلى اللائحة التي عرّفته، وساعاته ودرجة نجاحه محفوظة عليه. وكوده فريد داخل لائحته لا داخل الكلية، فلائحتان قد تحملان الكود نفسه بساعات مختلفة — وهذا هو الوضع الطبيعي حين تتغيّر اللائحة ويُعاد تعريف المقرر. والمقرر يحمل مستواه وفصله كذلك.
زر «استيراد لائحة» يقرأ ملف اللائحة (JSON) فيُنشئ في خطوة واحدة: اللائحة بمتطلبات تخرجها، ومقرراتها بأسمائها وساعاتها ونهاياتها، وخطة البرنامج تحتها.

الفصل يُنشأ بكوده (2026-1) واسمه وتاريخَي بدايته ونهايته، ويُنسب تلقائيًا إلى عامه الجامعي وإلى ترتيبه (الأول/الثاني) من تواريخه، ويمكن تحديدهما يدويًا.
| المرحلة | ما يُسمح به |
|---|---|
| مخطط | تهيئة فقط |
| التسجيل | الطلاب يسجّلون، والمرشدون يراجعون ويعتمدون |
| الدراسة | التسجيل مغلق على الطالب، والإضافة والحذف عن طريق الإرشاد، والدرجات تُرصد |
| رصد الدرجات | الدرجات تُرصد وتُصحَّح |
| مغلق | النتائج نهائية، ولا تتغير إلا بطلب تعديل معتمد |

الفصل يُدرّس المقررات التي تضعها الخطة فيه: مقررات الفصل الثاني في الفصل الثاني. وهذا ما يُعرض على الطالب في شاشة التسجيل — لا الخطة كاملة.
ومن أيقونة «مقررات الفصل» في صف أي فصل تفتح شاشةً بتبويبين:
والطالب يرى سبب وجود المقرر في قائمته حين لا يكون السبب أنه ببساطة من مقررات هذا الفصل: «إعادة»، «مفتوح استثناءً». والقاعدة نفسها تُطبَّق عند الحفظ لا على الشاشة فقط، فمقرر لا يُدرَّس هذا الفصل يُرفض مهما أرسلت الشاشة.
من أيقونة «قواعد التسجيل» في صف الفصل. القاعدة تقول: لمن يُفتح التسجيل ومتى.
وهناك مفتاح عام في الإعدادات يوقف تسجيل الطلاب كليًا مهما قالت القواعد.
ويمكن إعادة فتح فصل مغلق لرصد الدرجات، فتعود سجلاته قابلة لإعادة الحساب حتى يُغلق ثانية.
قائمة الطلاب تُفلتر بالبرنامج والقسم والمستوى والحالة والمرشد، وتُصدَّر إلى Excel.
بطاقات أعلى الصفحة: المعدل التراكمي (وتحته «معدل أدخله الطالب» إن وُجد)، والساعات المكتسبة من إجمالي الخطة، والحالة، والإنذارات المفتوحة، والمرشد. وتحتها تبويبات:
| التبويب | ما فيه |
|---|---|
| البيانات | الهوية والاتصال والقسم والبرنامج وسنة القبول، و«ساعات الفصل لهذا الطالب» |
| السجل | كل درجاته بالفصول، ومن أدخل كل درجة، وأزرار الإدخال والتعديل |
| السجل الفصلي | بيان الدرجات مستوًى مستوًى، ثم صف لكل فصل: المستوى والساعات والمعدلات والوضع، وسجل المستويات |
| الخطة | تقدّمه في الخطة، وأقسام الاختياري، وسطر ما ينقصه للتخرج |
| الملف | نماذج الإرشاد الخاصة به |
| الجلسات · الإنذارات · المواعيد · التسجيل | كلٌّ في تبويبه |
تبويب «السجل الفصلي» يبدأ بجدول البيان كما تقرأه الكلية في كشوفها: سطر لكل فصل تحت مستواه، وسطر للمستوى يجمع فصليه، وفيه المجموع التراكمي (نقاط × ساعات) وعدد الساعات والمجموع بالدرجات والمعدل والتقدير. وفي ذيله أربع بطاقات: المعدل التراكمي، والنسبة المئوية للمعدل = ٥٠ + (المعدل − ١) × ٥٠ ÷ ٣، والنسبة التراكمية = مجموع الدرجات ÷ المجموع الكلي × ١٠٠، والتقدير الكلي المأخوذ منها.
المقاصة قاعدة ثالثة غير هاتين: ساعاتها تُحتسب ودرجاتها لا تُحتسب. فتدخل ساعاتها مقام المعدل التراكمي ولا تدخل درجاتها بسطه، ولا تدخل «المجموع بالدرجات» ولا «المجموع الكلى بالدرجات». وفي سطر المستوى الذي تغطّيه المقاصة تُكتب كلمة «معهد» مكان التقدير، ومعدله صفر وساعاته كاملة.
المقاصة قرار تصدره اللجنة لسنة بعينها، لا رقم مستوى: «مقاصة ٢٠٢٣» وفيها قائمة مقررات، و«مقاصة ٢٠٢٤» بقائمة أخرى. ولهذا يُربط القرار باللائحة — لأنه كلام عن مقررات تلك اللائحة — ويوضع الطالب على قرار بعينه.
regulation_code في استيراد الطلاب، أو من لائحة رابط التسجيل الذي سجّل من خلاله.«طالب جديد» يطلب الرقم القومي والاسم والرقم الجامعي والبرنامج والقسم والمستوى. وتظهر كلمة المرور المولَّدة مرة واحدة مع زر نسخ. ويمكن إدخال رصيد سابق (معدل وساعات) للمحوَّل أو لمن درس قبل المنصة، فيُضاف إلى ما يدرسه هنا.

الطلاب والمقررات والخطط والدرجات تُستورَد من ملفات Excel. ولكل شاشة قالب يُنزَّل بأعمدته الصحيحة.
استيراد الدرجات من الشاشة يرفض الفصل المغلق، وهذا صواب: نتيجة اعتُمدت لا تُعدَّل بملف Excel. لكن طالبًا درس أربع سنوات قبل المنصة ليس عنده إلا فصول مغلقة. ولهذا أمر على الخادم يقرأ بيان الدرجات كما تحفظه شؤون الطلاب — سطر لكل مقرر، ومعه السنة والفصل الذي دُرس فيه — ويضعه كاملًا: السنوات الأكاديمية، والفصول، والطالب إن كان جديدًا، وكل درجة من الباب الذي تدخل منه أي درجة اليوم.
murshid import-record db/records/record.csv # يقول ماذا سيفعل ولا يكتب شيئًا murshid import-record db/records/record.csv --apply # ثم يفعله
وأمر murshid يُثبَّت مرة واحدة على الخادم (انظر دليل النشر): يجد Node ومجلد المنصة عنك، ويشغّل الأمر بالمستخدم الصحيح. وملفات db/records/ تصل مع git pull لأنها تُنشر ضمن الإصدار.
أعمدة الملف (CSV بترميز UTF-8، بأي ترتيب):
| العمود | ما فيه |
|---|---|
student_number | مطلوب في كل سطر |
full_name · id_number · program_code · admission_year | بيانات الطالب، تُكتب في أول سطر فقط — ولا يُنشَأ الطالب إلا إن لم يكن موجودًا |
course_code | مطلوب، ولا بد أن يكون في دليل المقررات؛ المقرر المجهول يُذكر بالاسم ولا يُخترع |
academic_year + term | مثل 2022-2023 و1 أو 2 أو 3 للصيفي — يُنشئ الفصل إن لم يكن موجودًا بكود 2022-1 |
mark · max_mark | الدرجة ومن كم؛ من ١٠٠ إن لم تُذكر |
exempt · exempt_note | مقاصة: ساعاتها تُحتسب ودرجتها لا — للطالب القادم من معهد |
من تبويب «السجل» في ملف الطالب. ويلزم أن يكون الفصل في «الدراسة» أو «رصد الدرجات».
| ما تُدخله | النتيجة |
|---|---|
| درجة فقط (٨٧) | يُشتق التقدير من حدود اللائحة |
| درجة + تقدير | التقدير المُختار هو المعتمد، والدرجة تُحفظ بجواره |
| تقدير فقط | للوائح التي لا حدود درجات لها، أو لنتيجة لا يشرحها الرقم |
| بلا درجة | «مسجَّل»: يدرس المقرر ولم تظهر نتيجته |
«إدخال درجات جماعي» يفتح جدولًا لمقرر واحد وعدة طلاب (كما تصل كشوف اللجان)، أو لعدة مقررات لطالب واحد. يمكن لصق عمودين من Excel مباشرة. والصف المرفوض يعود باسمه وسببه وتُحفظ البقية.
إن كانت درجات رُصدت قبل ضبط النهايات الصغرى، فهناك أداة تُشغَّل على الخادم تعيد قراءة كل درجة بالقواعد الحالية، وتعرض ما ستغيّره قبل أن تكتب شيئًا، ثم تكتبه وتعيد حساب سجلات من تأثّروا. راجع فريق التشغيل.
الأصل أن ترصد الوحدة الدرجات. لكن الكلية التي تبدأ من سجل فارغ تنتظر فصولًا قبل أن يعني السجل شيئًا، والطالب يعرف نتائجه من موقع الجامعة بالفعل. فيمكن تسليمه هذا الإدخال — بمفتاحين معًا لا بواحد:
| المفتاح | مكانه | مداه |
|---|---|---|
| المشرف العام | الإعدادات ← «السماح للطلاب بإدخال درجاتهم بأنفسهم» | المنصة كلها |
| المرشد | الملف الشخصي ← «بيانات المكتب» ← «السماح لطلابي بإدخال درجاتهم بأنفسهم» | الطلاب المسندون إليه وحدهم |
والوحدة تستطيع فتحه نيابةً عن المرشد من الحسابات ← تعديل حسابه. والطالب الذي لا مرشد له لا يشمله مفتاح أحد. ويرى الطالب في صفحة «درجاتي» أي المفتاحين مغلق بالنص.
في الصفحة نفسها خانة يكتب فيها الطالب المعدل الذي يعطيه موقع الجامعة إن خالف المحسوب. يُحفظ باسمه وتاريخه ويظهر لك في ملفه بجوار المحسوب، ولا يُبنى عليه شيء: لا إنذار ولا رفع مستوى ولا تخرج.
الضغط على اسم الطالب يفتح ملفه كاملًا فوق الطلب لا بدلًا منه؛ وإغلاقه يعيدك إلى الطلب كما تركته بكل قراراتك.


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


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

النماذج الورقية المعتمدة، مطابقةً لترتيبها وأرقامها، تُملأ على الشاشة وتُطبع بشعار الجامعة والكلية:


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

| المجموعة | ما تضبطه |
|---|---|
| الهوية | اسم الجامعة والكلية بالعربية والإنجليزية، والشعاران، واللون الأساسي، واسم العميد ورئيس وحدة الإرشاد في المطبوعات |
| القواعد الأكاديمية | مدة الموعد الافتراضية، واشتراط موافقة المرشد على المواعيد، ومفتاح تسجيل الطلاب العام، ورفع المستويات تلقائيًا، والسماح للطلاب بإدخال درجاتهم، ورمز التحقق عند الدخول، واستعادة كلمة المرور بتيليجرام |

لكل مهمة وقت يومي بتوقيت الخادم، وزر «شغّل الآن»، وسجل تشغيل. والأوقات مضبوطة بما يناسب يوم الكلية: النسخ الاحتياطي ٢:٠٠، وفحص الإنذارات ٦:٠٠، والتذكير بالمواعيد ٨:٠٠، والملخص اليومي ٨:٣٠. غيّر أي وقت، أو اتركه فارغًا لإيقاف المهمة.
| المهمة | ما تفعله |
|---|---|
| فحص الإنذارات | يراجع معدلات كل الطلاب ويصدر الإنذارات أو يصعّدها أو يغلقها |
| تذكير بالمواعيد | يذكّر الطالب والمرشد بالمواعيد القريبة |
| ملخص يومي | أرقام اليوم إلى مجموعة الوحدة على تيليجرام |
| رفع المستويات | يمرّ على كل الطلاب ويرفع من بلغ ساعات مستواه التالي. متوقفة افتراضيًا: الساعات ترفع الطالب لحظة رصد الدرجة، فلا يبقى للمسح اليومي ما يجده — وإنما تُشغَّل بالزر يوم تُدخل الحدود أول مرة |
| نسخة احتياطية | نسخة كاملة، مع حذف الأقدم والإبقاء على العدد المحدد |
وفي الثالثة والربع ليلًا تنظّف المنصة وحدها ما لا حاجة له: جلسات دخول منتهية منذ شهر، وإشعارات مقروءة مر عليها ستة أشهر، وطلبات استعادة مضى عليها ثلاثة أشهر. وسجل النظام لا يُحذف.
@BotFather وخذ رمزه.البوت يعرف من يكلّمه: المحادثة مربوطة بحساب واحد، وتيليجرام نفسه يعرض لكل محادثة قائمة دورها وحده — فلا يرى الطالب أمرًا إداريًا ولا يرى المرشد /gpa. و/help يكتب اسم الحساب ودوره فوق القائمة.
| الحساب | أوامره |
|---|---|
| قبل الربط | /link · /semester · /about · /chatid — لا شيء شخصي |
| الطالب | /gpa · /statement بيانه مستوًى مستوًى · /grades · /courses مقررات فصله · /plan ما بقي للتخرج · /registration · /appointments · /warnings · /advisor · /ask سؤال يصل مرشده |
| المرشد الأكاديمي | /today · /pending · /students · /alerts من يحتاج انتباهه · /student 20220001 طالب بعينه · /remind تذكير كل من له موعد |
| المشرف العام (الدعم) | كل ما للمرشد، وزيادةً: /stats · /health حالة المنصة والنسخ الاحتياطي · /find بحث عن أي حساب |
| مالك النظام | كل ما سبق |
/ask لا يرسل رسالة إلى رقم مجهول: يصل سؤال الطالب إشعارًا على شاشة مرشده بجوار بقية ملفه، فيُجاب حيث يُقرأ وحيث يبقى في السجل./alerts لا يسرد مئتي اسم: ثلاث قوائم فقط — من عليه ملاحظة أكاديمية، ومن له إنذار مفتوح، ومن لم يسجّل والتسجيل مفتوح. والأخيرة هي التي يتعذّر إصلاحها يوم يُغلق التسجيل.

اثنتان بواجهة واحدة: PostgreSQL حين يكون DATABASE_URL مضبوطًا في ملف .env بجوار التطبيق، وPGlite (قاعدة مدمجة في مجلد محلي) حين يكون فارغًا. الإنتاج على PostgreSQL دائمًا؛ وPGlite موجودة ليعمل npm run dev والاختبارات بلا تنصيب شيء.
pm2 logs murshid --lines 100 --nostream | grep -i database
يقول السطر database : PostgreSQL أو built-in (PGlite) — وهذا هو الفصل في الأمر.
data/pglite لا يعني أن المنصة تعمل عليه: يُنشأ بمجرد أن يعمل التطبيق مرة واحدة دون DATABASE_URL — أول إقلاع قبل كتابة ملف .env مثلًا. انظر إلى تاريخ تعديله وإلى عدد الصفوف في PostgreSQL قبل أن تقلق.DATABASE_URL: قيامه على قاعدة مدمجة فارغة بجوار القاعدة الحقيقية أسوأ من ألا يقوم، لأنه يخدم كلية بلا طلاب ويقبل تسجيلات لا تراها القاعدة الحقيقية أبدًا. ولمن يقصد ذلك فعلًا: ALLOW_EMBEDDED_DB=1.كل عملية مؤثّرة تُكتب: من فعلها، ومتى، وعلى ماذا، وبأي تفاصيل. يُفلتر بالمستخدم والعملية والتاريخ، ويُصدَّر.
ويُكتب كذلك في ملف نصي يومي على الخادم، فيبقى الأثر ولو تعطّلت قاعدة البيانات. والسجل لا يُحذف في التنظيف الليلي.

راجع: هل له مرشد؟ هل باب التسجيل مفتوح لمستواه (قواعد التسجيل)؟ هل رفع صفحة واحدة على الأقل من صور التسجيل؟ هل ساعاته ضمن الحدود؟
الخطة تضعه في الفصل الآخر. إما تنقله إلى هذا الفصل في الخطة، أو تفتحه استثناءً لهذا الفصل وحده (القسم ٩).
المقرر لا يحمل نهاية صغرى. أعد استيراد اللائحة ليأخذها، أو اكتبها في شاشة المقررات.
افتح اللوائح ← تعديل اللائحة ← حدود الدرجات واملأ الجدول. أو أدخل التقدير بحرفه.
الصلاحية موجودة افتراضيًا للمرشدين الجدد. والحساب القديم قد لا يحملها: امنحه «تعديل الدرجات» من شاشة الصلاحيات.
انتهت مهلة العشرة أيام، أو رصدت الوحدة الدرجة بعده. وفي الحالتين التعديل للمرشد.
شيء ما يعتمد عليه، والرسالة تقول ماذا. انقل ما يعتمد عليه أولًا ثم أعد المحاولة.