# Modulo — Obiettivi di squadra

**Stato:** implementato (v1.0), con target stagionali da aggiornare a mano (i mesi di
riferimento sono ora dinamici)
**File principali:** `src/lib/obiettivi.ts`, `src/lib/rosa.ts` (`useObiettivi()`)

---

## Obiettivo

Mostrare traguardi collettivi (non individuali) che avanzano con il contributo di tutta la
rosa — presenze, risposte alle convocazioni, pagelle, risultati di campionato — per motivare
comportamenti di squadra oltre alla singola prestazione.

---

## Dati

Nessuna tabella dedicata: ogni obiettivo è una funzione pura in `obiettivi.ts` che legge dati
già aggregati altrove (`risposte_presenze`, `pagelle_voti`, i risultati ufficiali CSI, le
serie).

---

## Obiettivi definiti

| Obiettivo                          | Calcolo                                         | Target | Fonte                                          |
| ---------------------------------- | ----------------------------------------------- | ------ | ---------------------------------------------- |
| 90% presenze del mese               | risposte presente/ritardo sugli eventi del mese corrente (dinamico) | 90%    | `risposte_presenze` |
| Tutti rispondono alle convocazioni | risposte totali / eventi possibili              | 90%    | `risposte_presenze`                            |
| 250 presenze complessive           | somma presenze di tutta la rosa                 | 250    | aggregato da `useRosa()`                       |
| Media pagelle da 7.5               | media di squadra                                | 7.5    | `pagelle_voti`                                 |
| 200 pagelle compilate              | conteggio voti                                  | 200    | `pagelle_voti`                                 |
| Continuità di squadra              | giocatori con ≥3 allenamenti consecutivi        | 12 (min. per un 6vs6) | `serieAllenamenti`             |
| 1 / 5 / 10 vittorie in campionato  | partite vinte da dati CSI ufficiali             | 1/5/10 | modulo [Collegamento CSI](collegamento-csi.md) |
| 1 evento di squadra al mese        | eventi di tipo "evento" nel mese corrente (dinamico) | 1      | `eventi_app`                              |

Mostrati in `squadra.tsx` (elenco completo con barra di progresso) e in `index.tsx` (home: il
primo obiettivo non completato). Un obiettivo che supera il 90% genera anche una notifica
smart (`notifiche-smart.ts`).

---

## Limiti noti

- Le vittorie di campionato dipendono dal **JSON** delle partite del portale CSI (non dalla
  classifica HTML): se quel parsing si rompe, questi tre obiettivi restano a 0% anche a fronte
  di vittorie reali, **senza segnalazione d'errore** — vedi il dettaglio in
  [Collegamento CSI § Limiti noti](collegamento-csi.md#limiti-noti).
- I target (250 presenze, 200 pagelle, ecc.) sono costanti fisse, da rivedere manualmente a
  ogni stagione — con l'eccezione di "Continuità di squadra" (vedi sotto), il cui target ha un
  significato specifico e non va scalato come gli altri.

---

## Obiettivi mensili — mese dinamico

"90% presenze del mese" e "1 evento di squadra al mese" si azzerano automaticamente a ogni
cambio mese: il mese di riferimento è calcolato dalla data corrente (fuso Europe/Rome), non più
una costante fissa. Per il primo, titolo ("90% di presenze ad agosto" / "a settembre" / ...) e
scadenza (ultimo giorno del mese) seguono di conseguenza.

"Tutti rispondono alle convocazioni" non si azzera (aggrega su tutti gli eventi in programma,
non solo quelli del mese corrente), ma la sua `scadenza` mostrata in interfaccia era anch'essa
una data fissa (`"2026-09-30"`): ora è anch'essa l'ultimo giorno del mese corrente.

Per i test, `obiettiviSquadra`/`obiettiviOrdinati` accettano un terzo parametro opzionale
`oggi: Date` per iniettare una data deterministica. Coperti sia da unit test
(`test/unit/obiettivi.test.ts`, funzione pura) sia da un integration test end-to-end
(`test/integration/obiettivi.test.ts`, scrive/rilegge righe vere su `eventi_app` e
`risposte_presenze` sullo stack Supabase locale).

---

## Continuità di squadra — il target 12 è il minimo per un 6vs6

Il target di 12 giocatori con almeno 3 allenamenti consecutivi **non è arbitrario**: è il numero
minimo di giocatori per schierare due sestetti (6 contro 6) in allenamento. A differenza degli
altri target fissi (250 presenze, 200 pagelle...), non va scalato in proporzione alla rosa se
questa cambia dimensione — resta 12 finché l'obiettivo è "riuscire ad allenarsi in modo
completo", indipendentemente da quanti giocatori ci sono in rosa oltre quel minimo.

Dipende da `serieAllenamenti` (vedi [Serie di presenze](serie-presenze.md)), calcolato sui dati
reali: un evento passato senza risposta vale come assenza e azzera la serie, quindi l'obiettivo
misura anche quanto la squadra risponde alle convocazioni, non solo la presenza fisica.

Coperto da unit test (rosa vuota, il confine ≥3 — 2 non basta, 3 sì — e il target fisso a 12) e
da un integration test end-to-end che scrive tre allenamenti e presenze reali sul database
locale, calcola `serieConsecutiva()` (la stessa funzione pura usata da `useRosa()` in
produzione) sui dati riletti, e verifica che solo chi è rimasto in serie venga contato.