السجلات
توفر صفحة السجلات مسار تدقيق شاملًا لجميع أحداث النظام في HandyCafe. كل إجراء مهم (من بدء الجلسات إلى تسجيل دخول أمناء الصندوق) يُسجّل هنا لأغراض المحاسبية واستكشاف الأخطاء والامتثال.
علامات التبويب
تنقسم الصفحة إلى علامات تبويب. كل واحدة تغطي مجموعة سجلات مختلفة.
| علامة التبويب | المحتوى |
|---|---|
| سجلات النظام | سجل الأحداث العام الموصوف في هذه الصفحة |
| المعاملات | حركات الأموال المسجلة على ورديات أمناء الصندوق |
| سلة المحذوفات | السجلات المحذوفة من صفحات أخرى والمحفوظة للاستعادة |
| التدقيق | سجلات غير قابلة للعبث للتغييرات الحساسة |
| سجلات IP | سجلات الوصول المحفوظة في ملفات يومية للاحتفاظ القانوني. راجع سجلات IP وسجلات الوصول |
| أحداث العبث | اكتشافات مكافحة الغش التي يبلّغ عنها العملاء |
| قائمة حظر HWID | معرّفات الأجهزة الممنوعة من فتح جلسة |
| Steam VAC | فحوص حظر Steam على حسابات الأعضاء |
يمكن إيقاف علامات التبويب فرديًا من الإعدادات ثم العرض. وعندما تكون كل العلامات موقوفة يختفي إدخال السجلات من قائمة التنقل. راجع إعدادات العرض.
علامة تبويب التدقيق
تسجّل علامة تبويب التدقيق التغييرات المهمة للمساءلة: تغييرات الصلاحيات والأدوار والتعديلات المالية وتغييرات المنتجات وتغييرات الإعدادات وحذف البيانات وعمليات وحدات التحكم.
لا يمكن تعديل سجلات التدقيق. فكل سجل محمي بتوقيع سلامة يرتبط بالسجل الذي يسبقه. وتعرض علامة التبويب نتيجة تحقق في الأعلى. وإذا جرى تغيير سجل ما فإن اللوحة تسمّي أول سجل ينكسر عنده التسلسل.
يمكن تصفية سجلات التدقيق حسب الفئة أو الإجراء. ويغطي البحث النصي الحر الفاعل والهدف.
الأداء
يستخدم عارض السجلات عرض القوائم الافتراضية للحفاظ على أداء سلس حتى عند عرض آلاف المدخلات. هذا يعني أن الصفوف المرئية فقط تُعرض في 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 فلا حاجة لتحديث الصفحة يدويًا. تحسّن ذاكرة التخزين المؤقت للسجلات الأداء بتقليل استعلامات قاعدة البيانات المتكررة عند التمرير بين المدخلات الأخيرة.