Merge main in feature/gara: campionato CSI 2026/27 (1.5.0)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> # Conflicts: # PROJECT_STATE.md # docs/CHANGELOG.md
2026-10-29 08:34:28 +01:00
commit 09dba1890d
@@ -9,9 +9,10 @@ schema in [docs/DATABASE.md](docs/DATABASE.md), le procedure in
 ## Stato generale
- **Versione:** 1.4.2 in produzione su `main` (tag `v1.4.2`): ogni evento può avere un link Google
+- **Versione:** 1.5.0 su `main` (tag `v1.5.0`): campionato CSI sulla stagione 2026/27 (nuovi `project_id`
-  Maps del luogo, mostrato come «Apri su Maps» nelle schede (`m34`). Su `feature/gara` c'è del lavoro
+  e `team_id`, nessuna Coppa). Su `feature/gara` c'è del lavoro non ancora rilasciato (voto MVP, vedi
-  non ancora rilasciato (voto MVP, vedi «Lavoro in corso»). La 1.4.1: gli eventi con convocati si
+  «Lavoro in corso»). La 1.4.2: ogni evento può avere un link Google Maps del luogo, mostrato come
  «Apri su Maps» nelle schede (`m34`). La 1.4.1: gli eventi con convocati si
  vedono solo ai convocati (admin e allenatori sempre) e «Rosa e presenze» elenca solo loro. La 1.4.0:
  avviso «Presenza modificata» ad admin e allenatori (DD-050, `m32`-`m33`). La 1.3.1: il Calendario
  mostra solo i prossimi compleanni del mese; tolta la serie «Conferme 24h» con i badge «Risposta
@@ -36,6 +36,22 @@ Quattro migration, da `m35` a `m38`, **non ancora applicate in produzione**.
  (`m38`): un client non può più salvare un nome diverso da quello del giocatore votato. In
  produzione non risultavano voti MVP, quindi nessun dato da bonificare.
 ## [1.5.0] - 2026-10-29
 Campionato CSI 2026/27. Nessuna migration.
 ### Modificato
 - Campionato CSI passato alla stagione 2026/27: nuovo `project_id` (933) e nuovo `team_id`
  (3878). La Coppa non c'è quest'anno e la sezione resta nascosta; lo storico 2025/26 non viene
  più mostrato.
 ### Dati
 - Calendario di produzione aggiornato a mano con le 12 gare di campionato già definite dal CSI
  (4/11/2026 – 11/3/2027): titolo «CAMPIONATO», luogo e link Google Maps dell'impianto. I 9
  allenamenti nello stesso giorno di una gara sono stati eliminati.
 ## [1.4.2] - 2026-10-26
 Link Google Maps del luogo degli eventi. Una migration, `m34`, applicata in produzione il
@@ -31,7 +31,7 @@ Tutto quello che è rilasciato, fino alla versione 1.0.0 (vedi `CHANGELOG.md`).
      resta un'estensione futura
 - [x] Gestione tesseramenti CSI — raccolta dati ed export CSV; il tracciamento di numero e data
      di tessera è stato tolto dalla dashboard (DD-048)
- [x] Collegamento CSI (stagione 2025/26)
+- [x] Collegamento CSI (stagione 2026/27)
 - [x] Classifica automatica (campionato e Coppa)
 - [x] Risultati campionato
 - [x] Dettaglio partita — formazioni, storico scontri diretti e probabilità di vittoria
@@ -1,6 +1,6 @@
 # Modulo — Collegamento CSI
-**Stato:** implementato (stagione 2025/26)
+**Stato:** implementato (stagione 2026/27)
 **Route interessate:** `/classifica` (classifica e storico), `/partita/$id` e `/partita-csi/$id`
 (dettaglio di una gara: formazioni e scontri diretti)
@@ -28,52 +28,50 @@ verificato leggendo `assets/js/project.js` e `assets/js/team.js`, referenziati i
 alle due pagine. Servono solo per la consultazione manuale nel browser (es. per ritrovare
 un `project_id`), nessun codice le chiama direttamente.
-### Identificativi (stagione 2025/26)
+### Identificativi (stagione 2026/27)
 | Cosa                  | Valore                                 |
 | --------------------- | -------------------------------------- |
 | Campionato            | PVM - Campionato Open Misto Eccellenza |
