El sistema de gestión de reportes permite a los moderadores revisar, procesar y administrar todos los reportes enviados por los jugadores de la comunidad. Esta herramienta centraliza la moderación y facilita el mantenimiento de un entorno seguro y agradable.

---

• Ruta: /scpsl/report-manager
• Menú lateral: Panel de Moderación → Gestión de Reportes
• Icono: 🚨 ReportProblem

• Autenticación obligatoria → Usuario debe estar logueado
• Rol de Staff → Permisos de moderación
• Permisos específicos → Gestión de reportes habilitada

• Solo staff autorizado puede acceder
• Usuarios normales no pueden ver esta sección
• Permisos granulares según jerarquía de moderación

---

El gestor de reportes se organiza en 3 pestañas principales:

1. 📋 REPORTES → Lista y gestión de reportes individuales
2. 📊 ESTADÍSTICAS → Métricas y análisis de tendencias
3. 👤 USUARIOS REPORTADOS → Ranking de usuarios con más reportes

---

Cada reporte incluye:

• ID único → Identificador numérico del reporte
• Fecha y hora → Cuándo se envió el reporte
• Usuario reportante → Quién envió el reporte (con avatar)
• Usuario reportado → Jugador señalado (con avatar)
• Razón del reporte → Tipo de infracción
• Servidor → Dónde ocurrió el incidente
• Botón Ver → Acceso a detalles completos

• Avatares de usuarios → Identificación visual rápida
• Chips de colores → Cada tipo de reporte tiene su color
• Estados diferenciados → Activos vs archivados
• Iconos descriptivos → Por tipo de servidor y razón

• Reportes Activos → Pendientes de revisión (por defecto)
• Reportes Archivados → Ya procesados por staff
• Chip interactivo → Cambia entre vistas con un clic

Opciones disponibles:

• Todos los servidores → Vista global (Global)
• Normal → Solo server normal
• RolePlay → Solo server de roleplay

• Botón Refresh → Actualiza la lista manualmente
• Animación de rotación → Feedback visual al actualizar
• Datos en tiempo real → Sincronización automática

• Campo numérico → Ingresa ID del reporte
• Validación → Solo números válidos
• Navegación directa → Ir al reporte específico
• Mensaje de error → Si el ID no es válido

• Ordenamiento → Por cualquier columna (ASC/DESC)
• Paginación → Navegación por páginas
• Búsqueda → Filtrado dinámico
• Responsive → Se adapta a móviles
• Loading states → Indicadores de carga

• Ver detalles → Botón para cada reporte
• Navegación a perfiles → Links a usuarios
• Tooltips informativos → Información adicional

---

Tres indicadores clave:

1. 📋 Reportes Activos

   • Contador principal → Número de reportes pendientes
   • Descripción → "Pendientes de revisión"
   • Barra de progreso → Porcentaje del total
   • Color → Azul (Info)

2. 📦 Reportes Archivados

   • Contador principal → Número de reportes procesados
   • Descripción → "Ya procesados"
   • Barra de progreso → Porcentaje del total
   • Color → Naranja (Warning)

3. 📊 Total Reportes

   • Contador principal → Suma total histórica
   • Descripción → "Histórico acumulado"
   • Barra de progreso → Siempre 100%
   • Color → Verde (Success)

• Gráfico de barras → Cada servidor con su conteo
• Iconos específicos → Visual para cada tipo de servidor
• Porcentajes → Distribución relativa
• Colores únicos → Diferenciación visual

Dos series de datos:

• Línea "Reportes" → Reportes recibidos por día
• Línea "Archivados" → Reportes procesados por día
• Eje X → Fechas de los últimos 7 días
• Eje Y → Cantidad de reportes
• Interactivo → Hover para detalles

Visualización de razones:

• Sectores proporcionales → Según frecuencia
• Colores diferenciados → Por tipo de infracción
• Etiquetas claras → Nombres de categorías

• Lista de razones → Con contadores específicos
• Avatares numerados → Identificación visual
• Conteo individual → "X reportes" por categoría

---

Información por usuario:

• Avatar grande → Imagen de perfil o inicial
• Nombre del usuario → Identificación clara
• Contador de reportes → "X reportes recibidos"
• Botón de perfil → Acceso directo al jugador

• Top 3 razones → Más frecuentes para ese usuario
• Chips de colores → Según tipo de infracción
• Contadores → Cantidad por razón

• Mensaje informativo → Cuando no hay usuarios reportados
• Icono de búsqueda → Indicador visual
• Texto explicativo → "Aparecerán cuando reciban reportes"

---

