Notifiche email

Tempo di lettura: ~5 minuti · Tempo di esecuzione: ~2 minuti (più verifica) · Pubblico: chiunque voglia essere avvisato via email quando succede qualcosa di critico in vasca

🟡 Guida importante — configurazione breve. Una volta attivate, le notifiche email funzionano da sole. La pagina serve poi solo per consultare attive/storico.

1. Cosa stai per fare

JoyReef genera eventi automaticamente (vedi guida 14) per tutto ciò che succede in vasca. Alcuni di questi eventi sono critici: vuoi saperlo subito, non aspettare di aprire il portale.

Esempio: l'ATO va in fault alle 3 di notte. Senza notifiche, lo scopri al mattino dopo che la pompa ha cercato di rabboccare invano per ore. Con la notifica email attiva, ricevi un'email immediatamente e puoi:

• Aprire il portale dal cellulare
• Valutare se è un problema serio o aspetta domani
• Eventualmente sbloccare l'ATO da remoto (vedi guida 14)

In questa guida:

• Attivi le notifiche email
• Capisci quali tipi di eventi generano una notifica e quali no
• Impari a leggere la pagina notifiche (Attive vs Storico)
• Vedi come risolvere i casi tipici (email non arrivano, finiscono in spam)

2. Cosa ti serve

• ✅ Un account JoyReef già attivo (con email confermata)
• ✅ La vasca primaria impostata (non strettamente necessario, ma molte notifiche sono per-vasca)

💡 L'indirizzo email usato è quello del tuo profilo. Se vuoi ricevere le notifiche su un'email diversa da quella del login, cambia l'email del profilo (Menu utente → Profilo → modifica email + conferma).

💡 Push e SMS: per ora non supportati. Solo email. Per "push" su mobile c'è la soluzione "ti arriva l'email su Gmail/Outlook → la app mobile fa il push" — non integriamo direttamente i push iOS/Android.

3. Tipi di notifica gestiti

JoyReef invia una notifica email per i seguenti eventi (lista può crescere nel tempo):

Cose che NON generano notifica email

Per evitare di spammarti:

• ❌ Eventi OK ordinari (ATO rabboccato, riscaldatore acceso, ecc.) — restano in timeline ma non mandano email
• ❌ Eventi Warning non critici (sonda stuck per 5 min, cambio piccolo di stato, ecc.)
• ❌ Stati che cambiano per pochi secondi (anti-flicker)

L'idea: se ricevi un'email da JoyReef, è perché c'è qualcosa che devi guardare davvero. Non rumore.

Anti-spam: una sola email per "evento attivo"

Quando un evento scatta (es. "Risalita ferma"), JoyReef invia una sola email e basta. Anche se la risalita resta ferma per ore, NON ricevi altre email su quella stessa risalita. Solo:

• Una nuova email se l'evento "rientra" e poi "scatta di nuovo" (ciclo nuovo)
• Email diverse per eventi diversi (se 3 cose vanno in errore, 3 email)

Questo per evitare il classico fenomeno "ho ricevuto 250 email per la stessa pompa che era ferma una notte".

4. Apri la pagina Notifiche

Dal portale JoyReef:

1. Menu di sinistra → "Notifiche" (icona campanella 🔔)
2. Oppure vai a portal.joy-reef.com/notifications

Si apre la pagina "Notifiche" con:

• Header con titolo, sottotitolo + pillola di stato "Email abilitate"/"Email disabilitate"
• Toggle "Notifiche email" (on/off)
• Stats: "Attive: X · Storico: Y"
• Sezione "Attive" con lista delle notifiche in corso
• Sezione "Storico recente" con lista dei cambi di stato passati

5. Step 1 — Attiva le email

Nel toggle "Notifiche email" in alto, clicca per attivarlo. Diventa verde.

Vedi un breve banner di conferma "Notifiche abilitate", e la pillola in alto cambia da "Email disabilitate" a "Email abilitate".

Da questo momento, ogni notifica di livello critico ti arriverà via email all'indirizzo del tuo profilo.

💡 Test immediato: il modo più semplice di verificare che le email arrivino è aspettare il primo evento reale. Se vuoi forzare un test puoi stacarre fisicamente la pompa di risalita per 5 minuti (vedi guida 13 sez. 11 - test consigliato). Ricevi l'email "Risalita ferma", la riattacchi, in pochi minuti torna tutto normale e ricevi (in storico) la conferma di "rientrata".

6. Step 2 — Leggi la sezione Attive

La sezione "Attive" mostra le notifiche in corso adesso: eventi scattati che non sono ancora rientrati.

Per ogni notifica vedi:

• Etichetta dell'evento (es. "ATO in fault", "Risalita ferma")
• Stato: 🟢 "Attiva"
• Timestamp di quando è scattata

💡 Se la sezione è vuota = "Nessuna notifica attiva". Buon segno, tutto a posto.

