Files
CRAPP/docs/modules/obiettivi-squadra.md
T
davideandClaude Sonnet 5 e13722eae9 Rende dinamica anche la scadenza di "Tutti rispondono alle convocazioni"
La scadenza era una data fissa (2026-09-30), stesso problema già risolto per
"presenze del mese" e "evento di squadra al mese": ora segue l'ultimo giorno
del mese corrente. Aggiunti unit test e integration test end-to-end contro il
database locale (isolando gli eventi di test, perché questo obiettivo aggrega
su tutti gli eventi indipendentemente dal mese).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-08 11:14:57 +02:00

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

  • "Continuità di squadra" 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.
  • 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.

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