تخطٍ إلى المحتوى
يو لوجستيدليل المستخدم

الفصل 11

إعدادات النظام وصيانته

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

71 قسماً42 دقيقة قراءة

11.1 الإعدادات

المكان في القائمة
النظام ← الإعدادات
الرابط
/admin/settings
الصلاحية المطلوبة
كل تبويب له صلاحية عرض خاصة به. يظهر عنصر القائمة لمن يحمل عرض ضمن إعدادات النظام.
التبويبصلاحية العرضصلاحية التعديل
بيانات المنشأةعرض ضمن بيانات المنشأةتعديل ضمن بيانات المنشأة
إعدادات المنصةعرض ضمن إعدادات المنصةتعديل ضمن إعدادات المنصة
إعدادات النظامعرض ضمن إعدادات النظامتعديل ضمن إعدادات النظام
المفاتيح السريةعرض ضمن المفاتيح والإعدادات السريةتعديل للإضافة والاستبدال، وحذف للحذف

الغرض

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

ما تراه في الشاشة

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

الإجراءات

تعديل إعداد وحفظه

  1. اختر التبويب المطلوب.
  2. عدّل الحقول التي تريدها. لا يُطبَّق أي تعديل قبل الحفظ.
  3. اضغط حفظ التغييرات. تظهر الرسالة تم حفظ التغييرات.
  4. للتراجع قبل الحفظ اضغط التراجع عن التعديلات.

الانتقال بين التبويبات

  1. اضغط اسم التبويب. يتغير الرابط معه، مثل /admin/settings/platform.
  2. انتبه: الانتقال إلى تبويب آخر يُسقط التعديلات غير المحفوظة في التبويب السابق. احفظ أولاً.

11.1.1 تبويب بيانات المنشأة

المكان في القائمة
النظام ← بيانات المنشأة
الرابط
/admin/settings/organization

هذا التبويب يحمل الهوية الرسمية للمنشأة. بياناته تُطبع كما هي على بطاقة المندوب وبطاقة التشغيل وكل تقرير يصدره النظام. له عنصر مستقل في القائمة الجانبية يفتحه مباشرة.

النموذج مقسم إلى خمسة أقسام. كل الحقول اختيارية.

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

قسم مرفقات المنشأة

يظهر تحت النموذج لمن يحمل عرض ضمن وحدة المرفقات. الرفع والاستبدال واعتماد ملف يحتاج رفع مرفق، والتنزيل يحتاج تنزيل مرفق، والحذف يحتاج حذف، وكلها ضمن وحدة المرفقات.

المجموعةنوع المرفقالاستخدام
الهوية البصريةالشعار الفاتحيظهر في الشريط الجانبي وشاشة الدخول وعلى المستندات المطبوعة. يُفضَّل ملف PNG بخلفية شفافة.
الهوية البصريةالشعار الداكنبديل الشعار في الوضع الداكن. عند غيابه يُستخدم الشعار الفاتح.
الهوية البصريةأيقونة الموقعالأيقونة الصغيرة في تبويب المتصفح. يُفضَّل ملف مربع بمقاس 512 في 512.
المستندات النظاميةالسجل التجاريصورة السجل التجاري السارية.
المستندات النظاميةالشهادة الضريبيةشهادة التسجيل في ضريبة القيمة المضافة.
المستندات النظاميةرخصة النشاط التجاري من البلديةرخصة مزاولة النشاط للموقع المسجل.
المستندات النظاميةالشهادة الصحيةالشهادة الصحية للمنشأة أو للعاملين فيها.
المستندات النظاميةشهادة السلامةشهادة السلامة ومعدات الإطفاء.
مرفقات أخرىعقودالعقود التي تخص المنشأة ككل، لا عقود العملاء أو المناديب.
مرفقات أخرىأخرىأي مستند آخر يلزم حفظه ضمن ملف المنشأة.

رفع شعار أو مستند

  1. انزل إلى مرفقات المنشأة وابحث عن نوع المرفق.
  2. اضغط رفع ملف. إن كان للنوع ملف سابق يظهر الزر باسم استبدال الملف.
  3. اختر الملف من جهازك. أثناء الرفع يظهر جارٍ الرفع....
  4. تظهر الرسالة تم رفع الملف ويصبح الملف الجديد هو المعتمد حالياً.

الرجوع إلى نسخة أقدم

  1. افتح نسخ أقدم من هذا المستند تحت النوع.
  2. اضغط اعتماد هذا الملف بجانب النسخة المطلوبة.

عرض أو تنزيل أو حذف مرفق

  1. اضغط عرض لفتح الملف، أو تنزيل لحفظه على جهازك.
  2. للحذف اضغط حذف ثم حذف نهائي في سؤال تأكيد حذف المرفق؟.

قواعد مرفقات المنشأة

  • الصيغ المقبولة: JPG و PNG و WEBP و GIF و PDF.
  • الحد الأقصى 10 ميجابايت للملف الواحد.
  • رفع ملف جديد يجعله المعتمد، ويبقى السابق محفوظاً ضمن النسخ الأقدم.
  • الحذف نهائي. إن كان المحذوف هو الشعار المعتمد فسيختفي فوراً من الشريط الجانبي والمستندات.
  • بعد حفظ بيانات المنشأة يتحدث الاسم والشعار في الواجهة دون حاجة إلى إعادة تحميل الصفحة.

11.1.2 تبويب إعدادات المنصة

الرابط
/admin/settings/platform

يضبط المنصة نفسها: شكلها، وصيغ العرض، وشروط التسجيل والجلسة، والضريبة. اسم المنشأة وبيانات التواصل تظهر هنا للاطلاع فقط، لأن مكان تعديلها هو تبويب بيانات المنشأة.

النموذج مقسم إلى سبعة أقسام قابلة للتعديل. كل الحقول اختيارية.