-| `project_id` (girone) | `767`                                  |
+| `project_id` (girone) | `933`                                  |
-| Coppa                 | PVM Coppa CSI Misto Silver             |
+| Coppa                 | nessuna: la squadra non è iscritta     |
-| `project_id` (coppa)  | `848`                                  |
+| `project_id` (coppa)  | `null`                                 |
-| Squadra sul portale   | `C.R.A.P. Volley` (con i punti)        |
+| Squadra sul portale   | `C.R.A.P. Volley`                      |
-| `team_id`             | `3359`                                 |
+| `team_id`             | `3878`                                 |
-| Girone                | B                                      |
+| Girone                | B (7 squadre)                          |
-`project_id` (767), `CSI_COPPA_PROJECT_ID` (848) e `team_id` (3359) sono costanti in
+`project_id` (933), `CSI_COPPA_PROJECT_ID` (`null`) e `team_id` (3878) sono costanti in
 `src/lib/csi-core.ts`.
-**Stagione 2026/27 non ancora sul portale (verificato il 24/09/2026).** Il CSI non ha ancora
+**A ogni stagione il CSI crea una nuova squadra, con un nuovo `team_id`.** Il 2025/26 era
-creato le pagine di campionato e Coppa 2026/27: le uniche competizioni della squadra sono
+`3359` (campionato `767`, Coppa `848`); verificato il 29/10/2026 che `getEventsByTeamId.php`
-ancora `767` e `848`, con gare da novembre 2025 a maggio 2026. Per questo `/classifica`
+per `3878` restituisce solo le 12 gare 2026/27 (4/11/2026 – 11/3/2027), nessuna giocata, e per
-mostra «Stagione 2025/26» mentre Squadra e Calendario, che hanno la stagione scritta nel
+`3359` solo quelle del 2025/26. Cambiando `team_id` lo storico della stagione scorsa sparisce
-codice, mostrano già «Stagione 2026/27». È voluto: la pagina Campionato riporta la stagione
+da `/classifica`: è voluto, si lascia perdere la stagione passata. A inizio stagione la
-dei dati CSI che sta mostrando, non quella in corso per la squadra. Quando il CSI pubblica
+classifica è tutta a zero (giocate 0): non è un errore di parsing.
 la nuova stagione si aggiornano i due `project_id` (vedi sotto) e l'etichetta passa da sola
 a 2026/27 ([DD-032](../decisions/DD-032.md)).
-Per ritrovare questi id a ogni cambio stagione: `components/team-main.php?team_id=3359`
+Per ritrovare gli id a ogni cambio stagione: aprire `team_details.php?team_id=<nuovo id>` (il
-(dietro `team_details.php`) contiene una sezione "Campionati" con un link
+`team_id` si legge dal link della squadra nella pagina del girone) oppure
-`league_details.php?project_id=…` per ogni competizione a cui la squadra è iscritta —
+`components/team-main.php?team_id=<id>`, che contiene una sezione "Campionati" con un link
-verificato chiamando l'endpoint direttamente, che oggi restituisce sia
+`league_details.php?project_id=…` per ogni competizione a cui la squadra è iscritta (oggi solo
-`project_id=848` (Coppa) sia `project_id=767` (Campionato). Non serve aprire
+`933`). Se il CSI crea una Coppa e la squadra vi è iscritta, compare qui: si mette il suo id in
-`team_details.php` nel browser, questo componente basta.
+`CSI_COPPA_PROJECT_ID` e la sezione ricompare in `/classifica`.
 ### Endpoint usati dall'app
-| Endpoint                                         | Formato | Uso                                                                | Pagina "umana" corrispondente                                           |
+| Endpoint                                           | Formato | Uso                                                                                         | Pagina "umana" corrispondente                                           |
-| ------------------------------------------------ | ------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------- |
+| -------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
-| `components/project-sheets.php?project_id=767`   | HTML    | Classifica completa dei due gironi di campionato                   | `league_details.php?project_id=767` (tab "Classifica")                  |
+| `components/project-sheets.php?project_id=933`     | HTML    | Classifica completa dei due gironi di campionato                                            | `league_details.php?project_id=933` (tab "Classifica")                  |
-| `components/project-sheets.php?project_id=848`   | HTML    | Classifica del girone di Coppa (solo fase a gironi, vedi limite 4) | `league_details.php?project_id=848` (tab "Classifica")                  |
+| `components/project-sheets.php?project_id=<Coppa>` | HTML    | Classifica del girone di Coppa, solo se `CSI_COPPA_PROJECT_ID` non è `null` (vedi limite 4) | `league_details.php?project_id=<Coppa>` (tab "Classifica")              |
-| `assets/json/getEventsByTeamId.php?team_id=3359` | JSON    | Tutte le gare della squadra                                        | `team_details.php?team_id=3359` (tab "Calendario", `team-calendar.php`) |
+| `assets/json/getEventsByTeamId.php?team_id=3878`   | JSON    | Tutte le gare della squadra                                                                 | `team_details.php?team_id=3878` (tab "Calendario", `team-calendar.php`) |
 **Formato di `project-sheets.php`** — tabella HTML per girone (una per `<table>`,
 `parseClassifica()` in `csi-core.ts` prende quella che contiene il nome della squadra).
 Colonne per `<td>` (0-indicizzate): `0` Pos · `1` Squadra (nome + logo + link a
 `team_details.php?team_id=…`) · `2` Punti · `3` Partite giocate · `4` Vinte · `5` Perse ·
 `6`-`7` Tie-break vinti/persi (non lette) · `8` Set fatti · `9` Set subiti · poi punti
