Logs de Auditoría - Raul125/PanelWiki GitHub Wiki

📋 Logs de Auditoría

El sistema de logs de auditoría (SL Action Logs) registra automáticamente todas las acciones administrativas realizadas por moderadores y administradores en el servidor. Esta herramienta proporciona trazabilidad completa, transparencia y control sobre las decisiones moderativas tomadas en la comunidad.


🌐 Acceso a Logs de Auditoría

📍 Navegación

  • Ruta: /admin/slactionlogs
  • Menú lateral: Panel de Moderación → Logs de Auditoría
  • Icono: 📋 ManageAccounts

🔐 Requisitos de Acceso

  • Autenticación obligatoria → Usuario debe estar logueado
  • Permisos específicosPermissions.Admin.Users
  • Rol administrativo → Acceso de nivel superior

🚫 Restricciones

  • Solo administradores pueden acceder
  • Moderadores básicos no tienen acceso
  • Información sensible protegida por permisos

🎯 Funcionalidades Principales

📊 Sistema de Filtrado Avanzado

El sistema incluye un panel completo de filtros que permite búsquedas precisas y análisis detallado de la actividad moderativa.

🔍 Panel de Filtros

  • Diseño en tarjeta → Interfaz clara y organizada
  • Reinicio rápido → Botón para limpiar todos los filtros
  • Indicador de estado → Muestra si hay filtros activos
  • Aplicación automática → Debounce de 500ms para optimización

🎛️ Tipos de Filtros Disponibles

🎭 Filtro por Tipo de Acción

📋 Acciones de Baneos

  • 🔴 Ban creado → Nueva sanción aplicada
  • 🟡 Ban editado → Modificación de ban existente
  • 🟢 Ban removido → Sanción levantada/revocada
  • ⚫ Ban eliminado → Borrado completo del registro

⚠️ Acciones de Advertencias

  • 🟡 Advertencia creada → Nueva advertencia aplicada
  • 🔵 Advertencia editada → Modificación de warn
  • 🟢 Advertencia removida → Advertencia retirada

🔇 Acciones de Silenciamientos

  • 🔴 Mute creado → Nuevo silenciamiento aplicado
  • 🟡 Mute editado → Modificación de mute existente
  • 🟢 Mute removido → Silenciamiento levantado

🏷️ Filtro por Tipo de Entidad

📊 Entidades del Sistema

  • Ban → Acciones relacionadas con baneos
  • Warn → Acciones relacionadas con advertencias
  • Mute → Acciones relacionadas con silenciamientos
  • User → Acciones relacionadas con usuarios
  • Report → Acciones relacionadas con reportes

👤 Filtro por Usuario (Autocomplete)

🔍 Realizado por

  • Búsqueda inteligente → Busca en nombres de staff
  • Avatar incluido → Identificación visual
  • Solo usuarios activos → Que han realizado acciones
  • Límite de resultados → Máximo 10 sugerencias

🎯 Usuario Afectado

  • Búsqueda inteligente → Busca en usuarios sancionados
  • Avatar incluido → Identificación visual
  • Solo usuarios relevantes → Que han recibido acciones
  • Límite de resultados → Máximo 10 sugerencias

📅 Filtro por Rango de Fechas

📊 Selector de Rango

  • Calendario interactivo → Interfaz visual para selección
  • Formato DD/MM/YYYY → Formato español
  • AutoClose → Se cierra automáticamente al seleccionar
  • Editable → Permite escritura manual

⚡ Atajos Rápidos

  • 📅 Última semana → Últimos 7 días
  • 📅 Último mes → Últimos 30 días
  • 📅 Último trimestre → Últimos 90 días
  • 🗑️ Limpiar → Remover filtro de fecha

🔍 Búsqueda en Texto

📝 Búsqueda en Detalles

  • Búsqueda parcial → Case-insensitive
  • Múltiples campos → Details, OldReason, NewReason
  • Tiempo real → Resultados inmediatos
  • Campo limpiable → Botón X para limpiar

📊 Tabla de Logs

📋 Información Mostrada

