Implementa il ruolo allenatore nell'app

- Modello: tipo sugli slot, inRosa() al posto del filtro su attivo in tutte le letture della rosa di gioco (presenze, convocati, voti, palloni, classifiche, badge, sollecito); gli allenatori restano solo nei compleanni e in Squadra. - Permessi: user_roles letto una volta per tutti i ruoli; usePuoGestireEventi() apre /eventi e il sollecito presenze anche all'allenatore, lato server con richiediGestoreEventi(). Palloni, sondaggio e messaggi restano all'admin. - Identità: useGiocatoreInCampo() è null per l'allenatore, così non risponde alle presenze e non vota; useSonoAllenatore() decide cosa si vede. - Profilo: per l'allenatore solo Docs (nome, cognome, nascita, telefono, email) e Opzioni; card avatar e tab Opzioni estratte per riusarle. - Home, Squadra e partita: niente statistiche personali, badge, cacche e obiettivi per l'allenatore; in Rosa compare con la dicitura «Allenatore». - Admin: tipo in «Aggiungi», allenatori a parte in Profili, fuori da conteggi ed export CSI. Test unit su rosa di gioco e completamento, route test sull'allenatore. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-24 14:54:35 +02:00
1 parent 15a010855e
commit 2ec72fd08f
@@ -3,7 +3,7 @@
 **Stato:** implementato
 **File principali:** `src/lib/eventi.ts`, `src/lib/eventi.server.ts`, `src/lib/calendario.ts`
 (griglia mensile condivisa), `src/routes/calendario.tsx` (vista mensile, tutti),
-`src/routes/eventi.tsx` (creazione/modifica, solo admin), `src/components/crapp/EventoCard.tsx`
+`src/routes/eventi.tsx` (creazione/modifica, admin e allenatori), `src/components/crapp/EventoCard.tsx`
 (card condivisa)
 **Test:** `test/unit/eventi.test.ts`, `test/unit/calendario.test.ts`