القسمالحقلالوصف والقيم المسموحة
المظهراسم المنصةاسم المنصة في الشريط الجانبي وعنوان المتصفح والبريد الصادر.
المظهرالوصف المختصرسطر واحد أسفل الاسم في شاشة الدخول والصفحة العامة.
المظهراللون الأساسيلون الأزرار والروابط الأساسية. اختر لوناً يبقى مقروءاً على خلفية بيضاء.
المظهراللون الثانويلون مساند للعناصر الثانوية.
الإعدادات الإقليميةرمز العملةقائمة من 18 عملة، منها الريال السعودي والدرهم الإماراتي والدولار الأمريكي. تغييره لا يحوّل المبالغ المسجلة سابقاً.
الإعدادات الإقليميةرمز اللغةقائمة اللغات المتاحة.
الإعدادات الإقليميةالمنطقة الزمنيةقائمة من 16 منطقة، منها الرياض ودبي والقاهرة والتوقيت العالمي المنسق.
الإعدادات الإقليميةرمز الدولةقائمة من 17 دولة. يحدد مفتاح الهاتف وصيغة العنوان الافتراضية.
الإعدادات الإقليميةصيغة التاريخخمس صيغ مع مثال لكل منها.
الإعدادات الإقليميةصيغة الوقتنظام ٢٤ ساعة أو نظام ١٢ ساعة (ص/م).
الإعدادات الإقليميةصيغة الأرقامأربع صيغ لفصل الآلاف والكسور، مثل 1,234.56.
بيانات محركات البحثعنوان الصفحةالعنوان الذي تعرضه محركات البحث وروابط المشاركة. نحو 60 حرفاً.
بيانات محركات البحثالكلمات المفتاحيةكلمات مفصولة بفواصل. اجعل القائمة قصيرة.
بيانات محركات البحثوصف الصفحةالملخص الظاهر أسفل العنوان في نتائج البحث. نحو 155 حرفاً.
التسجيل والدخولالسماح بالتسجيل الذاتيمفتاح تشغيل وإيقاف. الشاشة تحذر: عند تفعيله يستطيع أي شخص يملك الرابط إنشاء حساب دون دعوة.
التسجيل والدخولإلزام توثيق البريدمفتاح تشغيل وإيقاف. يتطلب بريداً صادراً يعمل فعلاً.
التسجيل والدخولإلزام التحقق بخطوتينمفتاح تشغيل وإيقاف. الشاشة تحذر: أعلن عنه قبل تفعيله.
الأمانانتهاء الجلسة بالدقائقرقم موجب. المعتاد بين 30 و120 دقيقة.
الأمانأقل طول لكلمة المروررقم موجب.
الأمانأقصى محاولات دخولرقم موجب. المعتاد خمس محاولات.
الأمانمدة قفل الحساب بالدقائقرقم موجب.
الأمانأقصى حجم للملف بالميجابايترقم موجب.
الأمانأنواع الملفات المسموحةامتدادات مفصولة بفواصل مثل pdf,jpg,png.
المالية والفواتيرتفعيل الضريبةمفتاح تشغيل وإيقاف.
المالية والفواتيرنسبة الضريبة الافتراضيةرقم يقبل الكسور، مثل 15 لنسبة 15 بالمئة.
المالية والفواتيراسم الضريبةالاسم المطبوع على سطر الضريبة، مثل ضريبة القيمة المضافة.
المالية والفواتيربادئة رقم الفاتورةمثل INV-.
المالية والفواتيررقم بداية الفواتيررقم غير سالب. اختيار رقم مستخدم سابقاً ينتج أرقاماً مكررة.
وضع الصيانةتفعيل وضع الصيانةمفتاح على مستوى المنصة، منفصل عن مفتاح الصيانة في تبويب بيانات المنشأة.
وضع الصيانةرسالة وضع الصيانةالنص المعروض أثناء الإيقاف.

قسم بيانات التواصل للاطلاع فقط

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

قواعد تبويب المنصة

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

11.1.3 تبويب إعدادات النظام

الرابط
/admin/settings/system

جدول مفاتيح تشغيلية تقرأها وحدات النظام مباشرة أثناء العمل. كل صف يعرض اسم المفتاح بالإنجليزية، ووصفه بالعربية، ونوع قيمته، وحقل القيمة.

ما تراه

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

أنواع القيم

النوعما يُقبل
رقم صحيحرقم دون كسور أو فواصل.
رقم عشريرقم بنقطة عشرية، مثل 12.5.
تشغيل وإيقافمربع اختيار.
تاريخبصيغة YYYY-MM-DD.
JSONنص بصيغة JSON صالحة.
نصنص حر يُخزَّن كما هو.

أهم المفاتيح وقيمها الافتراضية

المفتاحالوصفالافتراضي
id_document.expiry_alert_daysالتنبيه قبل انتهاء الهوية/الإقامة بعدد أيام60
driving_license.expiry_alert_daysالتنبيه قبل انتهاء رخصة القيادة بعدد أيام30
health_cert.expiry_alert_daysالتنبيه قبل انتهاء الشهادة الصحية بعدد أيام30
driver_card.expiry_alert_daysالتنبيه قبل انتهاء بطاقة السائق بعدد أيام30
operation_card.expiry_alert_daysالتنبيه قبل انتهاء بطاقة تشغيل المركبة بعدد أيام30
transport_license.expiry_alert_daysالتنبيه قبل انتهاء ترخيص نشاط النقل بعدد أيام60
vehicle_insurance.expiry_alert_daysالتنبيه قبل انتهاء تأمين المركبة بعدد أيام30
insurance_policy.expiry_alert_daysالتنبيه قبل انتهاء بوليصة التأمين الرئيسية بعدد أيام45
advance.due_alert_daysالتنبيه قبل استحقاق قسط السلفة بعدد أيام7
notifications.retention_daysحذف الإشعارات المقروءة بعد عدد أيام180
notifications.generator_cronموعد توليد إشعارات انتهاء الوثائق والأقساط يومياً06:00 يومياً
notifications.email_defaultإرسال بريد مع الإشعار افتراضياً، ما لم يلغ المستلم الاشتراكمفعّل
notifications.email_batch_sizeأقصى عدد رسائل تُرسل في دفعة واحدة أثناء التشغيل المجدول200
notifications.email_lookback_daysعدد الأيام السابقة التي تُفحص فيها الإشعارات غير المرسل بريدها2
dashboard.alert_days_criticalحد الأيام للمستوى الحرج في تنبيهات انتهاء الوثائق7
dashboard.alert_days_warningحد الأيام لمستوى التحذير15
dashboard.alert_days_noticeحد الأيام لمستوى التنبيه30
dashboard.recent_activity_limitعدد أحدث الأنشطة المعروضة في لوحة التحكم20
auth.max_login_attemptsعدد محاولات الدخول الفاشلة قبل قفل الحساب5
auth.lockout_minutesمدة قفل الحساب بعد تجاوز المحاولات بالدقائق. وهي نفسها مدة الحظر التلقائي للعنوان15
auth.window_minutesالنافذة الزمنية التي تُحسب خلالها المحاولات الفاشلة15
auth.session_ttl_minutesمدة صلاحية جلسة الدخول بالدقائق120
auth.challenge_ttl_secondsمدة صلاحية رمز التحقق قبل الدخول بالثواني120
auth.block_ip_after_failuresعدد المحاولات الفاشلة من نفس العنوان قبل حظره20
advance.max_amountالحد الأقصى لمبلغ السلفة الواحدة5000
advance.max_installmentsالحد الأقصى لعدد أقساط السلفة12
advance.max_open_per_riderعدد السلف غير المسددة المسموح بها للمندوب1
advance.requires_approvalاشتراط اعتماد السلفة قبل صرفهامفعّل
renewal.default_term_monthsمدة الصلاحية الافتراضية عند التجديد بالأشهر12
renewal.require_receiptاشتراط إرفاق إيصال عند تسجيل التجديدغير مفعّل
renewal.notify_on_renewإشعار المدراء عند تسجيل تجديد وثيقةمفعّل
logs.cleanup_cronموعد تشغيل مهمة تنظيف السجلات يومياً03:30 يومياً
logs.audit_retention_daysالاحتفاظ بسجل التدقيق. الحد الأدنى المفروض 90 يوماً365
logs.login_retention_daysالاحتفاظ بسجل محاولات الدخول. الحد الأدنى المفروض 60 يوماً180
logs.error_retention_daysالاحتفاظ بسجل أخطاء النظام90
logs.cron_retention_daysالاحتفاظ بسجل تشغيل المهام المجدولة90
logs.email_retention_daysالاحتفاظ بسجل رسائل البريد180
logs.session_retention_daysالاحتفاظ بالجلسات المنتهية والملغاة30
email.enabledتفعيل إرسال البريد الإلكتروني من النظام بالكامل. مفتاح إيقاف عاممفعّل
email.dry_runوضع تجريبي: تكوين الرسالة وتسجيلها دون إرسالها فعلياًغير مفعّل
oil_change.default_alert_daysعدد أيام التنبيه الافتراضي قبل استحقاق تغيير الزيت7
backup.auto_enabledتفعيل النسخ الاحتياطي التلقائيمفعّل
backup.cron و backup.keep_count و backup.typeموعد النسخة التلقائية وعدد النسخ المحتفظ بها ونوعها. تُضبط من شاشة النسخ الاحتياطي03:00 يومياً، 14 نسخة، كاملة

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