🔢 Columnas Principales

  1. ID → Identificador único del log
  2. Acción → Tipo de acción realizada (chip coloreado)
  3. Entidad → Tipo de entidad afectada (chip azul)
  4. Realizado por → Staff que ejecutó la acción (con avatar)
  5. Usuario afectado → Jugador que recibió la acción (con avatar)
  6. Fecha → Cuándo se realizó la acción (con tooltip detallado)
  7. Detalles → Botón para ver información completa

🎨 Elementos Visuales

  • Chips coloreados → Por tipo de acción
  • Avatares de usuarios → Identificación visual
  • Enlaces a perfiles → Navegación directa
  • Tooltips informativos → Fechas completas
  • Iconos descriptivos → Para cada tipo de acción

🎯 Funcionalidades de Tabla

📊 Ordenamiento Inteligente

Columnas ordenables:

  • ID → Numérico ascendente/descendente
  • Tipo de acción → Alfabético por tipo
  • Tipo de entidad → Alfabético por entidad
  • Realizado por → Por nombre de usuario
  • Usuario afectado → Por nombre afectado
  • Fecha → Cronológico (predeterminado: más reciente primero)

📄 Paginación Avanzada

  • Opciones múltiples → 10, 25, 50, 100 registros por página
  • Navegación fluida → Botones de página
  • Información contextual → Total de registros mostrado
  • Persistencia → Mantiene página al filtrar

🔄 Actualización de Datos

  • Botón refresh → Actualización manual
  • Indicador de carga → Durante operaciones
  • Notificación de éxito → Confirmación de actualización
  • Estado deshabilitado → Mientras carga

🎨 Código de Colores del Sistema

🚦 Por Tipo de Acción

🔴 Acciones Restrictivas (Rojo)

  • Ban creado → Nueva sanción severa
  • Mute creado → Nuevo silenciamiento

🟡 Acciones de Modificación (Amarillo)

  • Ban editado → Cambios en sanción existente
  • Warn creado → Nueva advertencia
  • Mute editado → Cambios en silenciamiento

🟢 Acciones de Alivio (Verde)

  • Ban removido → Sanción levantada
  • Warn removida → Advertencia retirada
  • Mute removido → Silenciamiento levantado

⚫ Acciones de Eliminación (Negro)

  • Ban eliminado → Borrado completo del registro

🔵 Acciones de Información (Azul)

  • Warn editada → Modificación de advertencia
  • Entidades → Todos los tipos de entidad

👤 Elementos de Usuario

  • 🟣 Avatar secundario → Cuando no hay imagen
  • 🔗 Enlaces azules → Navegación a perfiles
  • ⚪ Avatar predeterminado → Usuario desconocido

🔍 Diálogo de Detalles

📋 Información Completa

Cuando se hace clic en "Ver detalles", se abre un diálogo con información exhaustiva:

📊 Datos Principales

  • ID único → Identificador del log
  • Tipo de acción → Descripción completa
  • Entidad afectada → Tipo y ID de entidad
  • Fecha y hora exacta → Timestamp completo

👥 Información de Usuarios

  • Staff ejecutor → Nombre, avatar, enlace a perfil
  • Usuario afectado → Nombre, avatar, enlace a perfil
  • Roles y permisos → Contexto de autorización

📝 Detalles Específicos

  • Razón anterior → Estado antes del cambio
  • Razón nueva → Estado después del cambio
  • Detalles adicionales → Información contextual
  • Metadatos → Información técnica

⚡ Optimización y Rendimiento

🔄 Carga Eficiente de Datos

📊 Técnicas de Optimización

  • AsNoTracking → Sin seguimiento de cambios de EF
  • Eager Loading optimizado → Include solo lo necesario
  • AsSplitQuery → Mejora rendimiento con múltiples includes
  • Paginación server-side → Solo datos necesarios

🚀 Gestión de Consultas

  • CancellationToken → Cancelación de operaciones largas
  • Debounce inteligente → Evita consultas excesivas
  • Query optimizada → Filtros aplicados en BD
  • Proyección eficiente → Solo campos necesarios

💾 Gestión de Memoria

🔧 Liberación de Recursos

  • DbContext factory → Conexiones eficientes
  • Using statements → Liberación automática
  • Dispose pattern → Limpieza de timers y tokens
  • Memory management → Prevención de memory leaks

