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.

Pestañas

La página está dividida en pestañas. Cada una cubre un conjunto de registros distinto.

Pestaña	Contenido
Registros del sistema	El registro general de eventos descrito en esta página
Transacciones	Movimientos de dinero registrados contra los turnos de cajero
Papelera de reciclaje	Registros eliminados desde otras páginas, conservados para su recuperación
Auditoría	Registros a prueba de manipulación de los cambios sensibles
Registros IP	Registros de acceso guardados en archivos diarios para la retención legal. Consulte Registros IP y de acceso
Eventos de manipulación	Detecciones anti-cheat reportadas por los clientes
Lista negra de HWID	IDs de hardware bloqueados para abrir una sesión
Steam VAC	Comprobaciones de baneos de Steam en las cuentas de miembros

Las pestañas pueden desactivarse una a una en Configuración, luego Vista. Cuando todas están desactivadas, la entrada de Registros desaparece del menú de navegación. Consulte Configuración de vista.

La pestaña Auditoría

La pestaña Auditoría registra los cambios que importan para la rendición de cuentas: cambios de permisos y roles, ajustes financieros, cambios de productos, cambios de configuración, eliminaciones de datos y operaciones de consola.

Los registros de auditoría no pueden modificarse. Cada uno está protegido por una firma de integridad encadenada al registro anterior. La pestaña muestra un resultado de verificación en la parte superior. Si un registro ha sido alterado, el panel indica el primer registro donde se rompe la cadena.

Los registros de auditoría pueden filtrarse por categoría o por acción. La búsqueda de texto libre cubre el actor y el objetivo.

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:

Servidor: Inicio, apagado del servidor, cambios de configuración y eventos a nivel de sistema.
Cliente: Conexiones, desconexiones y cambios de estado de clientes.
Cajero: Inicio de sesión, cierre de sesión y acciones administrativas del cajero.
Miembro: Registro de miembros, actualizaciones de perfil y cambios de cuenta.
Sesión: Eventos del ciclo de vida de sesiones (inicio, fin, pausa, reanudación).
Consola: Eventos relacionados con consolas (adiciones, eliminaciones, asignaciones de sesión).
Pedido: Eventos de creación, modificación y cierre de pedidos.
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.