diff --git a/PROJECT_STATE.md b/PROJECT_STATE.md index c80063a..252561e 100644 --- a/PROJECT_STATE.md +++ b/PROJECT_STATE.md @@ -1,6 +1,6 @@ # Project State -Ultimo aggiornamento: 04/09/2026 +Ultimo aggiornamento: 06/09/2026 ## Stato generale @@ -21,7 +21,7 @@ reali (M9). - Cursor e Claude Code come ambienti di sviluppo - Vercel configurato; Environment Variables aggiornate al nuovo Supabase (Preview e Production) - Supabase proprietario attivo — Project Ref: `kfkcldwncxqaixetsjes` -- 20 migration in `supabase/migrations/`, fino a `m9_risposte_presenze_risposto_il` +- 23 migration in `supabase/migrations/`, fino a `m12_niente_autovoto` - Sviluppo locale verificato con il nuovo Supabase --- @@ -36,7 +36,8 @@ reali (M9). ## Database -- Schema v1.0 e migration da M1 a M9 applicate al nuovo Supabase +- Schema v1.0 e migration da M1 a M11 applicate al nuovo Supabase; `m12_niente_autovoto` + applicata in locale, **da applicare in produzione** (`npx supabase db push`) - `public.giocatori_squadra`: rosa iniziale di 17 giocatori (migration `m5_email_giocatori_squadra`) più quelli aggiunti da `/admin` a stagione in corso; da settembre 2026 tutti i giocatori attivi hanno l'email registrata (colonna `email`, DD-018), impostabile da `/admin` senza @@ -48,6 +49,14 @@ reali (M9). ancora presente su `giocatori_squadra`) - Migration `m6_avatar_giocatori`: bucket pubblico `avatar-giocatori` per le foto profilo, al posto di `localStorage` (una per giocatore, letto da `src/lib/avatar-store.ts`) +- Migration `m10_azzera_turni_palloni_allenamenti`: toglie i turni palloni salvati sugli + allenamenti, che non ricevono più una proposta automatica (vedi + [docs/modules/palloni.md](docs/modules/palloni.md)) +- Migration `m11_scritture_per_ruolo`: le policy di scrittura rispecchiano i permessi + dell'interfaccia (DD-023). Fino a M10 un qualsiasi utente autenticato poteva svuotare il + calendario o riscrivere il voto di un altro parlando direttamente con PostgREST; la tabella + dei permessi sta in [docs/DATABASE.md](docs/DATABASE.md) ed è verificata da + `test/integration/permessi.test.ts` - Migration `m7_scout_partite`: nuova tabella `scout_partite` per l'archivio delle partite scoutate concluse, e collegamento della tabella `scout_sessioni` (già presente nello schema ma mai usata) al blocco condiviso dello Scout Live — prima entrambi vivevano solo diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 3fc424c..bb640aa 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -60,8 +60,9 @@ ricorrente: `src/router.tsx` (`staleTime` 5 min, `gcTime` 30 min, `refetchOnWindowFocus/Mount/Reconnect` disattivati, `retry: 1`); - dopo una mutazione la cache si aggiorna con `setQueryData`, **non** con - `invalidateQueries`: invalidare provoca una rilettura e costa una query in più (unica - eccezione oggi: `scout-live.ts`); + `invalidateQueries`: invalidare provoca una rilettura e costa una query in più. Unica + eccezione: `scout-live.ts`, dove il lock può essere stato preso da un altro dispositivo, + quindi quello che abbiamo scritto non è detto sia quello che vale; - le funzioni pure di calcolo sono separate dagli hook (es. `palloni-core.ts` vs `palloni.ts`, `mediePagelle()` vs `usePagelle()`); - `src/lib/rosa.ts` è l'aggregatore: compone tutti gli hook e restituisce la rosa completa diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index fc5e747..7b9cb04 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -6,6 +6,33 @@ qui: sta in [ROADMAP.md](ROADMAP.md). ## Versione attuale — agosto 2026 +### Tre riletture in meno dopo ogni salvataggio + +- «Aggiungi giocatore», salvataggio ed eliminazione di una partita scoutata e cambio della + foto profilo aggiornavano la cache con `invalidateQueries`, cioè rileggendo tutto dal + database. Ora usano `setQueryData` come il resto dell'app: il dato scritto è noto, non + serve richiederlo indietro. +- Resta una sola eccezione, `scout-live.ts`: lì il lock può essere stato preso da un altro + dispositivo, quindi rileggere è l'unico modo per sapere chi ha vinto. + +### Il cronometro delle conferme è verificato dai test + +- `test/integration/scritture.test.ts` controlla ora che un ripensamento non riscriva + `risposto_il`, cioè che il trigger di `m9` sia davvero al suo posto: prima il test guardava + `aggiornato_il`, che è l'ultima modifica e non alimenta nessuna statistica, quindi restava + verde anche senza trigger. +- Il calcolo dei destinatari del sollecito presenze esce dalla route ed è ora + `destinatariSollecito()` in `src/lib/presenze.ts`, con i suoi test — stesso trattamento già + dato ad `avvisiPalloniEvento()` per i palloni. + +### Nessuno si vota da solo + +- L'elenco della votazione MVP non mostra più il votante: prima bastava toccare il proprio + nome per eleggersi MVP, e il titolo finiva tra le statistiche come qualsiasi altro. +- I vincoli `mvp_no_autovoto` e `badge_social_no_autovoto` (migration `m12_niente_autovoto`) + rifiutano l'auto-voto anche a chi scrive direttamente su PostgREST, come `pagelle_voti` + faceva già dalla v1.0. Le righe che violavano la regola vengono cancellate dalla migration. + ### La suite copre i conteggi presenze, il calendario e la guardia delle notifiche - Nuovi check unitari su `contaPresenzeGiocatore`/`totaliEventiGiocatore` (numeratore e diff --git a/docs/DATABASE.md b/docs/DATABASE.md index 4102783..a91d0bd 100644 --- a/docs/DATABASE.md +++ b/docs/DATABASE.md @@ -61,11 +61,11 @@ La tabella è verificata da `test/integration/permessi.test.ts` contro il databa ## Votazioni -| Tabella | Scopo | Note | -| ------------------- | ------------------------------------ | ------------------------ | -| `mvp_voti` | Voti MVP assegnati a fine partita. | | -| `pagelle_voti` | Voti anonimi assegnati ai giocatori. | Usati per il voto medio. | -| `badge_social_voti` | Voti social per i badge. | | +| Tabella | Scopo | Note | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | +| `mvp_voti` | Voti MVP assegnati a fine partita. | Un voto per votante e partita; auto-voto rifiutato (`mvp_no_autovoto`, migration `m12_niente_autovoto`). | +| `pagelle_voti` | Voti anonimi assegnati ai giocatori. | Usati per il voto medio. Voto 1-10 e auto-voto rifiutato dai vincoli della v1.0. | +| `badge_social_voti` | Voti social per i badge. | Un voto per categoria, votante e partita; auto-voto rifiutato (`badge_social_no_autovoto`, `m12_niente_autovoto`). | ## Turni e notifiche diff --git a/docs/EFFICIENZA_CLOUD.md b/docs/EFFICIENZA_CLOUD.md index 21a0d5b..d782dc6 100644 --- a/docs/EFFICIENZA_CLOUD.md +++ b/docs/EFFICIENZA_CLOUD.md @@ -11,8 +11,9 @@ Query, traffico e invocazioni vanno tenuti al minimo **per costruzione**, non ot (`staleTime` 5 min, `gcTime` 30 min, `refetchOnWindowFocus/Mount/Reconnect` disattivati, `retry: 1`). Non alzare la frequenza di refetch modulo per modulo. 3. **Dopo una mutazione si aggiorna la cache con `setQueryData`**, non con - `invalidateQueries`: invalidare costa una rilettura. Unica eccezione oggi: - `src/lib/scout-live.ts`. + `invalidateQueries`: invalidare costa una rilettura. Unica eccezione: + `src/lib/scout-live.ts`, dove il lock di sessione può essere stato preso da un altro + dispositivo e la riga scritta non basta a sapere chi ha vinto. 4. **Scout Live**: scrive solo chi sta segnando; gli altri leggono dati già salvati. 5. **Write once, read many**: statistiche, badge e classifiche si calcolano una volta e non si ricalcolano a ogni apertura di pagina. I badge restano calcolati a runtime dai dati già diff --git a/docs/modules/badge.md b/docs/modules/badge.md index c8e5b14..46e28a0 100644 --- a/docs/modules/badge.md +++ b/docs/modules/badge.md @@ -33,7 +33,8 @@ badge assegnati per voto dai compagni. - **Badge social** (`badge-social.ts`, tabella `badge_social_voti`): 5 categorie fisse per partita ("Compagno affidabile", "Miglior spirito di squadra", "Fair play", "Meme della partita", "Cuore del gruppo"), votabili una volta a testa per categoria/partita - (modificabile), con **auto-voto escluso sia in UI sia in logica** (`VotoSocial.tsx`). A + (modificabile), con **auto-voto escluso in interfaccia** (`VotoSocial.tsx`) e rifiutato dal + database (vincolo `badge_social_no_autovoto`, migration `m12_niente_autovoto`). A differenza delle [Pagelle](pagelle.md), qui non c'è alcun tentativo di anonimato: `votante_id`/`votato_id` sono entrambi visibili. - `CollezioneBadge.tsx` mostra sbloccati, in progresso, badge social vinti e un contatore di @@ -63,8 +64,9 @@ badge assegnati per voto dai compagni. risposte precedenti a `m9`: su quelle righe la serie è un'approssimazione. - Nessuno storico dei badge sbloccati: se cambiano le soglie o i dati sorgente, un badge già "ottenuto" può sparire o apparire retroattivamente. -- RLS permissiva su `badge_social_voti` (stesso schema di `mvp_voti`): nessun controllo - server-side che `votante_id` coincida con l'utente autenticato. +- La policy di M11 garantisce che il voto sia firmato con il proprio `votante_id`, ma non + che il votato sia un giocatore convocato per quella partita: quello resta un filtro solo + applicativo. - Notifiche "nuovo badge" solo locali al dispositivo (localStorage), si ripetono cambiando browser o dispositivo. diff --git a/docs/modules/mvp.md b/docs/modules/mvp.md index feba855..a9e7a57 100644 --- a/docs/modules/mvp.md +++ b/docs/modules/mvp.md @@ -25,6 +25,9 @@ partita, sovrascrivibile. per la partita, altrimenti mostra "la partita non è ancora stata disputata". - `useVotaMvp()` fa upsert `onConflict: match_id, votante_id`: il voto è modificabile senza limiti, senza storico. +- Nessuno vota sé stesso: `VotazioneMvp.tsx` toglie il votante dall'elenco e il vincolo + `mvp_no_autovoto` (migration `m12_niente_autovoto`) rifiuta la riga anche a chi scrive + direttamente su PostgREST, come già faceva `pagelle_no_autovoto` per le pagelle. - `conteggioPartita()`/`vincitoriMvp()` richiedono un margine netto: in caso di parità, nessun vincitore viene assegnato per quella partita finché non arrivano altri voti. - `mvpVintiPerGiocatore()` conta una vittoria per ogni partita "vinta" con margine netto; il @@ -35,18 +38,15 @@ partita, sovrascrivibile. ## Limiti noti -- **Nessun controllo che impedisca di votare se stessi** — a differenza dei - [Badge social](badge.md), che escludono esplicitamente l'auto-voto. È una lacuna, non un - limite di design dichiarato altrove. - Nessuna scadenza o chiusura della votazione: resta aperta indefinitamente. -- RLS permissiva: `votante_id`/`votato_id` sono testo libero inviato dal client (l'id - giocatore proviene da `localStorage`, non da un claim di sessione verificato server-side); - nessun trigger lega il voto all'utente autenticato. +- Il voto è legato a chi lo scrive: da `m11_scritture_per_ruolo` la policy impone che + `votante_id` sia lo slot collegato all'account (DD-023). Su chi viene votato l'unico + vincolo è che non sia il votante stesso (`mvp_no_autovoto`): che sia un convocato di + quella partita resta un filtro solo applicativo. - In caso di parità, nessun MVP viene assegnato per quella partita. --- ## Evoluzioni possibili -- Impedire l'auto-voto come già avviene nei Badge social. - Introdurre una scadenza (es. la votazione si chiude N giorni dopo la partita). diff --git a/docs/modules/presenze.md b/docs/modules/presenze.md index 0c446e4..d056142 100644 --- a/docs/modules/presenze.md +++ b/docs/modules/presenze.md @@ -53,7 +53,8 @@ Bottone "Sollecita" (RosaPresenze.tsx) → POST /api/public/sollecita-presenze ↓ src/routes/api/public/sollecita-presenze.ts ├─ legge l'evento (eventi_app) e le risposte già date - ├─ calcola i destinatari: giocatori attivi senza risposta o con "forse" + ├─ destinatariSollecito() → src/lib/presenze.ts + │ (attivi senza risposta o con "forse"; funzione pura, testata in unit) ├─ per ciascuno invia una push col testo cifrato nel payload │ (src/lib/webpush.server.ts) └─ elimina le iscrizioni push scadute (404/410) @@ -70,24 +71,25 @@ vale per tutta la rosa) — `eventiContanoPresenze()` in `presenze.ts`. - Aggiornamento ottimistico della cache locale dopo ogni salvataggio: nessuna rilettura dal server, la UI risponde subito. - Il sollecito è **manuale**: nessun cron nel repository lo richiama automaticamente, parte - solo dal bottone admin. + solo dal bottone admin, e la route verifica il ruolo lato server con `richiediAdmin` + (DD-024). +- Ognuno risponde **solo per sé**, e non è più una regola della sola interfaccia: dalla + migration `m11_scritture_per_ruolo` la policy di `risposte_presenze` lega la riga allo slot + `giocatori_squadra` collegato all'account, con gli amministratori come sola deroga + (DD-023). Verificato da `test/integration/permessi.test.ts`. --- ## Limiti noti - Nessuna finestra temporale per rispondere: si può cambiare risposta anche a evento passato. -- Il controllo "solo il giocatore risponde per sé" è solo lato UI: le policy RLS di - `risposte_presenze` permettono a qualunque utente autenticato di scrivere qualunque riga - (`USING(true) WITH CHECK(true)`). +- La risposta di un evento passato resta modificabile: `risposte_presenze` non ha una + finestra di chiusura, né in UI né in RLS. - `useRispostePresenze()` legge sempre l'intera tabella, non filtrata per evento: adeguato per una singola squadra, da rivedere se il volume cresce molto. -- La route `/api/public/sollecita-presenze` non verifica lato server che il chiamante sia - admin: la protezione è solo nell'interfaccia (bottone visibile solo se `useIsAdmin()`). --- ## Evoluzioni possibili -- Restringere anche lato RLS/route chi può scrivere una risposta o chiamare il sollecito. - Filtrare la lettura delle presenze per evento invece di caricare tutta la tabella. diff --git a/docs/modules/serie-presenze.md b/docs/modules/serie-presenze.md index 6f0044c..c563b4c 100644 --- a/docs/modules/serie-presenze.md +++ b/docs/modules/serie-presenze.md @@ -4,7 +4,8 @@ **File principali:** `src/lib/serie.ts`, `src/lib/presenze.ts`, `src/lib/rosa.ts`, `src/components/crapp/SerieCard.tsx` **Migration collegata:** `m9_risposte_presenze_risposto_il` -**Test:** `test/unit/serie.test.ts`, `test/unit/presenze.test.ts` +**Test:** `test/unit/serie.test.ts`, `test/unit/presenze.test.ts`, +`test/integration/scritture.test.ts` (il trigger che congela `risposto_il`) --- @@ -58,6 +59,18 @@ UPDATE: senza, un giocatore che risponde subito e cambia idea una settimana dopo lento. `aggiornato_il` continua a registrare l'ultima modifica ed è un'altra cosa: non usarlo per le conferme. +Le due colonne si confondono facilmente, e sbagliarle non rompe niente di visibile: la serie +comincia solo a raccontare il falso. Per questo il confine è verificato in +`test/integration/scritture.test.ts` («la risposta di presenza si aggiorna senza far ripartire +il cronometro»), che riscrive la risposta provando a riscrivere anche `risposto_il` e controlla +che il database abbia tenuto la prima: se qualcuno togliesse il trigger, quel test diventa +rosso. Il test precedente guardava `aggiornato_il` e passava anche senza trigger. + +| Colonna | Cosa registra | Chi la usa | +| --------------- | --------------------- | ----------------------- | +| `risposto_il` | la **prima** risposta | la serie "Conferme 24h" | +| `aggiornato_il` | l'**ultima** modifica | nessuna statistica | + Cancellare la risposta (`stato: null` → DELETE) elimina anche `risposto_il`: se il giocatore risponde di nuovo, riparte il cronometro. È voluto — ha ritirato la risposta. @@ -102,8 +115,11 @@ ordine: - solo eventi a cui il giocatore era convocato. **`convocati` vuoto significa "tutta la rosa"**, non "nessuno": chi non è nell'elenco di una convocazione ristretta non vede quell'evento e la sua serie non si spezza. -2. **Scarta il futuro** (`e.data <= oggi`). Gli eventi di oggi contano già: se serve un - confronto diverso, il parametro `oggi` è iniettabile (i test lo fissano a una data). +2. **Tiene solo gli eventi già passati** (`e.data < oggi`, dentro `eventiContanoPresenze()`). + Il confronto è **stretto**: l'evento di oggi non conta ancora, perché nessuno ha potuto + presentarsi e conterebbe come assenza, azzerando la serie di tutta la squadra la mattina + della partita. Entra in gioco dal giorno dopo. Il parametro `oggi` è iniettabile — di + default `dataOggi()` — e i test lo fissano a una data per non dipendere dall'orologio. 3. **Ordina per data crescente** (`localeCompare` su `YYYY-MM-DD`). 4. **Riduce** applicando `aggiornaSerie(serie, onorato(e))` a ogni evento: `+1` se onorato, `0` altrimenti. La serie finale è quella che risulta **dopo l'ultimo evento passato**. diff --git a/src/components/crapp/VotazioneMvp.tsx b/src/components/crapp/VotazioneMvp.tsx index ea8b0de..87f7601 100644 --- a/src/components/crapp/VotazioneMvp.tsx +++ b/src/components/crapp/VotazioneMvp.tsx @@ -71,22 +71,26 @@ export function VotazioneMvp({ matchId }: { matchId: string }) { {aperto ? (