السجل

تتيح وحدة Journal في OneEntry للمسؤولين تتبّع ما يفعله المسؤولون الآخرون في النظام، ومتابعة نشاط واجهة Content API العامة. تضم الوحدة أربع علامات تبويب:

علامة التبويب	ما تعرضه
سجل إجراءات المسؤولين	جميع إجراءات المسؤولين في النظام: إنشاء الكيانات وتعديلها وحذفها.
حركة المسؤولين	جلسات دخول المسؤولين: وقت الدخول ووقت الخروج والجهاز المستخدم.
إحصائيات Content API	عدد استدعاءات كل نقاط النهاية العامة للموقع خلال فترات مختلفة.
أخطاء Content API	جميع استجابات 4xx/5xx من الواجهة البرمجية العامة مع تفاصيل الطلب وتتبّع المكدس (stack trace).

تحمل علامات التبويب في واجهة الوحدة الأسماء التالية: Admin Journal وAccess Log to Admin Application وContent API Statistics وContent API Errors.

تتطلب علامتا تبويب الإحصائيات والأخطاء الخاصتان بـ Content API أذونات منفصلة (انظر أذونات السجل).

---

سجل إجراءات المسؤولين

علامة التبويب الرئيسية، وتعرض جميع إجراءات المسؤولين في النظام.

عناصر الواجهة

تتكون علامة التبويب من قسمين:

• الفلاتر
• قائمة الإجراءات

الفلاتر

يمكنك تصفية الإجراءات بالحقول التالية:

1. From: حقل نصي لإدخال التاريخ الذي تبدأ منه التصفية.
2. To: حقل نصي لإدخال التاريخ الذي تنتهي عنده التصفية.

حقول إدخال التاريخ

اكتب التاريخ نصًا بتنسيق التاريخ المعتمد في منطقتك، أو اختره من التقويم الذي يظهر عند النقر على حقل التاريخ.

3. Administrator ID: حقل رقمي لإدخال المعرّف الفريد للمسؤول.
4. User actions: قائمة منسدلة بإجراءات المستخدم:
   • إنشاء
   • تعديل
   • حذف
5. Status: قائمة منسدلة بحالات الإجراءات:
   • ناجح
   • خطأ
6. Module name: قائمة منسدلة بأسماء الوحدات:
   • Administrators
   • Sets of attributes
   • Backup
   • Managing blocks
   • Event management
   • General settings
   • Uploading files
   • File editor
   • Managing forms
   • Localization
   • Markers
   • Menu
   • Modules
   • Content management
   • Products
   • Order management
   • Basic settings
   • Payment management
   • Product status management
   • USER
   • Authentication providers and users management
   • Template management
   • Preview template management
7. Record ID: حقل رقمي لإدخال المعرّف الفريد للإدخال.

يوجد أسفل الفلاتر زرّان:

• Delete data: يحذف إدخالات سجل إجراءات المسؤولين للفترة المحددة في الحقلين From / To (انظر مسح السجلات يدويًا).
• Reset: يلغي الفلاتر المطبقة.

قائمة الإجراءات

تُعرض قائمة الإجراءات في جدول من ستة أعمدة:

1. User actions
2. Status
3. User login
4. Module name
5. Record ID
6. Date and time

الفرز

انقر على عنوان أي عمود لفرز البيانات حسبه: النقرة الأولى تفرز تنازليًا، والثانية تصاعديًا، والثالثة تلغي الفرز.

تدقيق ظهور الكتلة

يُسجَّل كل تبديل لظهور كتلة (مفتاح «إظهار/إخفاء» في قسم الكتل بلوحة الإدارة) تلقائيًا في سجل إجراءات المسؤولين، فيمكنك معرفة أي مسؤول غيّر حالة كتلة معينة ومتى.

في قائمة الإجراءات، ينتمي هذا الإدخال إلى الوحدة Managing blocks.

---

حركة المسؤولين (Admin Access Log)

تسجّل علامة التبويب «حركة المسؤولين» كل دخول وخروج لمسؤول كإدخال مستقل، فيتضح منها من دخل لوحة الإدارة ومتى، وهذا مفيد للتدقيق.

