El sistema de gestión de usuarios permite a los administradores supervisar, buscar y administrar todos los usuarios registrados en la plataforma. Esta herramienta centraliza la información de usuarios del panel y del juego, facilitando la administración de roles, permisos y el seguimiento de la actividad de la comunidad.

---

• Ruta: /admin/users
• Menú lateral: Administración → Gestión de Usuarios
• Icono: 👥 ManageAccounts

• Autenticación obligatoria → Usuario debe estar logueado
• Permisos específicos → Permissions.Admin.Users
• Rol administrativo → Nivel de administrador requerido

• Solo administradores pueden acceder
• Moderadores no tienen acceso a gestión de usuarios
• Funciones sensibles protegidas por permisos adicionales

---

El panel de búsqueda permite localizar usuarios específicos usando múltiples criterios de filtrado.

• Diseño en tarjeta → Interfaz organizada y clara
• Botón de limpieza → Resetear todos los filtros
• Aplicación inmediata → Filtros se aplican automáticamente
• Estado visual → Indicadores de filtros activos

---

• Nombre de usuario → Búsqueda parcial en nombres
• SteamID → Identificador de Steam
• GameID → ID único del juego SCP:SL
• DiscordID → Identificador de Discord
• Búsqueda inteligente → Case-insensitive

• Búsqueda en tiempo real → Resultados inmediatos
• Campo limpiable → Botón X para resetear
• Enter para buscar → Tecla rápida
• Placeholder descriptivo → Guía de uso

• Todos los roles → Ver todos los usuarios
• Roles específicos → Filtrar por rol asignado
• Ordenados por peso → Jerarquía de roles
• Solo roles activos → Excluye roles predeterminados

• Dropdown inteligente → Lista de roles disponibles
• Icono de escudo → Identificación visual
• Filtrado instantáneo → Aplicación automática

• 🌐 Todos los tipos → Sin filtro aplicado
• 🎮 Panel User → Solo usuarios del panel web
• 🎯 SL User → Solo usuarios del juego
• 🔗 Usuarios Vinculados → Que tienen ambas cuentas

• Icons específicos → Steam, Games, Link
• Chips coloreados → Por tipo de cuenta
• Estados claros → Vinculado, Panel, SL

---

• Avatar dinámico → Imagen de Discord si está disponible
• Fallback inteligente → Primera letra del nombre
• Link al perfil → Navegación directa
• Nombre destacado → Tipografía clara

• Chip coloreado → Color específico del rol
• Nombre del rol → Rol principal del usuario
• N/A para usuarios sin rol → Indicador claro
• Jerarquía visual → Según importancia del rol

• SteamID → Para usuarios Panel (icono Steam)
• GameID → Para usuarios SL (icono Games)
• Chips clicables → Copiar al portapapeles
• Tooltips informativos → "Copiar SteamID/GameID"
• Múltiples IDs → Para usuarios vinculados

• 🟢 Vinculado → Usuario completo (Panel + SL)
• 🔵 Panel → Solo cuenta web
• 🟣 SL → Solo cuenta de juego
• Iconos descriptivos → Identificación rápida

• Formato DD/MM/YYYY → Fecha clara
• Tooltip detallado → Fecha y hora completa
• Diferentes fuentes → CreatedOn vs FirstSeen
• Chips informativos → Estilo consistente

• 👁️ Ver perfil → Navegación a perfil administrativo
• 🎮 Ver página SL → Solo para usuarios SL
• 🛠️ Editar roles → Solo con permisos específicos
• Grupo de botones → Diseño compacto

---

• Usuario → Alfabético por nombre
• Rol → Por peso/jerarquía del rol
• Tipo → Vinculados, Panel, SL
• Fecha → Cronológico por registro
• Orden predeterminado → Más recientes primero

• Flechas de ordenamiento → Dirección clara
• Estado activo → Columna seleccionada
• Cambio instantáneo → Sin recarga

• Navegación central → Botones de página
• Elementos por página → Configurable
• Información contextual → Página actual y total
• Persistencia → Mantiene filtros al cambiar página

• Loading state → Spinner durante carga
• Empty state → Cuando no hay resultados
• Error handling → Manejo de errores
• Contador de resultados → Total filtrado vs total

• Striped rows → Mejor legibilidad
• Hover effects → Interactividad clara
• Fixed header → Navegación fácil en listas largas

---

• Permisos específicos → Permissions.Admin.EditUserRoles
• Solo usuarios Panel → No se puede editar SL-only
• Roles no predeterminados → Excluye roles automáticos
• Jerarquía respetada → Según peso de roles

• Lista de roles disponibles → Ordenados por peso
• Selección múltiple → Checkboxes para roles
• Roles actuales → Preseleccionados
• Confirmación requerida → Evita cambios accidentales

1. Comparar roles → Actuales vs seleccionados
2. Identificar cambios → Roles a añadir/remover
3. Aplicar modificaciones → Base de datos
4. Registrar acción → Log de auditoría
5. Notificar resultado → Feedback al admin

• Roles eliminados → Lista de roles removidos
• Roles añadidos → Lista de roles agregados
• Timestamp → Fecha y hora exacta
• Admin responsable → Quién hizo el cambio

---

