# Alertes

Configuració de notificacions automàtiques per a administradors.

# Introducció

A l’apartat **"Configuració -> Alertes"** podreu configurar avisos personalitzats perquè els usuaris administradors de l’aplicatiu rebin notificacions en moments concrets de l'any o davant de venciments importants.

En accedir-hi, es mostra el llistat de totes les alertes configurades detallant el seu nom, el tipus d'alerta, el missatge que rebrà l'usuari i si està activa o no. El sistema permet **crear, modificar i esborrar** qualsevol alerta d'aquesta llista.

---

# Dades i camps de l'alerta

Quan es crea o es modifica una alerta, es poden omplir els següents camps informatius:

- **Nom de l’alerta** i **Missatge** personalitzat que apareixerà a l’administrador.
- **Tipus d'alerta:** Selecció segons l'origen de la notificació *(veure taula de tipus a continuació)*.
- **Data alerta:** Camp de calendari exclusiu per al cas *Genèrica puntual*.
- **Dia (1-31):** Camp numèric aplicable només per als casos *Periòdica anual* i *Periòdica mensual*.
- **Mes (Gener-Desembre):** Selector desplegable aplicable només per al cas *Periòdica anual*.
- **Activa:** Selector de *Sí / No*.
- **Accions a realitzar:** Opcions per marcar el canal de recepció de l'avís (*Enviar correu-e als administradors* i/o *Mostrar alerta aplicatiu*).

---

# Tipus d'alertes disponibles

El sistema automatitza la generació d'avisos creuant les dades dels diferents mòduls de la plataforma segons la següent tipologia:

| Tipus d'alerta | Funcionament i origen de la referència |
| :--- | :--- |
| **Genèrica puntual** | Es llança una sola vegada en una data fixa concreta prenent com a referència el camp *Data alerta*. |
| **Periòdica anual** | Es repeteix automàticament cada any prenent com a referència els camps *Mes* i *Dia*. |
| **Periòdica mensual** | Es repeteix de forma automàtica cada mes agafant el camp *Dia* com a referència. |
| **Preavís activitat immoble** | Monitoritza i avisa segons les dates de preavís registrades a les activitats de tots els immobles. |
| **Preavís conveni** | Es genera automàticament a partir de les dates de preavís configurades dins de cada conveni. |
| **Renovació conveni** | Es dispara de manera automàtica segons les dates de renovació establertes als convenis. |
| **Actualització quota conveni** | Controla les dates de revisió o actualització de la quota anual dels convenis de l'entitat. |
| **Preavís assegurança** | Monitoritza i llança avisos segons les dates de preavís configurades en el mòdul d'assegurances. |
| **Esdeveniment** | Avisos vinculats a l'agenda. Es configuren a la fitxa de cada acte indicant els dies concrets d'antelació (d'1 a 14 dies abans de l'acte). |

---

# Canals de recepció, traçabilitat i opció de posposar

- **Filtres de llista:** A la part superior es pot filtrar el llistat per visualitzar només les alertes actives o veure'ls tots. Per defecte, el sistema només mostrarà les que estan en marxa.
- **Canal Correu-e:** Els usuaris amb rol d'administrador rebran un correu electrònic amb el contingut de l'avís de manera immediata.
- **Canal Aplicatiu:** S’il·luminarà una icona de campana a la barra superior de l'aplicació que mostra el nombre de notificacions no llegides. En clicar-la es desplega la llista amb el nom i el missatge de cadascuna. L'usuari compta amb les opcions de **Tancar / Esborrar** l'avís definitivament o bé **Posposar-lo**.
- **Opció de posposar:** Aquesta opció només està disponible a l'aplicació (no des del correu). Permet seleccionar una nova data perquè l'alerta torni a saltar. Aquesta acció és individual: només afecta l'usuari connectat que la posposa, mantenint-se visible i inalterada per a la resta d'administradors. Es pot tornar a posposar tantes vegades com calgui.
- **Traçabilitat directa:** En fer clic sobre una alerta de la llista de la barra superior, el sistema us redirigirà de forma automàtica a la fitxa de l'element afectat (el conveni, l'assegurança, l'immoble o l'esdeveniment). Les alertes de tipus genèric no són clicables perquè no fan referència a cap objecte intern.

> ⏱️ **Funcionament del motor d'alertes i històric:**  
> Les alertes es calculen i es generen mitjançant un procés intern automàtic del servidor que s'executa diàriament **cada matí a les 8:00 h**. L'hora d'execució és fixa i no es pot modificar. Per garantir el rendiment del sistema i evitar l'acumulació de dades, el sistema escombra l'històric i **només guarda les alertes rebudes durant els darrers 6 mesos**.