Crear Warn - Raul125/PanelWiki GitHub Wiki

⚠️ Crear Warn

El sistema de advertencias (warns) de NeonCommunity permite a los moderadores aplicar sanciones preventivas a jugadores que cometen infracciones menores. Las advertencias sirven como escalón previo a sanciones más severas y quedan registradas permanentemente en el historial del usuario.


🌐 Acceso a Crear Warn

📍 Formas de Acceder

  • Menú lateral de staff → "Gestor de Advertencias" → Pestaña "Nueva Advertencia"
  • URL directa: https://panel.neoncommunity.eu/scpsl/warn-manager
  • Desde perfil de jugador → Botón "Advertir" en perfil SCP:SL
  • Desde reportes → Acción directa al resolver reporte menor

🔐 Requisitos

  • Rol de Staff en Discord
  • Permisos de moderación asignados
  • Autenticación activa en el panel
  • Conocimiento de las normas de advertencias

📊 Dashboard de Advertencias

📈 Métricas en Tiempo Real

Antes de crear una advertencia, puedes ver el estado actual del sistema:

📋 Advertencias Totales

  • Contador global → Número total de warns en el sistema
  • Avatar rojo → Ícono de reporte para identificación
  • Datos históricos → Acumulado desde el inicio

📅 Advertencias Este Mes

  • Filtro mensual → Solo warns del mes actual
  • Color amarillo → Indicador de período temporal
  • Tendencia → Comparación con meses anteriores

👥 Usuarios Advertidos

  • Usuarios únicos → Número de jugadores diferentes
  • Sin duplicados → Cuenta cada usuario solo una vez
  • Color azul → Identificación de métrica de usuarios

🗂️ Pestañas del Sistema

📋 Pestaña: Advertencias

Vista completa de todas las advertencias aplicadas con herramientas de gestión.

➕ Pestaña: Nueva Advertencia

Sistema de pasos (Stepper) para crear warns:


🎯 Paso 1: Selección de Jugadores

🔍 Búsqueda de Usuarios

🎯 Autocompletado Inteligente

  • Búsqueda en tiempo real → Resultados mientras escribes
  • Múltiples criterios de búsqueda:
    • Nombre en el juego SCP:SL
    • ID del jugador en el sistema
    • ID del usuario del panel
  • Límite de resultados → 10 usuarios para rendimiento óptimo
  • Template personalizado:
    • Avatar del usuario (Discord) o inicial del nombre
    • Nombre completo del jugador
    • ID visible para identificación

➕ Añadir Usuarios

  • Botón de agregar → Ícono PersonAdd junto al autocompletado
  • Validación automática → Evita duplicados en la lista
  • Feedback visual → Notificación de éxito o advertencia

👥 Lista de Jugadores Seleccionados

📊 Tabla Detallada

Información completa de cada usuario seleccionado:

Columnas disponibles:

  • Avatar → Imagen de Discord o inicial del nombre
  • Nombre → Destacado con highlighting de búsqueda
  • ID único → Chip con identificador del sistema
  • Conexiones detalladas:
    • Primera conexión → Fecha y hora de registro
    • Última conexión → Actividad más reciente
  • Estado del usuario:
    • Normal → Verde con checkmark (funcionamiento normal)
    • DNT Activo → Rojo con escudo (DoNotTrack habilitado)

🛠️ Acciones por Usuario

  • Eliminar → Quitar usuario específico de la lista
  • Vista detallada → Información contextual clara

📋 Estados de la Lista

📝 Lista Vacía

  • Mensaje instructivo → Icono de búsqueda con texto explicativo
  • Guía de uso → "Utiliza el buscador para añadir jugadores a advertir"
  • Diseño centrado → Visualmente claro y directo

👥 Con Usuarios Seleccionados

  • Contador dinámico → "Jugadores seleccionados (X)"
  • Tabla completa → Toda la información visible
  • Botón de limpieza → "Limpiar selección" para vaciar lista

⚙️ Paso 2: Detalles de la Advertencia

📝 Configuración del Motivo

✏️ Campo de Texto Avanzado

Características del formulario:

  • Hasta 150 caracteres → Con contador visual activo
  • 5 líneas de altura → Área cómoda para escritura
  • Contador en tiempo real → Muestra caracteres restantes
  • Validación obligatoria → Campo requerido para continuar