قواعد تبويب النظام

  • القيمة التي لا تطابق نوع المفتاح تُرفض، ويُرفض معها الحفظ كله. لا يُحفظ جزء ويُترك جزء.
  • تغيير مفاتيح الدخول يسري خلال ثوانٍ، دون إعادة تشغيل.
  • مواعيد المهام تُكتب بصيغة cron من خمس خانات: دقيقة، ساعة، يوم، شهر، يوم الأسبوع. مثال: 0 6 * * * يعني السادسة صباحاً كل يوم. الصيغة غير الصالحة تُتجاهل ويعود النظام إلى الموعد الافتراضي.
  • مدة الاحتفاظ بسجل التدقيق لا تنزل عن 90 يوماً، وبسجل الدخول عن 60 يوماً، مهما كتبت في الحقل.
  • كل تغيير يُسجَّل في سجل النشاط مع القيمة قبل وبعد.

11.1.4 تبويب المفاتيح السرية

الرابط
/admin/settings/private

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

ما تراه

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

إضافة مفتاح

  1. اضغط إضافة مفتاح.
  2. أدخل اسم المفتاح كما تتوقعه الخدمة تماماً.
  3. أدخل القيمة الجديدة.
  4. أدخل الوصف. لا تكتب فيه أي جزء من القيمة.
  5. أبقِ تشفير القيمة عند التخزين مفعّلاً إلا إذا كانت الخدمة تتطلب القيمة كما هي.
  6. اضغط حفظ التغييرات. تظهر الرسالة تم حفظ المفتاح.

استبدال قيمة مفتاح

  1. اضغط استبدال القيمة. اسم المفتاح يظهر مقفلاً.
  2. أدخل القيمة الجديدة واحفظ. القيمة القديمة تُفقد فور الحفظ ولا يمكن استرجاعها.

حذف مفتاح

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

11.2 المرفقات

المكان في القائمة
النظام ← المرفقات
الرابط
/admin/attachments
الصلاحية المطلوبة
عرض ضمن وحدة المرفقات. التنزيل يحتاج تنزيل مرفق، والحذف يحتاج حذف.

الغرض

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

ما تراه في الشاشة

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

الإجراءات

معاينة ملف

  1. اضغط أيقونة معاينة في الصف. يُفتح الملف في تبويب جديد.

تنزيل ملف

  1. اضغط أيقونة تنزيل. يُحفظ الملف على جهازك باسمه الأصلي.

حذف ملف

  1. اضغط أيقونة حذف.
  2. أكّد السؤال الذي يذكر اسم الملف.
  3. يُمحى الملف من القرص ومن السجل معاً، وتتحدث بطاقات الإحصاء.

قواعد وتنبيهات

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

11.3 قوالب البريد

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

الغرض

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

ما تراه في الشاشة

ثلاثة تبويبات: القوالب، إعدادات SMTP، الهوية والمحتوى. التبويب الذي لا تحمل صلاحية عرضه لا يظهر.

11.3.1 تبويب القوالب

ما تراه

  • في الجانب: قائمة القوالب مع عدّاد {count} قالب، مربع بحث، وزر قالب جديد. كل قالب يحمل شارة مُفعّل أو موقوف، وقوالب النظام تحمل الشارة قالب نظام.
  • في الوسط: محرر القالب المختار.
  • لوحة المتغيرات، ثم بيانات المعاينة، ثم المعاينة، ثم إرسال تجريبي.

القوالب الجاهزة

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

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

المتغيرات

المتغير كلمة إنجليزية بين قوسين معقوفين، مثل {owner_name}، يستبدلها النظام بالقيمة الحقيقية عند الإرسال.

المتغيرما يُستبدل به
{owner_name}اسم صاحب الوثيقة أو السلفة.
{doc_number}رقم الوثيقة.
{expiry_date}تاريخ الانتهاء.
{days_left}عدد الأيام المتبقية.
{user_name}اسم المستخدم في تنبيهات الدخول.
{login_time}وقت الدخول.
{ip_address}العنوان الذي تم منه الدخول.
{device}الجهاز أو المتصفح.
{job_name} و {status} و {duration}اسم المهمة المجدولة ونتيجتها ومدتها.
{company_name} و {company_name_en}اسم المنشأة بالعربية وبالإنجليزية.

لوحة المتغيرات تقارن بين ما أعلن القالب قبوله وما يحتويه النص فعلاً، وتصنفها ثلاث فئات:

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

تعديل قالب

  1. اختر القالب من القائمة.
  2. عدّل الاسم أو الموضوع أو نص الرسالة (HTML).
  3. لإدراج متغير ضع المؤشر في المكان المطلوب ثم اضغط المتغير في لوحة المتغيرات.
  4. اضغط حفظ. تظهر الرسالة تم حفظ القالب.
  5. للتراجع قبل الحفظ اضغط تراجع عن التغييرات.

معاينة قالب

  1. في بيانات المعاينة املأ قيمة لكل متغير. زر تفريغ القيم يمسحها.
  2. اضغط تحديث المعاينة.
  3. يظهر الموضوع كما سيصل ثم الرسالة داخل إطار.
  4. المعاينة تعرض النسخة المحفوظة. احفظ تعديلاتك أولاً لتراها.

إرسال تجريبي

  1. في إرسال تجريبي أدخل عنوان بريد في حقل إلى.
  2. اضغط إرسال تجريبي. تُرسل الرسالة ببيانات المعاينة وتُسجَّل في سجل البريد.

إنشاء قالب جديد

  1. اضغط قالب جديد.
  2. أدخل مفتاح القالب والاسم والموضوع ونص الرسالة (HTML).
  3. اضغط إنشاء القالب.

إيقاف قالب أو تفعيله

  1. اضغط إيقاف. القالب الموقوف لا يرسله النظام.
  2. لإعادته اضغط تفعيل.

حذف قالب

  1. اضغط حذف القالب وأكّد. الزر يظهر للقوالب المخصصة فقط.
الحقلإلزاميالوصف والقيم المسموحة
مفتاح القالبنعم عند الإنشاءحروف إنجليزية صغيرة وأرقام وشرطة سفلية ونقطة فقط، يبدأ بحرف، من 3 إلى 80 خانة. لا يتكرر.
الاسمنعماسم داخلي يميّز القالب في هذه الشاشة. لا يصل إلى المستلم.
الموضوعنعمعنوان الرسالة. يقبل المتغيرات نفسها.
نص الرسالة (HTML)نعممحتوى الرسالة. الترويسة والتذييل يضيفهما النظام تلقائياً.

قواعد القوالب

  • الإرسال التجريبي يُرفض برسالة واضحة في أربع حالات: لم تُضبط إعدادات SMTP، أو إرسال البريد موقوف على مستوى النظام، أو القالب موقوف، أو رفض خادم البريد الرسالة.
  • قالب النظام يمكن تعديل نصه وإيقافه، لكن لا يمكن حذفه.
  • لا يُقبل ترك الاسم أو الموضوع أو النص فارغاً.
  • المتغير المكتوب خطأً يصل إلى المستلم فارغاً. راجع لوحة المتغيرات قبل الحفظ.

