Files

T

davideandClaude Opus 5 822180bffc Riscrive AGENTS.md e riallinea la documentazione allo stato reale.

I riferimenti ai documenti in AGENTS.md erano rotti: una venticinquina di link
nella forma docs/[README.md](http://README.md), che spezzavano il nome del file
a meta e puntavano a domini inesistenti. Ora sono percorsi relativi verificati,
con CHANGELOG.md e DESIGN_DECISIONS.md sotto docs/ e PROJECT_STATE.md in root.

Tolte da AGENTS.md le sezioni Architettura, Documentazione e Struttura della
documentazione: duplicavano ARCHITECTURE.md e docs/README.md con uno stack ormai
parziale, contro la regola "ogni informazione ha una sola casa" che docs/README.md
stesso impone. Aggiunti invece i comandi, bun e la guardia minimumReleaseAge:
Codex e Cursor leggono solo AGENTS.md e non avevano modo di sapere come si
verifica una modifica. Scritta la checklist "Fine lavoro" che CLAUDE.md citava
senza che esistesse.

Nuova regola: chi aggiunge o modifica una funzione scrive o aggiorna il test nello
stesso lavoro, i test devono essere verdi e la doc del modulo va aggiornata se il
comportamento cambia (DD-020). Serve perche con main come branch di lavoro non
c'e piu un ambiente di prova tra il codice e i giocatori.

Il flusso git documentato non descriveva piu la realta: main e arrivato a 43
commit di vantaggio su develop, rimasto fermo. DD-003 e ora sostituita da DD-019:
il branch dei commit lo decide l'utente, l'assistente al massimo consiglia un
branch dedicato e non committa, non pusha e non apre PR di propria iniziativa.

Allineati di conseguenza ARCHITECTURE.md (sezione branch), README.md (flusso,
install con bun, comandi di test e lint), ROADMAP.md e TODO.md (le voci spuntate
sono in produzione, non su develop) e PROJECT_STATE.md (auth e profilo giocatore
in produzione, 20 migration fino a M9, passaggi 1-3 e 5 fatti).

Corretti poi sei disallineamenti tra documentazione e codice, ognuno verificato
sul sorgente:

- badge.md e obiettivi-squadra.md dicevano che le serie sono inerti e che
  serieAllenamenti e sempre 0, quindi badge e obiettivo "Continuita di squadra"
  non sbloccabili. Falso da 7237e8f: presenze.ts:48 le calcola e rosa.ts:64-67 le
  attacca al Giocatore. Il limite che resta e un altro, ora scritto: risposto_il
  non e ricostruibile prima di m9, quindi sulle risposte vecchie serieConferme e
  un'approssimazione.
- TODO.md e PROJECT_STATE.md davano il tracciamento tesseramento CSI come da
  fare, mentre ROADMAP, CHANGELOG e DATABASE lo davano per fatto. Lo e:
  admin.tsx:264-278 registra numero e data, :472 mostra Tesserato/Da tesserare,
  :676 il contatore.
- collegamento-csi.md indicava il check di parsing in src/lib/csi-core.test.ts;
  sta in test/unit/csi-core.test.ts, in src/lib non esiste nessun .test.ts.
- profilo-giocatore.md annunciava cinque aree del profilo e ne elencava sette.
- "Segnala un bug" e "Suggerisci una nuova funzionalita" (profilo.tsx:259-276,
  commit 72a9864) non erano documentati da nessuna parte, contro DD-002: ora
  stanno in profilo-giocatore.md e nel CHANGELOG.

npm run test: 28/28 file ok. npm run lint: 12 problemi, identici a prima di
questa modifica e tutti in src/, non toccato qui.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-04 23:24:22 +02:00

6.3 KiB

Raw Blame History

Changelog

Tutte le modifiche significative del progetto vengono registrate in questo documento, in ordine dalla più recente. L'elenco delle funzionalità disponibili e previste non si ripete qui: sta in ROADMAP.md.

Versione attuale — agosto 2026

Serie di presenze calcolate sui dati reali

serieConsecutiva() (src/lib/presenze.ts) deriva le serie da eventi passati e risposte_presenze: prima erano 0 fisso in useRosa() e la sezione «Serie di presenze» del profilo era di fatto inerte, insieme ai badge e all'obiettivo «Continuità di squadra» che ne dipendono.
Migration m9_risposte_presenze_risposto_il: nuova colonna risposto_il con l'istante della prima risposta, resa immutabile da un trigger (aggiornato_il registrava solo l'ultima modifica, quindi chi rispondeva subito e cambiava idea dopo risultava lento). Confrontata con eventi_app.creato_il sblocca finalmente la serie "Conferme 24h" e i badge "Risposta lampo" e "Mai un forfait". Il dato non è ricostruibile all'indietro: vale da qui in avanti (vedi modules/serie-presenze.md).
La barra di progresso di una serie ora misura l'avanzamento fra il traguardo raggiunto e il successivo: prima usava valore/prossimo e tornava indietro a ogni traguardo (2/3 = 67%, poi 3/6 = 50%).