أعمدة الجدول

يتكون الجدول من ستة أعمدة:

العمود	المعنى
Login	اسم دخول المسؤول
IP	عنوان IP الذي دخل منه المسؤول
Login Time	تاريخ تسجيل الدخول ووقته
Logout Time	تاريخ تسجيل الخروج ووقته (للجلسة التي لا تزال مفتوحة: Active)
Duration	مدة الجلسة (للجلسة النشطة: من تسجيل الدخول حتى اللحظة الحالية)
Reason	سبب إغلاق الجلسة: Logout (نقر المسؤول بنفسه على «Log out») أو Admin Revoked (أنهى مسؤول آخر الجلسة قسرًا)؛ وللجلسة المفتوحة: Active

الفرز

كما في سجل إجراءات المسؤولين، يمكنك فرز أي عمود بالنقر على عنوانه.

ℹ️انتهاء صلاحية التفويض

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

الفلاتر

• From / to: الفترة (حقلا تاريخ مع تقويم).
• Administrator ID: حقل رقمي للتصفية حسب مسؤول محدد.
• Session Status: قائمة منسدلة بحالة الجلسة: All / Active / Closed.

زر «Delete data»

يحذف إدخالات الجلسات للفترة المحددة في الحقلين From / To. عند النقر عليه يظهر مربع حوار للتأكيد:

Confirm action: Delete all closed sessions for the specified period? This action is irreversible. Active sessions will remain.

تُحذف الجلسات المغلقة فقط، ولا تُحذف الجلسات النشطة (ذات التفويض المفتوح).

---

إحصائيات Content API

تعرض علامة التبويب «إحصائيات Content API» عدد استدعاءات كل نقاط النهاية العامة للموقع خلال فترات مختلفة: ساعة واحدة أو 24 ساعة أو 7 أيام.

ما تعرضه

• قائمة بكل نقاط النهاية العامة (GET /api/content/...): تُنشأ تلقائيًا، فلا حاجة إلى تعبئتها يدويًا.
• عدّاد بجانب كل نقطة نهاية: عدد مرات استدعائها خلال الفترة المحددة.

عناصر الواجهة

• Period: قائمة منسدلة لاختيار الفترة: Last Hour / Last 24 Hours / Last 7 Days (القيمة الافتراضية: Last 24 Hours).
• Refresh: زر لفرض تحديث البيانات.

تُعرض البيانات في جدول من أربعة أعمدة:

العمود	المعنى
Path	مسار نقطة النهاية (/api/content/...)
Method	طريقة HTTP (GET، POST، …)
Description	وصف موجز لنقطة النهاية
Requests	عدد الاستدعاءات خلال الفترة المحددة

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

⚠️المقياس غير متاح مؤقتًا

إذا كانت بيانات الإحصائيات غير متاحة مؤقتًا، يظهر فوق الجدول التحذير «Metric temporarily unavailable. All endpoints are displayed with a zero count.». ورغم نص التحذير، قد يكون الجدول في هذه الحالة فارغًا وتظهر فيه الرسالة «No data available».

⚠️مدة الاحتفاظ بالإحصائيات

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

الغرض منها

تُظهر الإحصائيات أي نقاط نهاية Content API تُستخدم وأيها لا يُستدعى. والانخفاض الحاد في عدد استدعاءات نقطة نهاية واحدة يشير عادةً إلى مشكلة في تطبيق العميل.

ℹ️تواتر التحديث

لا تُحدَّث البيانات أكثر من مرة في الدقيقة: إذا نقرت Refresh مجددًا خلال 60 ثانية، فستظهر القيم نفسها.

---

أخطاء Content API

تعرض علامة التبويب «أخطاء Content API» جميع استجابات 4xx/5xx التي أعادتها الواجهة البرمجية العامة خلال الفترة. وبذلك يرى المطورون الذين يدمجون تطبيق العميل مع Content API أخطاء طلباتهم مباشرة في لوحة الإدارة.

ما تعرضه

كل إدخال هو خطأ HTTP مستقل. يتكون الجدول من خمسة أعمدة:

العمود	المعنى
Time	الطابع الزمني للخطأ
Status	حالة HTTP (4xx / 5xx)
Method	طريقة الطلب (GET، POST، …)
Path	المسار (/api/content/...)
Message	نص الخطأ

إذا لم تقع أخطاء خلال الفترة المحددة، تظهر بدلًا من الجدول الرسالة «No errors recorded for the selected period».

انقر على صف في الجدول لفتح نافذة بتفاصيل الخطأ:

• الوقت وحالة HTTP وطريقة الطلب ومساره؛
• رمز الخطأ ونصه؛
• تتبّع المكدس كاملًا (حتى 8 كيلوبايت)؛
• معرّف الطلب والرقم التسلسلي لـ app-token الذي أُرسل به الطلب؛
• عنوان IP للعميل وقيمة User-Agent الخاصة به؛
• Query: معاملات سلسلة الاستعلام؛
• معاينة لجسم الطلب دون بيانات سرية (كلمات المرور والرموز المميزة وترويسات التفويض مُقنَّعة).

الفلاتر

• From / to: الفترة (حقلا تاريخ مع تقويم).
• HTTP Status: قائمة منسدلة بالحالات. يمكنك اختيار مجموعة (4xx - Client-side أو 5xx - Server-side) أو رمز محدد: 400، 401، 403، 404، 422، 500، 502، 503.
• Path: حقل نصي للتصفية حسب المسار (مثل /api/content/blocks/*).

زر «Delete data»

يحذف إدخالات الأخطاء للفترة المحددة في الحقلين From / To. إذا لم تُحدَّد فترة، تُحذف جميع الأخطاء.

الأمان: إخفاء البيانات الحساسة

تُخفى البيانات الحساسة في إدخالات الأخطاء تلقائيًا: تُستبدل الحقول password وtoken وauthorization وapi_key وx-app-token وcookie وset-cookie (دون تمييز بين الأحرف الكبيرة والصغيرة) بـ ***. وتُقتطع أجسام الطلبات الكبيرة إلى 2 كيلوبايت.

---

مسح السجلات يدويًا

تُمسح إدخالات السجل يدويًا، ففي كل علامة تبويب تحتفظ بإدخالات يوجد زر «Delete data»:

علامة التبويب	ما يحذفه
سجل إجراءات المسؤولين	إدخالات إجراءات المسؤولين للفترة المحددة
حركة المسؤولين	الجلسات المغلقة فقط للفترة المحددة
أخطاء Content API	إدخالات الأخطاء للفترة المحددة

حدّد فترة الحذف بالحقلين From / To في فلاتر علامة التبويب. إذا لم تُحدَّد فترة، تُحذف جميع الإدخالات من النوع المعني. ويظهر دائمًا قبل الحذف مربع حوار التأكيد «Confirm action»، ولا يمكن التراجع عن العملية.

ℹ️الجلسات النشطة لا تُحذف

لا يحذف زر «Delete data» في علامة التبويب «حركة المسؤولين» الجلسات النشطة للمسؤولين: حتى لو حددت فترة تشمل اللحظة الحالية، فلن تُحذف الجلسة المفتوحة لزميل يعمل حاليًا. تُحذف الجلسات المغلقة فقط.

ℹ️لا يوجد مسح في علامة التبويب «إحصائيات Content API»

تُقرأ بيانات الإحصائيات في الوقت الفعلي ولا تُخزَّن في المشروع، لذا لا يوجد زر «Delete data» في علامة التبويب هذه، وهذا ما يشير إليه الشريط «Auto-cleanup not applicable».

---

أذونات السجل

تتطلب علامتا التبويب Content API Statistics وContent API Errors أذونات منفصلة في شجرة الأذونات (يفتح في علامة تبويب جديدة). ولا تظهر علامة التبويب لمن لا يملك الإذن.

علامة التبويب	الإذن
إحصائيات Content API	journal.viewContentApiStats
أخطاء Content API	journal.viewContentApiErrors

تظهر علامتا التبويب «سجل إجراءات المسؤولين» و«حركة المسؤولين» لجميع المسؤولين الذين يملكون صلاحية الوصول إلى وحدة السجل.