11.3.2 تبويب إعدادات SMTP

يحتوي لوحتين مستقلتين بالحقول نفسها:

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

ضبط خادم البريد

  1. في مزوّد البريد اختر مزودك: Gmail / Google، Zoho (السعودية)، Zoho (عالمي)، Microsoft 365 / Outlook. تُملأ حقول الخادم والمنفذ والتشفير تلقائياً. أو أدخل بيانات أي خادم آخر يدوياً.
  2. أدخل اسم المستخدم، وهو بريدك كاملاً عند هؤلاء المزودين.
  3. أدخل كلمة المرور. عند Gmail و Zoho مع التحقق بخطوتين استخدم كلمة مرور التطبيق، لا كلمة مرور الحساب.
  4. أدخل اسم المُرسِل وبريد المُرسِل.
  5. فعّل الإرسال عبر هذا الخادم.
  6. اضغط حفظ الإعدادات.

اختبار الاتصال

  1. احفظ الإعدادات أولاً.
  2. اكتب في البريد الذي تُرسل إليه رسالة الاختبار بريداً تستطيع فتحه.
  3. اضغط اختبار الاتصال.
  4. عند النجاح تصل رسالة الاختبار. تحقق من صندوق الوارد ومجلد الرسائل غير المرغوب فيها.
الحقلإلزاميالوصف والقيم المسموحة
الخادمنعمعنوان خادم البريد، مثل smtp.gmail.com.
المنفذنعمرقم بين 1 و 65535.
اسم المستخدملااسم حساب البريد.
كلمة المرورلااترك الحقل فارغاً للإبقاء على كلمة المرور المحفوظة. تحته يظهر كلمة مرور محفوظة أو لا توجد كلمة مرور محفوظة.
التشفيرلاتشفير STARTTLS (المنفذ ٥٨٧ غالباً) أو تشفير SSL/TLS (المنفذ ٤٦٥ غالباً) أو بدون تشفير، وهو غير مستحسن.
اسم المُرسِللاالاسم الذي يراه المستلم.
بريد المُرسِللاالعنوان الذي تصدر منه الرسائل.
الإرسال عبر هذا الخادملامفتاح تشغيل وإيقاف لهذا الخادم.

قواعد SMTP

  • كلمة المرور المحفوظة لا تُعرض أبداً ولا يعيدها الخادم.
  • إذا اختلف بريد المُرسِل عن اسم المستخدم يظهر تحذير، لأن هؤلاء المزودين يرفضون الإرسال إلا من الحساب نفسه أو من اسم مستعار موثّق فيه.
  • في Microsoft 365 يجب أن يسمح مسؤول الحساب بخاصية SMTP AUTH لهذا الصندوق.

11.3.3 تبويب الهوية والمحتوى

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

بطاقة ما تعرضه الرسائل الآن

ملخص يعرض: الاسم، الاسم البديل، الشعار، التذييل، سطور التواصل، عنوان الرد، عنوان المرسل، ومصدر كل قيمة: إعدادات البريد أو المنشأة أو اسم التطبيق أو القيمة الافتراضية.

حقول النموذج

القسمالحقلالوصف والقيم المسموحة
الهويةاستخدام هوية المنشأةمفتاح. عند تفعيله تأخذ الحقول الفارغة قيمها من بيانات المنشأة.
الهويةاسم الشركةحتى 150 حرفاً. الفارغ يُستخدم مكانه اسم المنشأة.
الهويةالاسم البديلحتى 150 حرفاً. الفارغ يُستخدم مكانه اسم المنشأة بالإنجليزية.
الهويةالاسم في الترويسةالأساسي أو البديل أو كلاهما أو حسب لغة الرسالة. في الخيار الأخير تعرض الرسائل العربية الاسم الأساسي، والإنجليزية والبنغالية الاسم البديل.
الشعارمصدر الشعارشعار المنشأة أو رفع شعار أو بدون شعار.
الشعاررفع الشعارPNG أو JPG أو WebP بحد أقصى 1 ميغابايت. يُحفظ بصيغة PNG بمقاس أقصاه 480 في 160 مع الحفاظ على الشفافية.
الشعارعرض الشعارشريط تمرير من 40 إلى 240 بكسل.
الشعارموضع الشعارفوق الاسم أو في الوسط أو بعرض الترويسة. في الأخير لا يُطبَّق عرض الشعار.
الشعارتضمين الشعار داخل الرسالةمفتاح. عند تفعيله تُرسل الصورة مع الرسالة نفسها، فتظهر حتى لو لم يكن الموقع متاحاً على الإنترنت.
الألوانخلفية الترويسةرمز لون سداسي مثل #0f172a.
الألواننص الترويسةرمز لون سداسي. إذا كان التباين مع الخلفية أقل من 4.5 إلى 1 يظهر تحذير.
الألواناللون المميزلون الأزرار والروابط.
التذييل وبيانات التواصلنص التذييلحقل للرسائل العربية وحقل للإنجليزية والبنغالية. حتى 500 حرف. الفارغ يُستخدم مكانه النص الافتراضي.
التذييل وبيانات التواصلسطور التواصلمفاتيح منفصلة لإظهار: العنوان، الهاتف، البريد الإلكتروني، الموقع الإلكتروني، رقم السجل التجاري، الرقم الضريبي. القيم مأخوذة من بيانات المنشأة.
التذييل وبيانات التواصلتنبيه الرسالة الآليةمفتاح. سطر صغير في آخر الرسالة يطلب عدم الرد. يمكن كتابة نص خاص بالعربية وآخر بالإنجليزية.
التذييل وبيانات التواصلعنوان الردبريد صحيح أو فارغ. الفارغ يعني أن الردود تصل إلى عنوان المرسل.

المعاينة المباشرة

  • تتحدث أثناء الكتابة وتشمل التغييرات غير المحفوظة.
  • لغة الرسالة: العربية أو الإنجليزية أو البنغالية.
  • الرسالة: اختر أي نوع من الرسائل لترى شكله. الافتراضي رسالة اختبار SMTP.
  • عرض المعاينة: سطح المكتب أو الجوال.

حفظ الهوية

  1. عدّل ما تريد وراقب المعاينة.
  2. اضغط زر الحفظ. تظهر الرسالة أن الهوية حُفظت وأن الرسائل الجديدة تستخدمها فوراً.

قائمة الرسائل المرسلة

تعرض كل أنواع الرسائل مجمّعة في خمس مجموعات: الوثائق، السلف، الأمان، بوابة المناديب، النظام. في رأس القائمة العدّاد {on} من {total} مفعّلة.

لكل نوع: اسمه ووصفه، اللغات المتاحة له، آخر إرسال، عدد المرسل والفاشل خلال آخر 30 يوماً، مفتاح تشغيل وإيقاف، ورابط تعديل القالب.

إيقاف نوع من الرسائل

  1. أطفئ المفتاح بجانب النوع. تظهر الرسالة أن النوع أُوقف ولن يُرسل.
  2. الإيقاف يشمل نسخ القالب بكل اللغات معاً.

قواعد الهوية والمحتوى

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

11.4 سجل البريد

المكان في القائمة
النظام ← سجل البريد
الرابط
/admin/email/log
الصلاحية المطلوبة
عرض ضمن سجل البريد. التصدير يحتاج تصدير ضمن الوحدة نفسها. إعادة المحاولة تحتاج تعديل ضمن قوالب البريد.