Segnalazioni dal profilo

«Segnala un bug» e «Suggerisci una nuova funzionalità» in /profilo → Impostazioni: due link che aprono una issue GitHub sul template giusto (.github/ISSUE_TEMPLATE/bug_report.yml, feature_request.yml). Nessuna tabella e nessuna schermata di gestione: la segnalazione vive su GitHub (vedi modules/profilo-giocatore.md).

Autenticazione e dashboard amministratore (in produzione)

Login con Google tramite Supabase Auth (DD-011). Al primo accesso l'account si collega a un giocatore di giocatori_squadra, e il collegamento non è più modificabile dal giocatore stesso (DD-016 regola 2).
La selezione libera del giocatore è stata rimossa: /benvenuto offre solo l'accesso con Google e senza sessione non si entra in nessuna schermata. Sparita anche la variabile VITE_AUTH_OBBLIGATORIA (non serve più) e il pulsante «Cambia giocatore» in /profilo.
I permessi di amministrazione arrivano solo da user_roles (src/lib/ruoli.ts): la lista di nomi in crapp-data.ts è stata eliminata, altrimenti bastava scegliere il nome giusto per amministrare.
Migration m4_solo_autenticati: toglie al ruolo anon l'accesso alle tabelle v1.0. Applicata in produzione il 03/09/2026, dopo aver impostato l'email di tutta la rosa attiva — il login era già l'unica via d'accesso lato app, quindi il collegamento dei singoli account (che resta un processo continuo a ogni login) non era comunque condizionato da questa migration.
Collegamento automatico al proprio giocatore per email (DD-018, migration m5_email_giocatori_squadra): niente più scelta manuale da un elenco, /benvenuto confronta l'email dell'account Google con giocatori_squadra.email e collega da solo. Senza corrispondenza compare solo un messaggio d'errore, con un pulsante per uscire e riprovare con un altro account.
Dashboard admin: nuove azioni "Aggiungi giocatore" (con email opzionale per il collegamento automatico) e "Disattiva/Riattiva giocatore" per chi lascia la squadra — la riga non viene mai eliminata, così presenze, voti, pagelle e badge della stagione restano agganciati al suo id. L'email è anche modificabile dal pannello "Dati squadra" di ogni giocatore già in rosa.
Tracciamento tesseramento CSI (migration m8_tesseramento_csi): numero e data di tessera in giocatori_squadra, come gli altri campi che gestisce solo l'admin (DD-016/DD-018). La dashboard mostra chi è già tesserato (badge sulla scheda, contatore in "Squadra") e un pannello per registrare numero e data una volta arrivata la tessera dal CSI.
Profilo giocatore: da /profilo ognuno compila i propri dati anagrafici e carica documento, certificato medico e foto tessera con le relative scadenze (modules/profilo-giocatore.md).
Nuova schermata /admin: stato dei profili della squadra, download di documento, certificato e foto tessera, export CSV per il tesseramento CSI.
Migration m2_profili_giocatore (tabella dei profili e bucket privato), additiva.
Dalla dashboard l'amministratore modifica i dati squadra (nome, cognome, numero, ruolo), compila i dati personali al posto di un giocatore e scollega un account da un profilo (DD-017). I file restano esclusi: li carica solo il giocatore. Nessuna migration: le policy di M1 e M2 lo consentivano già.
Foto profilo sincronizzate tra dispositivi: da /profilo la foto caricata finisce nel bucket pubblico avatar-giocatori (migration m6_avatar_giocatori) invece che in localStorage, così compare per tutta la squadra e non solo su chi l'ha caricata. L'Avatar mostra numero/iniziali finché la foto non è presente.
Scout Live sincronizzato tra dispositivi: il blocco "chi sta scoutando" ora passa dalla tabella scout_sessioni invece che da localStorage, quindi due telefoni non possono più prendere il controllo insieme sovrascrivendosi a vicenda. Le partite scoutate concluse vengono archiviate nella nuova tabella scout_partite (migration m7_scout_partite): prima restavano visibili solo sul telefono di chi aveva chiuso la partita.

Test

Suite di test in test/ (unit, integration, end-to-end) eseguita con bun, senza nuove dipendenze: npm run test e npm run test:all.
Corretto un difetto emerso dai test: una sessione Scout Live con timestamp illeggibile restava bloccata per sempre invece di scadere.

Collegamento CSI

Classifica e risultati ufficiali letti dal portale Livescore CSI Bologna (stagione 2025/26, Campionato Open Misto Eccellenza, Girone B).
La pagina Campionato non usa più dati dimostrativi.
Dettagli e limiti in modules/collegamento-csi.md.

Infrastruttura

Migrazione completa da Lovable a sviluppo locale.
Configurazione Git.
Repository GitHub indipendente.
Deploy automatico tramite Vercel.
Branch main e develop.

Versione 1.0 — luglio 2026

Prima versione usata dalla squadra. Funzionalità incluse: vedi ROADMAP.md § Versione 1.0.

6.3 KiB Raw Blame History