-fatti/subiti, quoziente, ultime cinque (non lette). Stessa struttura per `project_id=767`
+fatti/subiti, quoziente, ultime cinque (non lette). Stessa struttura per il campionato
-(campionato) e `project_id=848` (fase a gironi della Coppa): `parseClassifica()` è
+(`project_id=933`) e per la fase a gironi della Coppa, quando c'è: `parseClassifica()` è
 condivisa, nessun parser dedicato per la Coppa.
 **Formato di `getEventsByTeamId.php`** — array JSON, un oggetto per gara (girone **e**
@@ -247,9 +245,10 @@ DettaglioCsiEsteso           → src/components/crapp/DettaglioCsi.tsx (formazio
   ancora disponibile" (o l'ultimo dato buono in cache, se ce n'è uno) e i risultati ricadono
   sulle partite dello Scout Live locale, non su dati demo — non esistono più in `crapp-data.ts`.
   Il check con `CSI_LIVE=1` serve a scoprire il problema di parsing.
-2. **`project_id` è legato alla stagione.** Per il 2026/27 servirà un nuovo id (vedi
+2. **`project_id` e `team_id` sono legati alla stagione.** Per il 2027/28 serviranno due nuovi
-   "Sorgente dati" sopra per come ritrovarlo). Oggi va aggiornato a mano in `csi-core.ts`.
+   id (vedi "Sorgente dati" sopra per come ritrovarli): vanno aggiornati a mano in
-   L'etichetta «Stagione 2025/26» di `/classifica` invece non va toccata: il portale non
+   `csi-core.ts`, e lo storico della stagione precedente sparisce (DD-032 non lo conserva).
   L'etichetta «Stagione 2026/27» di `/classifica` invece non va toccata: il portale non
   espone il nome della stagione, quindi `stagioneDi()`/`stagioneDaPartite()` la ricavano
   dalla data delle gare (l'anno cambia ad agosto) e segue da sola il nuovo `project_id`.
 3. **La cache vive nel processo del server.** Si perde a ogni cold start e non è condivisa tra
@@ -258,20 +257,21 @@ DettaglioCsiEsteso           → src/components/crapp/DettaglioCsi.tsx (formazio
   dati in una tabella Supabase riempita da un job cron (stesso pattern di
   `promemoria-palloni`).
 4. **Le partite includono sia il girone di campionato sia la Coppa, mescolate.**
-   `getEventsByTeamId.php?team_id=3359` è per squadra, non per competizione (vedi tabella
+   `getEventsByTeamId.php?team_id=3878` è per squadra, non per competizione (vedi tabella
   endpoint sopra): risponde con tutte le gare di `C.R.A.P. Volley`. Il campo `project`
   distingue le due nel JSON grezzo, ma `partiteDaEventi()` (`csi-core.ts`) oggi non lo usa
   per filtrare: tutte le gare finiscono in `DatiCsi.partite` senza distinzione (`storico
 partite` in `/classifica` le mostra tutte insieme). Se in futuro servisse separarle, il
   filtro va aggiunto su `evento.project` in `partiteDaEventi()`.
-   **La classifica della Coppa, invece, è mostrata** (sopra quella del girone in
+   **La classifica della Coppa, invece, è mostrata quando c'è** (sopra quella del girone in
-   `/classifica`): `project-sheets.php?project_id=848` (`CSI_COPPA_PROJECT_ID`) ha la stessa
+   `/classifica`; nel 2026/27 `CSI_COPPA_PROJECT_ID` è `null` e la sezione non compare). Nel
-   struttura a tabella-per-girone di `project_id=767`, quindi `parseClassifica()` funziona
+   2025/26 era `project_id=848`: `project-sheets.php` ha la stessa
   struttura a tabella-per-girone del campionato, quindi `parseClassifica()` funziona
   invariata — nessun parser dedicato. Resta un limite: quella pagina copre **solo la fase a
   gironi**. La Coppa (PVM Coppa CSI Misto Silver) prevede due gironi da 4 squadre sola
   andata seguiti da una finale secca tra le due vincenti, disputata in un `project_id`
   figlio separato generato a fine fase a gironi (verificato con `curl` diretto:
-   `project-main.php?project_id=848` descrive il regolamento — "due gironi sola andata, le
+   `project-main.php?project_id=848` (2025/26) descrive il regolamento — "due gironi sola andata, le
   due vincenti in finale, gare 3 set su 5" — e `project-sheets.php?project_id=848` mostra
   sia le due classifiche a girone sia, in un'altra sezione della stessa risposta, il
   tabellone a eliminazione con quel `project_id` figlio). Se la squadra arrivasse in
@@ -1,12 +1,12 @@
 {
  "name": "crapp",
-  "version": "1.4.2",
+  "version": "1.5.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "crapp",
-      "version": "1.4.2",
+      "version": "1.5.0",
      "dependencies": {
        "@supabase/supabase-js": "^2.111.0",
        "@tailwindcss/vite": "^4.2.1",
@@ -1,6 +1,6 @@
 {
  "name": "crapp",
-  "version": "1.4.2",
+  "version": "1.5.0",
  "private": true,
  "sideEffects": false,
  "type": "module",
@@ -8,16 +8,17 @@ import type { RigaClassifica } from "./crapp-data";
 */
 export const CSI_BASE = "https://livescore.csibologna.it";
-/** Campionato Open Misto Eccellenza 2025/26. Cambia a ogni stagione. */
+/** Campionato Open Misto Eccellenza 2026/27. Cambia a ogni stagione. */
-export const CSI_PROJECT_ID = 767;
+export const CSI_PROJECT_ID = 933;
 /**
- * Coppa CSI Misto Silver 2025/26. Stesso formato di tabella del campionato (girone
+ * Coppa CSI della stagione in corso, `null` se la squadra non è iscritta (nel 2026/27 non c'è).
- * all'italiana), solo con meno squadre: `parseClassifica()` funziona invariata. Cambia a
+ * Stesso formato di tabella del campionato (girone all'italiana), solo con meno squadre:
- * ogni stagione come CSI_PROJECT_ID, vedi docs/modules/collegamento-csi.md.
+ * `parseClassifica()` funziona invariata. Cambia a ogni stagione come CSI_PROJECT_ID, vedi
 * docs/modules/collegamento-csi.md.
 */
-export const CSI_COPPA_PROJECT_ID = 848;
+export const CSI_COPPA_PROJECT_ID: number | null = null;
-/** C.R.A.P. Volley sul portale CSI. */
+/** C.R.A.P. Volley sul portale CSI: l'id cambia a ogni stagione (2025/26 era 3359). */
-export const CSI_TEAM_ID = 3359;
+export const CSI_TEAM_ID = 3878;
 export const CSI_GIRONE = "Girone B";
 export const CSI_NOME_SQUADRA = "C.R.A.P. Volley";
@@ -133,7 +134,7 @@ export type DettaglioPartitaCsi = {
 export type DatiCsi = {
  classifica: RigaClassifica[];
-  /** Classifica del girone di Coppa (project_id 848). Vuota se il parsing fallisce. */
+  /** Classifica del girone di Coppa (`CSI_COPPA_PROJECT_ID`). Vuota se il parsing fallisce. */
  classificaCoppa: RigaClassifica[];
  partite: PartitaCsi[];
  girone: string;
@@ -33,7 +33,9 @@ async function leggiCsi(): Promise<DatiCsi> {
    scarica(urlClassifica()),
    // Non blocca la risposta se fallisce: la Coppa è un dato supplementare, non critico
    // come classifica/partite del girone (vedi il controllo sotto).
-    scarica(urlClassifica(CSI_COPPA_PROJECT_ID)).catch(() => ""),
+    CSI_COPPA_PROJECT_ID === null
      ? Promise.resolve("")
      : scarica(urlClassifica(CSI_COPPA_PROJECT_ID)).catch(() => ""),
    scarica(urlPartite()),
  ]);
  const classifica = parseClassifica(html);
@@ -333,42 +333,51 @@ assert.equal(
 if (process.env["CSI_LIVE"]) {
  const [html, htmlCoppa, json] = await Promise.all([
    fetch(urlClassifica()).then((r) => r.text()),
-    fetch(urlClassifica(CSI_COPPA_PROJECT_ID)).then((r) => r.text()),
+    CSI_COPPA_PROJECT_ID === null
      ? Promise.resolve("")
      : fetch(urlClassifica(CSI_COPPA_PROJECT_ID)).then((r) => r.text()),
    fetch(urlPartite()).then((r) => r.json()),
  ]);
  const live = parseClassifica(html);
  const nostra = live.find((r) => isNostraSquadra(r.squadra));
  assert.ok(nostra, "la nostra squadra è in classifica");
-  assert.ok(live.length >= 8 && nostra.giocate > 0);
+  assert.ok(live.length >= 7); // a inizio stagione le giocate sono ancora 0
  const liveCoppa = parseClassifica(htmlCoppa);
-  assert.ok(
+  if (CSI_COPPA_PROJECT_ID !== null) {
-    liveCoppa.some((r) => isNostraSquadra(r.squadra)),
+    assert.ok(
-    "la nostra squadra è nel girone di Coppa",
+      liveCoppa.some((r) => isNostraSquadra(r.squadra)),
-  );
+      "la nostra squadra è nel girone di Coppa",
    );
  }
  const livePartite = partiteDaEventi(json);
  const liveGiocate = partiteGiocate(livePartite);
-  assert.ok(livePartite.length > 0 && liveGiocate.length > 0);
+  assert.ok(livePartite.length > 0, "calendario presente"); // liveGiocate può essere vuoto a inizio stagione
  assert.ok(
    liveGiocate.every((p) => p.link.startsWith("https://")),
    "ogni partita ha un referto",
  );
-  const primaGiocata = liveGiocate[0]!;
+  // A inizio stagione nessuna gara è ancora giocata: niente referto da leggere.
-  const [liveMain, livePlayers, liveStats] = await Promise.all([
+  if (liveGiocate.length === 0) {
-    fetch(urlPartitaInfo(primaGiocata.id)).then((r) => r.text()),
+    console.log(`live: ${live.length} squadre, ${livePartite.length} partite, nessuna giocata`);
-    fetch(urlPartitaFormazioni(primaGiocata.id)).then((r) => r.text()),
+  } else {
-    fetch(urlPartitaPrecedenti(primaGiocata.id)).then((r) => r.text()),
+    const primaGiocata = liveGiocate[0]!;
-  ]);
+    const [liveMain, livePlayers, liveStats] = await Promise.all([
-  const liveFormazioni = parseFormazioni(livePlayers);
+      fetch(urlPartitaInfo(primaGiocata.id)).then((r) => r.text()),
-  assert.ok(liveFormazioni, "formazioni riconosciute per una gara già giocata");
+      fetch(urlPartitaFormazioni(primaGiocata.id)).then((r) => r.text()),
-  assert.ok(isNostraSquadra(liveFormazioni!.noi.squadra));
+      fetch(urlPartitaPrecedenti(primaGiocata.id)).then((r) => r.text()),
-  const livePrecedenti = parsePrecedenti(liveStats);
+    ]);
-  assert.ok(livePrecedenti, "precedenti riconosciuti");
+    const liveFormazioni = parseFormazioni(livePlayers);
-  console.log(
+    assert.ok(liveFormazioni, "formazioni riconosciute per una gara già giocata");
-    `live: ${live.length} squadre, ${livePartite.length} partite, noi ${nostra.pos}°, ` +
+    assert.ok(isNostraSquadra(liveFormazioni!.noi.squadra));
-      `${parseInfoPartita(liveMain).giornata || "(senza giornata)"}, ` +
+    const livePrecedenti = parsePrecedenti(liveStats);
-      `formazione ${liveFormazioni!.noi.titolari.length} titolari`,
+    assert.ok(livePrecedenti, "precedenti riconosciuti");
-  );
+    console.log(
      `live: ${live.length} squadre, ${livePartite.length} partite, noi ${nostra.pos}°, ` +
        `${parseInfoPartita(liveMain).giornata || "(senza giornata)"}, ` +
        `formazione ${liveFormazioni!.noi.titolari.length} titolari`,
    );
  }
 }
 // --- stagioneDi / stagioneDaPartite: l'anno cambia ad agosto ------------------
@@ -377,6 +386,8 @@ assert.equal(stagioneDi("2026-05-20"), "2025/26");
 assert.equal(stagioneDi("2026-07-31"), "2025/26");
 assert.equal(stagioneDi("2026-08-01"), "2026/27");
 assert.equal(stagioneDi("2099-10-01"), "2099/00");
 assert.equal(stagioneDi("2026-11-04"), "2026/27", "prima gara del campionato 2026/27");
 assert.equal(stagioneDi("2027-03-11"), "2026/27", "ultima gara del campionato 2026/27");
 assert.equal(stagioneDaPartite([]), null);
 assert.equal(
  stagioneDaPartite([{ data: "2026-03-04" }, { data: "2025-11-12" }, { data: "" }]),