الغرض

كل رسالة حاول النظام إرسالها، وما آلت إليه. يُستخدم للتأكد من وصول تنبيه، أو لمعرفة سبب فشل رسالة وإعادة إرسالها.

ما تراه في الشاشة

  • مربع بحث: ابحث بالمستلم أو الموضوع….
  • عوامل التصفية: الحالة، القالب، من تاريخ، إلى تاريخ. عامل القالب يظهر فقط لمن يحمل عرض القوالب.
  • أعمدة الجدول: التاريخ، الحالة، القالب، المستلم (العنوان وتحته الاسم)، الموضوع، المحاولات.
  • الضغط على صف يفتح لوحة تفاصيل الرسالة.

الإجراءات

عرض تفاصيل رسالة

  1. اضغط الصف. تظهر اللوحة الجانبية وفيها: الحالة، القالب، المستلم، نسخة إلى، الموضوع، السجل المرتبط، وقت الإنشاء، وقت الإرسال، آخر محاولة، عدد المحاولات، معرّف الرسالة لدى المزوّد.
  2. للرسالة الفاشلة يظهر أيضاً رمز الخطأ ونص الخطأ.

إعادة إرسال رسالة فاشلة

  1. افتح تفاصيل رسالة حالتها فشلت.
  2. اضغط إعادة المحاولة.
  3. تظهر رسالة أن المحاولة أُعيدت. حدّث القائمة لرؤية النتيجة. يزيد عدّاد المحاولات بواحد.

الحالات ومعانيها

الحالةالمعنى
في الانتظارالرسالة مسجلة ولم تُرسل بعد.
أُرسلتقبلها خادم البريد.
فشلتلم تُرسل. السبب في نص الخطأ.

الاستيراد والتصدير

  • زر تصدير CSV يصدّر السجل بعد تطبيق البحث والتصفية الحاليين.

قواعد وتنبيهات

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

11.5 سجل النشاط

المكان في القائمة
النظام ← سجل النشاط
الرابط
/admin/logs/audit
الصلاحية المطلوبة
عرض ضمن سجل التدقيق أو عرض ضمن السجلات. التصدير يحتاج تصدير ضمن أي منهما.

الغرض

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

ما تراه في الشاشة

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

الإجراءات

عرض تفاصيل حدث

  1. اضغط الصف. تظهر لوحة تفاصيل الحدث وفيها الوقت والإجراء والمنفذ والسجل والعنوان والمسار ومعرّف الطلب والمتصفح.
  2. في قسم ما الذي تغيّر تظهر القيم قبل وبعد لكل حقل، مع العلامات مُضاف ومحذوف ومُعدَّل.
  3. اضغط إظهار القيم غير المتغيّرة ({n}) لرؤية بقية الحقول.

الحالات ومعانيها

درجات الخطورة:

الخطورةالمعنى
معلومةإجراء عادي، مثل تعديل بيانات.
تحذيرإجراء حساس، مثل تعطيل حساب أو حظر عنوان أو تغيير صلاحيات أو رفض وصول.
خطأإجراء انتهى بخطأ.
حرجإجراء لا رجعة فيه، مثل حذف حساب أو حذف دور.

حالة الحدث: ناجح، فاشل، خطأ، قيد الانتظار، مرفوض.

نوع المنفذ: مستخدم، النظام، واجهة برمجية، زائر، مهمة مجدولة.

الاستيراد والتصدير

  • زر تصدير CSV يصدّر السجل بعد تطبيق عوامل التصفية.

قواعد وتنبيهات

  • السجل للقراءة فقط. لا يمكن تعديل حدث ولا حذفه من الشاشة.
  • كل محاولة وصول مرفوضة لنقص الصلاحية تُسجَّل هنا بدرجة تحذير.
  • كلمات المرور والقيم السرية لا تُكتب في السجل أبداً.
  • يُحذف الأقدم تلقائياً بعد 365 يوماً في الإعداد الافتراضي، ولا تنزل المدة عن 90 يوماً.

11.6 محاولات الدخول

المكان في القائمة
النظام ← محاولات الدخول
الرابط
/admin/logs/login
الصلاحية المطلوبة
عرض ضمن سجل الدخول. التصدير يحتاج تصدير ضمن الوحدة نفسها.

الغرض

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

ما تراه في الشاشة

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

الحالات ومعانيها

الحالةالمعنى
ناجحتم الدخول وفُتحت جلسة.
فاشلرُفضت المحاولة. السبب في عمود سبب الفشل.

عمود سبب الفشل يعرض رمزاً إنجليزياً قصيراً:

الرمزالمعنى
bad_passwordكلمة المرور خاطئة لحساب موجود.
unknown_userالاسم المكتوب لا يطابق أي حساب.
account_lockedالحساب مقفل.
account_disabledالحساب معطّل.
ip_blockedالعنوان محظور.
challenge_invalidرمز التحقق خاطئ.
challenge_expiredرمز التحقق انتهت صلاحيته.
challenge_usedرمز التحقق استُعمل من قبل.
challenge_attempts_exceededتجاوز عدد الأخطاء المسموح على الرمز نفسه.
challenge_requiredلم يُرسل رمز تحقق.
missing_credentialsاسم المستخدم أو كلمة المرور فارغ.

الاستيراد والتصدير

  • زر تصدير CSV يصدّر السجل بعد تطبيق عوامل التصفية.

قواعد وتنبيهات

  • السببان bad_password و unknown_user فقط يُحسبان في عدّاد قفل الحساب. أخطاء رمز التحقق لا تقفل الحساب، لكنها تُحسب في عدّاد حظر العنوان.
  • محاولات كثيرة بالسبب unknown_user من عنوان واحد علامة على محاولة تخمين. احظر العنوان من شاشة العناوين المحظورة.
  • السجل للقراءة فقط.
  • يُحذف الأقدم تلقائياً بعد 180 يوماً في الإعداد الافتراضي، ولا تنزل المدة عن 60 يوماً.

11.7 أخطاء النظام

المكان في القائمة
النظام ← أخطاء النظام
الرابط
/admin/logs/errors
الصلاحية المطلوبة
عرض ضمن السجلات. التصدير يحتاج تصدير، والحذف يحتاج حذف، ضمن الوحدة نفسها.

الغرض

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

ما تراه في الشاشة

  • عوامل التصفية: المستوى، الطريقة، من تاريخ، إلى تاريخ.
  • أعمدة الجدول: الوقت، المستوى، رمز الخطأ، الوحدة، الرسالة، المسار، المستخدم.
  • المستويات: معلومة، تحذير، خطأ، حرج.
  • إذا لم توجد أخطاء تظهر العبارة أن لا أخطاء مطابقة وأن هذا خبر جيد.

الإجراءات

عرض تفاصيل خطأ

  1. اضغط الصف. تظهر لوحة تفاصيل الخطأ وفيها كل الحقول ومعها أثر التنفيذ.
  2. استخدم زر نسخ لنسخ التفاصيل وإرسالها إلى الدعم الفني.

حذف سجل خطأ

  1. في لوحة التفاصيل اضغط حذف السجل.
  2. في السؤال حذف هذا السجل نهائياً؟ اضغط نعم، احذف، أو تراجع للإلغاء.

الاستيراد والتصدير

  • زر تصدير CSV يصدّر السجل بعد تطبيق عوامل التصفية.

