davideandClaude Sonnet 5
8c6fceb682
Il target 12 non è un valore arbitrario da scalare con la rosa come gli altri target fissi: è il minimo di giocatori per schierare due sestetti (6vs6) in allenamento, confermato intenzionale. Documentato in docs/modules/obiettivi-squadra.md. Non aveva alcun test. Aggiunti unit test (rosa vuota, confine >= 3, target fisso) e 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 il conteggio. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
5.0 KiB
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 |
| 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 parsing HTML del portale CSI: se quel parsing si rompe, questi tre obiettivi restano a 0% anche a fronte di vittorie reali.
- 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), 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.