السجل

وحدة «السجل» في Platform OneEntry تتيح للمسؤولين تتبع كل من إجراءات المسؤولين الآخرين في النظام ونشاط واجهة برمجة التطبيقات العامة للمحتوى. تتكون الوحدة من أربع علامات تبويب:

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

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

كل علامة تبويب متاحة بموجب إذن منفصل — انظر الأذونات للسجل.

---

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

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

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

تتكون العلامة من كتلتين:

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

الفلاتر

لإجراء تصفية على الإجراءات، تتوفر الحقول التالية:

1. من — حقل نصي لإدخال التاريخ الذي يجب بدء تصفية الإجراءات منه.
2. إلى — حقل نصي لإدخال التاريخ الذي يجب انتهاء تصفية الإجراءات عنده.

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

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

3. معرف المسؤول — حقل إدخال رقمي لمعرف المسؤول الفريد.
4. إجراءات المستخدم — قائمة منسدلة لإجراءات المستخدم:
   • إنشاء
   • تعديل
   • حذف
5. الحالة — قائمة منسدلة لحالات الإجراءات:
   • ناجح
   • خطأ
6. اسم الوحدة — قائمة منسدلة لأسماء الوحدات:
   • المسؤولون
   • مجموعات السمات
   • النسخ الاحتياطي
   • إدارة الكتل
   • إدارة الأحداث
   • الإعدادات العامة
   • تحميل الملفات
   • محرر الملفات
   • إدارة النماذج
   • التوطين
   • العلامات
   • القائمة
   • الوحدات
   • إدارة المحتوى
   • المنتجات
   • إدارة الطلبات
   • الإعدادات الأساسية
   • إدارة الدفع
   • إدارة حالة المنتج
   • المستخدم
   • إدارة موفري ومستخدمي المصادقة
   • إدارة القوالب
   • إدارة معاينة القوالب
7. معرف السجل — حقل إدخال رقمي لمعرف السجل الفريد.

تحت كتلة الفلاتر، توجد زران:

• حذف البيانات — يحذف سجلات سجل إجراءات المسؤولين للفترة المحددة بواسطة حقول من / إلى (انظر تنظيف السجلات يدويًا).
• إعادة تعيين — يعيد تعيين الفلاتر المطبقة.

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

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

1. إجراءات المستخدم
2. الحالة
3. تسجيل دخول المستخدم
4. اسم الوحدة
5. معرف السجل
6. التاريخ والوقت

الفرز

لكل عمود إمكانية فرز البيانات بالنقر على عنوان العمود. النقر الأول يقوم بفرز البيانات تنازليًا، الثاني تصاعديًا، والثالث يعيد تعيين الفرز.

تدقيق رؤية الكتلة

كل تبديل لرؤية الكتلة (التبديل "عرض/عدم عرض" في إدارة الكتل) يتم تسجيله تلقائيًا في سجل إجراءات المسؤولين. يمكن رؤية أي مسؤول ومتى قام بتغيير حالة كتلة معينة.

في قائمة الإجراءات، تتعلق هذه السجلات بوحدة إدارة الكتل.

---

حركة المسؤولين (سجل وصول المسؤولين)

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

حقول الجدول

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

العمود	ماذا يعني
تسجيل الدخول	تسجيل دخول المسؤول
IP	عنوان IP الذي دخل منه المسؤول
وقت تسجيل الدخول	تاريخ ووقت تسجيل الدخول
وقت تسجيل الخروج	تاريخ ووقت تسجيل الخروج (لجلسة مفتوحة، يكون فارغًا)
المدة	مدة الجلسة (لجلسة نشطة، من تسجيل الدخول حتى اللحظة الحالية)
السبب	سبب إغلاق الجلسة: logout (المستخدم ضغط على "تسجيل الخروج") أو admin_revoked (مسؤول آخر أنهى الجلسة قسريًا)

الفرز

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

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

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

الفلاتر

• من / إلى — الفترة (حقول إدخال التاريخ مع التقويم).
• معرف المسؤول — حقل رقمي لتصفية حسب مسؤول معين.
• حالة الجلسة — قائمة منسدلة لحالة الجلسة: الكل / نشط / مغلق.

زر "حذف البيانات"

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

