diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index 55bade4..8cfe70f 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -9,14 +9,15 @@ schema in [docs/DATABASE.md](docs/DATABASE.md), le procedure in ## Stato generale -- **Versione:** 1.3.1 (in produzione su `main` la 1.3.0, tag `v1.3.0`) — il Calendario mostra solo i prossimi +- **Versione:** 1.4.0 (in produzione su `main` la 1.3.0, tag `v1.3.0`) — avviso «Presenza modificata» ad admin e + allenatori (DD-050, `m32`-`m33`). La 1.3.1: il Calendario mostra solo i prossimi compleanni del mese; tolta la serie «Conferme 24h» con i badge «Risposta lampo» e «Mai un forfait». La 1.3.0 portava la notifica di compleanno, gli obiettivi cliccabili, le presenze sui convocati, gli avvisi in Home ridisegnati e i caratteri più grandi. Dettaglio in [docs/CHANGELOG.md](docs/CHANGELOG.md). - **Backend:** Supabase proprietario (`kfkcldwncxqaixetsjes`). Lovable Cloud e il vecchio Project Ref `hetycilxgkdmccelwerq` non si usano più. -- **Migration:** 44 file in `supabase/migrations/`, fino a `m33_presenza_modificata_allenatori`. Fino alla `m32` applicate in produzione (verificato con `npx supabase migration list` il - 09/10/2026); la `m32` (DD-050, avviso «Presenza modificata» ai soli admin) è stata applicata quel giorno; la `m33` (anche agli allenatori) no, ancora da applicare. La `m29` toglie +- **Migration:** 44 file in `supabase/migrations/`, fino a `m33_presenza_modificata_allenatori`. Tutte applicate in produzione (verificato con `npx supabase migration list` il + 09/10/2026; la `m32` è l'avviso «Presenza modificata» ai soli admin, DD-050). La `m33`, che lo estende agli allenatori, è stata applicata il 09/10/2026. La `m29` toglie `foto_path`: il codice che non la legge più (1.2.2) va rilasciato. - **Worker delle notifiche** (`mailer/`): in funzione su un Raspberry Pi con Docker dal 29/09/2026 ([docs/WORKER_EMAIL.md](docs/WORKER_EMAIL.md)). Il codice con l'interruttore «Email» in Profilo diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 0759750..3641570 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -13,12 +13,17 @@ versioni `0.y.z` erano pre-release. ## [Non rilasciato] +## [1.4.0] - 2026-10-09 + +Gli admin e gli allenatori vengono avvisati quando una presenza cambia a ridosso di una partita o di un allenamento. +Due migration, `m32` e `m33`, entrambe applicate in produzione il 09/10/2026. + ### Aggiunto -- **Notifica «Presenza modificata» (DD-050)** — quando una risposta a una partita o a - un allenamento cambia, compare o viene ritirata a meno di 6 ore dall'inizio, gli admin e gli allenatori ricevono una notifica - (centro notifiche, push, email) con chi, quale evento e lo stato prima e dopo. Migration `m32` (solo admin, - applicata in produzione il 09/10/2026) e `m33` (anche allenatori). +- **Notifica «Presenza modificata» (DD-050)** — quando una risposta a una partita o a un allenamento cambia, + compare o viene ritirata a meno di 6 ore dall'inizio, gli admin e gli allenatori ricevono una notifica (centro + notifiche, push, email) con chi, quale evento e lo stato prima e dopo. Migration `m32` (solo admin, applicata in + produzione il 09/10/2026) e `m33` (aggiunge gli allenatori, applicata il 09/10/2026). ## [1.3.1] - 2026-10-06 diff --git a/docs/DATABASE.md b/docs/DATABASE.md index e772ccc..fd41d24 100644 --- a/docs/DATABASE.md +++ b/docs/DATABASE.md @@ -126,7 +126,7 @@ votante e votato convocati all'evento (RLS, `evento_permette_voto()`, DD-027). `sollecita_presenze_24h`, `_12h`, `_6h`, scritti dai job (DD-040). `turno_palloni` e `sollecita_presenze` restano i tipi dei pulsanti manuali. - Il trigger delle email salta tutti i tipi `turno_palloni*`; quello delle push accoda i tipi - automatici (compleanni compresi) ma non quelli dei pulsanti. + automatici (compleanni e `presenza_modificata` compresi) ma non quelli dei pulsanti. `presenza_modificata` ha `evento_id` NULL (come `admin`): la UNIQUE non si applica e ogni modifica resta una riga (M32, DD-050). ### Code di invio (`notifiche_email_coda`, `notifiche_push_coda`) diff --git a/docs/modules/notifiche-email.md b/docs/modules/notifiche-email.md index 6c1937e..82560f8 100644 --- a/docs/modules/notifiche-email.md +++ b/docs/modules/notifiche-email.md @@ -49,7 +49,7 @@ App su Vercel ──scrive──▶ notifiche_utente ──trigger──▶ noti ## Quali notifiche e a chi -**Ogni riga nuova di `notifiche_utente` genera una mail**: messaggio admin, sollecito presenze, sondaggio pre-partita, compleanno (DD-047: solo il titolo, senza corpo; la mail ha oggetto, link e avviso di disattivazione). **Fa eccezione il turno palloni** (DD-040, dalla +**Ogni riga nuova di `notifiche_utente` genera una mail**: messaggio admin, sollecito presenze, sondaggio pre-partita, compleanno (DD-047: solo il titolo, senza corpo; la mail ha oggetto, link e avviso di disattivazione), presenza modificata (DD-050, ad admin e allenatori). **Fa eccezione il turno palloni** (DD-040, dalla `m26`): per i tipi `turno_palloni`, `turno_palloni_12h`, `_6h`, `_3h` e `turno_palloni_revocato` il trigger non accoda nulla, restano push e centro notifiche. Un tipo nuovo che in futuro finisse in quella tabella viaggerebbe per email senza altro lavoro. Le notifiche già presenti quando si applica la migration diff --git a/docs/modules/notifiche.md b/docs/modules/notifiche.md index ecce147..83713eb 100644 --- a/docs/modules/notifiche.md +++ b/docs/modules/notifiche.md @@ -46,9 +46,9 @@ quelle del turno palloni**, che restano solo push e in-app: DD-040). | 8 | **Compleanno** — auguri al festeggiato, avviso agli altri | **Automatica**, **una volta al giorno, dalle 8:00** (fuso `Europe/Rome`) per chi compie gli anni quel giorno (DD-047, `m31`): job `pg_cron` ogni ora, funzione `genera_avvisi_compleanno()`, registro `compleanni_notificati`; tipi `compleanno_auguri` e `compleanno`, push dal worker. Nessun pulsante manuale. | **Tutti i membri attivi**, allenatori compresi: il festeggiato riceve gli auguri, gli altri l'avviso. Con più compleanni lo stesso giorno, un solo messaggio a testa (agli altri con tutti i nomi, a ogni festeggiato solo i propri auguri). | sì | sì | sì | | 9 | **Presenza modificata** — «Presenza modificata: _Nome Cognome_» _(DD-050, `m32` e `m33`)_ | **Automatica**, a ogni cambio di una risposta in `risposte_presenze` (nuova, modificata o ritirata) quando mancano da 0 a 6 ore all'inizio di una partita o di un allenamento: trigger sul database, tipo `presenza_modificata`, una notifica per modifica, push dal worker. | Gli **admin e gli allenatori attivi** (DD-050, `m33`; la `m32` li dava ai soli admin). Mai il giocatore a cui appartiene la presenza. | sì | sì | sì | -Le notifiche generate dal server (righe 1-6 e 8) hanno tutti e tre i canali (DD-038), tranne il turno palloni (riga 4), che non manda email (DD-040). La +Le notifiche generate dal server (righe 1-6, 8 e 9) hanno tutti e tre i canali (DD-038), tranne il turno palloni (riga 4), che non manda email (DD-040). La differenza sta in come parte la push: quelle dei pulsanti (3 e 6) la mandano le route dell'app, quelle -automatiche (4, 5 e 8; la 1 e la 2 non esistono più) nascono nel database e la manda il worker `mailer/` (vedi «Push dei +automatiche (4, 5, 8 e 9; la 1 e la 2 non esistono più) nascono nel database e la manda il worker `mailer/` (vedi «Push dei promemoria»). Il sondaggio riscrive la notifica esistente se l'admin preme di nuovo il pulsante per lo stesso evento (vedi «Centro notifiche in-app»). @@ -160,17 +160,18 @@ descrivono come funzionavano fino alla `m28`: la funzione esiste ancora ma nessu ### Test che verificano il catalogo -| Cosa | Test | -| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Promemoria 24 e 3 ore (funzione ancora presente ma non pianificata, M28): destinatari (convocati, tutti i giocatori attivi se `convocati` è vuoto, mai l'allenatore), deduplica, eliminazione, coda push ed email | `test/integration/destinatari-notifiche.test.ts`, `promemoria-eventi.test.ts`, `push-promemoria.test.ts`, `notifiche-email.test.ts`; niente job pianificati: `notifiche-automatiche.test.ts` (M28) | -| Messaggio dello staff: push a tutti i dispositivi (allenatore compreso) o a uno solo, in-app a tutta la rosa attiva, riservato agli admin | `destinatari-notifiche.test.ts`, `notifiche-utente.test.ts` | -| Turno palloni: incaricato e chi li aveva prima, solo allenamenti e partite, riservato agli admin | `destinatari-notifiche.test.ts`, `unit/palloni-core.test.ts` | -| Sollecito presenze: chi non ha risposto o ha detto «forse», mai l'allenatore; permesso ad allenatore e admin, non ai giocatori | `destinatari-notifiche.test.ts`, `unit/presenze.test.ts` | -| Sondaggio pre-partita: push senza allenatori, avviso in-app ed email ai giocatori attivi, `upsert`, riservato agli admin | `destinatari-notifiche.test.ts`, `sondaggio-notifiche.test.ts`, `unit/cacche.test.ts` | -| Promemoria con «oggi/domani», turno palloni a 3 ore e revoca, solleciti a 24 ore (manuale compreso): finestre, destinatari, una sola volta, registro (DD-040, `m26`; palloni a 3 ore: DD-042, solleciti a 24 ore: DD-045, `m30`; `m27`) | `integration/notifiche-automatiche.test.ts`, `promemoria-eventi.test.ts` (testo oggi/domani), `destinatari-notifiche.test.ts` (pulsanti), `unit/palloni-core.test.ts`, `unit/presenze.test.ts` | -| Compleanno: ora (anche con l'ora legale), festeggiato e altri, più compleanni lo stesso giorno, una sola volta anche se eliminata, push ed email in coda, 29 febbraio, job pianificato (DD-047, `m31`) | `integration/notifiche-compleanno.test.ts` | -| Worker: esiti, backoff, tetto giornaliero, iscrizioni scadute | `unit/mailer-core.test.ts` | -| L'allenatore è fuori dalla rosa di gioco | `unit/giocatori-squadra.test.ts` (`inRosa`) | +| Cosa | Test | +| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Promemoria 24 e 3 ore (funzione ancora presente ma non pianificata, M28): destinatari (convocati, tutti i giocatori attivi se `convocati` è vuoto, mai l'allenatore), deduplica, eliminazione, coda push ed email | `test/integration/destinatari-notifiche.test.ts`, `promemoria-eventi.test.ts`, `push-promemoria.test.ts`, `notifiche-email.test.ts`; niente job pianificati: `notifiche-automatiche.test.ts` (M28) | +| Messaggio dello staff: push a tutti i dispositivi (allenatore compreso) o a uno solo, in-app a tutta la rosa attiva, riservato agli admin | `destinatari-notifiche.test.ts`, `notifiche-utente.test.ts` | +| Turno palloni: incaricato e chi li aveva prima, solo allenamenti e partite, riservato agli admin | `destinatari-notifiche.test.ts`, `unit/palloni-core.test.ts` | +| Sollecito presenze: chi non ha risposto o ha detto «forse», mai l'allenatore; permesso ad allenatore e admin, non ai giocatori | `destinatari-notifiche.test.ts`, `unit/presenze.test.ts` | +| Sondaggio pre-partita: push senza allenatori, avviso in-app ed email ai giocatori attivi, `upsert`, riservato agli admin | `destinatari-notifiche.test.ts`, `sondaggio-notifiche.test.ts`, `unit/cacche.test.ts` | +| Promemoria con «oggi/domani», turno palloni a 3 ore e revoca, solleciti a 24 ore (manuale compreso): finestre, destinatari, una sola volta, registro (DD-040, `m26`; palloni a 3 ore: DD-042, solleciti a 24 ore: DD-045, `m30`; `m27`) | `integration/notifiche-automatiche.test.ts`, `promemoria-eventi.test.ts` (testo oggi/domani), `destinatari-notifiche.test.ts` (pulsanti), `unit/palloni-core.test.ts`, `unit/presenze.test.ts` | +| Compleanno: ora (anche con l'ora legale), festeggiato e altri, più compleanni lo stesso giorno, una sola volta anche se eliminata, push ed email in coda, 29 febbraio, job pianificato (DD-047, `m31`) | `integration/notifiche-compleanno.test.ts` | +| Presenza modificata: finestra di 0-6 ore, solo partite e allenamenti, admin e allenatori attivi (non gli inattivi né chi non ha slot, una sola notifica a chi ha due ruoli), mai il giocatore stesso, tutti gli stati, nessun avviso se lo stato non cambia o l'evento è cancellato, push ed email in coda (DD-050, `m32`-`m33`) | `integration/presenza-modificata.test.ts`, `unit/notifiche-utente.test.ts` (tipo) | +| Worker: esiti, backoff, tetto giornaliero, iscrizioni scadute | `unit/mailer-core.test.ts` | +| L'allenatore è fuori dalla rosa di gioco | `unit/giocatori-squadra.test.ts` (`inRosa`) | Le push dei test vanno a un servizio push finto in locale: si verifica **a chi** arrivano, non la consegna su un telefono. Non ha un test l'esclusione dell'allenatore dalle **notifiche smart**: la diff --git a/package-lock.json b/package-lock.json index 617b292..e98bbb3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "crapp", - "version": "1.3.1", + "version": "1.4.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "crapp", - "version": "1.3.1", + "version": "1.4.0", "dependencies": { "@supabase/supabase-js": "^2.111.0", "@tailwindcss/vite": "^4.2.1", diff --git a/package.json b/package.json index 91e4999..9053f63 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "crapp", - "version": "1.3.1", + "version": "1.4.0", "private": true, "sideEffects": false, "type": "module", diff --git a/test/integration/presenza-modificata.test.ts b/test/integration/presenza-modificata.test.ts index 6229601..274bba5 100644 --- a/test/integration/presenza-modificata.test.ts +++ b/test/integration/presenza-modificata.test.ts @@ -12,7 +12,7 @@ * - ogni modifica è una notifica a sé (nessun raggruppamento) e ha la coda email e la coda push. * * Gira solo sullo stack locale (`npx supabase start`). Usa gli slot `g4` (chi risponde), `g5` (admin), - * `g6` (giocatore) e `g10` (allenatore) della rosa seed, ripristinati alla fine. + * `g6` (giocatore), `g9` (allenatore inattivo) e `g10` (allenatore) della rosa seed, ripristinati alla fine. */ import assert from "node:assert/strict"; import { statoLocale } from "../helpers/locale"; @@ -32,6 +32,7 @@ if (!locale) { const ADMIN = "g5"; const GIOCATORE = "g6"; const ALLENATORE = "g10"; + const INATTIVO = "g9"; const PREFISSO = "test-presenza-mod-"; const rest = (percorso: string, token: string, init?: RequestInit) => @@ -137,10 +138,12 @@ if (!locale) { try { const admin = await creaUtente(`${PREFISSO}admin-${Date.now()}@example.test`); const allenatore = await creaUtente(`${PREFISSO}allenatore-${Date.now()}@example.test`); - idUtenti.push(admin.id, allenatore.id); + const inattivo = await creaUtente(`${PREFISSO}inattivo-${Date.now()}@example.test`); + const senzaSlot = await creaUtente(`${PREFISSO}senza-slot-${Date.now()}@example.test`); + idUtenti.push(admin.id, allenatore.id, inattivo.id, senzaSlot.id); await scrivi("user_roles", "POST", { user_id: admin.id, role: "admin" }); tokenAdmin = admin.token; - for (const id of [RISPONDE, ADMIN, GIOCATORE, ALLENATORE]) { + for (const id of [RISPONDE, ADMIN, GIOCATORE, ALLENATORE, INATTIVO]) { const [riga] = await leggi>( `giocatori_squadra?id=eq.${id}&select=tipo,attivo,auth_user_id`, ); @@ -159,6 +162,16 @@ if (!locale) { { tipo: "allenatore", auth_user_id: allenatore.id }, tokenAdmin, ); + // Un allenatore con slot disattivato, un admin senza nessuno slot e un admin che ha anche il + // ruolo allenatore: nessuno dei primi due può ricevere, il terzo riceve una sola notifica. + await scrivi( + `giocatori_squadra?id=eq.${INATTIVO}`, + "PATCH", + { tipo: "allenatore", auth_user_id: inattivo.id, attivo: false }, + tokenAdmin, + ); + await scrivi("user_roles", "POST", { user_id: senzaSlot.id, role: "admin" }); + await scrivi("user_roles", "POST", { user_id: admin.id, role: "allenatore" }); await svuota(); const [chi] = await leggi<{ nome: string; cognome: string }>( @@ -300,6 +313,93 @@ if (!locale) { assert.equal((await notifiche()).length, 0); }); + await prova( + "destinatari: né inattivi né senza slot, e una sola notifica a chi ha due ruoli", + async () => { + await svuota(); + const id = `${PREFISSO}destinatari`; + await creaEvento(id, "partita", 4); + idEventi.push(id); + await risposta(id, "presente"); + const destinatari = (await notifiche()).map((r) => r.giocatore_id); + assert.ok(!destinatari.includes(INATTIVO), "slot disattivato"); + assert.deepEqual([...destinatari].sort(), await attesi()); + assert.equal( + destinatari.filter((d) => d === ADMIN).length, + 1, + "chi ha sia il ruolo admin sia allenatore riceve una sola notifica", + ); + }, + ); + + await prova( + "cambio di un giocatore: avvisati admin e allenatore, mai il giocatore stesso", + async () => { + await svuota(); + const id = `${PREFISSO}per-conto`; + await creaEvento(id, "partita", 2); + idEventi.push(id); + await risposta(id, "presente"); + await aggiorna(id, "assente"); + const destinatari = new Set((await notifiche()).map((r) => r.giocatore_id)); + assert.ok(destinatari.has(ALLENATORE) && destinatari.has(ADMIN)); + assert.ok(!destinatari.has(RISPONDE)); + }, + ); + + await prova("tutti gli stati hanno il loro nome nel testo", async () => { + await svuota(); + const id = `${PREFISSO}stati`; + await creaEvento(id, "allenamento", 1); + idEventi.push(id); + const sequenza = ["presente", "assente", "forse", "ritardo", "infortunato"]; + await risposta(id, sequenza[0]!); + for (const stato of sequenza.slice(1)) await aggiorna(id, stato); + const corpi = (await notifiche()) + .filter((r) => r.giocatore_id === ADMIN) + .map((r) => r.corpo.split("\n").slice(2).join("|")); + assert.deepEqual(corpi, [ + "Da: nessuna risposta|A: presente", + "Da: presente|A: assente", + "Da: assente|A: forse", + "Da: forse|A: in ritardo", + "Da: in ritardo|A: infortunato", + ]); + }); + + // Confini della finestra: la soglia è di 6 ore esatte (da 0 a 6). + for (const [nome, ore, avvisa] of [ + ["a 5 ore e 50 minuti", 5 + 50 / 60, true], + ["a 6 ore e 10 minuti", 6 + 10 / 60, false], + ["a 10 minuti", 10 / 60, true], + ["iniziato da 10 minuti", -10 / 60, false], + ] as const) { + await prova(`finestra: evento ${nome} ${avvisa ? "avvisa" : "non avvisa"}`, async () => { + await svuota(); + const id = `${PREFISSO}soglia-${idEventi.length}`; + await creaEvento(id, "partita", ore); + idEventi.push(id); + await risposta(id, "presente"); + assert.equal((await notifiche()).length > 0, avvisa); + }); + } + + await prova("ora dell'evento illeggibile: nessun avviso e nessun errore", async () => { + await svuota(); + const id = `${PREFISSO}ora-illeggibile`; + const { data } = traOre(3); + await scrivi("eventi_app", "POST", { + id, + tipo: "partita", + titolo: "Ora strana", + data, + ora: "boh", + }); + idEventi.push(id); + await risposta(id, "presente"); + assert.equal((await notifiche()).length, 0); + }); + await prova("la funzione non è chiamabile dai client", async () => { for (const token of [ANON, admin.token]) { const res = await fetch(`${URL_BASE}/rest/v1/rpc/avvisa_presenza_modificata`, {