# Historial, casos y notas


> Consulta sanciones, entiende los casos y diferencia el historial de moderación del historial de infracciones.


- URL: https://nearsecurity.citymoon.org/docs/moderacion/historial
- Sección: Moderación
- Idioma: Español
- Palabras clave: historial, casos, sanciones, notas, securitylogs, modlog, prueba

NearSecurity guarda dos historiales distintos: los casos de moderación, que registran sanciones aplicadas por personas o por el bot, y el historial de infracciones de seguridad, que registra detecciones de filtros y protecciones. Se consultan con comandos diferentes y tienen propósitos diferentes.


### Historial de sanciones


`/historial` muestra los casos más recientes del servidor. Podés filtrar por usuario y limitar la cantidad de resultados entre 1 y 10; por defecto se muestran 5. Los casos se navegan con botones y cada uno incluye usuario, moderador, acción, razón, duración, prueba y fecha.


| Campo | Qué muestra |
| --- | --- |
| Usuario | Mención, nombre e ID del sancionado. |
| Moderador | Responsable de la acción. Puede ser el bot en sanciones automáticas. |
| Acción | Ban, kick, timeout u otra sanción registrada. |
| Razón | Motivo indicado en el formulario. |
| Duración | Tiempo de la sanción y fecha de expiración cuando corresponde. |
| Prueba | URL o descripción adjunta al caso. |


> **Casos temporales**
> Los casos con duración guardan una fecha de expiración. Cuando el ban expira y el desbaneo automático se ejecuta, el caso se actualiza para reflejar que ya no está vigente. El historial no elimina el registro.


### Notas internas


`/notas` permite guardar observaciones que no constituyen una sanción: contexto familiar, acuerdos con el miembro, seguimiento de una situación o advertencias informales. Las notas se numeran por usuario y se pueden añadir, listar y eliminar.


| Comando | Función |
| --- | --- |
| `/notas añadir` | Agrega una nota al usuario indicado. |
| `/notas ver` | Muestra todas las notas guardadas del usuario. |
| `/notas eliminar` | Elimina una nota por su número. |


> **Las notas no son secretas para el staff**
> Cualquier persona con `Gestionar mensajes` puede leer y modificar las notas. No guardes contraseñas, tokens ni información sensible que no corresponda a la moderación.


### Historial de infracciones


`/securitylogs` es el historial de detecciones automáticas. Guarda metadatos de cada violación: usuario, tipo, severidad, fecha y canal. No guarda el contenido completo de los mensajes. Se usa para detectar patrones de reincidencia y para auditar la eficacia de los filtros.


| Comando | Función |
| --- | --- |
| `/securitylogs usuario` | Historial de un usuario, agrupado por tipo de violación. |
| `/securitylogs servidor` | Totales del servidor, últimos siete días, tipos y severidades. |
| `/securitylogs limpiar` | Elimina registros por usuario o tipo. |


| Historial | Qué registra | Se consulta con |
| --- | --- | --- |
| Casos de moderación | Sanciones aplicadas por personas o por el bot. | `/historial` |
| Infracciones de seguridad | Detecciones de filtros y protecciones automáticas. | `/securitylogs` |


> **Diferencia clave**
> Un timeout por spam puede aparecer en ambos historiales: como caso de moderación y como infracción de seguridad. No son duplicados; cada uno guarda información distinta y se conserva por separado.


### Buenas prácticas


- Consultá el historial antes de aplicar una sanción larga o permanente.
- Usá notas para el contexto que no merece una sanción formal.
- No limpies el historial de infracciones durante una investigación activa.
- Revisá periódicamente las estadísticas del servidor para detectar canales problemáticos.
- Documentá en el caso qué prueba se revisó y dónde está guardada.