قواعد وتنبيهات

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

11.8 الوظائف المجدولة

المكان في القائمة
النظام ← الوظائف المجدولة
الرابط
/admin/cron-jobs
الصلاحية المطلوبة
عرض ضمن المهام المجدولة. التشغيل اليدوي يحتاج تشغيل، والتصدير يحتاج تصدير.

الغرض

عنوان الشاشة المهام المجدولة. تعرض المهام التي يشغّلها النظام من تلقاء نفسه، وتوقيتها، ونتيجة آخر تشغيل لكل منها، وتتيح تشغيل أي مهمة فوراً.

ما تراه في الشاشة

بطاقات المهام

لكل مهمة بطاقة فيها:

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

المهام المسجلة

اسم المهمةالوصف كما يظهرالموعد الافتراضيمفتاح الموعد في إعدادات النظام
document_expiryتوليد إشعارات انتهاء الوثائق وأقساط السلف وإرسال بريدهايومياً 06:00notifications.generator_cron
branding_checksفحص صور التحقق من التسجيل: الوضوح والوجه والكرتكل 5 دقائقbranding.checks_cron
branding_learnتعلُّم نموذج الكرت من مراجعات المشغّلين. يعتمد النموذج الجديد فقط إن تفوّق على القائميومياً 04:00branding.learn_cron
branding_syncمزامنة صور التحقق من التسجيل من تقرير HungerStation للأيام السابقة التي لم تُزامَن بعديومياً 10:00sync.branding_cron
data_syncمزامنة تقارير HungerStation، الأداء اليومي والتقييم الشهري، للأيام السابقة التي لم تُزامَن بعديومياً 15:00sync.cron
auto_backupنسخة احتياطية تلقائية مع حذف الأقدم من العدد المحتفظ بهيومياً 03:00backup.cron
log_cleanupحذف السجلات الأقدم من مدة الاحتفاظ: التدقيق والأخطاء والدخول والبريد والجلسات المنتهيةيومياً 03:30logs.cleanup_cron

سجل التشغيل

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

الإجراءات

تشغيل مهمة فوراً

  1. في بطاقة المهمة اضغط تشغيل الآن. يتغير الزر إلى جارٍ التشغيل….
  2. انتظر حتى تنتهي. تظهر رسالة بنجاح المهمة أو بانتهائها بخطأ.
  3. راجع التفاصيل في سجل التشغيل بالأسفل.

عرض تفاصيل تشغيل

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

تغيير موعد مهمة

  1. انسخ اسم المفتاح الظاهر في مصدر التوقيت.
  2. افتح الإعدادات، تبويب إعدادات النظام، وابحث عن المفتاح.
  3. عدّل قيمته بصيغة cron واحفظ.
  4. موعد النسخ الاحتياطي يُعدَّل من شاشة النسخ الاحتياطي مباشرة ويسري فور الحفظ.

الحالات ومعانيها

الحالةالمعنى
مفعّلة / معطّلةهل المهمة مسموح لها بالعمل.
مجدولة / غير مجدولةهل لها موعد قادم صالح. غير مجدولة تعني أن صيغة الموعد غير صالحة أو أن المجدول لم يبدأ.
قيد التشغيلالمهمة تعمل الآن.

نتيجة التشغيل: قيد التشغيل، اكتملت، فشلت.

الاستيراد والتصدير

  • زر تصدير CSV يصدّر سجل التشغيل بعد تطبيق عوامل التصفية.

قواعد وتنبيهات

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

11.9 النسخ الاحتياطي

المكان في القائمة
النظام ← النسخ الاحتياطي
الرابط
/admin/backups
الصلاحية المطلوبة
عرض ضمن النسخ الاحتياطي. بقية الإجراءات كما في الجدول.
الإجراءالصلاحية اللازمة ضمن النسخ الاحتياطي
عرض القائمة وسجل الاستعادة ومحتويات الأرشيفعرض
إنشاء نسخة، رفع نسخة من ملف، تسجيل ملفإضافة
التحقق من سلامة الأرشيفتحقق
تنزيل الأرشيفتنزيل مرفق
الاستعادةاستعادة
حذف نسخةحذف
تعديل جدولة النسخ التلقائيالإعدادات

الغرض

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

ما تراه في الشاشة

من الأعلى إلى الأسفل:

  1. بطاقة النسخ الاحتياطي التلقائي وفيها شارة مفعّل أو متوقف.
  2. بطاقة إنشاء نسخة جديدة.
  3. قائمة ملفات في مجلد النسخ بلا سجل، إن وُجدت.
  4. النسخ المتاحة: بطاقة لكل نسخة.
  5. سجل عمليات الاستعادة.

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

الإجراءات

إنشاء نسخة يدوية

  1. في إنشاء نسخة جديدة اختر نوع النسخة.
  2. اكتب ملاحظة (اختياري)، مثل سبب أخذ النسخة.
  3. اضغط إنشاء النسخة. يظهر جارٍ إنشاء النسخة….
  4. عند الانتهاء تظهر الرسالة تم إنشاء النسخة الاحتياطية وتُضاف النسخة إلى القائمة.

تنزيل نسخة

  1. في بطاقة النسخة اضغط تنزيل. يُحفظ ملف الأرشيف على جهازك.
  2. احفظه في مكان آمن خارج الخادم.

التحقق من سلامة نسخة

  1. اضغط تحقّق.
  2. تظهر النتيجة: البصمة مطابقة وتعني أن الأرشيف سليم، أو رسالة عدم المطابقة مع السبب.

رفع نسخة من ملف

  1. اضغط رفع نسخة من ملف.
  2. اختر ملف أرشيف بامتداد zip سبق تنزيله من هذا النظام.
  3. انتظر حتى يكتمل الرفع. تظهر النسبة المئوية.
  4. تظهر النسخة في القائمة وتصبح قابلة للاستعادة.

تسجيل ملف موجود على الخادم

  1. إذا ظهرت قائمة ملفات في مجلد النسخ بلا سجل فهذه ملفات وُضعت في مجلد النسخ مباشرة.
  2. اضغط تسجيل بجانب الملف ليظهر في القائمة.

استعادة نسخة

  1. في بطاقة النسخة اضغط استعادة. تُفتح لوحة استعادة نسخة احتياطية.
  2. اقرأ التحذير: ستحل محتويات هذه النسخة محل البيانات الحالية بالكامل.
  3. انتظر حتى تُقرأ محتويات الأرشيف. راجع تاريخ أخذ النسخة ومحتويات الأرشيف.
  4. في الملفات المرفوعة اترك الخيار كما هو للوضع الافتراضي، أو ضع علامة على حذف الملفات الحالية واستبدالها بملفات الأرشيف.
  5. في حقل تأكيد الاستعادة اكتب الكلمة RESTORE بالأحرف الإنجليزية الكبيرة. زر التنفيذ معطل قبل ذلك.
  6. اضغط تنفيذ الاستعادة وانتظر. لا تغلق الصفحة.
  7. عند النجاح تظهر تمت الاستعادة بنجاح مع عدد الجداول والملفات والمدة، ورقم نسخة الأمان، وحالة جلستك.

حذف نسخة

  1. اضغط حذف.
  2. في السؤال الذي يذكر اسم الأرشيف اضغط نعم، احذف.

