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>
89 lines
5.0 KiB
Markdown
89 lines
5.0 KiB
Markdown
# 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 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](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.
|