السجلات
توفر صفحة السجلات مسار تدقيق شاملًا لجميع أحداث النظام في HandyCafe. كل إجراء مهم -- من بدء الجلسات إلى تسجيل دخول أمناء الصندوق -- يُسجّل هنا لأغراض المحاسبية واستكشاف الأخطاء والامتثال.
الأداء
يستخدم عارض السجلات عرض القوائم الافتراضية للحفاظ على أداء سلس حتى عند عرض آلاف المدخلات. هذا يعني أن الصفوف المرئية فقط تُعرض في DOM في أي وقت مما يتيح للنظام التعامل مع أكثر من 1000 سجل دون تدهور في الواجهة.
حقول مدخل السجل
يحتوي كل مدخل سجل على الحقول التالية:
| الحقل | الوصف |
|---|---|
| الطابع الزمني | تاريخ ووقت حدوث الحدث |
| المصدر | مكون النظام الذي أنشأ الحدث |
| الفئة | تصنيف الحدث (انظر الفئات أدناه) |
| الإجراء | نوع الإجراء المحدد (انظر الإجراءات الشائعة أدناه) |
| الجهاز | جهاز العميل أو وحدة التحكم المعنية إن وُجدت |
| عنوان IP | عنوان IP المرتبط بالحدث |
| العضو | العضو المعني إن وُجد |
| أمين الصندوق | أمين الصندوق الذي أثار الحدث أو كان مناوبًا عند حدوثه |
| الرسالة | وصف مقروء لما حدث |
فئات السجلات
تُصنّف الأحداث في 8 فئات:
- الخادم -- بدء تشغيل الخادم وإيقافه وتغييرات الإعدادات والأحداث على مستوى النظام.
- العميل -- اتصالات العملاء وانقطاعها وتغييرات الحالة.
- أمين الصندوق -- تسجيل دخول أمين الصندوق وخروجه والإجراءات الإدارية.
- العضو -- تسجيل الأعضاء وتحديثات الملفات الشخصية وتغييرات الحسابات.
- الجلسة -- أحداث دورة حياة الجلسة (بدء وإيقاف وإيقاف مؤقت واستئناف).
- وحدة التحكم -- أحداث متعلقة بوحدات التحكم (إضافات وحذف وتعيينات جلسات).
- الطلب -- إنشاء الطلبات وتعديلها وإغلاقها.
- الدفع -- معالجة المدفوعات والاستردادات وأحداث المعاملات المالية.
الإجراءات المسجلة الشائعة
تظهر الإجراءات التالية بشكل متكرر في السجل:
startSession-- بُدئت جلسة جديدة على عميل أو وحدة تحكم.stopSession-- أُنهيت جلسة نشطة.pauseSession-- أُوقفت جلسة جارية مؤقتًا.resumeSession-- استُؤنفت جلسة متوقفة مؤقتًا.consoleAdded-- سُجّلت وحدة تحكم ألعاب جديدة في النظام.newMemberAdded-- أُنشئ حساب عضو جديد.orderCreated-- أُنشئ طلب منتج جديد.orderClosed-- أُكمل طلب وأُغلق.cashierLogin-- سجّل أمين صندوق دخوله إلى النظام.cashierLogout-- سجّل أمين صندوق خروجه.serverStarted-- بُدئ تطبيق خادم HandyCafe.clientConnected-- أنشأ جهاز عميل اتصالًا بالخادم.clientDisconnected-- انقطع جهاز عميل عن الخادم.
التصفية والبحث
تصفية الفئة
حدد فئة واحدة أو أكثر لتضييق عرض السجل. مثلًا اعرض أحداث الجلسة والدفع فقط لتدقيق النشاط المالي.
تصفية الإجراء
صفّ حسب أنواع إجراءات محددة لإيجاد أحداث معينة بسرعة.
تصفية نطاق التاريخ
قيّد عرض السجل بفترة زمنية محددة. مدمجة مع عوامل التصفية الأخرى يسهّل هذا التحقيق في حوادث وقعت خلال نافذة زمنية معروفة.
خيارات الترتيب
رتّب مدخلات السجل حسب أي حقل بترتيب تصاعدي أو تنازلي. الترتيب حسب الطابع الزمني (الأحدث أولًا) هو الافتراضي.
البحث النصي
مربع بحث نصي حر يطابق جميع الحقول مما يتيح البحث عن اسم جهاز محدد أو عنوان IP أو اسم عضو أو أي كلمة مفتاحية في رسائل السجل.
الصلاحيات
يُتحكم بالوصول إلى صفحة السجلات بالصلاحيات التالية:
| الصلاحية | الوصف |
|---|---|
LOG_VIEW |
مطلوبة للوصول إلى صفحة السجلات |
LOG_DISPLAY_FULL |
تسمح بعرض سجل السجلات الكامل |
LOG_DISPLAY_TODAY |
تقيّد العرض بمدخلات اليوم فقط |
LOG_DELETE |
تسمح بحذف مدخلات السجلات |
أمين الصندوق الذي يملك LOG_VIEW وLOG_DISPLAY_TODAY يمكنه مراجعة أحداث اليوم لكنه لا يستطيع الوصول إلى البيانات التاريخية. المستخدمون الذين يملكون LOG_DISPLAY_FULL فقط يمكنهم تصفح أرشيف السجلات الكامل.
التحديثات الفورية
تظهر أحداث السجل الجديدة تلقائيًا في العارض عند حدوثها. يستمع النظام لأحداث السجل عبر اتصال أحداث TCP فلا حاجة لتحديث الصفحة يدويًا. تحسّن ذاكرة التخزين المؤقت للسجلات الأداء بتقليل استعلامات قاعدة البيانات المتكررة عند التمرير بين المدخلات الأخيرة.