@@ -20,12 +20,14 @@ scout e turno palloni — la maggior parte degli altri moduli dipende da un `eve

 - **`/calendario`** — vista mensile per tutta la squadra, sola lettura. Mostra allenamenti,
  partite, eventi ed **eventi virtuali** per i compleanni della rosa (`compleanniEventi()`
-  in `eventi.ts`, generati a runtime dall'anagrafica di `useAnagraficaRosa()`, non righe
+  in `eventi.ts`, generati a runtime dall'anagrafica di `useAnagraficaRosa({ conAllenatori:
+true })` — ci sono anche gli allenatori, DD-034 — non righe
  vere di `eventi_app`): la spunta della vista `giorniIT`/`mesiIT` colora la cella per tipo
  di evento, i giorni con più eventi si dividono lo spazio.
- **`/eventi`** — "Gestione eventi", riservata agli amministratori (`useIsAdmin()`): crea,
-  modifica ed elimina un evento, sceglie i convocati (`convocatiEvento()`, vuoto = tutta la
-  rosa). Da qui si distingue "partita" da "amichevole" tramite il flag `campionato`
+- **`/eventi`** — "Gestione eventi", riservata ad amministratori e allenatori
+  (`usePuoGestireEventi()`, [DD-034](../DESIGN_DECISIONS.md#dd-034--lallenatore-è-uno-slot-della-squadra-con-tipo-diverso-non-un-giocatore)):
+  crea, modifica ed elimina un evento, sceglie i convocati tra i soli giocatori
+  (`convocatiEvento()`, vuoto = tutta la rosa). Da qui si distingue "partita" da "amichevole" tramite il flag `campionato`
  (`categoriaEvento()`/`daCategoria()` in `eventi.ts` convertono tra la categoria mostrata
  in interfaccia e la coppia `{ tipo, campionato }` salvata nel database). La pagina mostra
  solo una griglia mensile (stessa logica di `/calendario`, tramite le funzioni condivise di
@@ -14,6 +14,9 @@ L'obiettivo è centralizzare in un'unica schermata tutti i dati necessari sia al

 ## Utenti

+L'allenatore ha un profilo ridotto (solo Docs con i dati personali essenziali e Opzioni):
+la specifica sta in [allenatore.md](allenatore.md).
+
 ### Giocatore

 Può:
@@ -35,7 +38,8 @@ Può:
 - modificare i dati squadra di qualsiasi giocatore (nome, cognome, numero, ruolo, email)
 - compilare e correggere i dati personali e del documento al posto di un giocatore (DD-017)
 - scollegare un account da un profilo, liberando lo slot
- aggiungere un nuovo giocatore alla rosa (id, nome, cognome, numero, ruolo, email opzionale)
+- aggiungere un nuovo giocatore alla rosa (id, nome, cognome, numero, ruolo, email opzionale),
+  oppure un allenatore (tipo «Allenatore»: niente numero né ruolo, DD-034)
 - disattivare un giocatore che ha lasciato la squadra, e riattivarlo in caso di errore: la
  riga non viene eliminata, così presenze, voti, pagelle e badge della stagione restano
  agganciati al suo id
@@ -179,6 +183,9 @@ alle notifiche push e i loro nomi, leggendo `GET /api/public/notifiche-attive` (
 giocatore deve fare dal proprio dispositivo (Profilo), l'admin non può attivarla per conto
 di altri.

+Gli allenatori stanno nella stessa tab in un gruppo «Allenatori» a parte, senza documenti né
+tesseramento, e non entrano nei conteggi della tab Squadra né nell'export CSI (DD-034).
+
 Per ogni giocatore, nella tab Profili, vengono mostrati.

 - Stato del profilo
@@ -39,19 +39,29 @@ giocatore dalla dashboard admin non aveva alcun effetto sul resto dell'app.

 Entrambe filtrano solo i giocatori `attivo`: chi ha lasciato la squadra resta nel database
 (presenze, voti, pagelle e badge della stagione restano agganciati al suo id) ma sparisce
-dagli elenchi correnti.
+dagli elenchi correnti. Il filtro è `inRosa()` (`giocatori-squadra.ts`), che esclude anche
+gli allenatori (`tipo = 'allenatore'`, DD-034): hanno uno slot ma non giocano.
+`useAnagraficaRosa({ conAllenatori: true })` li include, per i compleanni.
+
+## Allenatori in Squadra
+
+Nella tab Rosa gli allenatori attivi compaiono in cima, con foto, nome e la dicitura
+«Allenatore» dove i giocatori hanno il ruolo in campo (`ruoloVisibile()`); niente numero,
+statistiche né badge, e niente posto nella tab Stats. Chi usa l'app da allenatore vede solo
+Rosa e Stats, senza badge e senza cacche (criterio «Cacche» e riga «Cacche/partita»). La
+specifica completa sta in [allenatore.md](allenatore.md).

 ## Gestione dati squadra (solo amministratore)

 Da `/admin` un amministratore può ([DD-017](../DESIGN_DECISIONS.md#dd-017--lamministratore-può-compilare-i-dati-al-posto-del-giocatore)):

-| Azione                | Hook                    | Effetto                                                        |
-| ---------------------- | ------------------------ | ------------------------------------------------------------- |
-| Modificare dati squadra | `useSalvaDatiSquadra()` | Nome, cognome, numero, ruolo, email (usata per il collegamento automatico, non il dato personale del profilo) |
-| Aggiungere un giocatore | `useAggiungiGiocatore()` | Nuova riga con id progressivo `g<N>` (`prossimoIdGiocatore()`), non generato dal database |
-| Attivare/disattivare    | `useImpostaAttivo()`     | Non elimina la riga: la storia della stagione resta intatta    |
-| Scollegare un account   | `useScollegaAccount()`   | Libera uno slot collegato per errore ([DD-016](../DESIGN_DECISIONS.md#dd-016--schema-dati-profilo-giocatore-f0) regola 2); il giocatore si ricollega al primo accesso successivo |
-| Registrare il tesseramento CSI | `useSalvaTesseramento()` | Numero e data tessera, note solo dopo il tesseramento effettivo (vedi `profilo-giocatore.md`) |
+| Azione                         | Hook                     | Effetto                                                                                                                                                                          |
+| ------------------------------ | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Modificare dati squadra        | `useSalvaDatiSquadra()`  | Nome, cognome, numero, ruolo, email (usata per il collegamento automatico, non il dato personale del profilo)                                                                    |
+| Aggiungere un giocatore        | `useAggiungiGiocatore()` | Nuova riga con id progressivo `g<N>` (`prossimoIdGiocatore()`), non generato dal database; con tipo «Allenatore» senza numero né ruolo (DD-034)                                  |
+| Attivare/disattivare           | `useImpostaAttivo()`     | Non elimina la riga: la storia della stagione resta intatta                                                                                                                      |
+| Scollegare un account          | `useScollegaAccount()`   | Libera uno slot collegato per errore ([DD-016](../DESIGN_DECISIONS.md#dd-016--schema-dati-profilo-giocatore-f0) regola 2); il giocatore si ricollega al primo accesso successivo |
+| Registrare il tesseramento CSI | `useSalvaTesseramento()` | Numero e data tessera, note solo dopo il tesseramento effettivo (vedi `profilo-giocatore.md`)                                                                                    |

 Il collegamento giocatore↔account, invece, non è manuale: avviene in automatico al primo
 accesso con Google, per corrispondenza email