Le notifiche attive non si possono "chiudere" a mano: rientrano automaticamente quando la condizione sottostante si risolve (es. la risalita riparte, l'ATO viene riattivato, il device torna online). A quel punto sparisce da Attive e compare in Storico.

7. Step 3 — Leggi la sezione Storico

La sezione "Storico recente" mostra gli ultimi N cambi di stato (sia trigger che rientri).

Per ogni voce vedi:

• Etichetta dell'evento
• Stato: 🟢 Attiva / ⚪ Rientrata
• Timestamp del trigger
• Se rientrata: "Rientro: HH:MM"

💡 Usa lo storico per: capire quanto frequentemente un certo problema si verifica. Esempio: se "Skimmer fermo" appare 3 volte nell'ultima settimana, c'è un problema sistemico (intasamento ricorrente, pompa che si blocca per scarsa manutenzione, debordamento).

8. Disattivare le notifiche

Per disattivare:

1. Vai in /notifications
2. Clicca il toggle "Notifiche email" → diventa grigio
3. Banner "Notifiche disabilitate"

Da questo momento non riceverai più email, ma gli eventi continueranno comunque a essere registrati in /events (vedi guida 14). Puoi controllarli a mano.

💡 Quando disattivare temporaneamente: vacanza in cui sei in zona senza copertura, manutenzione lunga della vasca (cambio acqua + pulizia + dosometriche + ecc.), test di setup iniziale (per non ricevere alert mentre stai sperimentando).

⚠️ Ricordati di riattivarle dopo. Notifiche disattivate sono il miglior modo per perdere un problema serio "perché non me lo ha detto nessuno".

9. Se qualcosa non va

Ho attivato le email ma non ne ricevo

Diagnostica in ordine:

1. Controlla la cartella SPAM/Promozioni del tuo provider email. Le email automatiche tipicamente finiscono lì le prime volte
2. Aggiungi noreply@joy-reef.com (o l'indirizzo da cui arrivano) alla rubrica → marca come "Non spam" → in futuro arrivano in posta principale
3. Verifica l'email del profilo (Menu utente → Profilo): dev'essere confermata (badge "Email verificata"). Se non confermata, riinvia il link di verifica.
4. Controlla che ci siano davvero eventi critici da notificare: se la vasca è perfetta, semplicemente non ci sono email da inviare. Vai in /events filtro "Errori" → se la lista è vuota, è tutto ok!
5. Provider email che blocca/ritarda: Gmail e Outlook personali funzionano sempre. Alcune email aziendali (.edu, .gov, .corporate) hanno filtri rigorosi che bloccano le email automatiche → cambia con un indirizzo personale

Ricevo troppe email

Probabile causa: hai un problema reale ricorrente. Le email JoyReef non si "moltiplicano" da sole — se ne ricevi tante per la stessa cosa, significa che la condizione "scatta + rientra + scatta + rientra" più volte.

• Vai in /events filtro "Errori" e identifica il pattern
• Risolvi la causa sottostante (es. sensore galleggiante intasato che oscilla)
• Le email cesseranno

Se l'evento ricorrente non è risolvibile rapidamente, considera la modalità manutenzione (per energy/health, vedi guida 13) per silenziare gli alert finché non sistemi.

L'email è in inglese / italiano sbagliato

Le notifiche usano la lingua del profilo. Verifica nel tuo profilo che la lingua sia "Italiano" e non "English" (impostata di default per nuovi account in alcuni ambienti).

Voglio inoltrare le email a più persone (es. moglie / cliente)

JoyReef invia a un solo indirizzo (quello del profilo). Per inoltrare:

• Crea una regola di inoltro sul tuo client email (Gmail, Outlook hanno tutti questa funzione): "se l'email viene da joy-reef.com → inoltra a XXX@yyy.com"
• Oppure usa un alias email (mailgun, fastmail) che inoltra a più persone

In una versione futura potremmo aggiungere notifiche multi-destinatario nativamente.

Voglio ricevere notifiche push sul cellulare (non email)

Per ora non supportato direttamente. Workaround:

• Gmail/Outlook app sul cellulare: queste app fanno push delle email in arrivo → equivalente a una notifica push
• Configura un'etichetta/filtro nell'app per evidenziare le email di JoyReef → suono diverso, badge sull'icona
• Quando avremo notifiche push native (Firebase/APNs), la guida verrà aggiornata

10. Prossimo passo

Hai le notifiche attive. La vasca ora ti chiama quando ha bisogno, invece di aspettare che tu vada a controllarla.

Restano poche altre funzionalità del portale da documentare:

➡️ Guida 16 — Installazione firmware via USB (per chi vuole aggiornare il firmware del controller o della dosometrica direttamente da browser)

💡 Consiglio finale per non vivere in ansia: una volta attivate le notifiche, non controllare ossessivamente il portale. Se ricevi un'email → guardi. Se non la ricevi → la vasca sta bene. La pagina /events resta lì per il check rituale del mattino, ma il vero scopo del sistema è non doverla guardare.