Perfiles de Jugadores - Raul125/PanelWiki GitHub Wiki

👤 Perfiles de Jugadores

El sistema de perfiles de jugadores permite a los moderadores consultar información detallada de todos los usuarios registrados en los servidores de SCP:SL. Esta herramienta centraliza datos de actividad, estadísticas, sanciones y comportamiento para facilitar la toma de decisiones moderativas.


🌐 Acceso a Perfiles de Jugadores

📍 Navegación

  • Ruta: /scpsl/players
  • Menú lateral: Panel de Moderación → Perfiles de Jugadores
  • Icono: 👥 People

🔐 Requisitos de Acceso

  • Autenticación obligatoria → Usuario debe estar logueado
  • Permisos específicosPermissions.ScpSl.Users
  • Rol de Staff → Autorización de moderación

🚫 Restricciones

  • Solo staff autorizado puede acceder
  • Usuarios normales no pueden ver esta sección
  • Datos sensibles protegidos según privacidad del usuario

🎯 Vista General del Sistema

📊 Panel Principal

🔍 Barra de Búsqueda Avanzada

  • Campo de búsqueda → Por nombre de usuario o ID
  • Búsqueda en tiempo real → Debounce de 300ms
  • Múltiples criterios → Nombre, ID de usuario, ID único
  • Highlighting → Resalta términos encontrados

🎛️ Controles de Filtrado

Dos switches principales:

  1. 🟢 Jugadores Activos

    • Badge dinámico → Contador en tiempo real
    • Criterio → Última conexión dentro de 7 días
    • Color → Verde (Success)
    • Función → Filtrar solo usuarios recientes
  2. 🔴 Con Sanciones

    • Badge dinámico → Contador de usuarios sancionados
    • Criterio → Tienen bans, warns o mutes
    • Color → Rojo (Error)
    • Función → Identificar usuarios problemáticos

🔄 Actualización de Datos

  • Botón Refresh → Actualización manual
  • Timestamp → Hora de última actualización
  • Feedback visual → Notificación de éxito
  • Loader → Indicador durante la carga

📋 Tabla de Jugadores

📊 Columnas de Información

👤 Nombre del Jugador

  • Avatar del usuario → Imagen de Discord si está disponible
  • Inicial como fallback → Primera letra del nombre
  • Link al perfil → Navegación directa
  • Highlighting → Resalta términos de búsqueda

🔗 ID del Usuario

  • ID único del jugador → Identificador del sistema
  • Fuente monoespaciada → Mejor legibilidad
  • Highlighting → Resalta en búsquedas
  • Formato{userId}@neon para búsquedas

⏰ Última Conexión

  • Tiempo relativo → "hace X días/horas"
  • Tooltip detallado → Fecha y hora exacta
  • Indicador de color → Según actividad reciente
    • 🟢 < 1 día → Verde (Success)
    • 🔵 < 7 días → Azul (Info)
    • 🟡 < 30 días → Amarillo (Warning)
    • 🔴 > 30 días → Rojo (Error)

📅 Primera Conexión

  • Tiempo relativo → "hace X días/meses"
  • Tooltip detallado → Fecha de registro
  • Icono calendario → Identificación visual
  • Historial → Antigüedad en la comunidad

🔒 Configuración de Privacidad

  • Icono visual → Ojo abierto/cerrado
  • Tooltip explicativo → Estado de privacidad
  • Colores distintivos:
    • 🟡 DoNotTrack activado → Warning
    • 🟢 Privacidad normal → Success

⚖️ Estado de Sanciones

Chips informativos por tipo:

  • 🔴 Bans → Chip rojo con contador
  • 🟡 Mutes → Chip amarillo con contador
  • 🔵 Warns → Chip azul con contador
  • 🟢 Sin sanciones → "Perfecto" en verde
  • Tooltip detallado → Desglose de sanciones activas/históricas

⏱️ Tiempo de Juego

  • Barra de progreso → Visual del tiempo acumulado
  • Texto formateado → Días, horas o minutos
  • Colores por nivel:
    • < 1 hora → Gris (Default)
    • 🔵 < 10 horas → Azul (Info)
    • 🟣 < 100 horas → Morado (Primary)
    • 🟡 < 500 horas → Amarillo (Warning)
    • 🔴 500+ horas → Rojo (Error)
  • Tooltip completo → Estadísticas detalladas

🎯 Acciones

  • Botón Ver Perfil → Icono AccountCircle
  • Navegación directa → A perfil individual
  • Tooltip informativo → "Ver perfil completo"

🎨 Características Visuales

🌈 Código de Colores del Sistema

🚦 Por Estado de Actividad

  • 🟢 Verde → Usuario muy activo (< 1 día)
  • 🔵 Azul → Usuario activo (< 7 días)
  • 🟡 Amarillo → Usuario inactivo (< 30 días)
  • 🔴 Rojo → Usuario muy inactivo (> 30 días)