💡 Información Contextual

  • Label claro → "Motivo de la advertencia"
  • Placeholder descriptivo → "Detalla el motivo de la advertencia"
  • Helper text → "Explica claramente el motivo para facilitar revisiones futuras"
  • Avatar informativo → Ícono de advertencia en color amarillo

📋 Mejores Prácticas para Motivos

  • Ser específico → Describir la infracción exacta
  • Incluir contexto → Cuándo y dónde ocurrió
  • Mencionar regla → Norma específica violada
  • Evidencias → Referencias a pruebas si las hay

✅ Paso 3: Confirmar y Aplicar

📋 Resumen Visual de la Advertencia

👥 Información de Jugadores

Visualización inteligente:

  • Chips individuales → Hasta 5 usuarios mostrados
  • Formato estilizado → Borde redondeado con ícono de persona
  • Contador adicional → "+X más" si hay más de 5 seleccionados
  • Colores consistentes → Azul primario para identificación

📝 Motivo Destacado

Presentación del motivo:

  • Sección separada → Con título descriptivo
  • Área resaltada → Fondo gris claro para destacar
  • Texto completo → Sin truncamiento, lectura completa
  • Espaciado adecuado → Line-height optimizado para legibilidad

⚠️ Advertencia Final

🚨 Alerta de Confirmación

Mensaje prominente con información crítica:

  • Número exacto → "X advertencia(s)" dinámico
  • Permanencia → "Se registrará en el historial de los jugadores"
  • Irreversibilidad → "Esta acción queda registrada y no puede revertirse"
  • Diseño de advertencia → Fondo amarillo con gradiente

🎉 Confirmación de Éxito

✅ Pantalla de Completado

Al aplicar correctamente las advertencias:

  • Ícono de éxito → Checkmark verde grande
  • Mensaje personalizado → Singular/plural según número de warns
  • Instrucciones claras → "Pulsa 'Reiniciar' para realizar otra advertencia"
  • Reset automático → Formulario limpio para siguiente uso

🤖 Sistema de Automatización

📋 WarnManager - Sistema Inteligente

🔄 Proceso Automatizado

1. Validar usuario y motivo
2. Crear registro en base de datos
3. Aplicar warn al historial del jugador
4. Generar log de auditoría automático
5. Notificar resultado al moderador

🛡️ Validaciones Automáticas

  • Usuario existe → Verificación en base de datos
  • Motivo válido → No vacío, longitud apropiada
  • Permisos staff → Verificación de autorización
  • Duplicados → Evita warns repetidos accidentales

📞 Notificaciones del Sistema

📊 Feedback al Moderador

Notificaciones en tiempo real:

  • Éxito individual → "Advertencia aplicada a [nombre] correctamente"
  • Éxito múltiple → "Se aplicaron correctamente X advertencias"
  • Errores específicos → "Error al advertir a [nombre]" con detalles
  • Resumen final → Conteo de éxitos vs. fallos

📋 Estados de Procesamiento

  • Procesando → Indicador de carga durante aplicación
  • Completado → Confirmación visual de finalización
  • Error → Mensaje específico del problema

📝 Logs Automáticos de Auditoría

🔍 Registro Completo

Cada advertencia genera automáticamente:

  • ID de la advertencia → Identificador único
  • Staff responsable → Quién aplicó la advertencia
  • Usuario advertido → Datos completos del sancionado
  • Fecha y hora exacta → Timestamp preciso
  • Motivo completo → Razón detallada proporcionada
  • Estado de aplicación → Exitosa, fallida, editada, eliminada

📊 Pestaña: Estadísticas

📈 Gráficos Informativos

📅 Advertencias por Mes

  • Gráfico de barras → Últimos 6 meses de actividad
  • Datos históricos → Tendencias temporales claras
  • Interactivo → Información detallada al hover
  • Actualización → Botón de refresh para datos recientes

🏆 Usuarios Más Advertidos

Tabla con ranking:

  • Top 10 usuarios → Ordenados por número de warns
  • Avatar y nombre → Identificación visual clara
  • Contador de advertencias → Chip amarillo con número
  • Última advertencia → Fecha del warn más reciente
  • Enlaces directos → Clic para ver perfil completo

👮 Actividad de Moderación

Rendimiento del equipo staff:

  • Staff member → Nombre e imagen del moderador
  • Total advertencias → Número acumulado histórico
  • Este mes → Actividad del período actual
  • Última advertencia → Fecha y hora específicas
  • Ordenamiento → Por actividad descendente

🛠️ Funciones Adicionales

📝 Gestión de Advertencias Existentes

