davideandClaude Sonnet 5.5
8f25143aa5
- 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>
6.3 KiB
6.3 KiB
Glossario
Termini del dominio e del progetto, per chi (persona o assistente AI) non conosce la squadra o il campionato. Dove serve il dettaglio c'è il rimando al modulo.
| Termine | Significato |
|---|---|
| Slot | Riga di giocatori_squadra: la «casella» di una persona della squadra. L'account Google la reclama al primo accesso (auth_user_id), collegandosi per email (DD-018). Un admin può liberarla. |
| Rosa | I giocatori attivi di gioco (inRosa()): esclude gli slot disattivati e l'allenatore (DD-034). La legge useRosa(). |
| Allenatore | Slot con tipo = 'allenatore': gestisce gli eventi, ma non gioca, non ha numero né riceve i promemoria degli eventi (DD-034, DD-039). Vedi modules/allenatore.md. |
| Admin | Chi ha il ruolo admin in user_roles. Gestisce squadra, profili e notifiche; i permessi veri stanno nelle policy RLS (DATABASE.md). |
| Evento | Riga di eventi_app: partita, allenamento o evento extra-campo (es. cena). I compleanni compaiono in calendario ma non sono eventi di campo. |
| Convocati | Giocatori chiamati a un evento. convocati vuoto = tutta la rosa attiva: è la convenzione di convocatiEvento() e di evento_permette_voto(). |
| Presenza / risposta | Risposta di un giocatore a un evento (risposte_presenze): presente, ritardo, assente, forse, infortunato. Vedi modules/presenze.md. |
| Serie | Streak di comportamenti positivi consecutivi (allenamenti, partite, conferme entro 24 ore). Vedi modules/serie-presenze.md. |
| Pagelle | Voti 1-10 anonimi ai compagni dopo una partita; solo i convocati votano, finché pagelle_chiuse = false (DD-027). Vedi modules/pagelle.md. |
| MVP | Voto al migliore in campo a fine partita, uno per votante (DD-027). Vedi modules/mvp.md. |
| Badge | Riconoscimenti calcolati a runtime, mai salvati (DD-007): normali (bronzo/argento/oro), segreti, social (votati dai compagni). Vedi modules/badge.md. |
| Cacche | Sondaggio pre-partita (cacche_partita) usato per statistiche e per il badge segreto s-cacche. |
| Palloni | Turno a rotazione di chi porta e riporta i palloni a partite e allenamenti. Vedi modules/palloni.md. |
| Scout / Scout Live | Rilevazione in tempo reale delle azioni di una partita, con blocco condiviso («Scout occupato da X»). Solo statistiche di squadra, mai classifiche individuali (DD-008). |
| CSI | Centro Sportivo Italiano, l'ente del campionato. Due usi: il tesseramento dei giocatori (manuale, DD-009) e il collegamento con classifica e risultati ufficiali (modules/collegamento-csi.md). |
| Stagione CSI | Si ricava dalle date delle gare, non da un'impostazione (DD-032). |
| Centro notifiche | Storico in-app (notifiche_utente) sull'avatar del profilo, separato dalla push (DD-030). |
| Tre canali | Ogni notifica può uscire come in-app, push ed email (DD-038). Email e push dei promemoria partono dal worker (mailer/). |
| Worker | Il container Docker in mailer/ che invia email e push dei promemoria con la service role (WORKER_EMAIL.md). |
| Service role | Chiave Supabase che bypassa la RLS. Solo server e worker, mai il client (OPERATIONS.md). |
| DD-XXX | Decisione registrata in decisions/. |
| M1…M26 | Numero d'ordine delle migration (m26_notifiche_automatiche…) in supabase/migrations/. |