⚖️ Por Estado de Sanciones

  • 🔴 Rojo → Bans activos/históricos
  • 🟡 Amarillo → Mutes activos/históricos
  • 🔵 Azul → Advertencias (warns)
  • 🟢 Verde → Sin sanciones (usuario perfecto)

📊 Por Nivel de Experiencia

  • ⚪ Gris → Nuevos jugadores (< 1h)
  • 🔵 Azul → Principiantes (< 10h)
  • 🟣 Morado → Jugadores regulares (< 100h)
  • 🟡 Amarillo → Veteranos (< 500h)
  • 🔴 Rojo → Expertos (500h+)

🎭 Efectos Visuales

📱 Responsividad

  • Breakpoint Sm → Adaptación para móviles
  • Vista compacta/normal → Toggle disponible
  • Columnas adaptables → Reorganización automática
  • Tabla striped → Mejor legibilidad

🎯 Resaltado de Filas

  • Usuarios baneados → Fondo rojo transparente
  • Usuarios muteados → Fondo amarillo transparente
  • Hover effect → Resaltado al pasar ratón
  • Selección visual → Estados claramente diferenciados

🔍 Funcionalidades de Búsqueda

🎯 Criterios de Búsqueda

📝 Campos Compatibles

  • Nombre de usuario → Búsqueda parcial case-insensitive
  • ID del jugador → Identificador único
  • ID del sistema → Formato {userId}@neon
  • Highlighting → Resalta coincidencias encontradas

⚡ Búsqueda en Tiempo Real

  • Debounce inteligente → 300ms de retraso
  • Sin peticiones excesivas → Optimización de rendimiento
  • Feedback inmediato → Resultados al escribir
  • Limpieza automática → Filtros se resetean

🎛️ Filtros Avanzados

🔄 Filtros Combinables

  • Jugadores activos + Con sanciones → Usuarios problemáticos recientes
  • Solo activos → Comunidad actual
  • Solo con sanciones → Revisión disciplinaria
  • Búsqueda + filtros → Criterios múltiples simultáneos

📊 Contadores Dinámicos

  • Badges actualizados → Números en tiempo real
  • Feedback visual → Cantidad de resultados
  • Estadísticas contextuales → "Mostrando X de Y jugadores"

📊 Información Detallada por Usuario

⏱️ Métricas de Tiempo de Juego

📈 Datos de Sesiones

  • Tiempo total → Suma de todas las sesiones
  • Número de sesiones → Cantidad de conexiones
  • Promedio por sesión → Tiempo medio jugado
  • Última sesión → Fecha de última partida
  • Formato inteligente → Días/horas/minutos según cantidad

📊 Distribución Temporal

  • Barra de progreso → Visualización del progreso
  • Porcentaje calculado → Basado en 500h como máximo
  • Colores progresivos → Según nivel de experiencia
  • Tooltip informativo → Detalles completos al hover

⚖️ Historial Disciplinario

📋 Sanciones Activas vs Históricas

  • Bans activos → Solo sanciones vigentes
  • Mutes activos → Solo silenciamientos vigentes
  • Warns totales → Todas las advertencias
  • Reportes recibidos → Cantidad de reportes

📊 Tooltip Detallado

Información completa:

  • Sanciones por tipo → Desglose específico
  • Estado actual → Activas vs expiradas
  • Contadores → Números exactos
  • Reportes → Enlaces a sistema de reportes

🔒 Configuración de Privacidad

👁️ DoNotTrack

  • Privacidad activada → Usuario protegido
  • Privacidad normal → Tracking completo
  • Indicador visual → Iconos claros
  • Respeto por la privacidad → Limitaciones en datos

🛠️ Herramientas de Gestión

📋 Vista de Tabla Avanzada

🔄 Opciones de Visualización

  • Vista compacta → Más filas por pantalla
  • Vista normal → Información más espaciada
  • Toggle dinámico → Cambio en tiempo real
  • Memoria de preferencia → Mantiene selección

📊 Paginación Inteligente

  • 15 usuarios por defecto → Carga rápida
  • Opciones múltiples → 15, 25, 50, 100
  • Navegación fluida → Botones de página
  • Información contextual → Página actual y total

🔄 Ordenamiento Dinámico

Columnas ordenables:

  • Nombre → Alfabético A-Z o Z-A
  • ID → Numérico ascendente/descendente
  • Última conexión → Más reciente/antiguo
  • Primera conexión → Más nuevo/veterano
  • Estado de sanciones → Por cantidad total
  • Tiempo jugado → Por horas acumuladas

⚡ Rendimiento y Optimización

🔄 Carga de Datos

  • Include optimizado → Carga relaciones necesarias
  • Async/await → Operaciones no bloqueantes
  • Error handling → Gestión de fallos
  • Loading states → Indicadores de progreso

