لمسؤولي النظام

دليل مسؤول النظام

وحدة نظام والإعدادات التي لا ينبغي أن يغيّرها إلا مسؤولو النظام. لترتيب التثبيت الجديد اتبع الإعداد لأول مرة أولًا.

يستخدمها: مسؤول النظام
القائمة: نظام

صفحات نظام بالإنجليزية

كثير من صفحات نظام الجديدة في الإصدار 7.5 تظهر بالإنجليزية حتى مع اختيار العربية: Notifications، وNotification Settings، وNotification Templates، وNotification Rules، وScheduled Reports، وBackground Jobs، وTheme Settings، وAPI Integration، وAbout. نذكر أسماءها الإنجليزية كما تظهر.

المستخدمون والأدوار والصلاحيات

الأدوار

الفتح: نظام › دور › أضف. الدور مجموعة صلاحيات. أعطِ كل دور اسم الدور وحدّد، في التبويبات الموظف وجهاز والحضور وكشف الرواتب ونظام، الصفحات والإجراءات المسموحة في كل صفحة (مثل الإضافة والاستيراد والسجل والتصدير والتعديل والحذف).

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

لا يرى المستخدم إلا عناصر القائمة التي يسمح بها دوره، ولا أزرار شريط الأدوات إلا للإجراءات المسموحة.
فتح الصفحة بعنوانها لا يتجاوز ذلك: الصفحة التي لا يسمح بها الدور تفتح لوحة التحكم بدلًا منها.
المستخدم الأعلى (Super user) له كل الصلاحيات ولا يحتاج إلى دور.

المستخدمون

الفتح: نظام › مستخدم › أضف

نموذج أضف مستخدم، الجزء العلوي — **أضف مستخدم.** إذا لم يكن المستخدم نشطًا فلا يمكنه تسجيل الدخول.

الحقل	المعنى
اسم المستخدم *	حتى 30 حرفًا: حروف وأرقام و`@ . + - _`.
كلمة المرور ، تأكيد كلمة المرور	8 أحرف على الأقل تجمع الحروف والأرقام. التلميح في الصفحة ما زال يذكر القاعدة القديمة (من 4 إلى 18 خانة) وكلمة مرور افتراضية؛ وفي الواجهة العربية يذكر `123456` بينما تذكر الإنجليزية `12345`. القاعدة التي يفرضها LanaTime فعلًا هي 8 أحرف. يظهر زر إعادة تعيين كلمة المرور عند تعديل مستخدم.
تفويض القسم	الأقسام التي يمكن لهذا المستخدم رؤيتها وإدارتها (مع الأقسام الفرعية أو بدونها). عدم اختيار شيء = كل الأقسام.
تفويض المنطقة	المناطق (وأجهزتها) التي يمكن لهذا المستخدم إدارتها. عدم اختيار شيء = كل المناطق.
الاسم الأول، اسم العائلة، عنوان البريد الإلكتروني	تظهر في قائمة المستخدم؛ ويُستخدم البريد للتنبيهات الموجهة إلى هذا المستخدم.
حالة الموظفين	(Staff Status) هل يستطيع المستخدم تسجيل الدخول إلى موقع الإدارة هذا.
حالة جيدة	(Super Status؛ الترجمة العربية خاطئة ومعناها «مستخدم أعلى») تعطي المستخدم كل الصلاحيات بغض النظر عن الدور.
دور	الدور الذي تُطبَّق صلاحياته.

قلّل عدد المستخدمين الأعلى

أعطِ المستخدمين العاديين دورًا فيه ما يحتاجونه فقط. كل تسجيل دخول وكل إيقاف وكل إدخال مرفوض يُسجَّل في سجل التدقيق الأمني، وكل تغيير في سجل النظام.

كلمات المرور وحماية تسجيل الدخول

كلمات المرور الجديدة تحتاج إلى 8 أحرف على الأقل تجمع الحروف والأرقام. كلمات المرور الضعيفة الموجودة (مثل 123456) يجب تغييرها عند الدخول التالي من الويب.
5 محاولات فاشلة خلال 15 دقيقة توقف ذلك الاسم لفترة.
يعيد الموظفون تعيين كلمة مرورهم برابط يُرسل إلى البريد المسجل في سجلهم؛ يعمل الرابط مرة واحدة وتنتهي صلاحيته بعد 30 دقيقة.
تُخزَّن كلمات المرور بتجزئة أحادية الاتجاه؛ لا يستطيع أحد قراءتها. لمساعدة مستخدم نسي كلمة مروره، عيّن له كلمة جديدة.

إعدادات الشركة والإعدادات الرئيسية

مشروحة خطوة بخطوة في الإعداد لأول مرة: إعداد الشركة والإعدادات الرئيسية.

التنبيهات (البريد الإلكتروني، الرسائل القصيرة، واتساب)

يرسل LanaTime 7.5 التنبيهات عبر خدمة تنبيهات مركزية لها أربع صفحات (بالإنجليزية):