⏱️ Control de Tiempo

  • Debounce timer → 500ms para filtros
  • Timeout handling → Para operaciones largas
  • Cancellation tokens → Cancelación limpia
  • Resource cleanup → Al desmontar componente

🎯 Casos de Uso Comunes

🔍 Investigación de Incidentes

📋 Análisis de Acción Específica

  1. Filtrar por fecha → Día del incidente
  2. Filtrar por usuario afectado → Jugador involucrado
  3. Revisar cronología → Orden por fecha
  4. Ver detalles completos → Clic en botón detalles
  5. Seguir enlaces → Perfiles relacionados

👮 Revisión de Staff

  1. Filtrar por "Realizado por" → Staff específico
  2. Filtrar por tipo de acción → Bans, warns, etc.
  3. Revisar patrones → Frecuencia y consistencia
  4. Analizar decisiones → Razones y contexto

📊 Análisis de Tendencias

📈 Actividad Moderativa

  1. Filtro de rango amplio → Último mes/trimestre
  2. Ordenar por fecha → Ver evolución temporal
  3. Filtrar por tipo → Analizar tipos de sanciones
  4. Estadísticas → Patrones en la moderación

🎯 Usuarios Problemáticos

  1. Filtrar por usuario afectado → Jugador específico
  2. Ver historial completo → Todas las acciones
  3. Analizar escalada → Progresión de sanciones
  4. Contexto de decisiones → Razones detalladas

⚖️ Auditoría y Supervisión

📋 Control de Calidad

  1. Revisar acciones recientes → Últimos días
  2. Verificar consistencia → Criterios aplicados
  3. Identificar errores → Acciones incorrectas
  4. Supervisar staff nuevo → Control de aprendizaje

📊 Transparencia Administrativa

  1. Acceso a información completa → Trazabilidad total
  2. Verificación de procesos → Cumplimiento de protocolos
  3. Resolución de apelaciones → Evidencia documentada
  4. Mejora de procesos → Basada en datos históricos

🚨 Solución de Problemas

❌ Problemas Comunes

🔍 No Aparecen Registros

  • Verificar filtros → Pueden estar muy restrictivos
  • Revisar permisos → Acceso de administrador
  • Limpiar filtros → Botón "Reiniciar"
  • Verificar fechas → Rango de fechas válido

⚡ Carga Lenta

  • Reducir rango de fechas → Períodos más cortos
  • Usar filtros específicos → Menos datos
  • Reducir elementos por página → 10-25 registros
  • Verificar conexión → Red y base de datos

🔄 Filtros No Funcionan

  • Esperar debounce → 500ms de retraso
  • Verificar campos → Texto correcto
  • Limpiar y reaplicar → Reiniciar filtros
  • Refrescar página → Si persiste el problema

⚡ Optimización de Consultas

🚀 Mejores Prácticas

  • Usar filtros específicos → Reducir conjunto de datos
  • Ordenar por fecha → Más eficiente como default
  • Páginas pequeñas → 10-25 registros
  • Evitar búsquedas muy amplias → Términos específicos

💾 Gestión de Recursos

  • Cerrar diálogos → Liberar memoria
  • No abrir múltiples ventanas → Del mismo sistema
  • Refrescar cuando necesario → No automático excesivo

🔗 Enlaces Relacionados


📞 Soporte y Ayuda

🆘 Obtener Ayuda

💡 Sugerencias de Mejora

  • Nuevos filtros → Proponer en Discord staff
  • Mejoras de interfaz → Feedback sobre usabilidad
  • Optimizaciones → Ideas para mejorar rendimiento
  • Nuevas funcionalidades → Análisis adicionales

📋 Información Técnica

  • Modelo de datos → Estructura de logs
  • Permisos requeridos → Sistema de autorización
  • API endpoints → Para integraciones externas

📋 Transparencia Total, Control Absoluto

¿Necesitas ayuda con los logs de auditoría? Consulta en el canal staff de [Discord](https://discord.neoncommunity.eu/) o revisa Panel de Moderación

⚠️ **GitHub.com Fallback** ⚠️