diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index 5320a6a..ec4767b 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -9,12 +9,14 @@ schema in [docs/DATABASE.md](docs/DATABASE.md), le procedure in ## Stato generale -- **Versione in produzione:** 1.2.1 su `main` — notifiche su tre canali (push, in-app, email), - promemoria che non si ripetono, turno palloni e solleciti presenze automatici. +- **Versione:** 1.2.2 su `develop` (su `main`, in produzione, resta la 1.2.1 fino al merge) — notifiche + su tre canali, avvisi di palloni (3 ore prima) e presenze (24 ore prima) una sola volta, niente + promemoria evento, niente foto tessera, avviso certificato a 30 giorni per il giocatore. - **Backend:** Supabase proprietario (`kfkcldwncxqaixetsjes`). Lovable Cloud e il vecchio Project Ref `hetycilxgkdmccelwerq` non si usano più. -- **Migration:** 37 file in `supabase/migrations/`, fino a `m26_notifiche_automatiche`, tutte - applicate in produzione (verificato con `npx supabase migration list` il 30/09/2026). +- **Migration:** 41 file in `supabase/migrations/`, fino a `m30_sollecito_solo_24h`, tutte + applicate in produzione (verificato con `npx supabase migration list` il 01/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 è su `develop`, non ancora su `main`. diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index e74a0e4..8bdee37 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -13,6 +13,39 @@ versioni `0.y.z` erano pre-release. ## [Non rilasciato] +## [1.2.2] - 2026-10-01 + +Meno notifiche automatiche e un profilo più snello: gli avvisi dei palloni e delle presenze partono una sola volta, il +promemoria degli eventi non c'è più, la foto tessera è stata tolta e l'avviso del certificato medico arriva al +giocatore un mese prima. Le migration `m27`–`m30` sono applicate in produzione dal 01/10/2026; questa versione porta il +codice dell'app che le accompagna, da rilasciare subito: la `m29` ha tolto la colonna `foto_path` che la versione +precedente ancora legge. + +### Rimosso + +- **Foto tessera del profilo** — il giocatore non la carica più e l'admin non la vede nella scheda; il + completamento del profilo si calcola su dati personali (34%), documento (33%) e certificato (33%). Migration + `m29_senza_foto_tessera` (elimina la colonna `foto_path`); i file già caricati sono stati cancellati dal + bucket `profili-giocatore` (DD-044). Applicata in produzione il 01/10/2026, con la cancellazione dei 4 file già caricati. + +- **Promemoria evento a 24 e 3 ore** — non partono più per nessun evento (allenamenti, partite, extra-campo): + niente notifica, push né email. Migration `m28_niente_promemoria_evento` (tolti i due job `pg_cron`; + funzione, tipi e notifiche già generate restano). Applicata in produzione il 01/10/2026 (DD-043). + +### Modificato + +- **Sollecito presenze: un solo avviso automatico, 24 ore prima** — a chi non ha risposto o ha risposto + «forse»; prima ne partivano tre (24, 12 e 6 ore). Il pulsante «Sollecita» non cambia. Migration + `m30_sollecito_solo_24h`, applicata in produzione il 01/10/2026 (DD-045). + +- **Turno palloni: un solo avviso, 3 ore prima** — a chi deve portare i palloni e a chi li deve + prendere; prima ne partivano tre (12, 6 e 3 ore). Migration `m27_palloni_solo_3h`, applicata in + produzione il 01/10/2026 (DD-042). + +- **Avviso certificati: giocatore a 30 giorni** — il giocatore vede l'avviso giallo sul proprio + certificato medico da un mese prima della scadenza (prima 7 giorni). Per gli admin non cambia + nulla: 7 giorni prima in giallo, nero dopo la scadenza (DD-041). + ## [1.2.1] - 2026-09-30 Turno palloni e sollecito presenze partono anche da soli, a orari fissi prima dell'evento, e i testi di diff --git a/docs/DATABASE.md b/docs/DATABASE.md index 416ba6b..3779090 100644 --- a/docs/DATABASE.md +++ b/docs/DATABASE.md @@ -66,10 +66,10 @@ Colonne di `giocatori_squadra` che meritano una nota: ## Storage -| Bucket | Scopo | Note | -| ------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `profili-giocatore` | Documento d'identità, certificato medico e foto tessera, in cartelle per giocatore (`/.`). | **Privato e destinato a restare tale**: documenti e dati sanitari non devono mai avere URL pubblici (DD-016 regola 4). Il giocatore gestisce solo la propria cartella; l'admin scarica tutto con signed URL a scadenza breve. | -| `avatar-giocatori` | Foto profilo (`/avatar.jpg`). | **Pubblico**: foto informali. Qualsiasi autenticato può caricare, sostituire o eliminare un file (nessun controllo per proprietario: la maggior parte dei giocatori non ha ancora `auth_user_id`, DD-018). Letto da `src/lib/avatar-store.ts`. | +| Bucket | Scopo | Note | +| ------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `profili-giocatore` | Documento d'identità e certificato medico, in cartelle per giocatore (`/.`). | **Privato e destinato a restare tale**: documenti e dati sanitari non devono mai avere URL pubblici (DD-016 regola 4). Il giocatore gestisce solo la propria cartella; l'admin scarica tutto con signed URL a scadenza breve. | +| `avatar-giocatori` | Foto profilo (`/avatar.jpg`). | **Pubblico**: foto informali. Qualsiasi autenticato può caricare, sostituire o eliminare un file (nessun controllo per proprietario: la maggior parte dei giocatori non ha ancora `auth_user_id`, DD-018). Letto da `src/lib/avatar-store.ts`. | ## Eventi e presenze @@ -151,15 +151,15 @@ Le notifiche automatiche nascono nel database, da job `pg_cron` che chiamano fun riservate alla service role (anon e utenti autenticati non possono chiamarle). Testi e regole sono in [modules/notifiche.md](modules/notifiche.md); le decisioni in DD-037, DD-038 e DD-040. -| Funzione (migration) | Cosa fa | Job `pg_cron` | -| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -| `genera_promemoria_eventi(tipo, finestra)` (M17, M23, M26) | Promemoria a 24 e 3 ore, con «oggi/domani», data, ora e luogo. | `promemoria-eventi-24h` (ogni ora), `-3h` (15 min) | -| `genera_avvisi_palloni()` (M26), con `genera_avvisi_palloni_fascia()` | Avvisi del turno palloni a 12, 6 e 3 ore per gli eventi con un incaricato confermato; poi chiama `genera_revoche_palloni()`. | `avvisi-palloni-automatici` (15 min) | -| `genera_revoche_palloni()` (M26) | Una revoca per chi aveva un avviso automatico e non è più destinatario, per eventi non ancora iniziati; guarda il registro. | (dentro `genera_avvisi_palloni()`) | -| `genera_solleciti_presenze()` (M26), con `..._fascia()` | Solleciti a 24, 12 e 6 ore ai destinatari dell'evento senza risposta o con «forse». | `solleciti-presenze-automatici` (15 min) | -| `inizio_evento(data, ora)` (M26) | Istante d'inizio di un evento in fuso `Europe/Rome`; `NULL` se l'ora non è valida, e l'evento viene solo escluso. | — | -| `giocatori_destinatari_evento(evento)` (M17, M21, M25) | Giocatori attivi destinatari: i convocati, o tutta la rosa se `convocati` è vuoto; mai gli allenatori. | — | -| `accoda_notifica_email()`, `accoda_push_promemoria()` (M22, M24, M26) | Trigger su `notifiche_utente`: la mail salta i tipi `turno_palloni*`; la push accoda i tipi automatici (non quelli dei pulsanti). | — | +| Funzione (migration) | Cosa fa | Job `pg_cron` | +| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | +| `genera_promemoria_eventi(tipo, finestra)` (M17, M23, M26) | Promemoria a 24 e 3 ore, con «oggi/domani», data, ora e luogo. **Non pianificata dalla M28** (DD-043): resta come funzione, nessun job la chiama. | `promemoria-eventi-24h` (ogni ora), `-3h` (15 min) | +| `genera_avvisi_palloni()` (M26, M27), con `genera_avvisi_palloni_fascia()` | Avviso del turno palloni a 3 ore (M27; in M26 erano 12, 6 e 3) per gli eventi con un incaricato confermato; poi chiama `genera_revoche_palloni()`. | `avvisi-palloni-automatici` (15 min) | +| `genera_revoche_palloni()` (M26) | Una revoca per chi aveva un avviso automatico e non è più destinatario, per eventi non ancora iniziati; guarda il registro. | (dentro `genera_avvisi_palloni()`) | +| `genera_solleciti_presenze()` (M26, M30), con `..._fascia()` | Sollecito a 24 ore (M30; in M26 erano 24, 12 e 6) ai destinatari dell'evento senza risposta o con «forse». | `solleciti-presenze-automatici` (15 min) | +| `inizio_evento(data, ora)` (M26) | Istante d'inizio di un evento in fuso `Europe/Rome`; `NULL` se l'ora non è valida, e l'evento viene solo escluso. | — | +| `giocatori_destinatari_evento(evento)` (M17, M21, M25) | Giocatori attivi destinatari: i convocati, o tutta la rosa se `convocati` è vuoto; mai gli allenatori. | — | +| `accoda_notifica_email()`, `accoda_push_promemoria()` (M22, M24, M26) | Trigger su `notifiche_utente`: la mail salta i tipi `turno_palloni*`; la push accoda i tipi automatici (non quelli dei pulsanti). | — | ## Badge diff --git a/docs/EFFICIENZA_CLOUD.md b/docs/EFFICIENZA_CLOUD.md index d782dc6..3a93f4b 100644 --- a/docs/EFFICIENZA_CLOUD.md +++ b/docs/EFFICIENZA_CLOUD.md @@ -19,7 +19,7 @@ Query, traffico e invocazioni vanno tenuti al minimo **per costruzione**, non ot si ricalcolano a ogni apertura di pagina. I badge restano calcolati a runtime dai dati già in cache, senza query aggiuntive (DD-007): `src/lib/rosa.ts` aggrega ciò che è già stato letto. -6. **Push solo per eventi importanti**: convocazioni, promemoria allenamento/partita, turno +6. **Push solo per eventi importanti**: convocazioni, turno palloni, esito finale. 7. **Niente funzionalità pesanti**: foto, video, chat. 8. **Indici** sui campi usati per filtri e relazioni in ogni nuova migration. diff --git a/docs/GLOSSARIO.md b/docs/GLOSSARIO.md index 1812865..28565bd 100644 --- a/docs/GLOSSARIO.md +++ b/docs/GLOSSARIO.md @@ -26,4 +26,4 @@ il campionato. Dove serve il dettaglio c'è il rimando al modulo. | **Worker** | Il container Docker in `mailer/` che invia email e push dei promemoria con la service role ([WORKER_EMAIL.md](WORKER_EMAIL.md)). | | **Service role** | Chiave Supabase che bypassa la RLS. Solo server e worker, mai il client ([OPERATIONS.md](OPERATIONS.md)). | | **DD-XXX** | Decisione registrata in [decisions/](decisions/README.md). | -| **M1…M26** | Numero d'ordine delle migration (`m26_notifiche_automatiche`…) in `supabase/migrations/`. | +| **M1…M27** | Numero d'ordine delle migration (`m27_palloni_solo_3h`…) in `supabase/migrations/`. | diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 6db1304..402191a 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -27,7 +27,7 @@ Tutto quello che è rilasciato, fino alla versione 1.0.0 (vedi `CHANGELOG.md`). - [x] Dashboard amministratore - [x] Download CSV dati - [x] Profilo Giocatore — dati personali, documento d'identità, certificato medico - (caricamento, scadenza, stato, download) e foto tessera; lo storico dei certificati + (caricamento, scadenza, stato, download); la foto tessera è stata tolta (DD-044); lo storico dei certificati resta un'estensione futura - [x] Gestione tesseramenti CSI — raccolta dati, export CSV e tracciamento di chi è già tesserato (numero e data di tessera) @@ -44,8 +44,8 @@ Tutto quello che è rilasciato, fino alla versione 1.0.0 (vedi `CHANGELOG.md`). - [x] Notifiche email — ogni notifica in-app inviata anche per email agli account registrati, da un worker Docker sull'host di casa via Gmail, con interruttore «Email» in Profilo ([specifica](modules/notifiche-email.md), DD-036) -- [x] Notifiche automatiche — promemoria con «oggi/domani», turno palloni 12, 6 e 3 ore prima, sollecito - presenze a 24, 12 e 6 ore (i pulsanti «Avvisa chi è di turno» e «Sollecita» restano) ([specifica](modules/notifiche.md#testi-delle-notifiche), DD-040) +- [x] Notifiche automatiche — turno palloni 3 ore prima, sollecito + presenze 24 ore prima (i pulsanti «Avvisa chi è di turno» e «Sollecita» restano; il promemoria a 24 e 3 ore è stato tolto, DD-043) ([specifica](modules/notifiche.md#testi-delle-notifiche), DD-040) ## Prossimo diff --git a/docs/WORKER_EMAIL.md b/docs/WORKER_EMAIL.md index 57e03b2..3707a7a 100644 --- a/docs/WORKER_EMAIL.md +++ b/docs/WORKER_EMAIL.md @@ -1,7 +1,7 @@ # Worker email: installazione e gestione Come si mette in funzione, si controlla e si diagnostica il worker (`mailer/`) che invia le notifiche -per email e le push delle notifiche che nascono nel database: promemoria a 24 e 3 ore, turno palloni a 12, 6 e 3 ore con revoca, solleciti presenze a 24, 12 e 6 ore (DD-040). Cosa fa il canale email sta in +per email e le push delle notifiche che nascono nel database: turno palloni a 3 ore con revoca, sollecito presenze a 24 ore (DD-040). Cosa fa il canale email sta in [modules/notifiche-email.md](modules/notifiche-email.md), la push dei promemoria in [modules/notifiche.md](modules/notifiche.md#push-dei-promemoria-m24); perché è fatto così in [DD-036](decisions/DD-036.md) diff --git a/docs/decisions/DD-016.md b/docs/decisions/DD-016.md index e01726c..66a09c0 100644 --- a/docs/decisions/DD-016.md +++ b/docs/decisions/DD-016.md @@ -16,7 +16,7 @@ Regole vincolanti: 1. **`giocatori_squadra` diventa progressivamente la source of truth** per l’anagrafica squadra. Durante la transizione, `crapp-data.ts` resta come **fallback** se il database non è disponibile o i dati non sono ancora migrati. 2. L’associazione **`auth_user_id` ↔ giocatore** è un’operazione **controllata e atomica** (es. al primo accesso da `/benvenuto`, con `UPDATE … WHERE auth_user_id IS NULL`). Il giocatore **non può modificare liberamente** `auth_user_id`; solo un admin può resettarlo in casi eccezionali. -3. I file (documento identità, certificato, foto tessera) vivono nel bucket Storage **`profili-giocatore`**, configurato come **privato**. +3. I file (documento identità, certificato; la foto tessera è stata tolta da DD-044) vivono nel bucket Storage **`profili-giocatore`**, configurato come **privato**. 4. Documenti personali e sanitari **non devono mai essere esposti tramite URL pubblici**. Accesso solo tramite client autenticato con policy RLS, o signed URL a scadenza breve per download admin. 5. Le **tabelle preesistenti non vengono modificate** (`eventi_app`, `risposte_presenze`, voti, palloni, scout, push, ecc.). Il profilo si aggancia agli ID `g1`…`g17` già in uso, senza migrare verso UUID per ora (coerente con DD-012). 6. La tabella `giocatori` (UUID) resta **invariata e non usata** dal modulo profilo. diff --git a/docs/decisions/DD-017.md b/docs/decisions/DD-017.md index 451bf9a..4ceee4f 100644 --- a/docs/decisions/DD-017.md +++ b/docs/decisions/DD-017.md @@ -15,7 +15,7 @@ Dalla dashboard amministratore, un admin può: Restano fuori, e non cambiano: -- i **file** (documento, certificato, foto): l'admin li scarica ma non li carica né li sostituisce. Un documento d'identità lo produce il suo titolare, e la catena di responsabilità deve restare leggibile; +- i **file** (documento, certificato; la foto tessera è stata tolta da DD-044): l'admin li scarica ma non li carica né li sostituisce. Un documento d'identità lo produce il suo titolare, e la catena di responsabilità deve restare leggibile; - il **giocatore**, che continua a non poter toccare i propri dati squadra. **Alternative scartate** diff --git a/docs/decisions/DD-025.md b/docs/decisions/DD-025.md index 061a06b..67ac8f4 100644 --- a/docs/decisions/DD-025.md +++ b/docs/decisions/DD-025.md @@ -50,5 +50,5 @@ torna utile, e con lui il segreto: DD-024 descrive già come farlo. --- -**Aggiornamento (30 settembre 2026)** — DD-040 affianca al pulsante un invio automatico a 12, 6 e 3 ore -prima dell'evento, per gli eventi con un incaricato confermato; il pulsante e la route restano. +**Aggiornamento (30 settembre 2026)** — DD-040 affianca al pulsante un invio automatico (poi ridotto a uno solo, 3 ore +prima, da DD-042), per gli eventi con un incaricato confermato; il pulsante e la route restano. diff --git a/docs/decisions/DD-035.md b/docs/decisions/DD-035.md index 31c474c..64875cd 100644 --- a/docs/decisions/DD-035.md +++ b/docs/decisions/DD-035.md @@ -1,7 +1,7 @@ # DD-035 — Avviso certificati: calcolato in Home, visibile solo al titolare e agli admin **Data:** 24 settembre 2026 -**Stato:** Accettata (implementata, versione 1.1.0) +**Stato:** Accettata (implementata, versione 1.1.0). La soglia del giocatore è stata alzata a 30 giorni da [DD-041](DD-041.md); quella dello staff resta 7. **Contesto** Il certificato medico ha una data di scadenza (`profili_giocatore.certificato_scadenza`), ma @@ -49,7 +49,7 @@ certificato viene rinnovato. Specifica completa in - Il rinnovo non richiede nessuna azione di chiusura: cambiata la data, l'avviso si aggiorna da solo. - Chi non apre l'app non viene avvisato: l'avviso raggiunge solo chi entra in Home. -- Un admin che è anche giocatore vede solo l'avviso dello staff, dove compare il suo nome. +- ~~Un admin che è anche giocatore vede solo l'avviso dello staff~~ → superato da DD-041: vede anche il proprio avviso personale. **Riesame** Se gli avvisi in Home non bastano (certificati che scadono comunque senza essere rinnovati), diff --git a/docs/decisions/DD-040.md b/docs/decisions/DD-040.md index 7feb8f3..c0ea9f0 100644 --- a/docs/decisions/DD-040.md +++ b/docs/decisions/DD-040.md @@ -1,8 +1,7 @@ # DD-040 — Promemoria con «oggi» o «domani», turno palloni e solleciti automatici **Data:** 30 settembre 2026 -**Stato:** Accettata (implementata e verificata in locale: migration `m26`, job, route e test; la -migration non è ancora applicata in produzione) +**Stato:** Accettata (implementata: migration `m26`, applicata in produzione il 30 settembre 2026, job, route e test). Il sollecito presenze è poi passato a un solo avviso a 24 ore da [DD-045](DD-045.md). Il turno palloni è poi passato a un solo avviso a 3 ore da [DD-042](DD-042.md). **Contesto** Quattro notifiche su sei partivano da un pulsante premuto da un admin (DD-025 per i palloni): se nessuno diff --git a/docs/decisions/DD-041.md b/docs/decisions/DD-041.md new file mode 100644 index 0000000..688ea4f --- /dev/null +++ b/docs/decisions/DD-041.md @@ -0,0 +1,39 @@ +# DD-041 — Avviso certificati: il giocatore è avvisato un mese prima dello staff + +**Data:** 1 ottobre 2026 +**Stato:** Accettata (modifica la soglia di [DD-035](DD-035.md) per il solo giocatore) + +**Contesto** +Con DD-035 giocatore e admin vedono l'avviso negli stessi 7 giorni prima della scadenza. Per +il giocatore sono pochi: prenotare una visita di idoneità richiede più tempo (era il rischio +indicato nel Riesame di DD-035). All'admin invece un avviso così anticipato riempirebbe la +Home di nomi che non può ancora sollecitare con urgenza. + +**Decisione** + +1. Il **giocatore** vede l'avviso giallo da **30 giorni** prima della scadenza + (`GIORNI_AVVISO_CERTIFICATO_GIOCATORE`). +2. L'**admin** resta a **7 giorni** prima (`GIORNI_AVVISO_CERTIFICATO`), invariato. +3. Dopo la scadenza l'avviso è **nero** per entrambi, invariato. +4. L'**admin che è anche giocatore** vede il proprio avviso **personale** (30 giorni, + cliccabile) oltre a quello dello staff, dal quale il suo nome è tolto per non duplicarlo. +5. Nessun altro aspetto di DD-035 cambia: calcolo al volo, niente push, stessi destinatari. + +Esempio: scadenza il 5 ottobre 2026 → dal 5 settembre l'avviso giallo compare solo al +giocatore; dal 28 settembre compare anche agli admin; dal 6 ottobre è nero per entrambi. + +**Alternative scartate** + +- «Un mese» come mese di calendario → la soglia varierebbe tra 28 e 31 giorni; 30 giorni fissi + sono prevedibili e coincidono con l'esempio della richiesta. +- Soglia unica a 30 giorni anche per l'admin → elenco dello staff pieno con settimane di + anticipo, senza nulla da fare per l'admin che non può caricare il file (DD-017). + +**Conseguenze** + +- Il giocatore vede il conto alla rovescia «scade tra N giorni» con N fino a 30. +- `avvisiCertificati()` riceve la soglia come parametro (default 7, cioè lo staff). + +**Riesame** +Se 30 giorni risultano ancora pochi o troppi, cambiare la costante; se serve una soglia +regolabile dall'admin, vedi il Riesame di DD-035. diff --git a/docs/decisions/DD-042.md b/docs/decisions/DD-042.md new file mode 100644 index 0000000..ac911f6 --- /dev/null +++ b/docs/decisions/DD-042.md @@ -0,0 +1,36 @@ +# DD-042 — Turno palloni: un solo avviso, 3 ore prima + +**Data:** 1 ottobre 2026 +**Stato:** Accettata (migration `m27`, applicata in produzione il 1 ottobre 2026; modifica la parte «turno palloni» di [DD-040](DD-040.md)) + +**Contesto** +DD-040 manda l'avviso del turno palloni a 12, 6 e 3 ore prima dell'evento: tre messaggi identici per +chi deve portare i palloni e per chi deve prenderli. Sono troppi per un'informazione che non cambia. + +**Decisione** + +1. L'avviso automatico parte **una sola volta, 3 ore prima** dell'inizio (finestra «meno di 3 ore»), a + chi deve portare i palloni («incarico assegnato») e a chi li deve prendere («riconsegna», se è + un'altra persona). Testi, destinatari, push senza email e condizione dell'incaricato confermato + restano quelli di DD-040. +2. La revoca resta: chi è stato avvisato e poi non è più destinatario riceve una sola volta «incarico + revocato». Un evento creato o assegnato a meno di 3 ore dall'inizio riceve l'avviso al giro + successivo del job. +3. **Migration `m27`:** `genera_avvisi_palloni()` chiama solo la fascia `turno_palloni_3h`. I tipi + `turno_palloni_12h` e `_6h` **restano nei `CHECK`** e nella revoca, perché notifiche e righe di + registro già generate li usano; non ne nascono di nuovi. +4. Il pulsante «Avvisa chi è di turno» non cambia. I solleciti presenze non cambiano qui (poi ridotti a uno, DD-045). + +**Alternative scartate** + +- Togliere i tipi `12h` e `6h` dai `CHECK` → le righe già generate in produzione non sarebbero più + valide e la revoca non vedrebbe più chi ha ricevuto quegli avvisi. +- Tenere anche un avviso a 12 ore → scartata su indicazione esplicita: uno solo. + +**Conseguenze** + +- Chi non apre l'app nelle 3 ore prima può non vedere l'avviso; la push è il canale principale. +- Per le notifiche palloni già generate con DD-040 non cambia nulla. + +**Riesame** +Se 3 ore risultano poche per procurarsi i palloni, alzare la finestra (una sola, mai più avvisi). diff --git a/docs/decisions/DD-043.md b/docs/decisions/DD-043.md new file mode 100644 index 0000000..026c21d --- /dev/null +++ b/docs/decisions/DD-043.md @@ -0,0 +1,35 @@ +# DD-043 — Niente promemoria automatico a 24 e 3 ore prima degli eventi + +**Data:** 1 ottobre 2026 +**Stato:** Accettata (migration `m28`, applicata in produzione il 1 ottobre 2026; sostituisce il promemoria di +[DD-030](DD-030.md), [DD-037](DD-037.md) e [DD-040](DD-040.md)) + +**Contesto** +Il promemoria a 24 e 3 ore prima di ogni evento non serve: la squadra ha già il calendario, il +sollecito presenze (per chi non ha risposto) e l'avviso del turno palloni a 3 ore. + +**Decisione** + +1. Il database **non genera più** `evento_promemoria_24h` ed `evento_promemoria_3h`, per nessun tipo di + evento (allenamento, partita, extra-campo). +2. La migration `m28` toglie solo i due job `pg_cron` (`promemoria-eventi-24h` e `-3h`). + `genera_promemoria_eventi()`, i tipi nei `CHECK`, il registro `promemoria_eventi_generati` e la coda + push restano: le notifiche già create continuano a esistere e rimettere il promemoria richiede solo + un `cron.schedule`. +3. Non cambiano: sollecito presenze, turno palloni (DD-042), messaggio dello staff, sondaggio. + +**Alternative scartate** + +- Togliere il promemoria solo per gli allenamenti → scartata su indicazione esplicita: via per tutti. +- Cancellare funzione, tipi e registro → scartata: vanno tenute le notifiche già generate e il lavoro per + rimetterlo sarebbe molto più grande di un `cron.schedule`. + +**Conseguenze** + +- Meno notifiche per la squadra. Chi voleva il promemoria di una partita non lo riceve più. +- Funzione, test e registro restano come codice non pianificato: sono ancora coperti da + `promemoria-eventi.test.ts` e dagli altri test sulla funzione. + +**Riesame** +Se la squadra sente la mancanza del promemoria (per esempio solo per le partite), rimettere i job o +reintrodurlo per tipo di evento. diff --git a/docs/decisions/DD-044.md b/docs/decisions/DD-044.md new file mode 100644 index 0000000..a82236f --- /dev/null +++ b/docs/decisions/DD-044.md @@ -0,0 +1,38 @@ +# DD-044 — Via la foto tessera dal profilo + +**Data:** 1 ottobre 2026 +**Stato:** Accettata (migration `m29`, applicata in produzione il 1 ottobre 2026) + +**Contesto** +Il profilo amministrativo chiedeva al giocatore una foto formato tessera (DD-016), per il +tesseramento CSI. Non serve più: non viene richiesta nel tesseramento e resta un dato personale +da custodire. + +**Decisione** + +1. Il profilo **non ha più la foto tessera**: sparisce il campo di caricamento dal Profilo e la + voce «Foto» dalla scheda dell'admin. +2. **Completamento del profilo** su tre sezioni: dati personali 34%, documento 33%, certificato 33% + (prima 30/30/30/10). Il totale resta 100 e il widget «Completa il tuo profilo» sparisce con le + tre sezioni complete. +3. **Dati:** la migration `m29` elimina la colonna `profili_giocatore.foto_path`. I file + `/foto.*` del bucket privato `profili-giocatore` vanno cancellati con l'API + Storage (da SQL Storage lo vieta) prima della migration, perché dopo i path non sono più + leggibili. **Non toccati:** l'avatar (bucket `avatar-giocatori`), il documento e il certificato. +4. Ordine in produzione: **prima il rilascio del codice** (la versione precedente seleziona + `foto_path` e darebbe errore), poi cancellazione dei file, poi `m29`. + +**Alternative scartate** + +- Lasciare la colonna e nascondere solo l'interfaccia → scartata: resterebbe un dato personale + senza uso e senza un campo da cui aggiornarlo. +- Tenere i pesi 30/30/30 senza rinormalizzare → scartata: nessun profilo arriverebbe a 100%. + +**Conseguenze** + +- Cancellazione definitiva: le foto già caricate non si recuperano. +- Il 1 ottobre 2026 sono state cancellate in produzione le 4 foto caricate, poi la colonna. +- Le percentuali di completamento cambiano per tutti (chi aveva il 90% senza foto passa al 100%). + +**Riesame** +Se il comitato CSI dovesse richiedere di nuovo la foto, reintrodurla con una nuova decisione. diff --git a/docs/decisions/DD-045.md b/docs/decisions/DD-045.md new file mode 100644 index 0000000..4ddfd9e --- /dev/null +++ b/docs/decisions/DD-045.md @@ -0,0 +1,34 @@ +# DD-045 — Sollecito presenze: un solo avviso automatico, 24 ore prima + +**Data:** 1 ottobre 2026 +**Stato:** Accettata (migration `m30`, applicata in produzione il 1 ottobre 2026; modifica la parte «sollecito presenze» +di [DD-040](DD-040.md)) + +**Contesto** +DD-040 manda il sollecito presenze a 24, 12 e 6 ore prima dell'evento: fino a tre messaggi per chi non +risponde o resta su «forse». Ne basta uno. + +**Decisione** + +1. Il sollecito automatico parte **una sola volta, 24 ore prima** (finestra «meno di 24 ore»), a chi in + quel momento non ha risposto o ha risposto «forse» tra i destinatari dell'evento (convocati, o tutta + la rosa attiva; mai l'allenatore). Un evento creato a meno di 24 ore dall'inizio lo riceve comunque, + al giro successivo del job. Testo e canali (push, centro notifiche, email) restano quelli di DD-040. +2. Il **pulsante «Sollecita»** e la route `sollecita-presenze` non cambiano: l'admin o l'allenatore possono + sempre rimandarlo a mano, anche dopo l'automatico. +3. **Migration `m30`:** `genera_solleciti_presenze()` chiama solo la fascia `sollecita_presenze_24h`. I tipi + `sollecita_presenze_12h` e `_6h` restano nei `CHECK` per le notifiche già generate; non ne nascono di nuovi. + +**Alternative scartate** + +- Mandarlo a un orario più vicino (12 o 6 ore) → scartata su indicazione esplicita: 24 ore. +- Togliere i tipi `12h` e `6h` dai `CHECK` → le righe già generate non sarebbero più valide. + +**Conseguenze** + +- Chi risponde «forse» o non risponde dopo il sollecito non riceve altri avvisi automatici: tocca al + pulsante manuale. +- Il massimo di mail automatiche per giocatore ed evento scende a una (il sollecito). + +**Riesame** +Se il tasso di risposta cala, valutare un secondo sollecito più vicino all'evento, solo per chi non ha mai risposto. diff --git a/docs/decisions/README.md b/docs/decisions/README.md index db9f954..8cdc861 100644 --- a/docs/decisions/README.md +++ b/docs/decisions/README.md @@ -46,46 +46,51 @@ Una decisione sostituita non si cancella: si cambia il suo **Stato** e si rimand **Accettate** -| ID | Titolo | -| ------------------- | ------------------------------------- | -| [DD-001](DD-001.md) | Indipendenza da Lovable | -| [DD-002](DD-002.md) | Sviluppo document-first | -| [DD-004](DD-004.md) | Ogni versione aggiunge, non riscrive | -| [DD-005](DD-005.md) | Mobile-first | -| [DD-006](DD-006.md) | AI solo se utile | -| [DD-007](DD-007.md) | Badge calcolati, non in DB | -| [DD-008](DD-008.md) | Gamification equa tra ruoli | -| [DD-009](DD-009.md) | CSI manuale, poi integrazione API | -| [DD-010](DD-010.md) | Niente storico certificati | -| [DD-011](DD-011.md) | Auth reale prima del profilo | -| [DD-012](DD-012.md) | Rimandare la migrazione ID | -| [DD-013](DD-013.md) | Portabilità dello stack | -| [DD-015](DD-015.md) | Rosa da hardcoded a DB | -| [DD-016](DD-016.md) | Schema dati Profilo Giocatore | -| [DD-017](DD-017.md) | L'admin scrive al posto del giocatore | -| [DD-018](DD-018.md) | Collegamento automatico per email | -| [DD-019](DD-019.md) | Il branch lo decide l'utente | -| [DD-020](DD-020.md) | Test obbligatori e verdi | -| [DD-021](DD-021.md) | Molle interrompibili con motion | -| [DD-022](DD-022.md) | App solo chiara | -| [DD-023](DD-023.md) | Scritture limitate per ruolo | -| [DD-024](DD-024.md) | Route di notifica autenticate | -| [DD-025](DD-025.md) | Promemoria palloni manuale | -| [DD-026](DD-026.md) | Payload push cifrato | -| [DD-027](DD-027.md) | Voto limitato ai convocati | -| [DD-028](DD-028.md) | Soglia minima Media voto e MVP | -| [DD-029](DD-029.md) | Pulizia a cascata evento cancellato | -| [DD-030](DD-030.md) | Centro notifiche in-app | -| [DD-031](DD-031.md) | Nascita pubblica sincronizzata | -| [DD-032](DD-032.md) | Stagione CSI dalle date delle gare | -| [DD-033](DD-033.md) | Gestione eventi solo da calendario | -| [DD-034](DD-034.md) | Ruolo allenatore | -| [DD-035](DD-035.md) | Avviso certificati in Home | -| [DD-036](DD-036.md) | Notifiche email via Gmail | -| [DD-037](DD-037.md) | Promemoria evento senza ritorni | -| [DD-038](DD-038.md) | Tre canali per ogni notifica | -| [DD-039](DD-039.md) | Niente promemoria all'allenatore | -| [DD-040](DD-040.md) | Palloni e solleciti automatici | +| ID | Titolo | +| ------------------- | ------------------------------------------- | +| [DD-001](DD-001.md) | Indipendenza da Lovable | +| [DD-002](DD-002.md) | Sviluppo document-first | +| [DD-004](DD-004.md) | Ogni versione aggiunge, non riscrive | +| [DD-005](DD-005.md) | Mobile-first | +| [DD-006](DD-006.md) | AI solo se utile | +| [DD-007](DD-007.md) | Badge calcolati, non in DB | +| [DD-008](DD-008.md) | Gamification equa tra ruoli | +| [DD-009](DD-009.md) | CSI manuale, poi integrazione API | +| [DD-010](DD-010.md) | Niente storico certificati | +| [DD-011](DD-011.md) | Auth reale prima del profilo | +| [DD-012](DD-012.md) | Rimandare la migrazione ID | +| [DD-013](DD-013.md) | Portabilità dello stack | +| [DD-015](DD-015.md) | Rosa da hardcoded a DB | +| [DD-016](DD-016.md) | Schema dati Profilo Giocatore | +| [DD-017](DD-017.md) | L'admin scrive al posto del giocatore | +| [DD-018](DD-018.md) | Collegamento automatico per email | +| [DD-019](DD-019.md) | Il branch lo decide l'utente | +| [DD-020](DD-020.md) | Test obbligatori e verdi | +| [DD-021](DD-021.md) | Molle interrompibili con motion | +| [DD-022](DD-022.md) | App solo chiara | +| [DD-023](DD-023.md) | Scritture limitate per ruolo | +| [DD-024](DD-024.md) | Route di notifica autenticate | +| [DD-025](DD-025.md) | Promemoria palloni manuale | +| [DD-026](DD-026.md) | Payload push cifrato | +| [DD-027](DD-027.md) | Voto limitato ai convocati | +| [DD-028](DD-028.md) | Soglia minima Media voto e MVP | +| [DD-029](DD-029.md) | Pulizia a cascata evento cancellato | +| [DD-030](DD-030.md) | Centro notifiche in-app | +| [DD-031](DD-031.md) | Nascita pubblica sincronizzata | +| [DD-032](DD-032.md) | Stagione CSI dalle date delle gare | +| [DD-033](DD-033.md) | Gestione eventi solo da calendario | +| [DD-034](DD-034.md) | Ruolo allenatore | +| [DD-035](DD-035.md) | Avviso certificati in Home | +| [DD-036](DD-036.md) | Notifiche email via Gmail | +| [DD-037](DD-037.md) | Promemoria evento senza ritorni | +| [DD-038](DD-038.md) | Tre canali per ogni notifica | +| [DD-039](DD-039.md) | Niente promemoria all'allenatore | +| [DD-040](DD-040.md) | Palloni e solleciti automatici | +| [DD-045](DD-045.md) | Sollecito presenze: un solo avviso a 24 ore | +| [DD-044](DD-044.md) | Via la foto tessera dal profilo | +| [DD-043](DD-043.md) | Niente promemoria evento a 24 e 3 ore | +| [DD-042](DD-042.md) | Turno palloni: un solo avviso a 3 ore | +| [DD-041](DD-041.md) | Avviso certificati: giocatore a 30 giorni | **In valutazione** diff --git a/docs/modules/allenatore.md b/docs/modules/allenatore.md index 6f40313..10fb41b 100644 --- a/docs/modules/allenatore.md +++ b/docs/modules/allenatore.md @@ -55,8 +55,8 @@ Un link diretto a `/profilo?tab=stagione` o `?tab=badge` apre Documenti. | Telefono | `profili_giocatore.telefono` | | | Foto profilo | bucket `avatar-giocatori` | stesso cerchio avatar e stesso upload dei giocatori | -**Non** si mostrano: indirizzo di residenza, documento d'identità, certificato medico, foto -tessera, tesseramento CSI. +**Non** si mostrano: indirizzo di residenza, documento d'identità, certificato medico, +tesseramento CSI. ### Completamento profilo @@ -114,7 +114,7 @@ a lui (`usePuoGestireEventi()`). Può anche **sollecitare le presenze** di un evento, come l'admin: la route `sollecita-presenze.ts` accetta admin o allenatore (`richiediGestoreEventi()`), e il -sollecito arriva solo ai giocatori che non hanno risposto, mai all'allenatore stesso. Con DD-040 si aggiungono solleciti automatici a 24, 12 e 6 ore prima dell'evento, ma il pulsante resta. +sollecito arriva solo ai giocatori che non hanno risposto, mai all'allenatore stesso. Con DD-040 si aggiungono un sollecito automatico 24 ore prima dell'evento, ma il pulsante resta. **Restano solo admin:** dashboard `/admin`, dati e documenti dei giocatori, export CSI, notifica personalizzata, promemoria palloni, apertura sondaggio cacche, correzione delle @@ -125,14 +125,14 @@ risposte presenze altrui, gestione dei ruoli. Cosa riceve l'allenatore, notifica per notifica (il catalogo completo, con i canali di tutti, sta in [notifiche.md](notifiche.md#catalogo-delle-notifiche)): -| Notifica | L'allenatore la riceve? | Note | -| ------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Promemoria a 24 e 3 ore prima di un evento | **no** | Dal 29/09/2026 (m25, DD-039) `giocatori_destinatari_evento()` include solo i giocatori attivi: l'allenatore non può rispondere alle presenze né essere convocato, quindi il promemoria non gli chiederebbe nulla che possa fare (per esempio una cena di squadra). Prima gli arrivava sempre, convocato o no (m21). | -| Messaggio dello staff | **sì** | In-app ed email vanno a tutta la rosa attiva, allenatori compresi; la push ai suoi dispositivi iscritti, o solo a lui se il messaggio è per lui. | -| Sollecito presenze | no | L'allenatore non risponde alle presenze (DD-034). Può invece **far partire** il sollecito . | -| Turno palloni | no | I turni riguardano solo i giocatori. | -| Sondaggio pre-partita | no | Né la push né l'avviso in-app e per email (DD-038): il sondaggio non lo riguarda. | -| Notifiche smart (badge, serie, obiettivi, social) | **no** | Le mostra `CelebrazioneBadge` per il giocatore selezionato, letto da `useIo()`, che cerca l'id in `useRosa()`, da cui l'allenatore è escluso: per lui `useIo()` è `null` e `useNotificheSmart()` non fa nulla. Non ha statistiche da cui calcolarle. | +| Notifica | L'allenatore la riceve? | Note | +| ------------------------------------------------------------ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Promemoria a 24 e 3 ore prima di un evento (rimosso, DD-043) | **no** | Dal 29/09/2026 (m25, DD-039) `giocatori_destinatari_evento()` include solo i giocatori attivi: l'allenatore non può rispondere alle presenze né essere convocato, quindi il promemoria non gli chiederebbe nulla che possa fare (per esempio una cena di squadra). Prima gli arrivava sempre, convocato o no (m21). | +| Messaggio dello staff | **sì** | In-app ed email vanno a tutta la rosa attiva, allenatori compresi; la push ai suoi dispositivi iscritti, o solo a lui se il messaggio è per lui. | +| Sollecito presenze | no | L'allenatore non risponde alle presenze (DD-034). Può invece **far partire** il sollecito . | +| Turno palloni | no | I turni riguardano solo i giocatori. | +| Sondaggio pre-partita | no | Né la push né l'avviso in-app e per email (DD-038): il sondaggio non lo riguarda. | +| Notifiche smart (badge, serie, obiettivi, social) | **no** | Le mostra `CelebrazioneBadge` per il giocatore selezionato, letto da `useIo()`, che cerca l'id in `useRosa()`, da cui l'allenatore è escluso: per lui `useIo()` è `null` e `useNotificheSmart()` non fa nulla. Non ha statistiche da cui calcolarle. | Le email arrivano solo se il suo slot ha un account collegato e un'email registrata e se non ha spento l'interruttore «Email»; la push solo sui dispositivi su cui ha attivato «Notifiche» dal @@ -164,7 +164,7 @@ giocatore). | ------------------------------------------------------------------- | ---------- | ------------------ | ----------------------------------- | | Modificare nome e cognome | no | sì, i propri | tutti | | Dati personali e foto profilo | i propri | i propri (ridotti) | tutti (non i file) | -| Documento, certificato, foto tessera | i propri | — | lettura/download | +| Documento, certificato | i propri | — | lettura/download | | Avviso certificati in Home | il proprio | no | tutta la rosa | | Creare/modificare/eliminare eventi, convocati | no | sì | sì | | Sollecitare le presenze | no | sì | sì | diff --git a/docs/modules/notifiche-email.md b/docs/modules/notifiche-email.md index dedd0d8..a2b2662 100644 --- a/docs/modules/notifiche-email.md +++ b/docs/modules/notifiche-email.md @@ -49,8 +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, promemoria a 24 ore e a -3 ore, sollecito presenze, sondaggio pre-partita. **Fa eccezione il turno palloni** (DD-040, dalla +**Ogni riga nuova di `notifiche_utente` genera una mail**: messaggio admin, sollecito presenze, sondaggio pre-partita. **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 93bde69..9f3bbed 100644 --- a/docs/modules/notifiche.md +++ b/docs/modules/notifiche.md @@ -34,25 +34,25 @@ in-app** (storico in `notifiche_utente`, per tutti i giocatori) ed **email** ([notifiche-email.md](notifiche-email.md): ogni riga di `notifiche_utente` genera una mail, **tranne quelle del turno palloni**, che restano solo push e in-app: DD-040). -| # | Notifica | Cosa la fa partire | Destinatari | Push | In-app | Email | -| --- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ------ | --------------- | -| 1 | **Promemoria a 24 ore** — «Promemoria evento di _domani_ (o _oggi_): _titolo_», con data, ora e luogo | Job `pg_cron` `promemoria-eventi-24h`, ogni ora, per gli eventi che iniziano entro le prossime 24 ore. Tipo `evento_promemoria_24h`. La push la manda il worker (M24). | I convocati dell'evento, o tutta la rosa attiva se `convocati` è vuoto; mai gli allenatori (DD-039). | sì (worker) | sì | sì | -| 2 | **Promemoria a 3 ore** — stesso testo | Job `pg_cron` `promemoria-eventi-3h`, ogni 15 minuti, per gli eventi che iniziano entro le prossime 3 ore. Tipo `evento_promemoria_3h`. La push la manda il worker (M24). | Come il promemoria a 24 ore. | sì (worker) | sì | sì | -| 3 | **Messaggio dello staff** — titolo fisso «Messaggio dallo staff», corpo il testo scritto (max 300 caratteri) | Un admin, dalla tab «Notifiche» della dashboard: «Invia messaggio a tutti» o il pulsante della riga di un giocatore. Route `notifica-personalizzata`, tipo `admin`. | Push: tutti i dispositivi iscritti, o quelli del giocatore scelto. In-app ed email: tutta la rosa attiva (allenatori compresi, anche senza dispositivi iscritti), o il giocatore scelto. | sì | sì | sì | -| 4 | **Turno palloni** — «Turno palloni: incarico assegnato» / «Turno palloni: riconsegna» | **Automatica**, **12, 6 e 3 ore prima** dell'evento (DD-040): job `pg_cron` ogni 15 minuti, solo per allenamenti e partite con un incaricato confermato; tipi `turno_palloni_12h`, `_6h` e `_3h`, push dal worker. Se l'incaricato cambia, chi aveva già ricevuto un avviso riceve una volta «Turno palloni: incarico revocato» (tipo `turno_palloni_revocato`). **Manuale**, in più: un admin, con il pulsante nella pagina dell'evento; route `promemoria-palloni`, tipo `turno_palloni`, push dalla route. | L'incaricato del turno di quell'evento e, se è un'altra persona, chi aveva i palloni all'evento precedente. Se per l'evento non c'è un incaricato non parte nulla. | sì | sì | **no** (DD-040) | -| 5 | **Sollecito presenze** — «Conferma di partecipazione richiesta: _titolo_» | **Automatica**, in tre tempi (DD-040): **24, 12 e 6 ore** prima dell'evento, dallo stesso job; tipi `sollecita_presenze_24h`, `_12h`, `_6h`, push dal worker. **Manuale**, in più: un admin o un allenatore con il pulsante nella pagina dell'evento; route `sollecita-presenze`, tipo `sollecita_presenze`, push dalla route. | Automatica e manuale: i destinatari dell'evento (convocati, o tutta la rosa attiva se `convocati` è vuoto; mai gli allenatori) che in quel momento non hanno risposto o hanno risposto «forse». | sì | sì | sì | -| 6 | **Sondaggio pre-partita** — «💩 Sondaggio pre-partita aperto» | Un admin, dalla pagina della partita. Route `apri-sondaggio` (vedi [Scout Live](scout-live.md)). | Push: tutti i dispositivi iscritti, tranne quelli degli allenatori. In-app ed email (tipo `sondaggio_cacche`): i giocatori attivi, allenatori esclusi, anche senza dispositivi iscritti. | sì | sì | sì | -| 7 | **Notifiche smart** — badge appena sbloccato, serie a un traguardo, obiettivo di squadra tra il 90 e il 100%, badge social vinto | L'app, mentre è aperta: sono calcolate in locale da `calcolaNotifiche()`. | Chi ha l'app aperta con uno slot giocatore in rosa selezionato; **mai l'allenatore**. Nessun invio verso altri dispositivi. | no (solo locale) | no | no | +| # | Notifica | Cosa la fa partire | Destinatari | Push | In-app | Email | +| --- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ------ | --------------- | +| 1 | ~~Promemoria a 24 ore~~ — **rimosso** | Non parte più: i job `pg_cron` sono stati tolti dalla migration `m28` (DD-043). Restano le notifiche già generate (tipo `evento_promemoria_24h`). | — | — | — | — | +| 2 | ~~Promemoria a 3 ore~~ — **rimosso** | Come la riga 1 (tipo `evento_promemoria_3h`). | — | — | — | — | +| 3 | **Messaggio dello staff** — titolo fisso «Messaggio dallo staff», corpo il testo scritto (max 300 caratteri) | Un admin, dalla tab «Notifiche» della dashboard: «Invia messaggio a tutti» o il pulsante della riga di un giocatore. Route `notifica-personalizzata`, tipo `admin`. | Push: tutti i dispositivi iscritti, o quelli del giocatore scelto. In-app ed email: tutta la rosa attiva (allenatori compresi, anche senza dispositivi iscritti), o il giocatore scelto. | sì | sì | sì | +| 4 | **Turno palloni** — «Turno palloni: incarico assegnato» / «Turno palloni: riconsegna» | **Automatica**, **una sola volta, 3 ore prima** dell'evento (DD-040, DD-042): job `pg_cron` ogni 15 minuti, solo per allenamenti e partite con un incaricato confermato; tipo `turno_palloni_3h` (`_12h` e `_6h` esistono solo nelle notifiche generate prima di `m27`), push dal worker. Se l'incaricato cambia, chi aveva già ricevuto un avviso riceve una volta «Turno palloni: incarico revocato» (tipo `turno_palloni_revocato`). **Manuale**, in più: un admin, con il pulsante nella pagina dell'evento; route `promemoria-palloni`, tipo `turno_palloni`, push dalla route. | L'incaricato del turno di quell'evento e, se è un'altra persona, chi aveva i palloni all'evento precedente. Se per l'evento non c'è un incaricato non parte nulla. | sì | sì | **no** (DD-040) | +| 5 | **Sollecito presenze** — «Conferma di partecipazione richiesta: _titolo_» | **Automatica**, **una sola volta, 24 ore prima** dell'evento (DD-040, DD-045): per gli eventi che iniziano entro 24 ore, dallo stesso job; tipo `sollecita_presenze_24h` (`_12h` e `_6h` esistono solo nelle notifiche generate prima di `m30`), push dal worker. **Manuale**, in più: un admin o un allenatore con il pulsante nella pagina dell'evento; route `sollecita-presenze`, tipo `sollecita_presenze`, push dalla route. | Automatica e manuale: i destinatari dell'evento (convocati, o tutta la rosa attiva se `convocati` è vuoto; mai gli allenatori) che in quel momento non hanno risposto o hanno risposto «forse». | sì | sì | sì | +| 6 | **Sondaggio pre-partita** — «💩 Sondaggio pre-partita aperto» | Un admin, dalla pagina della partita. Route `apri-sondaggio` (vedi [Scout Live](scout-live.md)). | Push: tutti i dispositivi iscritti, tranne quelli degli allenatori. In-app ed email (tipo `sondaggio_cacche`): i giocatori attivi, allenatori esclusi, anche senza dispositivi iscritti. | sì | sì | sì | +| 7 | **Notifiche smart** — badge appena sbloccato, serie a un traguardo, obiettivo di squadra tra il 90 e il 100%, badge social vinto | L'app, mentre è aperta: sono calcolate in locale da `calcolaNotifiche()`. | Chi ha l'app aperta con uno slot giocatore in rosa selezionato; **mai l'allenatore**. Nessun invio verso altri dispositivi. | no (solo locale) | no | no | Le notifiche generate dal server (righe 1-6) 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 (1, 2, 4 e 5) nascono nel database e la manda il worker `mailer/` (vedi «Push dei +automatiche (4 e 5; 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»). > **Righe 1, 2, 4 e 5 (DD-040).** Implementate con la migration `m26` (job `pg_cron`, testi, revoca) e -> verificate in locale; la migration va ancora applicata in produzione. Finché non lo è, l'app si comporta -> come in 1.2.0: promemoria con il testo breve, turno palloni e sollecito presenze solo da pulsante. +> applicate in produzione (`m26` il 30/09/2026; `m27` il 01/10/2026, che porta il turno palloni a un solo +> avviso 3 ore prima, DD-042). Cosa riceve l'allenatore, notifica per notifica: [allenatore.md](allenatore.md#notifiche). @@ -63,17 +63,17 @@ volta sola. Nell'email il titolo diventa l'oggetto e il corpo segue il formato d [notifiche-email.md](notifiche-email.md#contenuto-delle-mail) (link «Apri CrAPP» e avviso di disattivazione). Tra `<…>` i valori che cambiano a ogni invio; le date sono `GG/MM/AAAA`. -| # | Notifica | Titolo | Corpo | -| --- | ----------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 1-2 | Promemoria 24 e 3 ore | `Promemoria evento di domani: `, oppure `…di oggi: ` | `Data: domani, `
`Ora: `
`Luogo: ` — «domani» se la data dell'evento è quella di domani, «oggi» altrimenti (fuso `Europe/Rome`, vale per entrambi i promemoria) | -| 3 | Messaggio dello staff | `Messaggio dallo staff` | Il testo scritto dall'admin, max 300 caratteri. | -| 4a | Turno palloni, all'incaricato | `Turno palloni: incarico assegnato` | `Evento: `
`Data: , ore `
`Incarico: custodia dei palloni al termine dell'evento`
`Riconsegna: ` — senza evento successivo la riga «Riconsegna» manca | -| 4b | Turno palloni, a chi li aveva | `Turno palloni: riconsegna` | `Evento: `
`Data: , ore `
`Incarico: riconsegna dei palloni in custodia dal turno precedente` | -| 4c | Turno palloni, revoca | `Turno palloni: incarico revocato` | `Evento: `
`Data: , ore `
`Incarico: non più a tuo carico per questo evento` — a chi aveva ricevuto un avviso (4a o 4b) e non è più destinatario; una sola volta | -| 5 | Sollecito presenze | `Conferma di partecipazione richiesta: ` | `Data: `
`Ora: `
`Luogo: `
`Richiesta di: ` (solo nel sollecito manuale, e solo se il nome c'è)
`Risposta attuale: nessuna` (oppure `forse`)
`Azione: indicare presente, assente o in ritardo` — stesso testo a 24, 12 e 6 ore | -| 6 | Sondaggio pre-partita | `💩 Sondaggio pre-partita aperto` | ` · ore . Quante cacche hai fatto? Rispondi prima del fischio d'inizio.` | +| # | Notifica | Titolo | Corpo | +| --- | --------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1-2 | Promemoria 24 e 3 ore (rimosso, DD-043) | `Promemoria evento di domani: `, oppure `…di oggi: ` | `Data: domani, `
`Ora: `
`Luogo: ` — «domani» se la data dell'evento è quella di domani, «oggi» altrimenti (fuso `Europe/Rome`, vale per entrambi i promemoria) | +| 3 | Messaggio dello staff | `Messaggio dallo staff` | Il testo scritto dall'admin, max 300 caratteri. | +| 4a | Turno palloni, all'incaricato | `Turno palloni: incarico assegnato` | `Evento: `
`Data: , ore `
`Incarico: custodia dei palloni al termine dell'evento`
`Riconsegna: ` — senza evento successivo la riga «Riconsegna» manca | +| 4b | Turno palloni, a chi li aveva | `Turno palloni: riconsegna` | `Evento: `
`Data: , ore `
`Incarico: riconsegna dei palloni in custodia dal turno precedente` | +| 4c | Turno palloni, revoca | `Turno palloni: incarico revocato` | `Evento: `
`Data: , ore `
`Incarico: non più a tuo carico per questo evento` — a chi aveva ricevuto un avviso (4a o 4b) e non è più destinatario; una sola volta | +| 5 | Sollecito presenze | `Conferma di partecipazione richiesta: ` | `Data: `
`Ora: `
`Luogo: `
`Richiesta di: ` (solo nel sollecito manuale, e solo se il nome c'è)
`Risposta attuale: nessuna` (oppure `forse`)
`Azione: indicare presente, assente o in ritardo` — stesso testo a 24, 12 e 6 ore | +| 6 | Sondaggio pre-partita | `💩 Sondaggio pre-partita aperto` | ` · ore . Quante cacche hai fatto? Rispondi prima del fischio d'inizio.` | -Le righe 1-2, 4a-4c e 5 nascono nelle funzioni SQL della migration `m26` +Le righe 4a-4c e 5 (e le 1-2, finché esistevano) nascono nelle funzioni SQL della migration `m26` (`genera_promemoria_eventi`, `genera_avvisi_palloni_fascia`, `genera_revoche_palloni`, `genera_solleciti_presenze_fascia`); i pulsanti usano gli stessi testi da `palloni-core.ts` (`avvisiPalloniEvento`) e `presenze.ts` (`testoSollecito`), e `notifiche-automatiche.test.ts` verifica che siano @@ -96,8 +96,8 @@ dall'emoji. Non entrano nel centro notifiche e non generano email. ### Cosa non genera nessuna notifica -- Creare, spostare, modificare o cancellare un evento: contano solo i promemoria prima - dell'inizio (DD-030). +- Creare, spostare, modificare o cancellare un evento. Dalla `m28` (DD-043) non parte nemmeno più un + promemoria prima dell'inizio: restano solo il turno palloni e il sollecito presenze. - L'arrivo di un risultato, di una pagella o di un voto MVP. - Un giocatore che risponde a un evento: nessun avviso a chi gestisce gli eventi. - Assenze e infortuni. @@ -106,7 +106,9 @@ dall'emoji. Non entrano nel centro notifiche e non generano email. ### Comportamenti da conoscere -Sono l'effetto attuale della logica, non scelte documentate altrove: +Sono l'effetto attuale della logica, non scelte documentate altrove. I punti sui **promemoria 1 e 2** +descrivono come funzionavano fino alla `m28`: la funzione esiste ancora ma nessun job la chiama +(DD-043); valgono solo se i job vengono ripianificati. - **I promemoria (1 e 2) non distinguono il tipo di evento:** scattano per allenamenti, partite ed eventi extra-campo (per esempio una cena). Il turno palloni (4), invece, esiste solo per @@ -134,28 +136,28 @@ Sono l'effetto attuale della logica, non scelte documentate altrove: proposta automatica di `completaTurni()` non salvata non basta. Se l'incaricato cambia dopo un avviso, il nuovo riceve il proprio al giro successivo e il precedente riceve una sola volta «Turno palloni: incarico revocato»; se viene poi riassegnato, non riceve un secondo avviso. -- **I solleciti cadono in finestre che non si sovrappongono** (DD-040): 24 ore tra 24 e 12 ore - prima dell'inizio, 12 ore tra 12 e 6, 6 ore sotto le 6. Un evento creato a meno di 12 ore - dall'inizio riceve solo quello della sua finestra. Chi risponde presente, assente o in ritardo - smette di riceverli; chi resta su «forse» li riceve tutti e tre. -- **Per ogni evento un giocatore riceve al massimo cinque mail automatiche** (DD-040): due - promemoria e tre solleciti, più quelle dei pulsanti manuali (sollecito, sondaggio). Il turno palloni +- **Il sollecito automatico è uno solo, a 24 ore** (DD-045): parte per gli eventi che iniziano entro 24 + ore, a chi in quel momento non ha risposto o ha risposto «forse». Un evento creato a meno di 24 + ore dall'inizio lo riceve comunque, una volta. Chi risponde dopo non ne riceve altri; chi resta su + «forse» non lo riceve una seconda volta. Altri solleciti solo col pulsante manuale. +- **Per ogni evento un giocatore riceve al massimo una mail automatica** (DD-045): il + sollecito presenze (il promemoria è stato tolto, DD-043), più quelle dei pulsanti manuali (sollecito, sondaggio). Il turno palloni (avvisi automatici, revoca e pulsante) non manda email: restano la push e l'alert in app. - **Non esistono preferenze per tipo di notifica:** un solo interruttore per la push («Notifiche») e uno per le email («Email»). Il centro notifiche in-app non si può spegnere. ### Test che verificano il catalogo -| Cosa | Test | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Promemoria 24 e 3 ore: 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` | -| 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 12·6·3 ore e revoca, solleciti a 24·12·6 ore (manuale compreso): finestre, destinatari, una sola volta, registro (DD-040, `m26`) | `integration/notifiche-automatiche.test.ts` (nuovo), `promemoria-eventi.test.ts` (testo oggi/domani), `destinatari-notifiche.test.ts` (pulsanti), `unit/palloni-core.test.ts`, `unit/presenze.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` | +| 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 @@ -282,12 +284,11 @@ non richiede che il dispositivo abbia attivato «Notifiche», ha uno storico per stessa cosa delle notifiche smart (quelle restano locali, non salvate a database). Cinque sorgenti scrivono in `notifiche_utente`, mai il client (con DD-040 le sorgenti 3 e 4 hanno in più un -job `pg_cron` come la 2, che scrive `turno_palloni_12h`/`_6h`/`_3h`/`_revocato` e `sollecita_presenze_24h`/ -`_12h`/`_6h`; i pulsanti restano e scrivono `turno_palloni` e `sollecita_presenze`): +job `pg_cron` come la 2, che scrive `turno_palloni_3h`/`_revocato` (`_12h`/`_6h` solo fino a `m26`) e `sollecita_presenze_24h` (`_12h`/`_6h` solo fino a `m29`); i pulsanti restano e scrivono `turno_palloni` e `sollecita_presenze`): 1. **Messaggio admin** — `notifica-personalizzata.ts` inserisce una riga per destinatario in parallelo all'invio push esistente (a tutta la rosa attiva se `giocatoreId` è omesso). -2. **Promemoria evento** — due job `pg_cron` (ogni ora per la finestra delle 24h, ogni 15 +2. **Promemoria evento (rimosso dalla `m28`, DD-043: i job non esistono più)** — due job `pg_cron` (ogni ora per la finestra delle 24h, ogni 15 minuti per quella delle 3h) generano una notifica per evento imminente, per i convocati (o tutta la rosa attiva se l'evento non ne specifica), deduplicata dal registro `promemoria_eventi_generati` (M23, DD-037; il vincolo `UNIQUE (giocatore_id, evento_id, tipo)` @@ -325,7 +326,7 @@ ritrova per sempre nell'elenco, solo segnata come letta. ## Push dei promemoria (M24) -I promemoria a 24 e 3 ore nascono nel database (job `pg_cron`), che non può firmare né cifrare una +I promemoria a 24 e 3 ore (rimossi con la `m28`, DD-043; la coda resta valida per i tipi già esistenti) nascevano nel database (job `pg_cron`), che non può firmare né cifrare una push Web: la manda il worker `mailer/`, lo stesso che invia le email ([WORKER_EMAIL.md](../WORKER_EMAIL.md), DD-038). diff --git a/docs/modules/palloni.md b/docs/modules/palloni.md index c7358a0..0aa6f3e 100644 --- a/docs/modules/palloni.md +++ b/docs/modules/palloni.md @@ -11,7 +11,7 @@ Gestire un turno a rotazione condiviso per chi porta e riporta i palloni ad allenamenti e partite, con proposta automatica, possibilità di modifica manuale e avvisi push, nel centro -notifiche e senza email a 12, 6 e 3 ore dall'evento (DD-040). Gli eventi extra-campo (`tipo === "evento"`, es. cena di squadra) e i +notifiche e senza email 3 ore prima dell'evento (DD-040, DD-042). Gli eventi extra-campo (`tipo === "evento"`, es. cena di squadra) e i compleanni non c'entrano: non richiedono palloni. --- @@ -56,7 +56,7 @@ oggi`, stesso criterio delle presenze): un turno assegnato in anticipo per un al ## Route API pubblica `/api/public/promemoria-palloni` > **Affiancata da un invio automatico (DD-040, migration `m26`).** Oltre al pulsante, un job -> `pg_cron` ogni 15 minuti manda l'avviso **12, 6 e 3 ore prima** dell'evento, solo se per l'evento c'è un +> `pg_cron` ogni 15 minuti manda l'avviso **una sola volta, 3 ore prima** dell'evento (DD-042, migration `m27`), solo se per l'evento c'è un > incaricato confermato in `turni_palloni`. Il pulsante e la route **restano**, con tipo > `turno_palloni` e push dalla route. I due destinatari e i testi nuovi («incarico assegnato» / > «riconsegna», validi per il pulsante e per i job, più la revoca se l'incaricato cambia) sono nel diff --git a/docs/modules/presenze.md b/docs/modules/presenze.md index 4c0cc82..1c9974c 100644 --- a/docs/modules/presenze.md +++ b/docs/modules/presenze.md @@ -79,7 +79,7 @@ src/routes/api/public/sollecita-presenze.ts > **Sollecito automatico (DD-040, migration `m26`).** Il pulsante «Sollecita» e la route > **restano**, ma `destinatariSollecito()` passa a guardare anche i convocati (convocati che non hanno -> risposto o hanno risposto «forse», o tutta la rosa se `convocati` è vuoto); in più un job `pg_cron` manda il sollecito **24, 12 e 6 ore prima** dell'evento a chi in +> risposto o hanno risposto «forse», o tutta la rosa se `convocati` è vuoto); in più un job `pg_cron` manda il sollecito **una sola volta, 24 ore prima** dell'evento (DD-045, migration `m30`) a chi in > quel momento non ha risposto o ha risposto «forse», tra i destinatari dell'evento (convocati, o > tutta la rosa attiva; mai l'allenatore). Testo e finestre nel [catalogo](notifiche.md#catalogo-delle-notifiche). > Il diagramma sopra è quello del pulsante, che da DD-040 legge anche `convocati` dell'evento. @@ -94,7 +94,7 @@ vale per tutta la rosa) — `eventiContanoPresenze()` in `presenze.ts`. - Aggiornamento ottimistico della cache locale dopo ogni salvataggio: nessuna rilettura dal server, la UI risponde subito. -- Il sollecito ha due vie (DD-040): tre solleciti **automatici** (24, 12 e 6 ore prima, job `pg_cron` +- Il sollecito ha due vie (DD-040): un sollecito **automatico** (24 ore prima, job `pg_cron` nel database) e il pulsante **manuale** accanto, che non sostituiscono. La route del pulsante verifica il ruolo lato server con `richiediGestoreEventi` (admin o allenatore, DD-024, DD-034). - Ognuno risponde **solo per sé**, e non è più una regola della sola interfaccia: dalla diff --git a/docs/modules/profilo-giocatore.md b/docs/modules/profilo-giocatore.md index 785fc6f..4dec796 100644 --- a/docs/modules/profilo-giocatore.md +++ b/docs/modules/profilo-giocatore.md @@ -44,7 +44,7 @@ Può: riga non viene eliminata, così presenze, voti, pagelle e badge della stagione restano agganciati al suo id -Non può caricare o sostituire i file altrui: documento, certificato e foto restano +Non può caricare o sostituire i file altrui: documento e certificato restano responsabilità del giocatore che li fornisce. ## Flusso utente @@ -73,7 +73,6 @@ Viene mostrata una barra di avanzamento (esempio: _Profilo completato — 85%_), - Dati personali - Documento di identità - Certificato medico -- Foto tessera Quando tutte le sezioni sono complete il widget scompare automaticamente. @@ -82,7 +81,7 @@ sulla tab Stagione. ### Avviso certificati -**Stato:** implementato (DD-035). +**Stato:** implementato (DD-035, soglia del giocatore DD-041). Un avviso in Home segnala i certificati medici in scadenza o scaduti, così nessuno se ne accorge quando il giocatore è già fuori regola. Si calcola al volo dalla data di scadenza @@ -90,13 +89,13 @@ già salvata: niente tabella, niente migration, niente push. #### Chi lo vede -| Utente | Cosa vede | Al tocco | -| --------------------------- | --------------------------------------------------------------- | ----------------------------- | -| Admin | l'avviso **dello staff**: i nomi di tutti i giocatori coinvolti | niente, non è cliccabile | -| Giocatore interessato | l'avviso **personale**: solo il proprio certificato | apre `/profilo?tab=documenti` | -| Admin che è anche giocatore | solo l'avviso dello staff, dove compare già il suo nome | niente | -| Altri giocatori | niente | — | -| Allenatore | niente: non vede i certificati altrui e non ne ha uno (DD-034) | — | +| Utente | Cosa vede | Al tocco | +| --------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------- | +| Admin | l'avviso **dello staff**: i nomi di tutti i giocatori coinvolti | niente, non è cliccabile | +| Giocatore interessato | l'avviso **personale**: solo il proprio certificato | apre `/profilo?tab=documenti` | +| Admin che è anche giocatore | **entrambi**: lo staff (senza il suo nome) e il proprio personale, a 30 giorni | personale: apre `/profilo?tab=documenti` | +| Altri giocatori | niente | — | +| Allenatore | niente: non vede i certificati altrui e non ne ha uno (DD-034) | — | L'avviso dello staff non è cliccabile, come quello dei palloni: l'admin non può caricare il certificato al posto del giocatore (DD-017), quindi può solo sollecitarlo, e il giocatore @@ -109,15 +108,24 @@ solo proprio a un giocatore. #### Quando compare -`giorni` è la differenza in giorni di calendario tra la scadenza e oggi (ora locale), soglia -`GIORNI_AVVISO_CERTIFICATO = 7`. +`giorni` è la differenza in giorni di calendario tra la scadenza e oggi (ora locale). La +soglia del giallo dipende da chi guarda (DD-041): il giocatore è avvisato un mese prima dello +staff. -| Condizione | Stato | Avviso | -| -------------------- | ----------- | ------------------ | -| `giorni > 7` | valido | nessuno | -| `0 ≤ giorni ≤ 7` | in scadenza | giallo (`warning`) | -| `giorni < 0` | scaduto | nero (`primary`) | -| data o file mancanti | mancante | nessuno | +| Chi guarda | Soglia | +| ---------- | ------------------------------------------ | +| Giocatore | `GIORNI_AVVISO_CERTIFICATO_GIOCATORE = 30` | +| Admin | `GIORNI_AVVISO_CERTIFICATO = 7` | + +| Condizione | Stato | Avviso | +| --------------------- | ----------- | ------------------ | +| `giorni > soglia` | valido | nessuno | +| `0 ≤ giorni ≤ soglia` | in scadenza | giallo (`warning`) | +| `giorni < 0` | scaduto | nero (`primary`) | +| data o file mancanti | mancante | nessuno | + +Esempio: scadenza il 5 ottobre 2026. Dal 5 settembre l'avviso giallo compare solo al +giocatore; dal 28 settembre anche agli admin; dal 6 ottobre è nero per entrambi. - Il giorno della scadenza il certificato vale ancora, coerente con `statoScadenza()`: il giocatore compare nel giallo con «scade oggi» e passa al nero dal giorno dopo. @@ -136,7 +144,7 @@ solo proprio a un giocatore. | Giallo, personale | «Certificato in scadenza» | «Il tuo certificato medico scade tra 5 giorni» / «domani» / «oggi» | | Nero, personale | «Certificato scaduto» | «Il tuo certificato medico è scaduto il 12/09/2026: caricane uno nuovo» | -Il numero di giorni scende da solo ogni giorno (7, 6, 5… domani, oggi): l'avviso non +Il numero di giorni scende da solo ogni giorno (30… 7, 6, 5… domani, oggi): l'avviso non conserva niente, rilegge la data a ogni apertura della Home. #### Più giocatori @@ -182,14 +190,16 @@ la Home non deve rompersi per un dato accessorio. #### Implementazione -| Pezzo | Ruolo | -| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| `GIORNI_AVVISO_CERTIFICATO` (`profili-core.ts`) | la soglia, 7 | -| `giorniAllaScadenza(scadenza, oggi)` | differenza in giorni di calendario tra due date `AAAA-MM-GG`, negativa se scaduto | -| `avvisiCertificati(rosa, profili, oggi)` | funzione pura: restituisce `{ scaduti, inScadenza }`, ognuno una lista ordinata di `{ giocatoreId, nome, cognome, scadenza, giorni }` | -| `testoScadenza(giorni)` | «scade oggi» / «scade domani» / «scade tra N giorni» | -| `src/components/crapp/AvvisoCertificati.tsx` | legge `useGiocatoriSquadra()`, `useProfili()`, `useIsAdmin()` e l'utente corrente; sceglie avviso dello staff o personale e disegna le card | -| `src/routes/index.tsx` | monta `` subito dopo `` | +| Pezzo | Ruolo | +| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `GIORNI_AVVISO_CERTIFICATO` (`profili-core.ts`) | la soglia dello staff, 7 | +| `GIORNI_AVVISO_CERTIFICATO_GIOCATORE` | la soglia del giocatore, 30 (DD-041) | +| `giorniAllaScadenza(scadenza, oggi)` | differenza in giorni di calendario tra due date `AAAA-MM-GG`, negativa se scaduto | +| `avvisiCertificati(rosa, profili, oggi, soglia)` | funzione pura (`soglia` di default 7): restituisce `{ scaduti, inScadenza }`, ognuno una lista ordinata di `{ giocatoreId, nome, cognome, scadenza, giorni }` | +| `avvisiCertificatiUtente(rosa, profili, oggi, utente)` | funzione pura: `{ personale, staff }` per chi guarda; l'admin giocatore ha entrambi, senza il suo nome nello staff (DD-041) | +| `testoScadenza(giorni)` | «scade oggi» / «scade domani» / «scade tra N giorni» | +| `src/components/crapp/AvvisoCertificati.tsx` | legge `useGiocatoriSquadra()`, `useProfili()`, `useIsAdmin()` e l'utente corrente; sceglie avviso dello staff o personale e disegna le card | +| `src/routes/index.tsx` | monta `` subito dopo `` | - "Oggi" viene da `oggiISO()` (`palloni-core.ts`), in ora locale. Non da `new Date().toISOString()`, che è in UTC e tra mezzanotte e le 2 darebbe il giorno prima. @@ -197,7 +207,7 @@ la Home non deve rompersi per un dato accessorio. `/admin`, quindi al massimo una lettura di `profili_giocatore` per sessione (vedi [EFFICIENZA_CLOUD.md](../EFFICIENZA_CLOUD.md)). Per l'allenatore il componente non legge i profili. -- Test in `test/unit/profili-core.test.ts`: soglia (8 giorni no, 7 sì, 0 sì, −1 scaduto), +- Test in `test/unit/profili-core.test.ts`: avvisi per utente (admin giocatore, admin puro, giocatore semplice), soglia dello staff (8 giorni no, 7 sì, 0 sì, −1 scaduto) e del giocatore (31 no, 30 sì), certificato senza file o senza data escluso, giocatore disattivato e allenatore esclusi, ordinamento (per data, poi alfabetico), testi al singolare e al plurale, cambio di mese e di anno nel calcolo dei giorni. @@ -254,17 +264,16 @@ Upload. Il giocatore può aggiornare liberamente sia la data sia il file. -Quando mancano 7 giorni o meno alla scadenza, o il certificato è scaduto, il giocatore -riceve un avviso nella propria Home e compare in quello degli admin (vedi +Quando mancano 30 giorni o meno alla scadenza, o il certificato è scaduto, il giocatore +riceve un avviso nella propria Home; compare in quello degli admin da 7 giorni prima (vedi [Avviso certificati](#avviso-certificati)). Lo storico non viene mantenuto nella prima versione. ### Foto tessera -Upload di una fotografia formato tessera. - -Utilizzata dagli amministratori per il tesseramento CSI. +**Rimossa** (DD-044, migration `m29`): il profilo non chiede più la foto tessera e la colonna +`foto_path` non esiste più. I file già caricati sono stati cancellati dal bucket. ### Statistiche @@ -317,7 +326,6 @@ Per ogni giocatore, nella tab Profili, vengono mostrati. - Stato del profilo - Certificato medico - Documento di identità -- Foto tessera - Stato tesseramento CSI (tesserato / da tesserare) Azioni disponibili. @@ -325,7 +333,6 @@ Azioni disponibili. - Visualizza profilo (la scheda si apre in linea nell'elenco: nessuna schermata separata) - Scarica certificato - Scarica documento -- Scarica foto tessera - Modifica dati squadra e dati personali del giocatore (DD-017) - Registra numero e data della tessera CSI, una volta arrivata dal comitato - Scollega account, per liberare uno slot assegnato per errore @@ -366,10 +373,9 @@ Ogni sezione contribuisce alla percentuale di completamento. | Sezione | Peso | | --------------------- | ---- | -| Dati personali | 30% | -| Documento di identità | 30% | -| Certificato medico | 30% | -| Foto tessera | 10% | +| Dati personali | 34% | +| Documento di identità | 33% | +| Certificato medico | 33% | Quando tutte le sezioni risultano complete il profilo raggiunge il 100%. @@ -391,7 +397,6 @@ nessun altro ne vede (vedi [Avviso certificati](#avviso-certificati)). - Gestione dati personali - Documento di identità - Certificato medico -- Foto tessera - Dashboard amministratore - Esportazione CSV CSI diff --git a/package.json b/package.json index 4c9380c..77e6a63 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "crapp", - "version": "1.2.1", + "version": "1.2.2", "private": true, "sideEffects": false, "type": "module", diff --git a/src/components/crapp/AvvisoCertificati.tsx b/src/components/crapp/AvvisoCertificati.tsx index 94b4ac9..d0a68ad 100644 --- a/src/components/crapp/AvvisoCertificati.tsx +++ b/src/components/crapp/AvvisoCertificati.tsx @@ -2,7 +2,7 @@ import { AlertCircle } from "lucide-react"; import { Link } from "@tanstack/react-router"; import { useProfili } from "@/lib/profili"; import { - avvisiCertificati, + avvisiCertificatiUtente, formatDataBreve, testoScadenza, type AvvisoCertificato, @@ -49,7 +49,10 @@ function Card({ ); } -/** Avviso certificati in scadenza/scaduti (DD-035): calcolato al volo, niente push. */ +/** + * Avviso certificati in scadenza/scaduti (DD-035, DD-041): calcolato al volo, niente push. + * Il giocatore lo vede da 30 giorni prima della scadenza, lo staff da 7. + */ export function AvvisoCertificati() { const admin = useIsAdmin(); const ruoliPronti = useRuoliPronti(); @@ -61,50 +64,48 @@ export function AvvisoCertificati() { const oggi = oggiISO(); - if (admin) { - const { scaduti, inScadenza } = avvisiCertificati(rosa, profili, oggi); - if (scaduti.length === 0 && inScadenza.length === 0) return null; - return ( - <> - {scaduti.length > 0 ? ( - rigaStaff(a, `scaduto il ${formatDataBreve(a.scadenza)}`))} - /> - ) : null} - {inScadenza.length > 0 ? ( - rigaStaff(a, testoScadenza(a.giorni)))} - /> - ) : null} - - ); - } + // Admin che è anche giocatore: vede il proprio avviso a 30 giorni e quello dello staff (DD-041). + const { personale, staff } = avvisiCertificatiUtente(rosa, profili, oggi, { admin, base }); + const cardPersonale = personale ? ( + personale.giorni < 0 ? ( + + ) : ( + + ) + ) : null; - if (!base) return null; - const { scaduti, inScadenza } = avvisiCertificati([base], profili, oggi); - const mio = scaduti[0] ?? inScadenza[0]; - if (!mio) return null; - - return mio.giorni < 0 ? ( - - ) : ( - + if (!staff) return cardPersonale; + const { scaduti, inScadenza } = staff; + return ( + <> + {cardPersonale} + {scaduti.length > 0 ? ( + rigaStaff(a, `scaduto il ${formatDataBreve(a.scadenza)}`))} + /> + ) : null} + {inScadenza.length > 0 ? ( + rigaStaff(a, testoScadenza(a.giorni)))} + /> + ) : null} + ); } diff --git a/src/components/crapp/ProfiloAmministrativo.tsx b/src/components/crapp/ProfiloAmministrativo.tsx index a41c8ea..17cfdee 100644 --- a/src/components/crapp/ProfiloAmministrativo.tsx +++ b/src/components/crapp/ProfiloAmministrativo.tsx @@ -120,14 +120,12 @@ export function CampiProfilo({ sezioni, fileDocumento, fileCertificato, - fileFoto, }: { corrente: Profilo; aggiorna: (patch: Partial) => void; sezioni: Record; fileDocumento?: React.ReactNode; fileCertificato?: React.ReactNode; - fileFoto?: React.ReactNode; }) { return ( <> @@ -241,14 +239,13 @@ export function CampiProfilo({ /> {fileCertificato} - {fileFoto} ); } /** * I dati personali dell'allenatore (DD-034): gli stessi campi di `profili_giocatore`, meno - * indirizzo, documento, certificato e foto tessera. Condivisi tra Profilo e dashboard admin. + * indirizzo, documento e certificato. Condivisi tra Profilo e dashboard admin. */ export function CampiAllenatore({ corrente, @@ -469,18 +466,6 @@ export function ProfiloAmministrativo({ onCaricato={caricato("certificatoPath")} /> } - fileFoto={ - <> - - - - } />