الصفحة	استخدمها لـ
Notification Settings	تشغيل التنبيهات، وضبط اسم الشركة وعنوان LanaTime والمنطقة الزمنية وصيغة التاريخ والوقت ورمز الدولة الافتراضي وعدد إعادة المحاولات ومدة الاحتفاظ بالسجل؛ وإعداد قنوات البريد الإلكتروني والرسائل القصيرة وواتساب واختبارها؛ وتشغيل الوحدات أو إيقافها.
Notification Templates	نص كل رسالة، لكل حدث وقناة.
Notification Rules	من يستلم ماذا ومتى وكيف: لكل حدث القنوات والمستلمون والشروط والتأخير. تبويب Recipient groups يدير مجموعات المستلمين.
Background Jobs	الطابور: كل رسالة ومهمة مجدولة مع حالتها (Scheduled, Queued, Processing, Completed, Failed, Retrying, Cancelled) وعدد المحاولات والخطأ.

صفحة Notification Settings، تبويب General، مع إشعار بأن التنبيهات متوقفة — **Notification Settings.** يقول الشريط إن التنبيهات متوقفة: الأحداث تُسجَّل لكن لا يُرسل شيء حتى تحديد *Send notifications*.

إعداد التنبيهات

نظام › Notification Settings › General: أدخل اسم الشركة (Company name)، وعنوان LanaTime (LanaTime address: عنوان الويب الذي يستخدمه الناس، ويلزم للروابط في الرسائل والتقارير)، والمنطقة الزمنية (Time zone) والصيغ. احفظ.
تبويب E-mail: أدخل إعدادات خادم البريد، واختر اختبار الاتصال وأرسل رسالة تجريبية. افعل الشيء نفسه في تبويبي SMS وWhatsApp إن كنت تستخدمهما (يعطيك مزود الرسائل القصيرة أو واتساب القيم).
نظام › Notification Rules: افتح كل قاعدة تريدها (مثل «طلب إجازة إلى المعتمِد»، و«القرار إلى الموظف»، و«جهاز غير متصل إلى مسؤولي النظام»)، وتحقق من قنواتها ومستلميها، وفعّلها.
عُد إلى General وحدّد Send notifications ثم احفظ.من الآن تُرسل الأحداث رسائل. تابعها في Background Jobs.

قائمة Notification Rules مع القواعد والأحداث والقنوات والمستلمين — **Notification Rules.** يحتوي التثبيت الجديد على 21 قاعدة.

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

أبقِ المعالج يعمل

تُرسل الرسائل بواسطة معالج يعمل في الخلفية داخل LanaTime (Background processing in this web application). إذا بقيت الرسائل بحالة Queued فاستخدم Restart worker في Notification Settings واطلب من تقنية المعلومات إبقاء مجمع تطبيقات LanaTime يعمل دائمًا.

إعدادات التنبيه والرسائل القصيرة من الإصدار 7.1

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

البيانات السرية

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

التقارير المجدولة

الفتح: نظام › Scheduled Reports › New schedule.

صفحة Scheduled Reports مع الشرح — **Scheduled Reports.** تشرح الصفحة طريقة تسليم الملفات.

اختر تقريرًا من تقارير الإحصائيات، والفترة (مثل الأمس أو الأسبوع الماضي أو الشهر السابق)، والموظفين (الكل، أو أقسام مع أقسامها الفرعية، أو أشخاص مختارين)، وصيغة PDF أو Excel، والبريد أو واتساب، والمستلمين، وموعد الإرسال (يوميًا أو أسبوعيًا أو شهريًا أو مرة واحدة).
يُرفق الملف بالبريد إذا كان صغيرًا بما يكفي؛ وإلا، وفي واتساب، تحتوي الرسالة على رابط تنزيل يتطلب تسجيل الدخول.
التقارير التي تحسب بياناتها داخل الصفحة (أول دخول/آخر خروج، والسنوية وما شابهها) لا يمكن جدولتها.
تبويب History يعرض كل تشغيل. اضبط عنوان LanaTime في Notification Settings أولًا، وإلا تعذّر إنشاء الروابط.

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

الفتح: نظام › دعم (هذا اسم صفحة النسخ الاحتياطي في الواجهة العربية، وهو ترجمة خاطئة لكلمة Backup). يظهر اسم قاعدة البيانات؛ ويُقترح اسم ملف النسخ الاحتياطي من التاريخ والوقت (حروف وأرقام و_ و- فقط). زر انشئ نسخة احتياطية يكتب النسخة على الخادم (المجلد BackupDB في موقع LanaTime)؛ وزر تنزيل النسخ الاحتياطي ينزّلها.

النسخة على الخادم نفسه لا تكفي

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

الترخيص و«خدمة» وAbout

نظام › About: تفاصيل الترخيص لكل خيار: الحالة، وحالة التفعيل، وتاريخ الانتهاء، والعدد، والمستخدم، والمتبقي (مثل عدد الأجهزة أو الموظفين الذين يمكنك إضافتهم).
نظام › خدمة (Utility): تفعيل خيارات الترخيص (أدخل رمز التجزئة الذي يعطيك إياه المورّد).
بعض الميزات تحتاج إلى خيار ترخيص خاص، مثل الوصول عبر API.

