Buscar en la documentación

Consultar la auditoría

Las dos pestañas de la auditoría global, quién ve cada una, el alcance por jerarquía y la paginación por cursor.

1 min de lecturaVer en GitHub

La pantalla “Auditoría” tiene dos pestañas que nunca se mezclan en una misma consulta:

  • Incidentes (audit.incidents.view, Supervisor y Super admin): todo el historial de incident_activities, incluidos los incidentes eliminados.
  • Administración (audit.admin.view, Administrador y Super admin): admin_actions, es decir, cuentas, roles, exportaciones y acciones de sistema.

Es de solo lectura: nadie puede editar ni borrar un registro.

Diagrama4 carriles · 8 pasos · 2 salidas de error
IncidentesAdministraciónSíNoSíNoAbre Auditoría yfiltra1¿Qué pestañapuede ver?2¿Tieneaudit.incidents.view?3Responde 403¿Tieneaudit.admin.view?4Responde 403Aplica el alcancepor jerarquía5Fija el rango defechas6Lee una página porcursor7Muestra filas y"Cargar más"8
Los números coinciden con el paso a paso. En pantallas pequeñas el diagrama se desliza de lado.

Paso a paso

  1. PersonaAbre Auditoría y filtra

    Rango de fechas (30 días por defecto), quién hizo el cambio, tipo, incidente (26-0142) o persona o rol afectado. Los filtros quedan en la dirección. "Ver su actividad" en la ficha de una persona abre esta pantalla ya filtrada.

  2. Navegador¿Qué pestaña puede ver?

    Si entra a /auditoria sin elegir, va a la primera que su permiso le deja ver.

  3. API¿Tiene audit.incidents.view?
  4. API¿Tiene audit.admin.view?
  5. APIAplica el alcance por jerarquía

    El Super admin ve todo. Los demás ven sus propias acciones y las que tocan a una persona o un rol de un nivel menor al suyo (nivel de hoy).

  6. APIFija el rango de fechas

    Sin fechas, los últimos 30 días; con solo el final, los 30 anteriores; con solo el inicio, hasta ahora. Ninguna consulta recorre toda la tabla sin querer. El rango aplicado vuelve en meta.

  7. Base de datosLee una página por cursor

    Cursor = fecha + id (en base64), y una fila de más para saber si hay otra página, sin contar el total. Medido sobre unas 523.000 filas: menos de 2 ms.

  8. NavegadorMuestra filas y "Cargar más"

    Fecha, quién, qué, sobre qué y resumen del cambio. El detalle muestra todo, más IP y navegador, con enlaces al incidente o a la ficha si quien mira puede abrirlos.

Qué ve la persona en cada error

CódigoHTTPCuándoMensaje en pantalla
INVALID_CURSOR422El cursor de “Cargar más” está dañadoNo pudimos seguir cargando la lista. Vuelve a cargarla desde el principio.
INCIDENT_CODE_FORMAT422El filtro de incidente no tiene forma de códigoEscribe el código del incidente con su año, por ejemplo 26-0142.
FORBIDDEN_ACTION403Sin el permiso de esa pestañaNo tienes permiso para hacer esta acción. Si crees que deberías tenerlo, habla con un administrador.

Dónde está en el código