HandyCafe Docs
owner

Журналы

Страница "Журналы" предоставляет полный аудиторский след всех системных событий в HandyCafe. Каждое значимое действие - от запуска сессий до входа кассиров - фиксируется здесь для подотчетности, устранения неполадок и соблюдения требований.

Производительность

Просмотрщик журналов использует виртуальный рендеринг списка для обеспечения плавной работы даже при отображении тысяч записей. Это означает, что в DOM отрисовываются только видимые строки, что позволяет системе обрабатывать более 1000 записей без деградации интерфейса.

Поля записи журнала

Каждая запись журнала содержит следующие поля:

Поле Описание
Метка времени Дата и время события
Источник Компонент системы, сгенерировавший событие
Категория Классификация события (см. категории ниже)
Действие Конкретный тип действия (см. типичные действия ниже)
ПК Клиентский ПК или консоль (при наличии)
IP IP-адрес, связанный с событием
Участник Участник (при наличии)
Кассир Кассир, инициировавший событие или дежуривший на момент события
Сообщение Описание произошедшего

Категории журналов

События классифицируются по 8 категориям:

  1. Сервер - запуск, выключение, изменения конфигурации и системные события.
  2. Клиент - подключения, отключения и изменения состояния клиентов.
  3. Кассир - вход, выход и административные действия кассиров.
  4. Участник - регистрация, обновление профилей и изменения аккаунтов участников.
  5. Сессия - события жизненного цикла сессий (запуск, остановка, пауза, возобновление).
  6. Консоль - события консолей (добавление, удаление, назначение сессий).
  7. Заказ - создание, изменение и закрытие заказов.
  8. Платеж - обработка платежей, возвраты и финансовые транзакции.

Типичные журналируемые действия

Следующие действия часто встречаются в журнале:

  • startSession - запущена новая сессия на клиенте или консоли.
  • stopSession - завершена активная сессия.
  • pauseSession - приостановлена активная сессия.
  • resumeSession - возобновлена приостановленная сессия.
  • consoleAdded - зарегистрирована новая игровая консоль.
  • newMemberAdded - создан новый аккаунт участника.
  • orderCreated - размещен новый заказ товаров.
  • orderClosed - заказ завершен и закрыт.
  • cashierLogin - кассир вошел в систему.
  • cashierLogout - кассир вышел из системы.
  • serverStarted - запущено приложение HandyCafe Server.
  • clientConnected - клиентский ПК установил соединение с сервером.
  • clientDisconnected - клиентский ПК отключился от сервера.

Фильтрация и поиск

Фильтр по категории

Выберите одну или несколько категорий для сужения отображения журнала. Например, показать только события "Сессия" и "Платеж" для аудита финансовой деятельности.

Фильтр по действию

Фильтрация по конкретным типам действий для быстрого поиска определенных событий.

Фильтр по диапазону дат

Ограничение просмотра журнала определенным временным периодом. В сочетании с другими фильтрами это упрощает расследование инцидентов, произошедших в известном временном окне.

Параметры сортировки

Сортировка записей журнала по любому полю в порядке возрастания или убывания. Сортировка по метке времени (сначала новые) используется по умолчанию.

Текстовый поиск

Свободное поле поиска, совпадающее со всеми полями, позволяет искать конкретное имя хоста, IP-адрес, имя участника или любое ключевое слово в сообщениях журнала.

Права доступа

Доступ к странице журналов контролируется следующими правами:

Право Описание
LOG_VIEW Необходимо для доступа к странице журналов
LOG_DISPLAY_FULL Позволяет просматривать полную историю журналов
LOG_DISPLAY_TODAY Ограничивает просмотр только записями за сегодня
LOG_DELETE Позволяет удалять записи журналов

Кассир с правами LOG_VIEW и LOG_DISPLAY_TODAY может просматривать события за сегодня, но не имеет доступа к историческим данным. Только пользователи с LOG_DISPLAY_FULL могут просматривать полный архив журналов.

Обновления в реальном времени

Новые события журнала появляются в просмотрщике автоматически по мере их возникновения. Система получает события через TCP-соединение, поэтому ручное обновление страницы не требуется. Кэш журналов повышает производительность, сокращая повторные запросы к базе данных при прокрутке недавних записей.