تكامل API

الفتح: نظام › API Integration. يتيح لنظام آخر (مثل نظام تخطيط الموارد أو برنامج رواتب) قراءة بيانات الحضور بمفتاح.

قائمة API Integration مع Add API وAdd API (Non-Calculated) — **API Integration.** لا توجد مفاتيح API في التثبيت التجريبي.

Add API ينشئ مفتاحًا يعيد نتائج الحضور المحسوبة (النتائج نفسها التي في التقارير؛ احسب أولًا).
Add API (Non-Calculated) ينشئ مفتاحًا يعيد البصمات الخام.
لكل مفتاح اختر اسمًا (API Name)، والأعمدة التي يمكنه إعادتها (Selected Columns)، ووصفًا، وهل هو نشط (Active). تعرض القائمة المفتاح؛ اختره لرؤية المفتاح كاملًا ونسخه.

يستدعي النظام الآخر العنوان التالي (استبدل الأجزاء المكتوبة بأحرف كبيرة):

GET https://YOUR-LANATIME-ADDRESS/api/CustomApi/GetData?apiKey=YOUR-API-KEY&startDate=2026-10-01&endDate=2026-10-31

تعامل مع مفاتيح API ككلمات المرور

من يملك المفتاح يستطيع قراءة الأعمدة التي يسمح بها. أعطِ كل نظام مفتاحه الخاص، واستخدم HTTPS، وأوقف المفتاح (Active) عندما لا يعود مطلوبًا. لا تعيد الواجهة شيئًا إذا انتهت صلاحية خيار ترخيص API.

السجلات والتدقيق

المكان	المحتوى
نظام › سجل	التغييرات التي أجراها المستخدمون في LanaTime: المستخدم، والدور، والإجراء (إضافة، تعديل، حذف، تصدير، تسجيل دخول، أخرى)، والوقت، ونوع الكائن، والوصف. صفِّ وصدّر.
زر سجل في كل صفحة	السجل نفسه لصفحة واحدة.
صفحة التنبيهات (نظام › Notification)	تنبيهات النظام الأخيرة.
سجل التطبيق (على الخادم)	الأخطاء والتحذيرات وبدء LanaTime وإيقافه في ملفات يومية `App_Data\Logs\lanatime-yyyyMMdd.log` على الخادم، يُحتفظ بها 30 يومًا. لكل إدخال الوقت والمستخدم والصفحة ومعرّف الطلب. تقرأ تقنية المعلومات هذه الملفات عندما تبلّغ عن مشكلة.
التدقيق الأمني (قاعدة البيانات)	عمليات تسجيل الدخول، والإيقاف، والإدخال المرفوض، وتغيير كلمات المرور، مع معرّف الطلب نفسه.

تنظيف البيانات

نظام › تنظيف البيانات يحذف البيانات القديمة: اختر تنظيف البيانات قبل (تاريخ) والعناصر المراد تنظيفها؛ وتعرض نتائج التنظيف ما حُذف.

لا يمكن التراجع

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

المظهر

يختار كل مستخدم مظهره في Theme Settings (Alt + T): الوضع الفاتح أو الداكن، ولون التمييز، والكثافة، والخلفية. أما نظام › Theme Settings فهي الصفحة الأقدم ذات أنظمة الألوان الثابتة.

إعدادات محرك الحساب (على الخادم)

تضبطها تقنية المعلومات في ملف إعداد LanaTime (Web.config، قسم appSettings) وتنطبق على تقرير الحضور وتقرير الإحصائيات وتقرير كشف الرواتب كلٍّ على حدة.

الإعداد	القيم	الأثر
`LtAttStatsEngine`، `LtStatsReportsEngine`، `LtPayrollEngine`	`legacy` (الافتراضي) / `optimized`	optimized يحسب النتائج نفسها باستعلامات أقل بكثير على قاعدة البيانات.
`LtAttStatsCorrections`، `LtStatsReportsCorrections`، `LtPayrollCorrections`	`true` (الافتراضي) / `false`	مع المحرك المحسّن: يصحح عطلة السبت رقم N، ومطابقة العطلات، وأنصاف الأيام في الجداول المؤقتة، وقيمة كانت تنتقل بين الأيام. قد تتغير نتائج الفترات السابقة المعاد حسابها؛ اتفق مع الموارد البشرية والرواتب أولًا.

إعدادات خادم أخرى في الملف نفسه: طول كلمة المرور (LtPasswordMinLength)، وفرض تغيير كلمات المرور الضعيفة (LtForceWeakPasswordChange)، وإيقاف تسجيل الدخول (LtLoginMaxFailures، LtLoginWindowMinutes)، ومدة صلاحية رابط إعادة التعيين (LtPasswordResetMinutes)، وسجل التطبيق (LtLogDirectory، LtLogLevel، LtLogRetentionDays، LtLogMaxFileMB).

ذو صلة: الإعداد لأول مرة · حل المشكلات · قائمة الشاشات