• Ver reporte → /scpsl/report/{id} - Detalles completos
• Perfil reportante → /scpsl/profile/{userId} - Usuario del panel
• Perfil reportado → /admin/profile/{userId} - Usuario SCPSL

• Ver perfil → /admin/profile/{userId} - Perfil administrativo
• Acceso directo → Toda la información del jugador

---

• 🔴 Toxicidad → Color.Error (Rojo)
• 🟠 Freekill → Color.Warning (Naranja)
• 🟣 AntiRol → Color.Secondary (Morado)
• ⚪ Otros → Color.Default (Gris)

• 🔵 Información → Color.Info (Azul)
• 🟢 Éxito → Color.Success (Verde)
• 🟡 Advertencia → Color.Warning (Amarillo)
• 🔴 Error → Color.Error (Rojo)

• Hover effects → Sombras y escalado en botones
• Rotación → Botón de actualizar gira al hacer clic
• Transiciones suaves → 0.3s ease en todos los cambios
• Feedback visual → Estados de carga y confirmación

• Desktop → Tabla completa con todas las columnas
• Tablet → Adaptación de columnas importantes
• Móvil → Stack de información principal
• Breakpoints → Transiciones suaves entre tamaños

---

• Pestaña inicial → Solo datos básicos de reportes
• Estadísticas → Se cargan al hacer clic en la pestaña
• Usuarios reportados → Carga diferida similar
• Indicadores de carga → Spinners durante la carga

• DbContext factory → Conexiones eficientes
• Async/await → Operaciones no bloqueantes
• CancellationToken → Cancelación de operaciones
• Using statements → Liberación automática de recursos

• Consultas optimizadas → Solo datos de la página actual
• Conteo eficiente → Total de registros optimizado
• Filtros en BD → Reducción de transferencia de datos
• Ordenamiento en servidor → Mejor rendimiento

---

• Tabla de reportes → Paginación configurable
• Top usuarios → Máximo 6 mostrados
• Gráfico temporal → Últimos 7 días
• Distribución → Todas las categorías

• Manual → Botón de refresh disponible
• Automática → Al cambiar filtros
• Estados → Indicadores de carga

• Tema automático → Según preferencias del usuario
• Iconos adaptables → Visibilidad en ambos modos
• Contrastes → Legibilidad optimizada

---

1. Acceder al gestor → Desde menú lateral
2. Revisar reportes activos → Lista principal
3. Filtrar si necesario → Por servidor específico
4. Ver detalles → Clic en "Ver" de cada reporte
5. Procesar reporte → Aplicar sanción o archivar
6. Actualizar lista → Verificar cambios

1. Cambiar a pestaña "Usuarios Reportados"
2. Identificar usuarios problemáticos → Top reportados
3. Ver perfil completo → Clic en botón perfil
4. Analizar patrones → Razones frecuentes
5. Tomar medidas → Según historial

1. Pestaña "Estadísticas" → Vista general
2. Analizar métricas → Activos vs procesados
3. Revisar tendencia → Gráfico de 7 días
4. Identificar patrones → Picos y bajas
5. Distribución → Por servidor y tipo

---

• Verificar conexión → Base de datos disponible
• Recargar página → F5 o Ctrl+R
• Limpiar filtros → Resetear a valores por defecto

• Revisar filtros → Servidor seleccionado
• Cambiar vista → Activos vs archivados
• Verificar permisos → Acceso de moderador

• Esperar carga → Pueden tardar unos segundos
• Refrescar pestaña → Cambiar y volver
• Verificar datos → Debe haber reportes en BD

• Usar filtros → Reducir conjunto de datos
• Paginar resultados → No cargar todo de una vez
• Cerrar otras pestañas → Liberar memoria del navegador

---

• Panel de Moderación - Centro de control para staff
• Crear Ban - Sancionar usuarios después de revisar reportes
• Crear Warn - Advertir usuarios por infracciones leves
• Crear Mute - Silenciar usuarios por comportamiento tóxico
• Perfiles de Jugadores - Ver historial completo de usuarios
• Logs de Auditoría - Registro de todas las acciones moderativas
• Sistema de Reportes - Cómo los usuarios envían reportes
• Revocar Sanciones - Corregir errores de moderación

---

• Canal Staff Discord → [discord.neoncommunity.eu](https://discord.neoncommunity.eu/)
• Documentación API → /swagger para desarrolladores
• Issues GitHub → Reportar bugs técnicos

• Funcionalidades nuevas → Proponer en Discord staff
• Problemas de UX → Feedback directo al equipo
• Optimizaciones → Ideas para mejorar rendimiento

---