ضبط النسخ التلقائي

  1. في بطاقة النسخ الاحتياطي التلقائي فعّل إنشاء نسخة تلقائيًا حسب الجدول أو أوقفه.
  2. اختر نوع النسخة.
  3. حدّد الموعد اليومي. أو اكتب صيغة cron (متقدم) لجدولة غير يومية.
  4. حدّد عدد النسخ التلقائية المحتفظ بها.
  5. اضغط حفظ الجدولة. تظهر الرسالة حُفظت جدولة النسخ. ويسري الموعد الجديد فوراً.

الحقول

الحقلإلزاميالوصف والقيم المسموحة
نوع النسخةنعمكاملة (قاعدة بيانات + ملفات) أو قاعدة البيانات فقط أو الملفات المرفوعة فقط.
ملاحظةلانص حر. يُحفظ أيضاً مع النسخة المرفوعة أو المسجلة.
التشغيللامفتاح تفعيل النسخ التلقائي.
الموعد اليوميلاوقت بتوقيت الرياض. الافتراضي 03:00.
صيغة cron (متقدم)لاخمس خانات: دقيقة، ساعة، يوم، شهر، يوم الأسبوع. الصيغة غير الصالحة تُرفض برسالة صيغة cron غير صالحة.
عدد النسخ التلقائية المحتفظ بهالارقم صحيح من 1 إلى 365. الافتراضي 14.
تأكيد الاستعادةنعم عند الاستعادةالكلمة RESTORE حرفياً.
حذف الملفات الحالية واستبدالها بملفات الأرشيفلامربع اختيار. غير محدد افتراضياً.
تجاوز فحص البصمةلامربع اختيار يظهر فقط عند عدم تطابق البصمة.

الحالات ومعانيها

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

قواعد وتنبيهات

عن نوع النسخة

  • النسخة الكاملة هي الوحيدة التي تُستعاد بلا نقص. استعادة قاعدة البيانات وحدها تترك كل صورة ووثيقة تشير إلى ملف غير موجود.

عن التشفير

  • التشفير تلقائي بمفتاح الخادم. لا توجد كلمة مرور يكتبها المستخدم عند إنشاء النسخة أو استعادتها.
  • الملف المنزَّل مشفّر ولا يُفتح إلا بمفتاح هذا الخادم نفسه.
  • على مسؤول الخادم الاحتفاظ بمفتاح التشفير في مكان آمن ومنفصل عن النسخ. بدونه لا تُفتح أي نسخة.
  • إذا رُفعت نسخة مختومة بمفتاح خادم آخر، تُسجَّل مع تحذير أنها لن تُستعاد إلا بالمفتاح الأصلي.

عن الاستعادة

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

عن النسخ التلقائي

  • النسخة التلقائية مشفرة كالنسخ اليدوية.
  • بعد كل نسخة تلقائية جديدة يُحذف الأقدم من العدد المحتفظ به. النسخ اليدوية ونسخ الأمان والنسخ المرفوعة لا تُحذف تلقائياً.
  • عند التوقف أو عند صيغة موعد غير صالحة تظهر العبارة أن لا تشغيل قادم.

عن الرفع

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

سجل عمليات الاستعادة

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

11.10 اللغات

المكان في القائمة
النظام ← اللغات
الرابط
/admin/languages
الصلاحية المطلوبة
عرض ضمن اللغات والترجمات. الرفع والتعديل والحذف وإعادة البناء تحتاج إدارة ضمن الوحدة نفسها.

الغرض

عنوان الشاشة اللغات والترجمة. تعرض كل لغات الواجهة، ومدى اكتمال ترجمة كل منها مقارنة بالعربية، وتتيح إضافة لغة جديدة أو تحديث ترجمة، ثم إعادة بناء الواجهة لتصبح التغييرات فعالة.

ما تراه في الشاشة

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

اللغات المدمجة ثلاث: العربية والإنجليزية والبنغالية. أي لغة أخرى تُضاف من هذه الشاشة.

الإجراءات

تنزيل ملف ترجمة

  1. في بطاقة اللغة اضغط تنزيل.
  2. اختر الصيغة: Excel (.xlsx) أو CSV (.csv) أو JSON (.json).
  3. الملف يحتوي كل المفاتيح مع النص العربي والإنجليزي والترجمة الحالية لهذه اللغة.

إضافة لغة جديدة

  1. اضغط إضافة لغة. يُفتح معالج من أربع خطوات: اللغة، الملف، المعاينة، البناء.
  2. في خطوة اللغة اختر لغة جديدة. اختر من اقتراحات أو أدخل البيانات يدوياً: رمز اللغة، اتجاه الكتابة، الاسم باللغة نفسها، الاسم بالإنجليزية، والخط والعلم اختياريان. اضغط التالي.
  3. في خطوة الملف نزّل القالب من تنزيل قالب، املأ عمود الترجمة، ثم اسحب الملف إلى المربع أو اضغط للاختيار. اضغط تحليل الملف.
  4. في خطوة المعاينة راجع الأرقام والأخطاء، ثم اضغط تطبيق الترجمة.
  5. في خطوة البناء انتظر. يمكنك إغلاق النافذة وسيستمر البناء.
  6. عند ظهور الترجمات الجديدة منشورة اضغط إعادة تحميل الصفحة.

تحديث ترجمة لغة موجودة

  1. اضغط رفع تحديث في بطاقة اللغة، أو رفع ترجمة في الرأس ثم اختر تحديث لغة موجودة وحدد اللغة.
  2. ارفع الملف وحلله كما في الخطوات السابقة.
  3. الترجمات المرفوعة تُحفظ تعديلات فوق ملف اللغة دون المساس بالأصل.

تعديل ترجمة عبارة واحدة

  1. في بطاقة اللغة اضغط عرض المفاتيح.
  2. ابحث في مربع ابحث في المفتاح أو النص…، أو اختر من عرض: الناقصة فقط أو المعدّلة فقط.
  3. اضغط تعديل الترجمة بجانب العبارة. أعمدة الجدول: المفتاح، المرجع العربي، الإنجليزية، ثم عمود باسم اللغة.
  4. اكتب الترجمة واضغط حفظ، أو اضغط Ctrl+Enter. زر Esc يلغي.
  5. يظهر تنبيه التعديلات لم تُنشر بعد. اضغط إعادة البناء الآن بعد الانتهاء من كل تعديلاتك.

التراجع عن تعديل

  1. بجانب العبارة التي تحمل الشارة معدّل اضغط التراجع إلى النص الأصلي.

إعادة بناء الواجهة

  1. اضغط إعادة البناء الآن. تظهر الرسالة بدأت إعادة بناء الواجهة.
  2. راقب شارة البناء. اضغط عرض السجل لرؤية مخرجات البناء.
  3. عند الفشل تظهر فشل بناء الواجهة. الملفات محفوظة لكن الواجهة المنشورة لم تتغير. اضغط إعادة محاولة البناء.

حذف لغة

  1. في بطاقة لغة مصدرها مُنشأة من اللوحة اضغط حذف.
  2. أكّد بالضغط على نعم، احذف اللغة. تُحفظ نسخة احتياطية من ملفاتها وتبدأ إعادة البناء.

الحقول