💾 Gestión de Memoria

  • DbContext factory → Conexiones eficientes
  • Dispose automático → Liberación de recursos
  • Lazy loading → Carga bajo demanda
  • Cache inteligente → Optimización de consultas

📱 Experiencia de Usuario

🎯 Navegación Intuitiva

🔗 Enlaces Contextuales

  • Perfil completo → Desde nombre de usuario
  • Botón dedicado → Icono AccountCircle
  • Navegación sin recarga → SPA experience
  • Breadcrumbs → Navegación contextual

💬 Feedback Visual

  • Notificaciones → Éxito, error, información
  • Loading spinners → Durante operaciones
  • Empty states → Cuando no hay datos
  • Tooltips informativos → Ayuda contextual

📱 Adaptabilidad

📐 Diseño Responsive

  • Mobile first → Optimización móvil
  • Tablet friendly → Experiencia intermedia
  • Desktop optimized → Máximo aprovechamiento
  • Breakpoints inteligentes → Transiciones suaves

♿ Accesibilidad

  • Contraste adecuado → Legibilidad garantizada
  • Tooltips descriptivos → Información adicional
  • Keyboard navigation → Navegación por teclado
  • Screen reader friendly → Etiquetas apropiadas

🎯 Casos de Uso Comunes

👮 Moderación Preventiva

🔍 Identificación de Usuarios Problemáticos

  1. Activar filtro "Con sanciones" → Ver solo usuarios sancionados
  2. Ordenar por sanciones → Más problemáticos primero
  3. Revisar perfiles individuales → Acceder a detalles
  4. Tomar medidas preventivas → Supervisión cercana

📊 Análisis de Comportamiento

  1. Filtrar jugadores activos → Comunidad actual
  2. Revisar tiempo de juego → Identificar dedicación
  3. Correlacionar sanciones → Patrones de comportamiento
  4. Monitoreo continuo → Seguimiento temporal

🔍 Investigaciones Específicas

🎯 Búsqueda de Usuario Específico

  1. Usar barra de búsqueda → Por nombre o ID
  2. Revisar resultados → Highlighting de coincidencias
  3. Acceder al perfil → Clic en nombre o botón
  4. Análisis detallado → Toda la información disponible

📈 Análisis de Tendencias

  1. Alternar entre vistas → Activos vs todos
  2. Revisar métricas → Tiempo de juego y actividad
  3. Identificar patrones → Usuarios veteranos vs nuevos
  4. Planificar acciones → Basado en datos

🎮 Gestión de Comunidad

👥 Análisis de Actividad

  1. Filtro de jugadores activos → Ver comunidad vigente
  2. Revisar última conexión → Detectar inactividad
  3. Identificar abandono → Usuarios que dejaron de jugar
  4. Estrategias de retención → Basadas en datos

🏆 Reconocimiento de Veteranos

  1. Ordenar por tiempo jugado → Más dedicados primero
  2. Identificar usuarios perfectos → Sin sanciones
  3. Reconocer contribuciones → Usuarios modelo
  4. Premiar lealtad → Programas especiales

🚨 Solución de Problemas

❌ Problemas Comunes

🔍 No Aparecen Usuarios

  • Verificar filtros → Desactivar filtros activos
  • Revisar búsqueda → Limpiar campo de búsqueda
  • Actualizar datos → Botón refresh
  • Verificar permisos → Acceso autorizado

⚡ Carga Lenta

  • Reducir filtros → Menos usuarios mostrados
  • Vista compacta → Menor carga visual
  • Paginación → Reducir elementos por página
  • Conexión a BD → Verificar estado del servidor

🔄 Datos Desactualizados

  • Actualización manual → Botón refresh
  • Cache del navegador → Limpiar caché
  • Sincronización → Verificar última actualización
  • Restart de sesión → Re-login si necesario

⚡ Optimización de Rendimiento

🚀 Mejores Prácticas

  • Usar filtros → Reducir conjunto de datos
  • Búsquedas específicas → Términos precisos
  • Paginación inteligente → Páginas pequeñas
  • Cerrar pestañas → Liberar memoria

💾 Gestión de Recursos

  • Refrescar cuando necesario → No automático excesivo
  • Cerrar modales → Liberar componentes
  • Navegación eficiente → Evitar bucles de carga

🔗 Enlaces Relacionados


📞 Soporte y Ayuda

🆘 Obtener Ayuda

💡 Sugerencias de Mejora

  • Nuevas funcionalidades → Proponer en Discord staff
  • Mejoras de interfaz → Feedback sobre usabilidad
  • Optimizaciones → Ideas para mejorar rendimiento

👤 Conoce a tu Comunidad, Modera con Información

¿Necesitas ayuda con perfiles de jugadores? Pregunta en el canal staff de [Discord](https://discord.neoncommunity.eu/) o consulta Panel de Moderación

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