Turno palloni: un solo avviso, 3 ore prima dell'evento (DD-042)

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>

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.

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 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

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 (24, 12 e 6 ore) non cambiano.
+
+**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).

docs/decisions/README.md

@@ -86,6 +86,7 @@ Una decisione sostituita non si cancella: si cambia il suo **Stato** e si rimand
 | [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-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**