CRAPP/docs/decisions/DD-053.md

DD-053 — Valutazioni − / + dei fondamentali nello Scout Live

Data: 2 novembre 2026
Stato: Accettata (migration m39)

Contesto
Lo scout registrava solo ciò che fa punto o lo toglie (attacco, ace, muro, errore). Mancava un giudizio sul resto del gioco — battuta, ricezione, attacco, muro — che non cambia il punteggio.

Decisione

• Per ogni convocato, un − o un + su battuta, ricezione, attacco e muro, per set.

• Sono valutazioni, non azioni: lista valutazioni separata da azioni, così non entrano nel punteggio, nei parziali né nei totali P/A/M/E (totaliPerGiocatore, badge, classifiche: DD-008).

• Ogni tocco è una riga (giocatore, fondamentale, segno, set, istante): permette l'annulla e il conteggio per set senza strutture da tenere allineate.

• Stato in corso dentro scout_live.stato (jsonb, nessuna modifica); partita archiviata nella nuova colonna scout_partite.valutazioni jsonb NOT NULL DEFAULT '[]' (m39, solo additiva).

• Nella schermata dello scout, su richiesta, sono stati tolti i tasti delle azioni, il tabellone del punteggio e il blocco avversario/campo: lo scout è fatto solo di valutazioni. Non c'è più una «Chiudi set» e «Fine partita» funzionano anche senza punti: il set chiuso vale 0-0 e la partita archiviata di sole valutazioni non è un risultato (haPunteggio()), quindi non compare in Home, Classifica né al posto del referto CSI.

• Il salvataggio dello stato in corso è immediato a ogni tocco, con avviso se fallisce.

Alternative scartate

• Nuovi AzioneTipo dentro azioni → ogni consumatore (punteggio, totali, CSV) andrebbe filtrato per non contarli come punti.
• Solo contatori aggregati per giocatore/set → niente annulla preciso, né ordine cronologico.
• Tabella dedicata → per un dato che nasce e muore con la partita archiviata è più schema del necessario.

Conseguenze
Le partite già archiviate hanno valutazioni = []. Le valutazioni sono visibili solo nel CSV admin; sono dato di squadra a uso tecnico, non entrano in classifiche individuali.

Riesame
Se servirà confrontare le valutazioni tra partite o mostrarle ai giocatori.