الحقلإلزاميالوصف والقيم المسموحة
رمز اللغةنعمحرفان أو ثلاثة صغيرة، مثل fr أو ur، ويمكن إضافة رمز المنطقة مثل pt-BR.
اتجاه الكتابةنعممن اليمين لليسار أو من اليسار لليمين.
الاسم باللغة نفسهانعمكما يراه متحدث اللغة في قائمة اختيار اللغة.
الاسم بالإنجليزيةنعممثل French أو Urdu.
الخطلااتركه فارغاً لاستخدام الخط الافتراضي حسب الاتجاه.
العلملارمز تعبيري واحد.
ملف الترجمةنعمJSON أو Excel أو CSV، حتى 5 ميغابايت.

الحالات ومعانيها

حالة البناء:

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

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

قواعد وتنبيهات

  • المتغيرات يجب أن تبقى كما هي. إذا احتوى النص العربي على متغير بين قوسين معقوفين مثل {name} فيجب أن تحتويه الترجمة نفسه. الترجمة المخالفة تُرفض.
  • تُقبل فقط المفاتيح الموجودة في العربية. أي مفتاح آخر يُتجاهل.
  • في اللغة الجديدة، العبارات غير المترجمة تُملأ بالإنجليزية مؤقتاً.
  • الترجمة نص فقط بحد أقصى 5000 حرف، ولا تُحفظ فارغة.
  • التعديلات لا تظهر للمستخدمين قبل إعادة بناء الواجهة. رفع ملف يبدأ البناء تلقائياً، أما تعديل عبارة واحدة فلا يبدأه.
  • لا يعمل بناءان معاً. الطلب الثاني ينتظر.
  • صلاحية المعاينة 30 دقيقة. بعدها حلّل الملف مرة أخرى.
  • إذا فشل فحص تطابق مفاتيح اللغات تُعاد الملفات إلى حالتها السابقة ولا يُطبَّق أي تغيير.
  • لا يمكن حذف اللغات المدمجة: العربية والإنجليزية والبنغالية.
  • لا يمكن إضافة لغة برمز موجود. اختر تحديث لغة موجودة.
  • إذا لم تكن ملفات الواجهة المصدرية متوفرة على الخادم تظهر رسالة بذلك، ولا يمكن تعديل اللغات.
  • اللغة الجديدة تظهر في قائمة اختيار اللغة وفي حقل لغة الواجهة في الملف الشخصي بعد نجاح البناء.

11.11 معالج التثبيت الأول

المكان في القائمة
لا يظهر في القائمة. يُفتح تلقائياً عند أول تشغيل قبل التثبيت
الرابط
/setup
الصلاحية المطلوبة
لا يحتاج حساباً، لأنه يعمل قبل وجود أي حساب. بعد اكتمال التثبيت يُغلق ولا يمكن فتحه.

الغرض

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

الخطوات

الخطوة 1: قاعدة البيانات

  1. أدخل بيانات الاتصال بخادم قاعدة البيانات.
  2. اضغط اختبار الاتصال. زر الحفظ معطل حتى ينجح الاختبار.
  3. اضغط زر الحفظ والمتابعة.

الحقول: المضيف (Host) واسم المستخدم واسم قاعدة البيانات إلزامية، والمنفذ (Port) وكلمة المرور اختياريان. المنفذ الافتراضي 3306. تُنشأ القاعدة تلقائياً إذا لم تكن موجودة.

الخطوة 2: الجداول والبيانات

  1. اضغط زر تشغيل إنشاء الجداول والبيانات الأساسية.
  2. راقب سجل التنفيذ حتى تظهر رسالة اكتمال إنشاء الجداول والبيانات بنجاح.
  3. اضغط متابعة. الزر معطل حتى ينجح التنفيذ.

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

الخطوة 3: بيانات المنصة

  1. أدخل اسم المنصة، وهو الحقل الإلزامي الوحيد.
  2. أكمل بيانات الشركة: الوصف، اسم الشركة، الرقم الضريبي، عنوان الشركة، بريد الدعم، هاتف الدعم، رابط الموقع.
  3. في الهوية النظامية للمنشأة أدخل اسم المنشأة بالإنجليزية، رقم الهوية / المنشأة، رقم السجل التجاري.
  4. في الشعار ووثائق المنشأة ارفع ما يتوفر: شعار المنشأة، شعار الوضع الداكن (اختياري)، صورة السجل التجاري، الشهادة الضريبية، رخصة النشاط التجاري (البلدية)، شهادة السلامة، الشهادة الصحية، أيقونة الموقع (Favicon).
  5. في الإعدادات الإقليمية اختر اللغة الافتراضية، العملة الافتراضية، المنطقة الزمنية، الدولة الافتراضية.
  6. في المظهر والضرائب اختر اللون الأساسي واللون الثانوي، وأدخل اسم الضريبة ونسبة الضريبة الافتراضية (%)، وحدد تفعيل الضريبة.
  7. اضغط حفظ ومتابعة.

الملفات صور أو PDF بحد أقصى 10 ميجابايت للملف الواحد. كلها اختيارية، ويمكن رفعها أو استبدالها لاحقاً من الإعدادات ← بيانات المنشأة.

الخطوة 4: حساب المدير

  1. أدخل الاسم الكامل والبريد الإلكتروني وكلمة المرور وتأكيد كلمة المرور. كلها إلزامية.
  2. اضغط إنشاء الحساب ومتابعة.

هذا الحساب هو المدير الأول للنظام بصلاحيات كاملة، ودوره Super Admin. اسم الدخول يُشتق تلقائياً من الجزء الذي يسبق علامة @ في البريد، ويمكن الدخول بالبريد نفسه أيضاً.

الخطوة 5: البريد الإلكتروني

  1. أدخل إعدادات خادم البريد: خادم SMTP، المنفذ، التشفير، اسم المستخدم، كلمة المرور، اسم المرسل، بريد المرسل.
  2. اضغط زر الحفظ، أو اضغط تخطي لتأجيل الإعداد.

هذه الخطوة اختيارية. يمكن ضبط البريد لاحقاً من شاشة قوالب البريد، تبويب إعدادات SMTP.

الخطوة 6: اكتمال

  1. تظهر الرسالة تم تثبيت المنصة بنجاح! مع رابط لوحة التحكم وبريد المدير واسم قاعدة البيانات.
  2. اضغط الذهاب إلى لوحة التحكم.
  3. سجّل الدخول بحساب المدير الذي أنشأته.

قواعد وتنبيهات

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

أسئلة شائعة

غيّرت أقصى محاولات دخول في إعدادات المنصة ولم يتغير سلوك الدخول، لماذا؟

حدود الدخول الفعلية تُقرأ من تبويب إعدادات النظام، تصنيف الأمان. عدّل المفتاح auth.max_login_attempts لعدد المحاولات، و auth.lockout_minutes لمدة القفل، و auth.session_ttl_minutes لمدة الجلسة. يسري التغيير خلال ثوانٍ.

كيف أغيّر عدد الأيام التي يبدأ قبلها التنبيه بانتهاء وثيقة؟

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

الرسائل لا تصل إلى أحد، من أين أبدأ؟

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

نزّلت نسخة احتياطية ولم أستطع فتح الملف على جهازي، هل هي تالفة؟

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

عدّلت ترجمة عبارة ولم تتغير في الواجهة، لماذا؟

تعديل عبارة واحدة يُحفظ لكنه لا يُنشر حتى تُعاد بناء الواجهة. اضغط إعادة البناء الآن في شاشة اللغات، وانتظر حتى تصبح الحالة نجح، ثم اضغط إعادة تحميل الصفحة.

هل أستطيع إيقاف مهمة مجدولة من شاشة الوظائف المجدولة؟

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

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