• Contador principal → Número total de usuarios
• Usuarios nuevos → Registros del mes actual
• Icono de grupo → Identificación visual
• Chip de novedad → "X nuevos este mes"

• Total de reportes → Histórico completo
• Reportes del mes → Actividad reciente
• Icono de reporte → Identificación visual
• Trend mensual → Comparativa temporal

• Top 3 roles → Más asignados
• Contador por rol → Cantidad específica
• Colores originales → Según configuración del rol
• Distribución visual → Chips informativos

• Total histórico → Todas las advertencias
• Del mes actual → Actividad reciente
• Fondo coloreado → Tema visual consistente
• Iconografía clara → Warning icon

• Total histórico → Todos los baneos
• Del mes actual → Actividad reciente
• Color de error → Indicador de severidad
• Iconografía clara → Block icon

• Total histórico → Todos los mutes
• Del mes actual → Actividad reciente
• Color secundario → Diferenciación visual
• Iconografía clara → VolumeOff icon

---

• 🟢 Verde (Success) → Usuarios vinculados
• 🔵 Azul (Info) → Solo usuarios Panel
• 🟣 Morado (Secondary) → Solo usuarios SL
• ⚪ Gris (Default) → Sin rol asignado

• Colores dinámicos → Según configuración del rol
• Jerarquía visual → Según peso del rol
• Consistencia → Mismo color en toda la plataforma

• 🔵 Azul (Primary) → Elementos principales
• 🟡 Amarillo (Warning) → Advertencias
• 🔴 Rojo (Error) → Baneos y errores
• 🟣 Morado (Tertiary) → Acciones secundarias

• Hover effects → En botones y links
• Smooth transitions → Cambios suaves
• Loading spinners → Durante operaciones
• Toast notifications → Feedback de acciones

• Breakpoint Sm → Adaptación móvil
• Tabla adaptable → Columnas reorganizadas
• Botones compactos → En pantallas pequeñas
• Navegación táctil → Optimizada para móvil

---

1. Buscar usuario → Por nombre o ID
2. Verificar permisos → Botón editar roles visible
3. Abrir editor → Clic en botón ManageAccounts
4. Seleccionar roles → Checkboxes apropiados
5. Confirmar cambios → Guardar modificaciones
6. Verificar resultado → Notificación de éxito

1. Filtrar por rol específico → Dropdown de roles
2. Revisar usuarios → Con ese rol asignado
3. Verificar permisos → Consistencia en asignaciones
4. Realizar ajustes → Si es necesario

1. Usar múltiples criterios → Nombre, ID, etc.
2. Aplicar filtros → Tipo o rol específico
3. Revisar resultados → Información detallada
4. Acceder a perfiles → Para más detalles

1. Revisar estadísticas → Panel expandible
2. Identificar tendencias → Crecimiento, actividad
3. Comparar métricas → Mes actual vs histórico
4. Tomar decisiones → Basadas en datos

1. Filtrar usuarios inactivos → Por fecha de registro
2. Identificar cuentas duplicadas → Usuarios vinculados
3. Revisar roles obsoletos → Distribución de roles
4. Optimizar estructura → Según estadísticas

1. Revisar usuarios nuevos → Estadística mensual
2. Analizar moderación → Métricas de sanciones
3. Evaluar crecimiento → Tendencias de registro
4. Planificar recursos → Basado en datos

---

• Verificar filtros → Pueden ser muy restrictivos
• Limpiar búsqueda → Resetear campo de texto
• Revisar tipo de usuario → Filtro específico aplicado
• Refrescar datos → Aplicar filtros de nuevo

• Verificar permisos → EditUserRoles requerido
• Solo usuarios Panel → SL-only no editable
• Rol de administrador → Nivel suficiente
• Usuario válido → Cuenta activa

• Caché del navegador → Refrescar página
• Sincronización de datos → Puede tardar
• Filtros aplicados → Afectan estadísticas
• Conexión a BD → Verificar estado

• Usar filtros específicos → Reducir conjunto de datos
• Búsquedas precisas → Términos exactos
• Paginación adecuada → No cargar todo
• Cerrar diálogos → Liberar memoria

• Evitar filtros muy amplios → Muchos resultados
• Cerrar pestañas innecesarias → Memoria del navegador
• Refrescar cuando necesario → No automático excesivo

---

• Panel de Moderación - Centro de control para staff
• Sistema de Roles - Configuración de roles y permisos
• Perfiles de Jugadores - Vista detallada de usuarios SL
• Logs de Auditoría - Registro de cambios de roles
• Sincronización con Discord y Steam - Gestión de roles en Discord
• Configuración del Sistema - Ajustes administrativos generales

---

• Canal Admin Discord → [discord.neoncommunity.eu](https://discord.neoncommunity.eu/)
• Documentación técnica → /swagger para desarrolladores
• Issues GitHub → Reportar problemas del sistema

• Nuevas funcionalidades → Proponer en Discord admin
• Mejoras de interfaz → Feedback sobre usabilidad
• Optimizaciones → Ideas para mejorar rendimiento
• Filtros adicionales → Criterios de búsqueda nuevos

• Modelo de usuarios → Estructura de datos
• Sistema de permisos → Autorización granular
• API endpoints → Para integraciones externas
• Logs de actividad → Trazabilidad de cambios

---