Bitacora de eventos

ModuloAtajos y herramientas

Perfil sugeridoCoordinacion / Administracion

PermisoAccion `SHOW_LOGS` (ver bitacora) y `SHOW_ALL_LOGS` (ver registros de todos los usuarios)

EstadoValidado

Objetivo

Consultar el registro historico de acciones realizadas en el sistema, filtrado por usuario y por rango de fechas, para auditar la operacion o investigar movimientos especificos.

Que es esta herramienta

Es un registro automatico que el sistema guarda cada vez que un usuario realiza una accion relevante: confirmar una cita, abrir o cerrar la caja, registrar un cobro, editar un paciente, etc. La bitacora se consulta desde una ventana y permite buscar por texto, filtrar por usuario y por rango de fechas.

No todas las acciones del sistema se registran, solo las que tienen impacto operativo (crear, modificar, eliminar, cobrar, abrir caja, etc.). Acciones como navegar entre pantallas no aparecen.

Donde se encuentra

La bitacora no tiene una ruta propia. Se abre como una ventana desde tres puntos:

1. Pie del menu lateral: boton "Ver bitacora" al final del sidebar. Solo aparece si tienes la accion SHOW_LOGS.
2. Spotlight: al seleccionar un usuario y elegir "Ver bitacora". Abre la bitacora filtrada por ese usuario.
3. Drawer de Mi perfil: la seccion "Actividad" muestra los 5 registros mas recientes del propio usuario (modo lectura, sin filtros).

Antes de empezar

• Tener la sesion iniciada.
• Tener la accion SHOW_LOGS habilitada (sino, el boton no aparece y se muestra un aviso al intentar abrir).
• Si quieres ver registros de otros usuarios, necesitas ademas la accion SHOW_ALL_LOGS.

Como abrir la bitacora

Desde el menu lateral

1. En el menu lateral, bajar hasta el pie de pagina.
2. Pulsar el boton "Ver bitacora".
3. Se abre la ventana Bitacora de Eventos.

Desde Spotlight

1. Abrir Spotlight con Ctrl + K o con el boton de lupa en la barra superior.
2. Escribir el nombre del usuario.
3. Pulsar Enter sobre el resultado.
4. En la sub-ventana del usuario, pulsar Ver Bitacora.
5. El sistema navega a la ficha del usuario con la bitacora filtrada por ese usuario.

Desde Mi perfil

1. Abrir el drawer Mi perfil (icono de engranaje al pie del menu lateral).
2. Bajar a la seccion Actividad.
3. La lista muestra los 5 registros mas recientes del propio usuario (modo lectura).

Como se ve la ventana

La ventana "Bitacora de Eventos" tiene tres partes:

Filtros (en la parte superior)

• Buscar: caja de texto libre. Filtra el contenido del campo "Registro". El sistema espera medio segundo despues de la ultima tecla para aplicar el filtro.
• Usuarios: selector multiple con check. Permite elegir uno o varios usuarios. Si no tienes la accion SHOW_ALL_LOGS, el selector esta deshabilitado y solo muestra tu propio usuario.
• Rango de fechas: selector de rango (dos calendarios en uno). Permite elegir fecha de inicio y fecha de fin, ambas opcionales. Tiene un boton para limpiar el rango.

Tabla de resultados

Tres columnas:

Columna	Que muestra
Usuario	Avatar y nombre de quien realizo la accion. Si la cuenta existio pero sus datos fueron borrados, aparece "Usuario sin nombre".
Registro	Texto descriptivo de la accion. Ejemplos: "Cita confirmada para Maria Lopez", "Caja abierta por Juan".
Fecha / Hora	Fecha y hora en que ocurrio la accion, en formato dia/mes/ano, hora:minuto (por ejemplo "11/06/2026, 03:45 p.m.").

Paginador (en la parte inferior)

• Muestra 10 registros por pagina (se puede cambiar a 5 o 20).
• Permite navegar entre paginas con flechas o el campo "Pagina N".
• Cada cambio de pagina o de filtro recarga los resultados.

Como buscar registros

1. Abrir la bitacora desde el menu lateral.
2. En el campo Buscar, escribir cualquier texto: parte del mensaje, nombre del paciente, monto, etc.
3. La tabla se actualiza automaticamente despues de medio segundo.

Como filtrar por usuario

1. Pulsar el campo Usuarios.
2. En el buscador del menu desplegable, escribir el nombre del usuario.
3. Marcar la casilla del usuario (o usuarios) que quieras incluir.
4. Cerrar el menu.
5. La tabla se recarga con los registros de los usuarios seleccionados.

