سجل النشاط: ما يُسجَّل ومن يراه

الغرض#

يشرح هذا الدليل شاشة سجلات نشطة (Active Logs): ما التغييرات التي تسجّلها المنصة تلقائياً، ومن يستطيع فتح الشاشة في شركتك، وكيف تقرأ أي قيد فيها، وما الذي لا تخبرك به. لا يوجد «تقرير نشاط» منفصل: هذه الشاشة نفسها هي سجل النشاط.

من يستطيع الوصول#

• موظفو شركة التوصيل على دومين الشركة نفسها، ممن يتضمن دورهم صلاحية log_read (مجموعة الصلاحيات «logs»). افتح «سجلات نشطة» من القائمة الجانبية. ومن لا يملك الصلاحية لا يرى هذا العنصر في القائمة الجانبية، ويُعاد إلى الصفحة الرئيسية إذا حاول فتح الصفحة.
• للوحة الشركة فقط. الشاشة جزء من لوحة الشركة، وليس في اللوحة المركزية لإدارة المنصة شاشة لسجل النشاط.
• من يملك الصلاحية. تُمنح عبر الأدوار. يتضمنها دورا «Admin» و«User» اللذان يُنشآن افتراضياً مع النظام؛ وفي الشركة التي ينشئها السوبر أدمن تأتي صلاحيات أول أدمن من وحدات باقة الشركة، والوحدة logs هي التي تحمل log_read.
• النطاق. تعرض القائمة فقط القيود التي أجراها مستخدمون من شركتك. أما القيد الذي لم يُنفَّذ بواسطة مستخدم مسجَّل الدخول فلا فاعل له، ولذلك لا يظهر في القائمة أبداً.

ما الذي يُسجَّل#

تستخدم المنصة حزمة لتسجيل النشاط. يُسجَّل تلقائياً كل نموذج (Model) يحمل سمة التسجيل عند إنشائه أو تعديله أو حذفه، ويكون المستخدم المسجَّل الدخول هو الفاعل. ولا تُخزَّن إلا الحقول المحددة لذلك النموذج: القيم الجديدة عند الإنشاء، والقيم الجديدة والقديمة عند التعديل، والقيم القديمة فقط عند الحذف.

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

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

قراءة السجل#

1. افتح «سجلات نشطة»

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

2. اقرأ الصف

   الأعمدة هي # و«اسم السجل» (النموذج، مثل Hub أو parcel) و«حدث» («مخلوق» أو «محدث») و«نوع الموضوع» (اسم الفئة (class) الكامل للعنصر الذي تغيّر) و«وصف» وعمود «رأي» الذي يحوي زر العين.

3. افتح التفاصيل

   اضغط زر العين. تظهر نافذة بعنوان «تفاصيل السجل» تسرد كل حقل مع قيمته «جديد» و«قديم». عند الإنشاء يكون عمود القديم فارغاً، وعند الحذف تظهر القيم القديمة فقط. وتأتي أسماء الحقول من ملف ترجمة سجل النشاط، والحقل الذي بلا ترجمة يظهر بالصيغة ActivityLogs.<field>.

4. تنقّل بين الصفحات

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

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

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

• لا يوجد بحث ولا تصفية ولا نطاق تواريخ ولا تصدير ولا حذف. يمكنك فقط التنقل بين الصفحات.
• لا تعرض القائمة ولا نافذة التفاصيل أي مستخدم ولا أي تاريخ: لا تعرف من أجرى التغيير ولا متى.
• ليس لحدث الحذف ووصفه ترجمة: تعرض الخلية النص الخام levels.deleted. والترجمة موجودة فقط لـ«مخلوق» و«محدث».
• في الواجهة العربية يظهر عنوان العمود الأخير «رأي» (أي «opinion»)، وهو ترجمة خاطئة لكلمة View، وتظهر الأحداث بالاسمين «مخلوق» و«محدث».

الاحتفاظ بالقيود#

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

أخطاء شائعة#

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

الحدود والصلاحيات#

• موظفو الشركة التي ليس لها اشتراك فعّال يُحوَّلون إلى صفحة باقات الشركة قبل الوصول إلى الشاشة.