HandyCafe Docs
owner

لاگ‌ها

صفحه لاگ‌ها یک مسیر کامل از تمامی رویدادهای سیستم در HandyCafe ارائه می‌دهد. هر اقدام مهمی، از شروع جلسات تا ورود صندوقداران، در اینجا برای پاسخگویی، عیب‌یابی و اهداف تطابق ثبت می‌شود.

عملکرد

نمایشگر لاگ از رندر لیست مجازی استفاده می‌کند تا حتی هنگام نمایش هزاران ورودی، عملکرد روانی را حفظ کند. این به این معنی است که تنها ردیف‌های قابل مشاهده در هر زمان در DOM رندر می‌شوند، که به سیستم اجازه می‌دهد بیش از ۱۰۰۰ رکورد لاگ را بدون افت کیفیت رابط کاربری مدیریت کند.

فیلدهای ورودی لاگ

هر ورودی لاگ شامل فیلدهای زیر است:

فیلد توضیحات
Timestamp تاریخ و زمانی که رویداد رخ داده است
Source مؤلفه سیستمی که رویداد را تولید کرده است
Category طبقه‌بندی رویداد (به دسته‌بندی‌ها در زیر مراجعه کنید)
Action نوع اقدام خاص (به اقدامات رایج در زیر مراجعه کنید)
PC کامپیوتر یا کنسول مشتری درگیر، در صورت وجود
IP آدرس IP مرتبط با رویداد
Member عضو درگیر، در صورت وجود
Cashier صندوقداری که رویداد را ایجاد کرده یا در حال وظیفه بوده است
Message توضیح قابل فهم انسانی از آنچه اتفاق افتاده است

دسته‌بندی‌های لاگ

رویدادها به ۸ دسته طبقه‌بندی می‌شوند:

  1. Server -- راه‌اندازی سرور، خاموشی، تغییرات پیکربندی و رویدادهای سطح سیستم.
  2. Client -- اتصالات مشتری، قطع ارتباط و تغییرات وضعیت.
  3. Cashier -- ورود و خروج صندوقدار و اقدامات مدیریتی.
  4. Member -- ثبت‌نام عضو، به‌روزرسانی پروفایل و تغییرات حساب.
  5. Session -- رویدادهای چرخه عمر جلسه (شروع، توقف، مکث، ادامه).
  6. Console -- رویدادهای مرتبط با کنسول (افزودن، حذف، تخصیص جلسه).
  7. Order -- رویدادهای ایجاد، اصلاح و بستن سفارش.
  8. Payment -- پردازش پرداخت، بازپرداخت و رویدادهای تراکنش مالی.

اقدامات رایج ثبت‌شده

اقدامات زیر به طور مکرر در لاگ ظاهر می‌شوند:

  • startSession -- یک جلسه جدید روی یک مشتری یا کنسول شروع شد.
  • stopSession -- یک جلسه فعال پایان یافت.
  • pauseSession -- یک جلسه در حال اجرا متوقف شد.
  • resumeSession -- یک جلسه متوقف شده ادامه یافت.
  • consoleAdded -- یک کنسول بازی جدید در سیستم ثبت شد.
  • newMemberAdded -- یک حساب کاربری جدید عضو ایجاد شد.
  • orderCreated -- یک سفارش محصول جدید ثبت شد.
  • orderClosed -- یک سفارش تکمیل و بسته شد.
  • cashierLogin -- یک صندوقدار وارد سیستم شد.
  • cashierLogout -- یک صندوقدار از سیستم خارج شد.
  • serverStarted -- برنامه HandyCafe Server شروع به کار کرد.
  • clientConnected -- یک کامپیوتر مشتری به سرور متصل شد.
  • clientDisconnected -- یک کامپیوتر مشتری از سرور قطع شد.

فیلتر و جستجو

فیلتر دسته‌بندی

یک یا چند دسته را برای محدود کردن نمایش لاگ انتخاب کنید. به عنوان مثال، فقط رویدادهای Session و Payment را برای بررسی فعالیت‌های مالی نمایش دهید.

فیلتر اقدام

بر اساس نوع اقدامات خاص فیلتر کنید تا رویدادهای خاص را به سرعت پیدا کنید.

فیلتر محدوده تاریخ

نمای لاگ را به یک دوره زمانی خاص محدود کنید. این کار همراه با فیلترهای دیگر، بررسی حوادثی که در یک بازه زمانی مشخص رخ داده‌اند را ساده می‌کند.

گزینه‌های مرتب‌سازی

ورودی‌های لاگ را بر اساس هر فیلدی به ترتیب صعودی یا نزولی مرتب کنید. مرتب‌سازی بر اساس زمان (جدیدترین ابتدا) به صورت پیش‌فرض است.

جستجوی متنی

یک جعبه جستجوی متن آزاد که با تمام فیلدها مطابقت دارد، به شما امکان می‌دهد برای یک نام میزبان خاص، آدرس IP، نام عضو یا هر کلمه کلیدی در پیام‌های لاگ جستجو کنید.

مجوزها

دسترسی به صفحه لاگ‌ها توسط مجوزهای زیر کنترل می‌شود:

مجوز توضیحات
LOG_VIEW برای دسترسی به صفحه لاگ‌ها به طور کلی لازم است
LOG_DISPLAY_FULL امکان مشاهده تاریخچه کامل لاگ را فراهم می‌کند
LOG_DISPLAY_TODAY نمایش را به ورودی‌های امروز محدود می‌کند
LOG_DELETE امکان حذف ورودی‌های لاگ را فراهم می‌کند

یک صندوقدار با LOG_VIEW و LOG_DISPLAY_TODAY می‌تواند رویدادهای امروز را بررسی کند اما به داده‌های تاریخی دسترسی ندارد. تنها کاربرانی که LOG_DISPLAY_FULL دارند می‌توانند کل آرشیو لاگ را مرور کنند.

به‌روزرسانی‌های بلادرنگ

رویدادهای جدید لاگ به طور خودکار در نمایشگر ظاهر می‌شوند. سیستم از طریق اتصال رویداد TCP به رویدادهای لاگ گوش می‌دهد، بنابراین نیازی به تازه‌سازی دستی صفحه نیست. یک کش لاگ عملکرد را با کاهش پرس‌وجوهای مکرر به پایگاه داده هنگام پیمایش در ورودی‌های اخیر بهبود می‌بخشد.