HandyCafe Docs
owner

Registros

La pagina de Registros proporciona una pista de auditoria completa de todos los eventos del sistema en HandyCafe. Cada accion significativa, desde inicios de sesion hasta accesos de cajeros, se registra aqui para rendicion de cuentas, solucion 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 mas de 1,000 registros sin degradacion de la interfaz.

Campos de la entrada de registro

Cada entrada de registro contiene los siguientes campos:

Campo Descripcion
Marca de tiempo Fecha y hora en que ocurrio el evento
Origen El componente del sistema que genero el evento
Categoria Clasificacion del evento (ver categorias abajo)
Accion Tipo de accion especifico (ver acciones comunes abajo)
PC El PC cliente o consola involucrado, si aplica
IP Direccion IP asociada al evento
Miembro El miembro involucrado, si aplica
Cajero El cajero que activo o estaba de turno durante el evento
Mensaje Descripcion legible de lo que sucedio

Categorias de registro

Los eventos se clasifican en 8 categorias:

  1. Servidor: Inicio, apagado del servidor, cambios de configuracion y eventos a nivel de sistema.
  2. Cliente: Conexiones, desconexiones y cambios de estado de clientes.
  3. Cajero: Inicio de sesion, cierre de sesion y acciones administrativas del cajero.
  4. Miembro: Registro de miembros, actualizaciones de perfil y cambios de cuenta.
  5. Sesion: Eventos del ciclo de vida de sesiones (inicio, fin, pausa, reanudacion).
  6. Consola: Eventos relacionados con consolas (adiciones, eliminaciones, asignaciones de sesion).
  7. Pedido: Eventos de creacion, modificacion 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 inicio una nueva sesion en un cliente o consola.
  • stopSession: Se finalizo una sesion activa.
  • pauseSession: Se pauso una sesion en curso.
  • resumeSession: Se reanudo una sesion pausada.
  • consoleAdded: Se registro una nueva consola de juego en el sistema.
  • newMemberAdded: Se creo una nueva cuenta de miembro.
  • orderCreated: Se creo un nuevo pedido de productos.
  • orderClosed: Se completo y cerro un pedido.
  • cashierLogin: Un cajero inicio sesion en el sistema.
  • cashierLogout: Un cajero cerro sesion.
  • serverStarted: Se inicio la aplicacion HandyCafe Server.
  • clientConnected: Un PC cliente establecio conexion con el servidor.
  • clientDisconnected: Un PC cliente se desconecto del servidor.

Filtrado y busqueda

Filtro por categoria

Seleccione una o mas categorias para limitar la visualizacion del registro. Por ejemplo, muestre solo eventos de Sesion y Pago para auditar la actividad financiera.

Filtro por accion

Filtre por tipos de accion especificos para encontrar eventos particulares rapidamente.

Filtro por rango de fechas

Restrinja la vista del registro a un periodo de tiempo especifico. Combinado con otros filtros, esto facilita la investigacion 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 (mas reciente primero) es el predeterminado.

Busqueda de texto

Un cuadro de busqueda de texto libre que busca en todos los campos, permitiendo buscar un nombre de equipo especifico, direccion IP, nombre de miembro o cualquier palabra clave en los mensajes del registro.

Permisos

El acceso a la pagina de Registros esta controlado por los siguientes permisos:

Permiso Descripcion
LOG_VIEW Requerido para acceder a la pagina de Registros
LOG_DISPLAY_FULL Permite ver el historial completo de registros
LOG_DISPLAY_TODAY Restringe la vista solo a las entradas del dia de hoy
LOG_DELETE Permite eliminar entradas del registro

Un cajero con LOG_VIEW y LOG_DISPLAY_TODAY puede revisar los eventos del dia pero no puede acceder a datos historicos. Solo los usuarios con LOG_DISPLAY_FULL pueden explorar el archivo completo de registros.

Actualizaciones en tiempo real

Los nuevos eventos de registro aparecen automaticamente en el visor a medida que ocurren. El sistema escucha eventos de registro a traves de la conexion de eventos TCP por lo que no es necesario recargar la pagina manualmente. Un cache de registros mejora el rendimiento reduciendo las consultas repetidas a la base de datos al desplazarse por las entradas recientes.