✏️ Editar Advertencias

Desde la lista principal:

  • Botón "Editar" → En cada fila de la tabla
  • Diálogo específicoEditWarnReasonDialog
  • Cambio de motivo → Actualizar razón de la advertencia
  • Motivo del cambio → Justificación requerida para auditoría
  • Log automático → Registra quién modificó qué y cuándo

🗑️ Eliminar Advertencias

Proceso de eliminación:

  • Botón "Retirar Advertencia" → Color verde (Success)
  • Diálogo de confirmaciónDeleteWarnDialog
  • Razón requerida → Motivo de la eliminación
  • Confirmación segura → Evita eliminaciones accidentales
  • Log crítico → Registro especial de eliminaciones

👁️ Visualización Detallada

🔍 Ver Advertencia Completa

  • Botón "Ver Warn" → En cada advertencia de la lista
  • Página dedicada/scpsl/warnview/{id}
  • Información completa → Todos los detalles del warn
  • Historial de cambios → Modificaciones realizadas

🔧 Herramientas de la Tabla Principal

🔍 Búsqueda y Filtros

🎯 Búsqueda en Tiempo Real

  • Campo de búsqueda → "Buscar por nombre o staff..."
  • Búsqueda instantánea → Resultados mientras escribes
  • Múltiples campos → Usuario advertido y staff que aplicó
  • 300px de ancho → Espacio cómodo para escribir

⚙️ Opciones de Vista

  • Modo compacto → Toggle para densidad de filas
  • Refresh manual → Botón para actualizar datos
  • Tooltips informativos → Ayuda contextual

📊 Columnas de Información

🆔 Columnas Principales

  • ID → Identificador único con formato "#123"
  • Usuario Advertido → Avatar + nombre + enlace a perfil
  • Staff → Moderador que aplicó + enlace a perfil
  • Motivo → Razón completa de la advertencia
  • Fecha → Formato DD/MM/YYYY HH:mm con tooltip extendido
  • Acciones → Botones de Ver, Editar, Eliminar

🎨 Características Visuales

  • Avatares circulares → 32x32px con sombra sutil
  • Enlaces funcionales → Navegación a perfiles relacionados
  • Tooltips informativos → Información adicional al hover
  • Colores diferenciados → Por tipo de acción y estado

💡 Consejos para Moderadores

⚠️ Cuándo Usar Advertencias

✅ Situaciones Apropiadas:

  • Primera infracción menor → Error sin malicia evidente
  • Comportamiento levemente disruptivo → Spam ocasional
  • Desobediencia menor → No seguir instrucciones simples
  • Lenguaje inapropiado leve → Sin insultos graves
  • Trolling menor → Comportamiento molesto pero no grave

❌ Cuándo NO Usar Advertencias:

  • Infracciones graves → Usar ban directamente
  • Comportamiento tóxico repetido → Escalado inmediato
  • Amenazas → Sanción mayor requerida
  • Evasión de sanciones → Require ban
  • Contenido extremo → Sin advertencia previa

📝 Redacción Efectiva de Motivos

✅ Ejemplos de Buenos Motivos:

  • "Spam en chat durante 5 minutos consecutivos en ronda 14:30, ignoró advertencia verbal"
  • "Teamkill accidental como SCP-096, sin seguir protocolo de disculpas a la víctima"
  • "Lenguaje inadecuado en chat de voz, palabras menores pero repetidas"
  • "No siguió instrucciones de staff durante evento especial, comportamiento disruptivo"

❌ Ejemplos de Malos Motivos:

  • "Se portó mal"
  • "Molestando"
  • "Warn general"
  • "Varios motivos"

🎯 Estrategia de Advertencias

📈 Escalado Progresivo

  1. Primera vez → Advertencia verbal (no registrada)
  2. Segunda vez → Warn oficial registrado
  3. Tercera vez → Warn + consideración de ban temporal
  4. Cuarta vez → Ban leve automático

📊 Seguimiento de Patrones

  • Revisar historial → Antes de aplicar nueva advertencia
  • Identificar tendencias → Tipos de infracciones repetidas
  • Comunicar con equipo → Usuarios problemáticos conocidos
  • Documentar bien → Para futuras referencias

🔗 Enlaces Relacionados


⚠️ Advierte con Propósito, Educa con Paciencia

¿Dudas sobre el sistema de advertencias? Pregunta en el canal staff de [Discord](https://discord.neoncommunity.eu/) o consulta Panel de Moderación

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