الفصل 11
إعدادات النظام وصيانته
يغطي هذا الفصل شاشات قسم النظام في القائمة الجانبية: الإعدادات بتبويباتها الأربعة، المرفقات، قوالب البريد وسجله، السجلات الثلاثة، المهام المجدولة، النسخ الاحتياطي، واللغات. ويختم بوصف معالج التثبيت الذي يُشغَّل مرة واحدة عند تركيب النظام.
يحتاجه مدير النظام عند ضبط بيانات المنشأة، أو تغيير مواعيد التنبيهات، أو إعداد البريد، أو أخذ نسخة احتياطية، أو تتبع من فعل ماذا.
أغلب هذه الشاشات حساسة، ولا يراها في الوضع الافتراضي إلا صاحب دور Super Admin.
71 قسماً42 دقيقة قراءة
11.1 الإعدادات
| التبويب | صلاحية العرض | صلاحية التعديل |
|---|---|---|
| بيانات المنشأة | عرض ضمن بيانات المنشأة | تعديل ضمن بيانات المنشأة |
| إعدادات المنصة | عرض ضمن إعدادات المنصة | تعديل ضمن إعدادات المنصة |
| إعدادات النظام | عرض ضمن إعدادات النظام | تعديل ضمن إعدادات النظام |
| المفاتيح السرية | عرض ضمن المفاتيح والإعدادات السرية | تعديل للإضافة والاستبدال، وحذف للحذف |
الغرض
شاشة واحدة عنوانها الإعدادات تجمع أربعة أنواع من الضبط. كل تبويب يخاطب جمهوراً مختلفاً ويُحفظ مستقلاً عن غيره.
ما تراه في الشاشة
- شريط التبويبات في الأعلى. التبويب الذي لا تحمل صلاحية عرضه لا يظهر أصلاً.
- في رأس كل تبويب فقرة تعريفية: ماذا يضبط ومن يتأثر به.
- شريط الحفظ: يعرض تعديلات غير محفوظة: {count} وزري التراجع عن التعديلات وحفظ التغييرات.
- كل حقل غيّرته يحمل الشارة مُعدَّل حتى تحفظ.
- تحت بعض الحقول سطر رمادي يشرح وظيفة الحقل، وتحت الحقول الخطرة سطر كهرماني يحذر من أثر القيمة الخاطئة.
- من يحمل العرض دون التعديل يرى القيم ومعها العبارة لديك صلاحية العرض فقط.
الإجراءات
تعديل إعداد وحفظه
- اختر التبويب المطلوب.
- عدّل الحقول التي تريدها. لا يُطبَّق أي تعديل قبل الحفظ.
- اضغط حفظ التغييرات. تظهر الرسالة تم حفظ التغييرات.
- للتراجع قبل الحفظ اضغط التراجع عن التعديلات.
الانتقال بين التبويبات
- اضغط اسم التبويب. يتغير الرابط معه، مثل
/admin/settings/platform. - انتبه: الانتقال إلى تبويب آخر يُسقط التعديلات غير المحفوظة في التبويب السابق. احفظ أولاً.
11.1.1 تبويب بيانات المنشأة
هذا التبويب يحمل الهوية الرسمية للمنشأة. بياناته تُطبع كما هي على بطاقة المندوب وبطاقة التشغيل وكل تقرير يصدره النظام. له عنصر مستقل في القائمة الجانبية يفتحه مباشرة.
النموذج مقسم إلى خمسة أقسام. كل الحقول اختيارية.
| القسم | الحقل | الوصف والقيم المسموحة |
|---|---|---|
| الهوية | اسم النظام | يظهر في عنوان المتصفح وشاشة الدخول. تغييره لا يعدّل أي مستند صدر سابقاً. |
| الهوية | إصدار النظام | رقم الإصدار المعروض في التذييل. حدّثه بعد كل تحديث فعلي للنظام. |
| الهوية | اسم المنشأة | الاسم النظامي بالعربية. يظهر في الشريط الجانبي وشاشة الدخول ويُطبع على المستندات. |
| الهوية | اسم المنشأة بالإنجليزية | للمستندات والرسائل الصادرة بالإنجليزية. اتركه فارغاً إن لم يكن مسجلاً. |
| البيانات النظامية | رقم الهوية / المنشأة | الرقم الموحد للمنشأة كما ورد في شهادتها. أرقام فقط دون فواصل أو مسافات. |
| البيانات النظامية | رقم السجل التجاري | كما هو في الشهادة. |
| البيانات النظامية | الرقم الضريبي | الرقم الضريبي المكون من 15 رقماً. |
| بيانات التواصل | بريد الدعم | بصيغة بريد صحيحة، وإلا رُفض الحفظ. |
| بيانات التواصل | هاتف الدعم | اكتبه بصيغة دولية تبدأ بمفتاح الدولة. |
| بيانات التواصل | الموقع الإلكتروني | ابدأه بـ https:// وإلا لن يفتح الرابط. |
| بيانات التواصل | العنوان | العنوان الوطني المطبوع على المستندات الرسمية. |
| الإعدادات الإقليمية | اللغة الافتراضية | قائمة باللغات المتاحة. هي اللغة التي يراها المستخدم قبل أن يختار لغته، والتي يتبعها من اختار لغة المنشأة في ملفه. |
| الإعدادات الإقليمية | المنطقة الزمنية | قائمة بالمدن، مثل الرياض. كل توقيت في النظام يُحسب منها، وعليها تعمل المهام المجدولة. |
| الإعدادات الإقليمية | العملة الافتراضية | قائمة بالعملات، مثل الريال السعودي. تُستخدم لكل مبلغ لا يحمل عملة خاصة به. |
| الإعدادات الإقليمية | صيغة التاريخ | خمس صيغ، كل واحدة معروضة مع مثال. تؤثر على الشكل فقط ولا تغيّر التاريخ المخزن. |
| وضع الصيانة | تفعيل وضع الصيانة | مفتاح تشغيل وإيقاف. الشاشة تحذر: تفعيله يمنع دخول جميع المستخدمين عدا المسؤولين. |
| وضع الصيانة | رسالة وضع الصيانة | النص الذي يراه المستخدم أثناء الإيقاف. اذكر فيه الموعد المتوقع لعودة الخدمة. |
قسم مرفقات المنشأة
يظهر تحت النموذج لمن يحمل عرض ضمن وحدة المرفقات. الرفع والاستبدال واعتماد ملف يحتاج رفع مرفق، والتنزيل يحتاج تنزيل مرفق، والحذف يحتاج حذف، وكلها ضمن وحدة المرفقات.
| المجموعة | نوع المرفق | الاستخدام |
|---|---|---|
| الهوية البصرية | الشعار الفاتح | يظهر في الشريط الجانبي وشاشة الدخول وعلى المستندات المطبوعة. يُفضَّل ملف PNG بخلفية شفافة. |
| الهوية البصرية | الشعار الداكن | بديل الشعار في الوضع الداكن. عند غيابه يُستخدم الشعار الفاتح. |
| الهوية البصرية | أيقونة الموقع | الأيقونة الصغيرة في تبويب المتصفح. يُفضَّل ملف مربع بمقاس 512 في 512. |
| المستندات النظامية | السجل التجاري | صورة السجل التجاري السارية. |
| المستندات النظامية | الشهادة الضريبية | شهادة التسجيل في ضريبة القيمة المضافة. |
| المستندات النظامية | رخصة النشاط التجاري من البلدية | رخصة مزاولة النشاط للموقع المسجل. |
| المستندات النظامية | الشهادة الصحية | الشهادة الصحية للمنشأة أو للعاملين فيها. |
| المستندات النظامية | شهادة السلامة | شهادة السلامة ومعدات الإطفاء. |
| مرفقات أخرى | عقود | العقود التي تخص المنشأة ككل، لا عقود العملاء أو المناديب. |
| مرفقات أخرى | أخرى | أي مستند آخر يلزم حفظه ضمن ملف المنشأة. |
رفع شعار أو مستند
- انزل إلى مرفقات المنشأة وابحث عن نوع المرفق.
- اضغط رفع ملف. إن كان للنوع ملف سابق يظهر الزر باسم استبدال الملف.
- اختر الملف من جهازك. أثناء الرفع يظهر جارٍ الرفع....
- تظهر الرسالة تم رفع الملف ويصبح الملف الجديد هو المعتمد حالياً.
الرجوع إلى نسخة أقدم
- افتح نسخ أقدم من هذا المستند تحت النوع.
- اضغط اعتماد هذا الملف بجانب النسخة المطلوبة.
عرض أو تنزيل أو حذف مرفق
- اضغط عرض لفتح الملف، أو تنزيل لحفظه على جهازك.
- للحذف اضغط حذف ثم حذف نهائي في سؤال تأكيد حذف المرفق؟.
قواعد مرفقات المنشأة
- الصيغ المقبولة: JPG و PNG و WEBP و GIF و PDF.
- الحد الأقصى 10 ميجابايت للملف الواحد.
- رفع ملف جديد يجعله المعتمد، ويبقى السابق محفوظاً ضمن النسخ الأقدم.
- الحذف نهائي. إن كان المحذوف هو الشعار المعتمد فسيختفي فوراً من الشريط الجانبي والمستندات.
- بعد حفظ بيانات المنشأة يتحدث الاسم والشعار في الواجهة دون حاجة إلى إعادة تحميل الصفحة.
11.1.2 تبويب إعدادات المنصة
يضبط المنصة نفسها: شكلها، وصيغ العرض، وشروط التسجيل والجلسة، والضريبة. اسم المنشأة وبيانات التواصل تظهر هنا للاطلاع فقط، لأن مكان تعديلها هو تبويب بيانات المنشأة.
النموذج مقسم إلى سبعة أقسام قابلة للتعديل. كل الحقول اختيارية.
| القسم | الحقل | الوصف والقيم المسموحة |
|---|---|---|
| المظهر | اسم المنصة | اسم المنصة في الشريط الجانبي وعنوان المتصفح والبريد الصادر. |
| المظهر | الوصف المختصر | سطر واحد أسفل الاسم في شاشة الدخول والصفحة العامة. |
| المظهر | اللون الأساسي | لون الأزرار والروابط الأساسية. اختر لوناً يبقى مقروءاً على خلفية بيضاء. |
| المظهر | اللون الثانوي | لون مساند للعناصر الثانوية. |
| الإعدادات الإقليمية | رمز العملة | قائمة من 18 عملة، منها الريال السعودي والدرهم الإماراتي والدولار الأمريكي. تغييره لا يحوّل المبالغ المسجلة سابقاً. |
| الإعدادات الإقليمية | رمز اللغة | قائمة اللغات المتاحة. |
| الإعدادات الإقليمية | المنطقة الزمنية | قائمة من 16 منطقة، منها الرياض ودبي والقاهرة والتوقيت العالمي المنسق. |
| الإعدادات الإقليمية | رمز الدولة | قائمة من 17 دولة. يحدد مفتاح الهاتف وصيغة العنوان الافتراضية. |
| الإعدادات الإقليمية | صيغة التاريخ | خمس صيغ مع مثال لكل منها. |
| الإعدادات الإقليمية | صيغة الوقت | نظام ٢٤ ساعة أو نظام ١٢ ساعة (ص/م). |
| الإعدادات الإقليمية | صيغة الأرقام | أربع صيغ لفصل الآلاف والكسور، مثل 1,234.56. |
| بيانات محركات البحث | عنوان الصفحة | العنوان الذي تعرضه محركات البحث وروابط المشاركة. نحو 60 حرفاً. |
| بيانات محركات البحث | الكلمات المفتاحية | كلمات مفصولة بفواصل. اجعل القائمة قصيرة. |
| بيانات محركات البحث | وصف الصفحة | الملخص الظاهر أسفل العنوان في نتائج البحث. نحو 155 حرفاً. |
| التسجيل والدخول | السماح بالتسجيل الذاتي | مفتاح تشغيل وإيقاف. الشاشة تحذر: عند تفعيله يستطيع أي شخص يملك الرابط إنشاء حساب دون دعوة. |
| التسجيل والدخول | إلزام توثيق البريد | مفتاح تشغيل وإيقاف. يتطلب بريداً صادراً يعمل فعلاً. |
| التسجيل والدخول | إلزام التحقق بخطوتين | مفتاح تشغيل وإيقاف. الشاشة تحذر: أعلن عنه قبل تفعيله. |
| الأمان | انتهاء الجلسة بالدقائق | رقم موجب. المعتاد بين 30 و120 دقيقة. |
| الأمان | أقل طول لكلمة المرور | رقم موجب. |
| الأمان | أقصى محاولات دخول | رقم موجب. المعتاد خمس محاولات. |
| الأمان | مدة قفل الحساب بالدقائق | رقم موجب. |
| الأمان | أقصى حجم للملف بالميجابايت | رقم موجب. |
| الأمان | أنواع الملفات المسموحة | امتدادات مفصولة بفواصل مثل pdf,jpg,png. |
| المالية والفواتير | تفعيل الضريبة | مفتاح تشغيل وإيقاف. |
| المالية والفواتير | نسبة الضريبة الافتراضية | رقم يقبل الكسور، مثل 15 لنسبة 15 بالمئة. |
| المالية والفواتير | اسم الضريبة | الاسم المطبوع على سطر الضريبة، مثل ضريبة القيمة المضافة. |
| المالية والفواتير | بادئة رقم الفاتورة | مثل INV-. |
| المالية والفواتير | رقم بداية الفواتير | رقم غير سالب. اختيار رقم مستخدم سابقاً ينتج أرقاماً مكررة. |
| وضع الصيانة | تفعيل وضع الصيانة | مفتاح على مستوى المنصة، منفصل عن مفتاح الصيانة في تبويب بيانات المنشأة. |
| وضع الصيانة | رسالة وضع الصيانة | النص المعروض أثناء الإيقاف. |
قسم بيانات التواصل للاطلاع فقط
يعرض قيماً محفوظة مصدرها شاشات أخرى، ومعه العبارة هذه القيم مخزّنة هنا لكنها لا تُعدَّل من هذه الشاشة. الحقول: اسم المنشأة، الرقم الضريبي للمنصة، بريد الدعم، هاتف الدعم، الموقع الإلكتروني، العنوان، تفعيل الدخول عبر جوجل، معرّف عميل جوجل، تفعيل الدخول عبر فيسبوك، معرّف تطبيق فيسبوك، نسبة عمولة المنصة.
قواعد تبويب المنصة
- الحقول الرقمية لا تقبل قيمة سالبة ولا نصاً. القيمة المخالفة تُرفض عند الحفظ.
- تنبيه مهم: حدود الدخول التي يطبقها النظام فعلياً عند تسجيل الدخول، وهي عدد المحاولات ومدة القفل ومدة الجلسة ومدة رمز التحقق وحد حظر العنوان، تُقرأ من تبويب إعدادات النظام، تصنيف الأمان، لا من قسم الأمان في هذا التبويب. لتغيير سلوك الدخول عدّل هناك. انظر القسم 11.1.3.
- الحد الأدنى لكلمة المرور عند إنشاء حساب أو تغيير كلمته من لوحة الإدارة هو 10 خانات دائماً.
11.1.3 تبويب إعدادات النظام
جدول مفاتيح تشغيلية تقرأها وحدات النظام مباشرة أثناء العمل. كل صف يعرض اسم المفتاح بالإنجليزية، ووصفه بالعربية، ونوع قيمته، وحقل القيمة.
ما تراه
- تنبيه قبل التعديل: هذه المفاتيح ليس لها تحقق مسبق من صحة القيمة. عدّل ما تعرف وظيفته فقط.
- شرائح تصفية حسب التصنيف، أولها الكل. التصفية تخفي الصفوف من العرض فقط ولا تلغي تعديلاً لم يُحفظ.
- التصنيفات التي لها اسم عربي: عام، الأمان، الإشعارات، السلف، الصيانة، النسخ الاحتياطي، البريد، الأداء. أي تصنيف آخر يظهر باسمه كما ورد.
- الصف المقفل يحمل الشارة غير قابل للتعديل ولا يتغير حتى مع صلاحية التعديل.
- تحت كل حقل تلميح بحسب نوع القيمة.
أنواع القيم
| النوع | ما يُقبل |
|---|---|
| رقم صحيح | رقم دون كسور أو فواصل. |
| رقم عشري | رقم بنقطة عشرية، مثل 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 تبويب المفاتيح السرية
مخزن لمفاتيح التكامل مع الخدمات الخارجية. القيم لا تُعرض هنا مطلقاً، لا كاملة ولا مقنّعة. يظهر فقط ما إذا كانت القيمة مضبوطة.
ما تراه
- شريط المفاتيح المسجّلة وفيه زرا تحديث وإضافة مفتاح.
- تنبيه بيانات حساسة وتحذير أن الاستبدال أو الحذف يسري فوراً على كل عملية تعتمد على المفتاح.
- لكل مفتاح: اسمه، وصفه، الشارة مشفّر إن كان مشفراً، الحالة القيمة مضبوطة أو القيمة غير مضبوطة، وتاريخ آخر تحديث.
- زرا استبدال القيمة وحذف بجانب كل مفتاح.
إضافة مفتاح
- اضغط إضافة مفتاح.
- أدخل اسم المفتاح كما تتوقعه الخدمة تماماً.
- أدخل القيمة الجديدة.
- أدخل الوصف. لا تكتب فيه أي جزء من القيمة.
- أبقِ تشفير القيمة عند التخزين مفعّلاً إلا إذا كانت الخدمة تتطلب القيمة كما هي.
- اضغط حفظ التغييرات. تظهر الرسالة تم حفظ المفتاح.
استبدال قيمة مفتاح
- اضغط استبدال القيمة. اسم المفتاح يظهر مقفلاً.
- أدخل القيمة الجديدة واحفظ. القيمة القديمة تُفقد فور الحفظ ولا يمكن استرجاعها.
حذف مفتاح
- اضغط حذف ثم حذف نهائي في سؤال تأكيد حذف المفتاح؟.
| الحقل | إلزامي | الوصف والقيم المسموحة |
|---|---|---|
| اسم المفتاح | نعم | من 1 إلى 100 خانة: حروف إنجليزية وأرقام ونقطة وشرطة وشرطة سفلية. لا يُعدَّل بعد الحفظ، والتغيير يتم بالحذف ثم الإضافة. |
| القيمة الجديدة | نعم | تُكتب مرة واحدة. لا تُقبل فارغة. |
| الوصف | لا | وظيفة المفتاح والخدمة التي تستخدمه. يراه كل من يحمل صلاحية عرض التبويب. |
| تشفير القيمة عند التخزين | لا | مفعّل افتراضياً. |
11.2 المرفقات
الغرض
كل ملف في النظام في مكان واحد: صور المركبات ووثائق المندوبين وأوراق المنشأة. تُستخدم للبحث عن ملف، ومعرفة المساحة المستخدمة، وحذف ما لا حاجة إليه.
ما تراه في الشاشة
- بطاقات الإحصاء: عدد الملفات، المساحة المستخدمة، ثم ثلاث بطاقات لأكثر أنواع السجلات ملفات، وتحت كل منها حجم ما تشغله.
- مربع بحث: ابحث باسم الملف أو الملاحظات….
- عوامل التصفية: نوع السجل، نوع المرفق، شكل الملف بقيمتيه صور وملفات PDF، الملف الحالي بقيمتيه الحالي فقط وغير الحالي، من تاريخ، إلى تاريخ.
- أعمدة الجدول: الملف مع صورة مصغرة واسم الملف وتحته الملاحظة، السجل وتحته نوعه، النوع، الحجم، الحالي، تاريخ الرفع، إجراءات.
- الشارة الحالي الخضراء تعني أن هذا الملف هو المعتمد لسجله الآن.
- قوائم نوع السجل ونوع المرفق تعرض فقط الأنواع التي لها ملفات فعلاً.
الإجراءات
معاينة ملف
- اضغط أيقونة معاينة في الصف. يُفتح الملف في تبويب جديد.
تنزيل ملف
- اضغط أيقونة تنزيل. يُحفظ الملف على جهازك باسمه الأصلي.
حذف ملف
- اضغط أيقونة حذف.
- أكّد السؤال الذي يذكر اسم الملف.
- يُمحى الملف من القرص ومن السجل معاً، وتتحدث بطاقات الإحصاء.
قواعد وتنبيهات
- هذه الشاشة لا ترفع ملفات. الرفع يتم من شاشة السجل نفسه، مثل صفحة المندوب أو المركبة، أو من مرفقات المنشأة.
- الحذف نهائي ولا يمكن استرجاع الملف إلا من نسخة احتياطية.
- حذف ملف يحمل شارة الحالي يترك سجله بلا ملف معتمد.
- أنواع السجلات التي تظهر في الجدول تشمل: المنشأة، مستخدم، مندوب، هوية المندوب، رخصة القيادة، الشهادة الصحية، بطاقة السائق، تصريح أجير، سلفة مندوب، مركبة، رخصة النقل، بطاقة التشغيل، رخصة السير، وثيقة التأمين، تأمين المركبة، بطاقة الوقود، تغيير الزيت، عقد، الأداء اليومي.
- لا يوجد تصدير في هذه الشاشة.
11.3 قوالب البريد
| الإجراء | الصلاحية اللازمة |
|---|---|
| تبويب القوالب | عرض ضمن قوالب البريد |
| إنشاء قالب | إضافة ضمن قوالب البريد |
| تعديل قالب، وإرسال تجريبي | تعديل ضمن قوالب البريد |
| تفعيل قالب أو إيقافه | تفعيل أو تعطيل ضمن قوالب البريد |
| حذف قالب | حذف ضمن قوالب البريد |
| تبويب إعدادات 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} | اسم المنشأة بالعربية وبالإنجليزية. |
لوحة المتغيرات تقارن بين ما أعلن القالب قبوله وما يحتويه النص فعلاً، وتصنفها ثلاث فئات:
| الفئة | المعنى |
|---|---|
| مُعلَن ومستخدم | سليم. |
| مُعلَن ولا يظهر في النص | معلن لكنه غير موجود في الموضوع ولا النص. أدرجه أو تجاهله. |
| مستخدم وغير مُعلَن | موجود في النص لكنه غير معلن. غالباً خطأ إملائي، وسيصل إلى المستلم فارغاً. |
تعديل قالب
- اختر القالب من القائمة.
- عدّل الاسم أو الموضوع أو نص الرسالة (HTML).
- لإدراج متغير ضع المؤشر في المكان المطلوب ثم اضغط المتغير في لوحة المتغيرات.
- اضغط حفظ. تظهر الرسالة تم حفظ القالب.
- للتراجع قبل الحفظ اضغط تراجع عن التغييرات.
معاينة قالب
- في بيانات المعاينة املأ قيمة لكل متغير. زر تفريغ القيم يمسحها.
- اضغط تحديث المعاينة.
- يظهر الموضوع كما سيصل ثم الرسالة داخل إطار.
- المعاينة تعرض النسخة المحفوظة. احفظ تعديلاتك أولاً لتراها.
إرسال تجريبي
- في إرسال تجريبي أدخل عنوان بريد في حقل إلى.
- اضغط إرسال تجريبي. تُرسل الرسالة ببيانات المعاينة وتُسجَّل في سجل البريد.
إنشاء قالب جديد
- اضغط قالب جديد.
- أدخل مفتاح القالب والاسم والموضوع ونص الرسالة (HTML).
- اضغط إنشاء القالب.
إيقاف قالب أو تفعيله
- اضغط إيقاف. القالب الموقوف لا يرسله النظام.
- لإعادته اضغط تفعيل.
حذف قالب
- اضغط حذف القالب وأكّد. الزر يظهر للقوالب المخصصة فقط.
| الحقل | إلزامي | الوصف والقيم المسموحة |
|---|---|---|
| مفتاح القالب | نعم عند الإنشاء | حروف إنجليزية صغيرة وأرقام وشرطة سفلية ونقطة فقط، يبدأ بحرف، من 3 إلى 80 خانة. لا يتكرر. |
| الاسم | نعم | اسم داخلي يميّز القالب في هذه الشاشة. لا يصل إلى المستلم. |
| الموضوع | نعم | عنوان الرسالة. يقبل المتغيرات نفسها. |
| نص الرسالة (HTML) | نعم | محتوى الرسالة. الترويسة والتذييل يضيفهما النظام تلقائياً. |
قواعد القوالب
- الإرسال التجريبي يُرفض برسالة واضحة في أربع حالات: لم تُضبط إعدادات SMTP، أو إرسال البريد موقوف على مستوى النظام، أو القالب موقوف، أو رفض خادم البريد الرسالة.
- قالب النظام يمكن تعديل نصه وإيقافه، لكن لا يمكن حذفه.
- لا يُقبل ترك الاسم أو الموضوع أو النص فارغاً.
- المتغير المكتوب خطأً يصل إلى المستلم فارغاً. راجع لوحة المتغيرات قبل الحفظ.
11.3.2 تبويب إعدادات SMTP
يحتوي لوحتين مستقلتين بالحقول نفسها:
- خادم بريد النظام: الحساب الذي يرسل منه النظام إشعاراته وتنبيهاته ورموز البوابة.
- بريد مراسلة المناديب وعليه الشارة للمناديب فقط: حساب مستقل تُرسل منه فقط رسائل تنشيط الحسابات وحل المشكلات إلى شركات التوصيل من صفحة المندوب. إن لم يُضبط تفشل هذه الرسائل، ولا يُستخدم بريد النظام بدلاً منه.
ضبط خادم البريد
- في مزوّد البريد اختر مزودك: Gmail / Google، Zoho (السعودية)، Zoho (عالمي)، Microsoft 365 / Outlook. تُملأ حقول الخادم والمنفذ والتشفير تلقائياً. أو أدخل بيانات أي خادم آخر يدوياً.
- أدخل اسم المستخدم، وهو بريدك كاملاً عند هؤلاء المزودين.
- أدخل كلمة المرور. عند Gmail و Zoho مع التحقق بخطوتين استخدم كلمة مرور التطبيق، لا كلمة مرور الحساب.
- أدخل اسم المُرسِل وبريد المُرسِل.
- فعّل الإرسال عبر هذا الخادم.
- اضغط حفظ الإعدادات.
اختبار الاتصال
- احفظ الإعدادات أولاً.
- اكتب في البريد الذي تُرسل إليه رسالة الاختبار بريداً تستطيع فتحه.
- اضغط اختبار الاتصال.
- عند النجاح تصل رسالة الاختبار. تحقق من صندوق الوارد ومجلد الرسائل غير المرغوب فيها.
| الحقل | إلزامي | الوصف والقيم المسموحة |
|---|---|---|
| الخادم | نعم | عنوان خادم البريد، مثل 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.
- عرض المعاينة: سطح المكتب أو الجوال.
حفظ الهوية
- عدّل ما تريد وراقب المعاينة.
- اضغط زر الحفظ. تظهر الرسالة أن الهوية حُفظت وأن الرسائل الجديدة تستخدمها فوراً.
قائمة الرسائل المرسلة
تعرض كل أنواع الرسائل مجمّعة في خمس مجموعات: الوثائق، السلف، الأمان، بوابة المناديب، النظام. في رأس القائمة العدّاد {on} من {total} مفعّلة.
لكل نوع: اسمه ووصفه، اللغات المتاحة له، آخر إرسال، عدد المرسل والفاشل خلال آخر 30 يوماً، مفتاح تشغيل وإيقاف، ورابط تعديل القالب.
إيقاف نوع من الرسائل
- أطفئ المفتاح بجانب النوع. تظهر الرسالة أن النوع أُوقف ولن يُرسل.
- الإيقاف يشمل نسخ القالب بكل اللغات معاً.
قواعد الهوية والمحتوى
- الرسائل الإلزامية تحمل قفلاً وعبارة أنها تُرسل دائماً، ولا يمكن إيقافها. وهي رسالة توثيق بريد بوابة المندوب، ورسالة استعادة كلمة مرور البوابة، ورسالة اختبار البريد.
- إزالة الشعار المخصص تعيد استخدام شعار المنشأة.
- من يحمل العرض فقط يرى الإعدادات دون تعديلها.
11.4 سجل البريد
الغرض
كل رسالة حاول النظام إرسالها، وما آلت إليه. يُستخدم للتأكد من وصول تنبيه، أو لمعرفة سبب فشل رسالة وإعادة إرسالها.
ما تراه في الشاشة
- مربع بحث: ابحث بالمستلم أو الموضوع….
- عوامل التصفية: الحالة، القالب، من تاريخ، إلى تاريخ. عامل القالب يظهر فقط لمن يحمل عرض القوالب.
- أعمدة الجدول: التاريخ، الحالة، القالب، المستلم (العنوان وتحته الاسم)، الموضوع، المحاولات.
- الضغط على صف يفتح لوحة تفاصيل الرسالة.
الإجراءات
عرض تفاصيل رسالة
- اضغط الصف. تظهر اللوحة الجانبية وفيها: الحالة، القالب، المستلم، نسخة إلى، الموضوع، السجل المرتبط، وقت الإنشاء، وقت الإرسال، آخر محاولة، عدد المحاولات، معرّف الرسالة لدى المزوّد.
- للرسالة الفاشلة يظهر أيضاً رمز الخطأ ونص الخطأ.
إعادة إرسال رسالة فاشلة
- افتح تفاصيل رسالة حالتها فشلت.
- اضغط إعادة المحاولة.
- تظهر رسالة أن المحاولة أُعيدت. حدّث القائمة لرؤية النتيجة. يزيد عدّاد المحاولات بواحد.
الحالات ومعانيها
| الحالة | المعنى |
|---|---|
| في الانتظار | الرسالة مسجلة ولم تُرسل بعد. |
| أُرسلت | قبلها خادم البريد. |
| فشلت | لم تُرسل. السبب في نص الخطأ. |
الاستيراد والتصدير
- زر تصدير CSV يصدّر السجل بعد تطبيق البحث والتصفية الحاليين.
قواعد وتنبيهات
- زر إعادة المحاولة يظهر للرسائل الفاشلة فقط.
- إذا كان القالب موقوفاً تُرفض إعادة المحاولة حتى تفعّله.
- رسائل مراسلة المناديب لا تُعاد من هذا السجل.
- يُحذف السجل تلقائياً بعد 180 يوماً في الإعداد الافتراضي.
11.5 سجل النشاط
الغرض
عنوان الشاشة سجل التدقيق. يسجل كل إجراء كتابي على النظام: من نفّذه، وعلى أي سجل، وما الذي تغيّر قبله وبعده. يُستخدم للإجابة عن سؤال: من غيّر هذا ومتى؟
ما تراه في الشاشة
- عوامل التصفية: الإجراء، نوع السجل، الخطورة، الحالة، نوع المنفِّذ، من تاريخ، إلى تاريخ.
- أعمدة الجدول: الوقت، الإجراء، المنفِّذ، السجل، الحالة، الخطورة، العنوان.
- أسماء الإجراءات وأنواع السجلات تظهر بالإنجليزية كما سجّلها النظام.
- الضغط على صف يفتح تفاصيل الحدث.
الإجراءات
عرض تفاصيل حدث
- اضغط الصف. تظهر لوحة تفاصيل الحدث وفيها الوقت والإجراء والمنفذ والسجل والعنوان والمسار ومعرّف الطلب والمتصفح.
- في قسم ما الذي تغيّر تظهر القيم قبل وبعد لكل حقل، مع العلامات مُضاف ومحذوف ومُعدَّل.
- اضغط إظهار القيم غير المتغيّرة ({n}) لرؤية بقية الحقول.
الحالات ومعانيها
درجات الخطورة:
| الخطورة | المعنى |
|---|---|
| معلومة | إجراء عادي، مثل تعديل بيانات. |
| تحذير | إجراء حساس، مثل تعطيل حساب أو حظر عنوان أو تغيير صلاحيات أو رفض وصول. |
| خطأ | إجراء انتهى بخطأ. |
| حرج | إجراء لا رجعة فيه، مثل حذف حساب أو حذف دور. |
حالة الحدث: ناجح، فاشل، خطأ، قيد الانتظار، مرفوض.
نوع المنفذ: مستخدم، النظام، واجهة برمجية، زائر، مهمة مجدولة.
الاستيراد والتصدير
- زر تصدير CSV يصدّر السجل بعد تطبيق عوامل التصفية.
قواعد وتنبيهات
- السجل للقراءة فقط. لا يمكن تعديل حدث ولا حذفه من الشاشة.
- كل محاولة وصول مرفوضة لنقص الصلاحية تُسجَّل هنا بدرجة تحذير.
- كلمات المرور والقيم السرية لا تُكتب في السجل أبداً.
- يُحذف الأقدم تلقائياً بعد 365 يوماً في الإعداد الافتراضي، ولا تنزل المدة عن 90 يوماً.
11.6 محاولات الدخول
الغرض
كل محاولة دخول ناجحة أو فاشلة، مع العنوان والجهاز وسبب الفشل. يُستخدم لاكتشاف محاولات الاختراق ولمعرفة سبب تعذر دخول موظف.
ما تراه في الشاشة
- شريط إحصاء عن آخر 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 أخطاء النظام
الغرض
الأخطاء التي سجّلها الخادم، مع الوحدة والمسار وأثر التنفيذ الكامل. هذه الشاشة موجهة للدعم الفني. دور الموظف فيها أن ينقل تفاصيل الخطأ إلى من يصلحه.
ما تراه في الشاشة
- عوامل التصفية: المستوى، الطريقة، من تاريخ، إلى تاريخ.
- أعمدة الجدول: الوقت، المستوى، رمز الخطأ، الوحدة، الرسالة، المسار، المستخدم.
- المستويات: معلومة، تحذير، خطأ، حرج.
- إذا لم توجد أخطاء تظهر العبارة أن لا أخطاء مطابقة وأن هذا خبر جيد.
الإجراءات
عرض تفاصيل خطأ
- اضغط الصف. تظهر لوحة تفاصيل الخطأ وفيها كل الحقول ومعها أثر التنفيذ.
- استخدم زر نسخ لنسخ التفاصيل وإرسالها إلى الدعم الفني.
حذف سجل خطأ
- في لوحة التفاصيل اضغط حذف السجل.
- في السؤال حذف هذا السجل نهائياً؟ اضغط نعم، احذف، أو تراجع للإلغاء.
الاستيراد والتصدير
- زر تصدير CSV يصدّر السجل بعد تطبيق عوامل التصفية.
قواعد وتنبيهات
- زر الحذف لا يظهر لمن لا يحمل صلاحية الحذف.
- حذف السجل لا يصلح الخطأ. احذف بعد أن يُعالج سببه.
- يُحذف الأقدم تلقائياً بعد 90 يوماً في الإعداد الافتراضي.
11.8 الوظائف المجدولة
الغرض
عنوان الشاشة المهام المجدولة. تعرض المهام التي يشغّلها النظام من تلقاء نفسه، وتوقيتها، ونتيجة آخر تشغيل لكل منها، وتتيح تشغيل أي مهمة فوراً.
ما تراه في الشاشة
بطاقات المهام
لكل مهمة بطاقة فيها:
- اسم المهمة بالإنجليزية، وتحته وصفها بالعربية.
- شارات الحالة: مفعّلة أو معطّلة، مجدولة أو غير مجدولة، وقيد التشغيل أثناء العمل.
- التعبير الزمني: موعد التشغيل بصيغة cron.
- مصدر التوقيت: اسم المفتاح في إعدادات النظام الذي قُرئ منه الموعد.
- التشغيل القادم وآخر تشغيل مع نتيجته.
- عدّادات آخر تشغيل: سجلات، إشعارات، رسائل، المدة.
- زر تشغيل الآن.
المهام المسجلة
| اسم المهمة | الوصف كما يظهر | الموعد الافتراضي | مفتاح الموعد في إعدادات النظام |
|---|---|---|---|
document_expiry | توليد إشعارات انتهاء الوثائق وأقساط السلف وإرسال بريدها | يومياً 06:00 | notifications.generator_cron |
branding_checks | فحص صور التحقق من التسجيل: الوضوح والوجه والكرت | كل 5 دقائق | branding.checks_cron |
branding_learn | تعلُّم نموذج الكرت من مراجعات المشغّلين. يعتمد النموذج الجديد فقط إن تفوّق على القائم | يومياً 04:00 | branding.learn_cron |
branding_sync | مزامنة صور التحقق من التسجيل من تقرير HungerStation للأيام السابقة التي لم تُزامَن بعد | يومياً 10:00 | sync.branding_cron |
data_sync | مزامنة تقارير HungerStation، الأداء اليومي والتقييم الشهري، للأيام السابقة التي لم تُزامَن بعد | يومياً 15:00 | sync.cron |
auto_backup | نسخة احتياطية تلقائية مع حذف الأقدم من العدد المحتفظ به | يومياً 03:00 | backup.cron |
log_cleanup | حذف السجلات الأقدم من مدة الاحتفاظ: التدقيق والأخطاء والدخول والبريد والجلسات المنتهية | يومياً 03:30 | logs.cleanup_cron |
سجل التشغيل
- مربع بحث: ابحث باسم المهمة أو نص الخطأ….
- عوامل التصفية: المهمة، النتيجة، من تاريخ، إلى تاريخ.
- أعمدة الجدول: بدأت، المهمة، النتيجة، المدة، سجلات، إشعارات، رسائل، الخطأ.
الإجراءات
تشغيل مهمة فوراً
- في بطاقة المهمة اضغط تشغيل الآن. يتغير الزر إلى جارٍ التشغيل….
- انتظر حتى تنتهي. تظهر رسالة بنجاح المهمة أو بانتهائها بخطأ.
- راجع التفاصيل في سجل التشغيل بالأسفل.
عرض تفاصيل تشغيل
- اضغط صفاً في سجل التشغيل.
- تظهر لوحة تفاصيل التشغيل وفيها: المهمة، النتيجة، وقت البدء والانتهاء، العدّادات، نص الخطأ إن وُجد، وما سجّلته المهمة.
تغيير موعد مهمة
- انسخ اسم المفتاح الظاهر في مصدر التوقيت.
- افتح الإعدادات، تبويب إعدادات النظام، وابحث عن المفتاح.
- عدّل قيمته بصيغة cron واحفظ.
- موعد النسخ الاحتياطي يُعدَّل من شاشة النسخ الاحتياطي مباشرة ويسري فور الحفظ.
الحالات ومعانيها
| الحالة | المعنى |
|---|---|
| مفعّلة / معطّلة | هل المهمة مسموح لها بالعمل. |
| مجدولة / غير مجدولة | هل لها موعد قادم صالح. غير مجدولة تعني أن صيغة الموعد غير صالحة أو أن المجدول لم يبدأ. |
| قيد التشغيل | المهمة تعمل الآن. |
نتيجة التشغيل: قيد التشغيل، اكتملت، فشلت.
الاستيراد والتصدير
- زر تصدير CSV يصدّر سجل التشغيل بعد تطبيق عوامل التصفية.
قواعد وتنبيهات
- لا يوجد في الشاشة زر لتفعيل مهمة أو تعطيلها. الشارة مفعّلة للعرض فقط. إيقاف النسخ التلقائي يتم من شاشة النسخ الاحتياطي، وإيقاف المزامنة من شاشة المزامنة.
- المهام تعمل على توقيت المنشأة المحدد في بيانات المنشأة، لا على توقيت الخادم.
- لا تعمل نسختان من المهمة نفسها معاً. إذا ضغطت تشغيل الآن والمهمة تعمل، تظهر رسالة أنها قيد التشغيل بالفعل ولا يبدأ تشغيل ثانٍ.
- التشغيل الذي يبقى قيد التشغيل أكثر من 60 دقيقة يُعتبر ميتاً ويُغلق بنتيجة فشلت.
- بعد كل تشغيل، ناجحاً كان أو فاشلاً، يصل إلى المدراء إشعار بملخص المهمة مع بريد.
- المهمة المعطلة من إعداداتها، مثل النسخ التلقائي المتوقف، تستيقظ في موعدها ثم تنتهي فوراً دون عمل.
- كل تشغيل يظهر في السجل، سواء جرى بالجدولة أو بالضغط على تشغيل الآن.
11.9 النسخ الاحتياطي
| الإجراء | الصلاحية اللازمة ضمن النسخ الاحتياطي |
|---|---|
| عرض القائمة وسجل الاستعادة ومحتويات الأرشيف | عرض |
| إنشاء نسخة، رفع نسخة من ملف، تسجيل ملف | إضافة |
| التحقق من سلامة الأرشيف | تحقق |
| تنزيل الأرشيف | تنزيل مرفق |
| الاستعادة | استعادة |
| حذف نسخة | حذف |
| تعديل جدولة النسخ التلقائي | الإعدادات |
الغرض
أخذ نسخة من بيانات النظام وحفظها، واسترجاعها عند الحاجة. النسخة الواحدة تضم قاعدة البيانات وكل الملفات المرفوعة معاً: الوثائق والصور والمرفقات.
ما تراه في الشاشة
من الأعلى إلى الأسفل:
- بطاقة النسخ الاحتياطي التلقائي وفيها شارة مفعّل أو متوقف.
- بطاقة إنشاء نسخة جديدة.
- قائمة ملفات في مجلد النسخ بلا سجل، إن وُجدت.
- النسخ المتاحة: بطاقة لكل نسخة.
- سجل عمليات الاستعادة.
بطاقة النسخة تعرض: اسم الملف، الحالة، النوع، عدّادات جدول وصف وملف وحجم الأرشيف، شارة مشفَّرة أو غير مشفَّرة، البصمة، ونتيجة آخر استعادة منها إن وُجدت، ثم الأزرار تحقّق، تنزيل، استعادة، حذف.
الإجراءات
إنشاء نسخة يدوية
- في إنشاء نسخة جديدة اختر نوع النسخة.
- اكتب ملاحظة (اختياري)، مثل سبب أخذ النسخة.
- اضغط إنشاء النسخة. يظهر جارٍ إنشاء النسخة….
- عند الانتهاء تظهر الرسالة تم إنشاء النسخة الاحتياطية وتُضاف النسخة إلى القائمة.
تنزيل نسخة
- في بطاقة النسخة اضغط تنزيل. يُحفظ ملف الأرشيف على جهازك.
- احفظه في مكان آمن خارج الخادم.
التحقق من سلامة نسخة
- اضغط تحقّق.
- تظهر النتيجة: البصمة مطابقة وتعني أن الأرشيف سليم، أو رسالة عدم المطابقة مع السبب.
رفع نسخة من ملف
- اضغط رفع نسخة من ملف.
- اختر ملف أرشيف بامتداد zip سبق تنزيله من هذا النظام.
- انتظر حتى يكتمل الرفع. تظهر النسبة المئوية.
- تظهر النسخة في القائمة وتصبح قابلة للاستعادة.
تسجيل ملف موجود على الخادم
- إذا ظهرت قائمة ملفات في مجلد النسخ بلا سجل فهذه ملفات وُضعت في مجلد النسخ مباشرة.
- اضغط تسجيل بجانب الملف ليظهر في القائمة.
استعادة نسخة
- في بطاقة النسخة اضغط استعادة. تُفتح لوحة استعادة نسخة احتياطية.
- اقرأ التحذير: ستحل محتويات هذه النسخة محل البيانات الحالية بالكامل.
- انتظر حتى تُقرأ محتويات الأرشيف. راجع تاريخ أخذ النسخة ومحتويات الأرشيف.
- في الملفات المرفوعة اترك الخيار كما هو للوضع الافتراضي، أو ضع علامة على حذف الملفات الحالية واستبدالها بملفات الأرشيف.
- في حقل تأكيد الاستعادة اكتب الكلمة RESTORE بالأحرف الإنجليزية الكبيرة. زر التنفيذ معطل قبل ذلك.
- اضغط تنفيذ الاستعادة وانتظر. لا تغلق الصفحة.
- عند النجاح تظهر تمت الاستعادة بنجاح مع عدد الجداول والملفات والمدة، ورقم نسخة الأمان، وحالة جلستك.
حذف نسخة
- اضغط حذف.
- في السؤال الذي يذكر اسم الأرشيف اضغط نعم، احذف.
ضبط النسخ التلقائي
- في بطاقة النسخ الاحتياطي التلقائي فعّل إنشاء نسخة تلقائيًا حسب الجدول أو أوقفه.
- اختر نوع النسخة.
- حدّد الموعد اليومي. أو اكتب صيغة cron (متقدم) لجدولة غير يومية.
- حدّد عدد النسخ التلقائية المحتفظ بها.
- اضغط حفظ الجدولة. تظهر الرسالة حُفظت جدولة النسخ. ويسري الموعد الجديد فوراً.
الحقول
| الحقل | إلزامي | الوصف والقيم المسموحة |
|---|---|---|
| نوع النسخة | نعم | كاملة (قاعدة بيانات + ملفات) أو قاعدة البيانات فقط أو الملفات المرفوعة فقط. |
| ملاحظة | لا | نص حر. يُحفظ أيضاً مع النسخة المرفوعة أو المسجلة. |
| التشغيل | لا | مفتاح تفعيل النسخ التلقائي. |
| الموعد اليومي | لا | وقت بتوقيت الرياض. الافتراضي 03:00. |
| صيغة cron (متقدم) | لا | خمس خانات: دقيقة، ساعة، يوم، شهر، يوم الأسبوع. الصيغة غير الصالحة تُرفض برسالة صيغة cron غير صالحة. |
| عدد النسخ التلقائية المحتفظ بها | لا | رقم صحيح من 1 إلى 365. الافتراضي 14. |
| تأكيد الاستعادة | نعم عند الاستعادة | الكلمة RESTORE حرفياً. |
| حذف الملفات الحالية واستبدالها بملفات الأرشيف | لا | مربع اختيار. غير محدد افتراضياً. |
| تجاوز فحص البصمة | لا | مربع اختيار يظهر فقط عند عدم تطابق البصمة. |
الحالات ومعانيها
| الحالة | المعنى |
|---|---|
| مكتملة | النسخة جاهزة للتنزيل والاستعادة. |
| قيد التنفيذ | النسخة ما زالت تُنشأ. |
| فاشلة | لم تكتمل. لا يمكن استعادتها. |
| شارة التشفير | المعنى |
|---|---|
| مشفَّرة | الأرشيف مشفّر بمفتاح هذا الخادم. تظهر معها بصمة المفتاح. |
| غير مشفَّرة | نسخة أُخذت قبل تفعيل التشفير، وما زالت قابلة للاستعادة. |
قواعد وتنبيهات
عن نوع النسخة
- النسخة الكاملة هي الوحيدة التي تُستعاد بلا نقص. استعادة قاعدة البيانات وحدها تترك كل صورة ووثيقة تشير إلى ملف غير موجود.
عن التشفير
- التشفير تلقائي بمفتاح الخادم. لا توجد كلمة مرور يكتبها المستخدم عند إنشاء النسخة أو استعادتها.
- الملف المنزَّل مشفّر ولا يُفتح إلا بمفتاح هذا الخادم نفسه.
- على مسؤول الخادم الاحتفاظ بمفتاح التشفير في مكان آمن ومنفصل عن النسخ. بدونه لا تُفتح أي نسخة.
- إذا رُفعت نسخة مختومة بمفتاح خادم آخر، تُسجَّل مع تحذير أنها لن تُستعاد إلا بالمفتاح الأصلي.
عن الاستعادة
- قبل أن تبدأ الاستعادة يأخذ النظام تلقائياً نسخة أمان كاملة من الوضع الحالي، فيبقى الرجوع ممكناً. رقمها يظهر بعد النجاح.
- في الوضع الافتراضي للملفات تُكتب ملفات الأرشيف ويبقى أي ملف أحدث كما هو.
- عند اختيار الاستبدال يُحذف أي ملف رُفع بعد تاريخ النسخة ولن يمكن استرجاعه.
- لا تعمل عمليتا استعادة معاً. المحاولة الثانية تُرفض برسالة أن هناك عملية جارية.
- النسخة التي لم تكتمل بنجاح لا تُستعاد.
- إذا تغيّر الأرشيف منذ إنشائه ولم يطابق بصمته، تُرفض الاستعادة. يمكن تجاوز الفحص بمربع نفّذ الاستعادة رغم عدم تطابق البصمة، مع خطر أن تفشل الاستعادة في منتصفها.
- بعد الاستعادة قد يُطلب منك تسجيل الدخول من جديد إن لم تكن جلستك ضمن النسخة المستعادة.
- إذا كان ملف الأرشيف غير موجود على القرص يظهر تحذير، ولا تظهر أزرار التحقق والتنزيل والاستعادة.
- إذا كانت مرفقات مفقودة من القرص وقت أخذ النسخة يظهر تحذير بعددها، ولن تعيدها الاستعادة.
عن النسخ التلقائي
- النسخة التلقائية مشفرة كالنسخ اليدوية.
- بعد كل نسخة تلقائية جديدة يُحذف الأقدم من العدد المحتفظ به. النسخ اليدوية ونسخ الأمان والنسخ المرفوعة لا تُحذف تلقائياً.
- عند التوقف أو عند صيغة موعد غير صالحة تظهر العبارة أن لا تشغيل قادم.
عن الرفع
- يُقبل أرشيف zip فقط، وبحد أقصى 4 غيغابايت.
- الملف الذي لا يحتوي بيان محتويات النسخة يُرفض برسالة أنه ليس نسخة احتياطية من هذا النظام.
- إذا رفض الخادم الوسيط حجم الملف، انسخ الملف إلى مجلد النسخ على الخادم ثم سجّله من القائمة.
سجل عمليات الاستعادة
جدول بأعمدة: التاريخ، الأرشيف، الحالة، بواسطة، تفاصيل. يعرض كل عملية استعادة نُفذت ونتيجتها.
11.10 اللغات
الغرض
عنوان الشاشة اللغات والترجمة. تعرض كل لغات الواجهة، ومدى اكتمال ترجمة كل منها مقارنة بالعربية، وتتيح إضافة لغة جديدة أو تحديث ترجمة، ثم إعادة بناء الواجهة لتصبح التغييرات فعالة.
ما تراه في الشاشة
- في الرأس: شارة البناء بحالته، وأزرار إعادة البناء الآن، رفع ترجمة، إضافة لغة.
- بطاقات الإحصاء: اللغات، مفاتيح الترجمة، متوسط الاكتمال، تعديلات مرفوعة، آخر بناء.
- بطاقة لكل لغة فيها: العلم، الاسم باللغة نفسها وبالإنجليزية، الرمز، شارة الاتجاه من اليمين لليسار أو من اليسار لليمين، شارة المصدر مدمجة أو مُنشأة من اللوحة، شريط اكتمال الترجمة، وعدّادات مترجمة وناقصة وتعديلات.
- العربية تحمل الشارة اللغة المرجعية، فكل اللغات تُقاس عليها.
- من يحمل العرض فقط يرى تنبيهاً بأنه يستطيع الاطلاع والتنزيل دون الرفع والتعديل.
اللغات المدمجة ثلاث: العربية والإنجليزية والبنغالية. أي لغة أخرى تُضاف من هذه الشاشة.
الإجراءات
تنزيل ملف ترجمة
- في بطاقة اللغة اضغط تنزيل.
- اختر الصيغة: Excel (.xlsx) أو CSV (.csv) أو JSON (.json).
- الملف يحتوي كل المفاتيح مع النص العربي والإنجليزي والترجمة الحالية لهذه اللغة.
إضافة لغة جديدة
- اضغط إضافة لغة. يُفتح معالج من أربع خطوات: اللغة، الملف، المعاينة، البناء.
- في خطوة اللغة اختر لغة جديدة. اختر من اقتراحات أو أدخل البيانات يدوياً: رمز اللغة، اتجاه الكتابة، الاسم باللغة نفسها، الاسم بالإنجليزية، والخط والعلم اختياريان. اضغط التالي.
- في خطوة الملف نزّل القالب من تنزيل قالب، املأ عمود الترجمة، ثم اسحب الملف إلى المربع أو اضغط للاختيار. اضغط تحليل الملف.
- في خطوة المعاينة راجع الأرقام والأخطاء، ثم اضغط تطبيق الترجمة.
- في خطوة البناء انتظر. يمكنك إغلاق النافذة وسيستمر البناء.
- عند ظهور الترجمات الجديدة منشورة اضغط إعادة تحميل الصفحة.
تحديث ترجمة لغة موجودة
- اضغط رفع تحديث في بطاقة اللغة، أو رفع ترجمة في الرأس ثم اختر تحديث لغة موجودة وحدد اللغة.
- ارفع الملف وحلله كما في الخطوات السابقة.
- الترجمات المرفوعة تُحفظ تعديلات فوق ملف اللغة دون المساس بالأصل.
تعديل ترجمة عبارة واحدة
- في بطاقة اللغة اضغط عرض المفاتيح.
- ابحث في مربع ابحث في المفتاح أو النص…، أو اختر من عرض: الناقصة فقط أو المعدّلة فقط.
- اضغط تعديل الترجمة بجانب العبارة. أعمدة الجدول: المفتاح، المرجع العربي، الإنجليزية، ثم عمود باسم اللغة.
- اكتب الترجمة واضغط حفظ، أو اضغط Ctrl+Enter. زر Esc يلغي.
- يظهر تنبيه التعديلات لم تُنشر بعد. اضغط إعادة البناء الآن بعد الانتهاء من كل تعديلاتك.
التراجع عن تعديل
- بجانب العبارة التي تحمل الشارة معدّل اضغط التراجع إلى النص الأصلي.
إعادة بناء الواجهة
- اضغط إعادة البناء الآن. تظهر الرسالة بدأت إعادة بناء الواجهة.
- راقب شارة البناء. اضغط عرض السجل لرؤية مخرجات البناء.
- عند الفشل تظهر فشل بناء الواجهة. الملفات محفوظة لكن الواجهة المنشورة لم تتغير. اضغط إعادة محاولة البناء.
حذف لغة
- في بطاقة لغة مصدرها مُنشأة من اللوحة اضغط حذف.
- أكّد بالضغط على نعم، احذف اللغة. تُحفظ نسخة احتياطية من ملفاتها وتبدأ إعادة البناء.
الحقول
| الحقل | إلزامي | الوصف والقيم المسموحة |
|---|---|---|
| رمز اللغة | نعم | حرفان أو ثلاثة صغيرة، مثل fr أو ur، ويمكن إضافة رمز المنطقة مثل pt-BR. |
| اتجاه الكتابة | نعم | من اليمين لليسار أو من اليسار لليمين. |
| الاسم باللغة نفسها | نعم | كما يراه متحدث اللغة في قائمة اختيار اللغة. |
| الاسم بالإنجليزية | نعم | مثل French أو Urdu. |
| الخط | لا | اتركه فارغاً لاستخدام الخط الافتراضي حسب الاتجاه. |
| العلم | لا | رمز تعبيري واحد. |
| ملف الترجمة | نعم | JSON أو Excel أو CSV، حتى 5 ميغابايت. |
الحالات ومعانيها
حالة البناء:
| الحالة | المعنى |
|---|---|
| خامل | لا يوجد بناء جارٍ. |
| في الانتظار | طُلب بناء أثناء بناء آخر، وسيبدأ بعد انتهائه. |
| قيد التنفيذ | البناء يعمل الآن. |
| نجح | اكتمل البناء والترجمات منشورة. |
| فشل | لم يكتمل. الواجهة المنشورة لم تتغير. |
خطوة المعاينة تعرض ثمانية أرقام: قيم في الملف، ترجمات جديدة، ترجمات معدّلة، بدون تغيير، مفاتيح غير معروفة وهذه تُتجاهل، قيم فارغة، أخطاء المتغيرات وهذه تُرفض، وناقصة بعد الاستيراد وهي ما سيبقى بلا ترجمة بعد التطبيق.
قواعد وتنبيهات
- المتغيرات يجب أن تبقى كما هي. إذا احتوى النص العربي على متغير بين قوسين معقوفين مثل
{name}فيجب أن تحتويه الترجمة نفسه. الترجمة المخالفة تُرفض. - تُقبل فقط المفاتيح الموجودة في العربية. أي مفتاح آخر يُتجاهل.
- في اللغة الجديدة، العبارات غير المترجمة تُملأ بالإنجليزية مؤقتاً.
- الترجمة نص فقط بحد أقصى 5000 حرف، ولا تُحفظ فارغة.
- التعديلات لا تظهر للمستخدمين قبل إعادة بناء الواجهة. رفع ملف يبدأ البناء تلقائياً، أما تعديل عبارة واحدة فلا يبدأه.
- لا يعمل بناءان معاً. الطلب الثاني ينتظر.
- صلاحية المعاينة 30 دقيقة. بعدها حلّل الملف مرة أخرى.
- إذا فشل فحص تطابق مفاتيح اللغات تُعاد الملفات إلى حالتها السابقة ولا يُطبَّق أي تغيير.
- لا يمكن حذف اللغات المدمجة: العربية والإنجليزية والبنغالية.
- لا يمكن إضافة لغة برمز موجود. اختر تحديث لغة موجودة.
- إذا لم تكن ملفات الواجهة المصدرية متوفرة على الخادم تظهر رسالة بذلك، ولا يمكن تعديل اللغات.
- اللغة الجديدة تظهر في قائمة اختيار اللغة وفي حقل لغة الواجهة في الملف الشخصي بعد نجاح البناء.
11.11 معالج التثبيت الأول
الغرض
هذا القسم موجه لمن يركّب النظام أول مرة. المعالج عنوانه معالج تثبيت المنصة، ويتكون من ست خطوات يظهر تقدمها في شريط علوي. يمكن تبديل لغة المعالج بين العربية والإنجليزية والبنغالية.
الخطوات
الخطوة 1: قاعدة البيانات
- أدخل بيانات الاتصال بخادم قاعدة البيانات.
- اضغط اختبار الاتصال. زر الحفظ معطل حتى ينجح الاختبار.
- اضغط زر الحفظ والمتابعة.
الحقول: المضيف (Host) واسم المستخدم واسم قاعدة البيانات إلزامية، والمنفذ (Port) وكلمة المرور اختياريان. المنفذ الافتراضي 3306. تُنشأ القاعدة تلقائياً إذا لم تكن موجودة.
الخطوة 2: الجداول والبيانات
- اضغط زر تشغيل إنشاء الجداول والبيانات الأساسية.
- راقب سجل التنفيذ حتى تظهر رسالة اكتمال إنشاء الجداول والبيانات بنجاح.
- اضغط متابعة. الزر معطل حتى ينجح التنفيذ.
في هذه الخطوة تُنشأ الأدوار الخمسة الجاهزة وصلاحياتها، وقوالب البريد، وإعدادات النظام بقيمها الافتراضية.
الخطوة 3: بيانات المنصة
- أدخل اسم المنصة، وهو الحقل الإلزامي الوحيد.
- أكمل بيانات الشركة: الوصف، اسم الشركة، الرقم الضريبي، عنوان الشركة، بريد الدعم، هاتف الدعم، رابط الموقع.
- في الهوية النظامية للمنشأة أدخل اسم المنشأة بالإنجليزية، رقم الهوية / المنشأة، رقم السجل التجاري.
- في الشعار ووثائق المنشأة ارفع ما يتوفر: شعار المنشأة، شعار الوضع الداكن (اختياري)، صورة السجل التجاري، الشهادة الضريبية، رخصة النشاط التجاري (البلدية)، شهادة السلامة، الشهادة الصحية، أيقونة الموقع (Favicon).
- في الإعدادات الإقليمية اختر اللغة الافتراضية، العملة الافتراضية، المنطقة الزمنية، الدولة الافتراضية.
- في المظهر والضرائب اختر اللون الأساسي واللون الثانوي، وأدخل اسم الضريبة ونسبة الضريبة الافتراضية (%)، وحدد تفعيل الضريبة.
- اضغط حفظ ومتابعة.
الملفات صور أو PDF بحد أقصى 10 ميجابايت للملف الواحد. كلها اختيارية، ويمكن رفعها أو استبدالها لاحقاً من الإعدادات ← بيانات المنشأة.
الخطوة 4: حساب المدير
- أدخل الاسم الكامل والبريد الإلكتروني وكلمة المرور وتأكيد كلمة المرور. كلها إلزامية.
- اضغط إنشاء الحساب ومتابعة.
هذا الحساب هو المدير الأول للنظام بصلاحيات كاملة، ودوره Super Admin. اسم الدخول يُشتق تلقائياً من الجزء الذي يسبق علامة @ في البريد، ويمكن الدخول بالبريد نفسه أيضاً.
الخطوة 5: البريد الإلكتروني
- أدخل إعدادات خادم البريد: خادم SMTP، المنفذ، التشفير، اسم المستخدم، كلمة المرور، اسم المرسل، بريد المرسل.
- اضغط زر الحفظ، أو اضغط تخطي لتأجيل الإعداد.
هذه الخطوة اختيارية. يمكن ضبط البريد لاحقاً من شاشة قوالب البريد، تبويب إعدادات SMTP.
الخطوة 6: اكتمال
- تظهر الرسالة تم تثبيت المنصة بنجاح! مع رابط لوحة التحكم وبريد المدير واسم قاعدة البيانات.
- اضغط الذهاب إلى لوحة التحكم.
- سجّل الدخول بحساب المدير الذي أنشأته.
قواعد وتنبيهات
- كلمة مرور المدير في المعالج 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 غير مفعّل في إعدادات النظام، وأن نوع الرسالة غير موقوف في قائمة الرسائل المرسلة.
نزّلت نسخة احتياطية ولم أستطع فتح الملف على جهازي، هل هي تالفة؟
لا. الأرشيف مشفّر بمفتاح الخادم ولا يُفتح خارجه. للتأكد من سلامته اضغط تحقّق في بطاقة النسخة. لاستعماله ارفعه إلى النظام نفسه، أو إلى خادم يحمل مفتاح التشفير نفسه، ثم استعده.
عدّلت ترجمة عبارة ولم تتغير في الواجهة، لماذا؟
تعديل عبارة واحدة يُحفظ لكنه لا يُنشر حتى تُعاد بناء الواجهة. اضغط إعادة البناء الآن في شاشة اللغات، وانتظر حتى تصبح الحالة نجح، ثم اضغط إعادة تحميل الصفحة.
هل أستطيع إيقاف مهمة مجدولة من شاشة الوظائف المجدولة؟
لا يوجد زر لذلك في الشاشة. النسخ التلقائي يُوقف من بطاقة النسخ الاحتياطي التلقائي، والمزامنة تُوقف من شاشة المزامنة، وبريد التنبيهات يُوقف نوعاً نوعاً من قائمة الرسائل المرسلة. أما موعد أي مهمة فيُغيَّر من مفتاحها في إعدادات النظام.