تأكيد الإجراء — هل تريد حذف جميع الجلسات المغلقة للفترة المحددة؟ هذا الإجراء لا يمكن التراجع عنه. ستبقى الجلسات النشطة.

يتم حذف فقط الجلسات المغلقة. الجلسات النشطة (مع تسجيل دخول مفتوح) لا يتم حذفها.

---

إحصائيات واجهة برمجة التطبيقات للمحتوى

تظهر علامة «إحصائيات واجهة برمجة التطبيقات للمحتوى» عدادات استدعاءات جميع نقاط النهاية العامة للموقع على فترات زمنية مختلفة — ساعة واحدة، 24 ساعة، 7 أيام.

ماذا تعرض

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

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

• الفترة — قائمة منسدلة للفترة: الساعة الأخيرة / آخر 24 ساعة / آخر 7 أيام (بشكل افتراضي — آخر 24 ساعة).
• تحديث — زر لتحديث البيانات بشكل قسري.

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

العمود	ماذا يعني
المسار	مسار نقطة النهاية (/api/content/...)
الطريقة	طريقة HTTP (GET، POST، …)
الوصف	وصف مختصر لنقطة النهاية
الطلبات	عدد الاستدعاءات خلال الفترة المحددة

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

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

إذا كانت بيانات الإحصائيات غير متاحة مؤقتًا، يظهر تحذير فوق الجدول "المقياس غير متاح مؤقتًا. جميع نقاط النهاية معروضة بعدد صفر." — لا يزال يتم عرض قائمة نقاط النهاية، ولكن مع عداد 0.

⚠️مدة تخزين الإحصائيات

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

لماذا هو مهم

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

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

يتم تحديث البيانات بمعدل لا يزيد عن مرة واحدة في الدقيقة: النقر المتكرر على تحديث خلال 60 ثانية سيظهر نفس القيم.

---

أخطاء واجهة برمجة التطبيقات للمحتوى

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

ماذا تعرض

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

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

إذا لم يكن هناك أخطاء خلال الفترة المحددة، يظهر بدلاً من الجدول رسالة "لا توجد أخطاء مسجلة للفترة المحددة".

حقل «المزيد» يفتح شاشة تفصيلية تحتوي على:

• جسم الطلب (بدون أسرار — كلمات المرور، الرموز، رؤوس التفويض مخفية)
• الاستعلام — معلمات سلسلة الاستعلام
• الرؤوس
• تتبع المكدس — مفصل (حتى 8 كيلوبايت)

الفلاتر

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

زر "حذف البيانات"

يحذف سجلات الأخطاء للفترة المحددة بواسطة حقول من / إلى. إذا لم يتم تحديد الفترة — يتم حذف جميع الأخطاء.

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

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

---

تنظيف السجلات يدويًا

يتم تنظيف سجلات السجل يدويًا — في كل علامة تبويب تحتفظ بالسجلات، يوجد زر «حذف البيانات»:

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

تحدد فترة الحذف بواسطة حقول من / إلى في فلاتر العلامة. إذا لم يتم تحديد الفترة — يتم حذف جميع السجلات من النوع المناسب. قبل الحذف، يظهر دائمًا مربع تأكيد «تأكيد الإجراء»، العملية لا يمكن التراجع عنها.

ℹ️لا يتم لمس الجلسات النشطة

زر "حذف البيانات" في علامة "حركة المسؤولين" لا يحذف الجلسات النشطة للمسؤولين — حتى إذا تم تحديد فترة تتداخل مع اللحظة الحالية، لن يتم حذف جلسة مفتوحة لزميل يعمل. يتم حذف فقط الجلسات المغلقة.

ℹ️علامة «إحصائيات واجهة برمجة التطبيقات للمحتوى» لا تحتوي على تنظيف

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

---

الأذونات للسجل

كل علامة تبويب في السجل متاحة بموجب إذن منفصل في شجرة الأذونات:

علامة التبويب	الإذن
سجل إجراءات المسؤولين	journal.viewAdminActions
حركة المسؤولين	journal.viewAdminAccess
إحصائيات واجهة برمجة التطبيقات للمحتوى	journal.viewContentApiStats
أخطاء واجهة برمجة التطبيقات للمحتوى	journal.viewContentApiErrors