# Alertas

Configuración de notificaciones automáticas para administradores.

# Introducción

En el apartado **"Configuración -> Alertas"** podréis configurar avisos personalizados para que los usuarios administradores de la aplicación reciban notificaciones en momentos concretos del año o ante vencimientos importantes.

Al acceder, se muestra el listado de todas las alertas configuradas detallando su nombre, el tipo de alerta, el mensaje que recibirá el usuario y si está activa o no. El sistema permite **crear, modificar y eliminar** cualquier alerta de esta lista.

---

# Datos y campos de la alerta

Cuando se crea o se modifica una alerta, se pueden completar los siguientes campos informativos:

- **Nombre de la alerta** y **Mensaje** personalizado que aparecerá al administrador.
- **Tipo de alerta:** Selección según el origen de la notificación *(ver tabla de tipos a continuación)*.
- **Fecha alerta:** Campo de calendario exclusivo para el caso *Genérica puntual*.
- **Día (1-31):** Campo numérico aplicable únicamente para los casos *Periódica anual* y *Periódica mensual*.
- **Mes (Enero-Diciembre):** Selector desplegable aplicable únicamente para el caso *Periódica anual*.
- **Activa:** Selector de *Sí / No*.
- **Acciones a realizar:** Opciones para marcar el canal de recepción del aviso (*Enviar correo-e a los administradores* y/o *Mostrar alerta en la aplicación*).

---

# Tipos de alertas disponibles

El sistema automatiza la generación de avisos cruzando los datos de los diferentes módulos de la plataforma según la siguiente tipología:

| Tipo de alerta | Funcionamiento y origen de la referencia |
| :--- | :--- |
| **Genérica puntual** | Se lanza una única vez en una fecha fija concreta tomando como referencia el campo *Fecha alerta*. |
| **Periódica anual** | Se repite automáticamente cada año tomando como referencia los campos *Mes* y *Día*. |
| **Periódica mensual** | Se repite de forma automática cada mes utilizando el campo *Día* como referencia. |
| **Preaviso actividad inmueble** | Monitoriza y avisa según las fechas de preaviso registradas en las actividades de todos los inmuebles. |
| **Preaviso convenio** | Se genera automáticamente a partir de las fechas de preaviso configuradas dentro de cada convenio. |
| **Renovación convenio** | Se activa de forma automática según las fechas de renovación establecidas en los convenios. |
| **Actualización cuota convenio** | Controla las fechas de revisión o actualización de la cuota anual de los convenios de la entidad. |
| **Preaviso seguro** | Monitoriza y lanza avisos según las fechas de preaviso configuradas en el módulo de seguros. |
| **Evento** | Avisos vinculados a la agenda. Se configuran en la ficha de cada acto indicando los días concretos de antelación (de 1 a 14 días antes del acto). |

---

# Canales de recepción, trazabilidad y opción de posponer

- **Filtros de lista:** En la parte superior se puede filtrar el listado para visualizar únicamente las alertas activas o verlas todas. Por defecto, el sistema solo mostrará las que están activas.
- **Canal Correo-e:** Los usuarios con rol de administrador recibirán un correo electrónico con el contenido del aviso de forma inmediata.
- **Canal Aplicación:** Se iluminará un icono de campana en la barra superior de la aplicación que muestra el número de notificaciones no leídas. Al hacer clic, se despliega la lista con el nombre y el mensaje de cada una. El usuario dispone de las opciones de **Cerrar / Eliminar** el aviso definitivamente o bien **Posponerlo**.
- **Opción de posponer:** Esta opción solo está disponible en la aplicación (no desde el correo). Permite seleccionar una nueva fecha para que la alerta vuelva a aparecer. Esta acción es individual: solo afecta al usuario conectado que la pospone, manteniéndose visible e inalterada para el resto de administradores. Se puede volver a posponer tantas veces como sea necesario.
- **Trazabilidad directa:** Al hacer clic sobre una alerta de la lista de la barra superior, el sistema redirigirá automáticamente a la ficha del elemento afectado (el convenio, el seguro, el inmueble o el evento). Las alertas de tipo genérico no son clicables porque no hacen referencia a ningún objeto interno.

> ⏱️ **Funcionamiento del motor de alertas e histórico:**  
> Las alertas se calculan y se generan mediante un proceso interno automático del servidor que se ejecuta diariamente **cada mañana a las 8:00 h**. La hora de ejecución es fija y no se puede modificar. Para garantizar el rendimiento del sistema y evitar la acumulación de datos, el sistema limpia el histórico y **solo guarda las alertas recibidas durante los últimos 6 meses**.