HandyCafe Docs
owner

Registros

La página de Registros proporciona una pista de auditoría completa de todos los eventos del sistema en HandyCafe. Cada acción significativa, desde inicios de sesión hasta accesos de cajeros, se registra aquí para rendición de cuentas, solución de problemas y cumplimiento.

Rendimiento

El visor de registros usa renderizado de lista virtual para mantener un rendimiento fluido incluso al mostrar miles de entradas. Esto significa que solo las filas visibles se renderizan en el DOM en cualquier momento, permitiendo que el sistema maneje más de 1,000 registros sin degradación de la interfaz.

Campos de la entrada de registro

Cada entrada de registro contiene los siguientes campos:

Campo Descripción
Marca de tiempo Fecha y hora en que ocurrió el evento
Origen El componente del sistema que generó el evento
Categoría Clasificación del evento (ver categorías abajo)
Acción Tipo de acción específico (ver acciones comunes abajo)
PC El PC cliente o consola involucrado, si aplica
IP Dirección IP asociada al evento
Miembro El miembro involucrado, si aplica
Cajero El cajero que activó o estaba de turno durante el evento
Mensaje Descripción legible de lo que sucedió

Categorías de registro

Los eventos se clasifican en 8 categorías:

  1. Servidor: Inicio, apagado del servidor, cambios de configuración y eventos a nivel de sistema.
  2. Cliente: Conexiones, desconexiones y cambios de estado de clientes.
  3. Cajero: Inicio de sesión, cierre de sesión y acciones administrativas del cajero.
  4. Miembro: Registro de miembros, actualizaciones de perfil y cambios de cuenta.
  5. Sesión: Eventos del ciclo de vida de sesiones (inicio, fin, pausa, reanudación).
  6. Consola: Eventos relacionados con consolas (adiciones, eliminaciones, asignaciones de sesión).
  7. Pedido: Eventos de creación, modificación y cierre de pedidos.
  8. Pago: Procesamiento de pagos, reembolsos y eventos de transacciones financieras.

Acciones registradas comunes

Las siguientes acciones aparecen frecuentemente en el registro:

  • startSession: Se inició una nueva sesión en un cliente o consola.
  • stopSession: Se finalizó una sesión activa.
  • pauseSession: Se pausó una sesión en curso.
  • resumeSession: Se reanudó una sesión pausada.
  • consoleAdded: Se registró una nueva consola de juego en el sistema.
  • newMemberAdded: Se creó una nueva cuenta de miembro.
  • orderCreated: Se creó un nuevo pedido de productos.
  • orderClosed: Se completó y cerró un pedido.
  • cashierLogin: Un cajero inició sesión en el sistema.
  • cashierLogout: Un cajero cerró sesión.
  • serverStarted: Se inició la aplicación HandyCafe Server.
  • clientConnected: Un PC cliente estableció conexión con el servidor.
  • clientDisconnected: Un PC cliente se desconectó del servidor.

Filtrado y búsqueda

Filtro por categoría

Seleccione una o más categorías para limitar la visualización del registro. Por ejemplo, muestre solo eventos de Sesión y Pago para auditar la actividad financiera.

Filtro por acción

Filtre por tipos de acción específicos para encontrar eventos particulares rápidamente.

Filtro por rango de fechas

Restrinja la vista del registro a un período de tiempo específico. Combinado con otros filtros, esto facilita la investigación de incidentes que ocurrieron durante una ventana de tiempo conocida.

Opciones de ordenamiento

Ordene las entradas del registro por cualquier campo en orden ascendente o descendente. El ordenamiento por marca de tiempo (más reciente primero) es el predeterminado.

Búsqueda de texto

Un cuadro de búsqueda de texto libre que busca en todos los campos, permitiendo buscar un nombre de equipo específico, dirección IP, nombre de miembro o cualquier palabra clave en los mensajes del registro.

Permisos

El acceso a la página de Registros está controlado por los siguientes permisos:

Permiso Descripción
LOG_VIEW Requerido para acceder a la página de Registros
LOG_DISPLAY_FULL Permite ver el historial completo de registros
LOG_DISPLAY_TODAY Restringe la vista solo a las entradas del día de hoy
LOG_DELETE Permite eliminar entradas del registro

Un cajero con LOG_VIEW y LOG_DISPLAY_TODAY puede revisar los eventos del día pero no puede acceder a datos históricos. Solo los usuarios con LOG_DISPLAY_FULL pueden explorar el archivo completo de registros.

Actualizaciones en tiempo real

Los nuevos eventos de registro aparecen automáticamente en el visor a medida que ocurren. El sistema escucha eventos de registro a través de la conexión de eventos TCP por lo que no es necesario recargar la página manualmente. Un caché de registros mejora el rendimiento reduciendo las consultas repetidas a la base de datos al desplazarse por las entradas recientes.