Logs de Auditoría - Raul125/PanelWiki GitHub Wiki
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.
-
Ruta:
/admin/slactionlogs
- Menú lateral: Panel de Moderación → Logs de Auditoría
- Icono: 📋 ManageAccounts
- Autenticación obligatoria → Usuario debe estar logueado
-
Permisos específicos →
Permissions.Admin.Users
- Rol administrativo → Acceso de nivel superior
- Solo administradores pueden acceder
- Moderadores básicos no tienen acceso
- Información sensible protegida por permisos
El sistema incluye un panel completo de filtros que permite búsquedas precisas y análisis detallado de la actividad moderativa.
- 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
- 🔴 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
- 🟡 Advertencia creada → Nueva advertencia aplicada
- 🔵 Advertencia editada → Modificación de warn
- 🟢 Advertencia removida → Advertencia retirada
- 🔴 Mute creado → Nuevo silenciamiento aplicado
- 🟡 Mute editado → Modificación de mute existente
- 🟢 Mute removido → Silenciamiento levantado
- 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
- 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
- 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
- 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
- 📅 Ú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 parcial → Case-insensitive
- Múltiples campos → Details, OldReason, NewReason
- Tiempo real → Resultados inmediatos
- Campo limpiable → Botón X para limpiar
- ID → Identificador único del log
- Acción → Tipo de acción realizada (chip coloreado)
- Entidad → Tipo de entidad afectada (chip azul)
- Realizado por → Staff que ejecutó la acción (con avatar)
- Usuario afectado → Jugador que recibió la acción (con avatar)
- Fecha → Cuándo se realizó la acción (con tooltip detallado)
- Detalles → Botón para ver información completa
- 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
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)
- 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
- Botón refresh → Actualización manual
- Indicador de carga → Durante operaciones
- Notificación de éxito → Confirmación de actualización
- Estado deshabilitado → Mientras carga
- Ban creado → Nueva sanción severa
- Mute creado → Nuevo silenciamiento
- Ban editado → Cambios en sanción existente
- Warn creado → Nueva advertencia
- Mute editado → Cambios en silenciamiento
- Ban removido → Sanción levantada
- Warn removida → Advertencia retirada
- Mute removido → Silenciamiento levantado
- Ban eliminado → Borrado completo del registro
- Warn editada → Modificación de advertencia
- Entidades → Todos los tipos de entidad
- 🟣 Avatar secundario → Cuando no hay imagen
- 🔗 Enlaces azules → Navegación a perfiles
- ⚪ Avatar predeterminado → Usuario desconocido
Cuando se hace clic en "Ver detalles", se abre un diálogo con información exhaustiva:
- 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
- Staff ejecutor → Nombre, avatar, enlace a perfil
- Usuario afectado → Nombre, avatar, enlace a perfil
- Roles y permisos → Contexto de autorización
- 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
- 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
- CancellationToken → Cancelación de operaciones largas
- Debounce inteligente → Evita consultas excesivas
- Query optimizada → Filtros aplicados en BD
- Proyección eficiente → Solo campos necesarios
- DbContext factory → Conexiones eficientes
- Using statements → Liberación automática
- Dispose pattern → Limpieza de timers y tokens
- Memory management → Prevención de memory leaks
- Debounce timer → 500ms para filtros
- Timeout handling → Para operaciones largas
- Cancellation tokens → Cancelación limpia
- Resource cleanup → Al desmontar componente
- Filtrar por fecha → Día del incidente
- Filtrar por usuario afectado → Jugador involucrado
- Revisar cronología → Orden por fecha
- Ver detalles completos → Clic en botón detalles
- Seguir enlaces → Perfiles relacionados
- Filtrar por "Realizado por" → Staff específico
- Filtrar por tipo de acción → Bans, warns, etc.
- Revisar patrones → Frecuencia y consistencia
- Analizar decisiones → Razones y contexto
- Filtro de rango amplio → Último mes/trimestre
- Ordenar por fecha → Ver evolución temporal
- Filtrar por tipo → Analizar tipos de sanciones
- Estadísticas → Patrones en la moderación
- Filtrar por usuario afectado → Jugador específico
- Ver historial completo → Todas las acciones
- Analizar escalada → Progresión de sanciones
- Contexto de decisiones → Razones detalladas
- Revisar acciones recientes → Últimos días
- Verificar consistencia → Criterios aplicados
- Identificar errores → Acciones incorrectas
- Supervisar staff nuevo → Control de aprendizaje
- Acceso a información completa → Trazabilidad total
- Verificación de procesos → Cumplimiento de protocolos
- Resolución de apelaciones → Evidencia documentada
- Mejora de procesos → Basada en datos históricos
- Verificar filtros → Pueden estar muy restrictivos
- Revisar permisos → Acceso de administrador
- Limpiar filtros → Botón "Reiniciar"
- Verificar fechas → Rango de fechas válido
- 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
- Esperar debounce → 500ms de retraso
- Verificar campos → Texto correcto
- Limpiar y reaplicar → Reiniciar filtros
- Refrescar página → Si persiste el problema
- 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
- Cerrar diálogos → Liberar memoria
- No abrir múltiples ventanas → Del mismo sistema
- Refrescar cuando necesario → No automático excesivo
- Panel de Moderación - Centro de control para staff
- Crear Ban - Las acciones registradas en logs
- Crear Warn - Advertencias registradas automáticamente
- Crear Mute - Silenciamientos en el historial
- Revocar Sanciones - Revocaciones registradas en logs
- Editar Sanciones - Modificaciones registradas
- Gestión de Reportes - Acciones sobre reportes
- Perfiles de Jugadores - Usuarios mencionados en logs
- Canal Staff Discord → [discord.neoncommunity.eu](https://discord.neoncommunity.eu/)
-
Documentación técnica →
/swagger
para desarrolladores - Issues GitHub → Reportar problemas del sistema
- Nuevos filtros → Proponer en Discord staff
- Mejoras de interfaz → Feedback sobre usabilidad
- Optimizaciones → Ideas para mejorar rendimiento
- Nuevas funcionalidades → Análisis adicionales
- 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