Files
davideandClaude Sonnet 5.5 8f25143aa5 Riorganizza la documentazione per l'uso con assistenti AI
- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice
- Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura
- Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md
- Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md
- Sintetizza la copertura test di badge.md e documenta docs/archive
- Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 08:53:38 +02:00

2.0 KiB

DD-032 — La stagione CSI si ricava dalle date delle gare

Data: 24 settembre 2026
Stato: Accettata

Contesto
La pagina Campionato (/classifica) non diceva a quale stagione si riferissero classifica e storico partite. Il portale CSI non espone il nome della stagione da nessuna parte: project-sheets.php, league_details.php, team-main.php e il feed getEventsByTeamId.php riportano solo il nome della competizione (verificato il 24/09/2026). Il project_id cambia a ogni stagione ed è aggiornato a mano in csi-core.ts.

Decisione
stagioneDi() in src/lib/csi-core.ts ricava la stagione ("2025/26") dalla data di una gara, con l'anno che cambia ad agosto; stagioneDaPartite() usa la prima gara del campionato letto (tutte le gare, non solo quelle giocate, così a inizio stagione basta il calendario). L'header di /classifica mostra quella stagione, e lo storico partite è diviso per stagione con raggruppaPerStagione(): le gare dello Scout Live locale, usate quando il CSI non ne ha, possono essere di stagioni diverse.

Alternative scartate

  • Una costante CSI_STAGIONE accanto a CSI_PROJECT_ID → un secondo valore da ricordarsi di aggiornare a ogni stagione, che può divergere dal project_id; ricavata dai dati segue da sola.
  • Usare la stagione "in corso" per la squadra (la data di oggi) → sbaglierebbe proprio nel periodo di passaggio: a settembre 2026 il CSI mostra ancora i dati 2025/26.

Conseguenze

  • Oggi Campionato mostra «Stagione 2025/26» mentre Squadra e Calendario, che hanno la stagione scritta nel codice, mostrano «Stagione 2026/27»: il CSI non ha ancora creato le pagine della nuova stagione. È voluto — Campionato riporta la stagione dei dati che mostra (dettagli in collegamento-csi.md).
  • Quando si aggiornano i project_id l'etichetta si aggiorna senza toccare altro codice.

Riesame
Se il CSI iniziasse a esporre il nome della stagione, leggerlo da lì; se una stagione CSI dovesse iniziare prima di agosto, spostare la soglia in stagioneDi().