davideandClaude Sonnet 5.5
cdf8b144e2
La migration m27 riduce il job automatico alla sola fascia delle 3 ore: l'avviso arriva una volta a chi deve portare i palloni e a chi li deve prendere. I tipi turno_palloni_12h e _6h restano ammessi per le notifiche già generate e per la revoca. Migration applicata in produzione. Test di integrazione aggiornati (nessun avviso a 4,5 e 9 ore); documentati DD-042, moduli, DATABASE, ROADMAP, glossario e changelog. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# DD-025 — Il promemoria palloni lo manda l'admin, per un evento
|
|
|
|
**Data:** 6 settembre 2026
|
|
**Stato:** Accettata
|
|
|
|
**Contesto**
|
|
`promemoria-palloni` era disegnata per un cron quotidiano: calcolava chi è di turno **oggi** e
|
|
gli mandava una push. DD-024 l'aveva chiusa con un segreto condiviso, coerente con quel
|
|
disegno. Ma nel repository non c'è nessun cron, e `docs/modules/palloni.md` lo annotava già
|
|
come «da verificare lato hosting»: nei fatti quel promemoria non è mai partito. Una route che
|
|
funziona e che nessuno chiama.
|
|
|
|
Nel frattempo l'app aveva già il precedente giusto: `apri-sondaggio` è manuale fin dall'inizio
|
|
(«Nessun cron: l'invio è manuale», CHANGELOG).
|
|
|
|
**Decisione**
|
|
Il promemoria lo fa partire un amministratore dal pulsante «Avvisa chi è di turno», dentro il
|
|
riquadro palloni della pagina evento. La route accetta un `eventoId` e avvisa i destinatari di
|
|
**quell'evento** — chi deve prendere i palloni e chi deve riportarli — invece della giornata
|
|
corrente. Il controllo di accesso diventa `richiediAdmin` come le altre due, e
|
|
`richiediSegreto` con la sua variabile `CRON_SEGRETO` spariscono.
|
|
|
|
Il testo dell'avviso viaggia dentro la push, cifrato nel payload (DD-026): il service worker
|
|
lo mostra così com'è, quindi un avviso mandato il martedì per il sabato arriva col testo
|
|
giusto.
|
|
|
|
**Alternative scartate**
|
|
|
|
- Un pulsante «manda il promemoria di oggi» in Dashboard → rispecchia la route com'era, ma
|
|
premuto un martedì qualsiasi risponderebbe «inviate: 0» e sembrerebbe rotto. L'admin
|
|
ragiona per evento, non per giornata.
|
|
- Tenere il cron e configurarlo davvero → più lavoro, una variabile d'ambiente da gestire in
|
|
ogni ambiente, e nessuno l'aveva chiesto. Un pulsante che funziona batte uno scheduler che
|
|
non esiste.
|
|
- Calcolare il testo al volo sulla giornata corrente → funziona solo se l'avviso parte il
|
|
giorno stesso, cioè proprio il vincolo da cui volevamo uscire.
|
|
|
|
**Conseguenze**
|
|
|
|
- Il promemoria è ora una scelta consapevole di un admin, non un automatismo: se nessuno preme
|
|
il pulsante, non parte niente. È un passo indietro rispetto all'idea originale, ma un passo
|
|
avanti rispetto alla realtà, dove non partiva mai.
|
|
- `destinatariPromemoriaPalloni()` non è più usata dalla route ma resta in `palloni-core.ts`.
|
|
- Sparisce `CRON_SEGRETO`: nessuna variabile d'ambiente nuova da configurare in nessun
|
|
ambiente.
|
|
|
|
**Riesame**
|
|
Se la squadra si accorge che l'admin si dimentica di premere il pulsante. A quel punto il cron
|
|
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 (poi ridotto a uno solo, 3 ore
|
|
prima, da DD-042), per gli eventi con un incaricato confermato; il pulsante e la route restano.
|