Si no tienes la accion SHOW_ALL_LOGS, el selector aparece gris y muestra el mensaje "Solo puedes ver tus propios logs". No podras agregar otros usuarios al filtro.

Como filtrar por rango de fechas

1. Pulsar el campo Rango de fechas.
2. En el calendario, seleccionar la fecha de inicio del rango.
3. En el mismo calendario, seleccionar la fecha de fin del rango.
4. Pulsar Aceptar o el icono de check.
5. La tabla se recarga con los registros dentro del rango (incluyendo los dos extremos).
6. Para limpiar el rango, pulsar la X del campo o usar el boton "Limpiar" del propio calendario.

Como funciona la paginacion

• La tabla carga 10 registros por pagina por defecto.
• Para cambiar la cantidad, usar el selector de filas por pagina en la parte inferior (opciones 5, 10 o 20).
• Para avanzar, usar las flechas del paginador o escribir el numero de pagina deseado.
• Cada cambio de pagina o de filtro dispara una nueva consulta al sistema.

Diferencia entre ver mis registros y ver registros de otros usuarios

Permiso	Que puedes hacer
SHOW_LOGS solamente	Abrir la bitacora, pero solo ver tus propios registros. El selector de usuarios esta deshabilitado.
SHOW_LOGS + SHOW_ALL_LOGS	Abrir la bitacora y filtrar por cualquier usuario. El selector de usuarios esta habilitado.

Casos comunes que aparecen en la bitacora

• Inicio de sesion: cuando un usuario entra al sistema.
• Apertura de caja: cuando alguien abre un turno de caja.
• Cierre de caja: cuando alguien cierra un turno de caja.
• Cobros: cuando se registra un cobro a un paciente.
• Cierre de consulta: cuando un medico termina la consulta de un paciente.
• Altas, ediciones y bajas de pacientes, medicos, usuarios, servicios, planes y catalogos.
• Cambios de estado de citas (confirmar, reagendar, cancelar, mover a consulta, etc.).

Estados o mensajes importantes

Estado	Que pasa
Cargando	La tabla muestra filas placeholder mientras consulta
Sin resultados	Mensaje "No se encontraron registros" en el area de la tabla
Rango de fechas invalido	Aviso de error dentro del propio calendario
Sin permiso SHOW_LOGS	Toast avisando que no tienes permiso y la ventana no se abre
Solo permiso SHOW_LOGS (sin SHOW_ALL_LOGS)	Selector de usuarios deshabilitado, solo se ven tus propios registros

Errores comunes

Situacion	Que hacer
No aparecen resultados	Verificar que el rango de fechas incluya registros y que el texto de busqueda no sea demasiado especifico.
El selector de usuarios esta deshabilitado	No tienes SHOW_ALL_LOGS. Solo puedes ver tus propios registros.
La accion que busco no aparece en la tabla	La accion puede no estar instrumentada. Si la necesitas, pedir al equipo tecnico que la agregue al registro.
La ventana se cierra al intentar abrir	No tienes SHOW_LOGS. Aparece un toast avisando.
La fecha aparece en formato distinto al esperado	La zona horaria puede ser del servidor. Verificar la configuracion regional del navegador.
El "Registro" dice "Usuario sin nombre"	La cuenta existio pero sus datos personales fueron borrados o anonimizados.

Permisos sugeridos

Perfil	Permisos
Usuario estandar	SHOW_LOGS (solo ve sus propios registros)
Coordinacion	SHOW_LOGS + SHOW_ALL_LOGS (ve registros de todos)
Administracion	SHOW_LOGS + SHOW_ALL_LOGS

La accion SHOW_LOGS controla el boton del menu lateral. La accion SHOW_ALL_LOGS controla el selector de usuarios. Son independientes.

Recomendaciones operativas

• Auditar periodicamente las acciones de apertura y cierre de caja para validar consistencia con el corte.
• En caso de incidente, acotar primero por rango de fechas y luego por usuario.
• Si la aplicacion lo permite, exportar a CSV los registros relevantes para anexarlos a un reporte de auditoria.

Relacion con otros modulos

• Usuarios y permisos: los logs identifican al usuario que realizo la accion.
• Notificaciones: algunas acciones que aparecen en la bitacora tambien disparan notificaciones. La bitacora es mas exhaustiva: incluye acciones de administracion.
• Caja: los logs de apertura, cierre y cobros permiten auditar el efectivo.
• Agenda: los logs de inicio, fin y movimientos de consulta permiten reconstruir el flujo del dia.
• Mi perfil: la seccion "Actividad" muestra los ultimos 5 registros del propio usuario.