Fantatitano
Fantacalcio sul Campionato Sammarinese di calcio: asta a crediti, rose, formazioni
settimanali, scontro diretto — senza pagelle. I voti (Voto Titano) sono calcolati da
eventi oggettivi del referto FSGC.
App (PWA) — installabile su iPhone/Android dalla schermata "Aggiungi a Home".
Richiede un account (Supabase: password, link via e-mail, e Google/Apple se attivati), leghe multiple con
codice invito, ruoli (admin di lega, Giudice Dati), rose, formazioni e contestazioni
condivise, dato del campionato inserito una volta per tutte le leghe, aggiornamenti in
tempo reale. Setup in supabase/README.md (schema e policy RLS in
supabase/schema.sql); chiavi pubbliche in src/config.js.
Anagrafiche e calendario (16 società, ~400 tesserati, 30 giornate) sono generati dal client
in modo deterministico: sono uguali per tutte le leghe e non serve caricarli.
Struttura
| Percorso | Contenuto |
|---|
index.html · manifest.webmanifest · sw.js · icons/ | Shell PWA, manifest, service worker, icone |
src/engine.js | Motore di scoring puro (artt. 4–8, 10–12): computeRating, computeLineupResult, computeStandings, conversione in gol |
src/data.js | Anagrafiche e calendario generati; eventi di esempio per le prime giornate (usati solo dal Giudice Dati per popolare il database) |
src/state.js | Stato applicativo: anagrafiche generate + dato e leghe da Supabase (src/backend.js) |
src/backend.js · src/config.js | Adattatore Supabase (leghe, rose, formazioni, dato globale, realtime) e chiavi pubbliche |
src/auth-clerk.js | Identità via Clerk, disattivata: si accende valorizzando CLERK_PUBLISHABLE_KEY in src/config.js |
src/views/onboarding.js · media/ | Presentazione al primo avvio su sfondo video (media/intro.mp4, facoltativo) |
supabase/migrations/ | Migrazioni SQL; la 001 rende l'identità indipendente dal fornitore (Clerk o Supabase Auth) |
supabase/schema.sql | Tabelle, funzioni (create_league, join_league, lock formazioni, congelamento), trigger di log e policy RLS |
src/app.js · src/ui.js · src/views/ | Router hash, shell (app bar, drawer, bottom bar), componenti e le viste |
styles/app.css | CSS dell'app, derivato dal design kit; i token vivono in design/tokens/tokens.css |
tests/engine.test.js | Test dei casi limite del regolamento (17 test) |
tests/mock-supabase.js | Mock in memoria di supabase-js per lo smoke test del flusso account/leghe |
design/ | Design kit: identità, sistema, architettura informativa, schermate, prototipo (design/index.html) |
ios/ · capacitor.config.json · nativo/ | App iPhone (Capacitor): apre fantatitano.site con notifiche native. Passi per l'App Store in IOS.md, scheda in store/scheda-appstore.md |
Sviluppo
npm test # motore di scoring
npm start # http://localhost:4173 (server statico)
python3 scripts/make-icons.py # rigenera le icone
Deploy: statico su Vercel dal branch main; il design kit resta raggiungibile su /design/.
Le prove decidono se il deploy parte. vercel.json passa a Vercel un
ignoreCommand (scripts/vercel-controlla.sh) che, prima del build, gira lint
e prove senza browser: se qualcosa è rosso il deploy non parte e resta
online la versione di prima. Attenzione alla logica, che è rovesciata perché
l'ignoreCommand risponde a «devo ignorare questo commit?»: uscita 0 = ignora
(niente deploy), uscita 1 = procedi. Prima la CI girava in parallelo al deploy,
quindi una versione rotta era online da un pezzo quando il rosso arrivava.
Le prove col browser restano in CI: servono un Chromium, e dieci minuti di
attesa a ogni push non si mettono davanti a una distribuzione.
Che giornata si gioca
Tre nozioni diverse, e tenerle separate è quello che evita il guasto in cui
l'app annuncia una giornata finita tre settimane prima:
giornataAperta() — la prima che si chiude nel futuro. Viene dal
calendario FSGC e da nient'altro, quindi non si pianta mai.currentMatchday() — la più avanti fra l'ultima col lock passato e
l'ultima con dei dati inseriti. Era definita solo come la seconda, e senza
referti caricati restava la prima per sempre.primaGiornata() — la prima giornata di questa lega: quella ancora
aperta quando la lega è stata creata. Una lega nata a metà settembre non ha
una prima, una seconda e una terza giornata, e non deve chiederne i voti.
Si ricava dalla data di creazione, non da una colonna: così vale anche per
le leghe che esistono già.
Da qui derivano il calendario degli scontri (niente prima di primaGiornata),
la classifica, la formazione da schierare e la scheda "Da calcolare" in home.
prove/giornata-corrente.cjs sposta l'orologio in tre momenti della stagione
e controlla cosa dice l'app, compreso che la data di chiusura mostrata non sia
mai nel passato.
Dal campo alla lega: due binari, non uno
Il risultato di campionato e i voti della lega si muovono in momenti
diversi, e confonderli e' stato il guasto di sabato 19 settembre: tre partite
giocate il venerdi' sera, e nell'app niente.
- Il risultato, gli stadi e i tabellini arrivano dall'import della FSGC
(
scripts/importa-fsgc.py, workflow Dati FSGC) dentro
src/calendario-dati.js e src/eventi-dati.js. Sono file del repository:
entrano in produzione con un deploy. Il lavoro si propone ogni due ore,
perche' GitHub le corse pianificate le accoda — il cron delle 05:30 e'
partito alle 09:55, alle 10:09, alle 10:06. E nei giorni di partita non
basta nemmeno quello: li' il lavoro resta acceso 5h20m e ricontrolla la
FSGC ogni 20 minuti (scripts/importa-in-giro.sh, finestra da un'ora prima
del primo calcio d'inizio a 48 ore dopo l'ultimo:
scripts/finestra-partite.mjs). Nessun token, nessun passo a mano.
- I voti dei singoli invece nascono dagli eventi nel database
(
match_events, match_appearances): finche' quelli mancano, una gara
finita in lega non ha voti, e la schermata Voti lo dice ("Voti in arrivo").
Il secondo passo era un bottone da premere a mano, e UNA VOLTA SOLA: gli
eventi si inseriscono e non si aggiornano, quindi la seconda premuta avrebbe
contato ogni gol due volte. Adesso succede da solo, all'apertura del Giudice
Dati (state.js, accanto al calendario dei lock), con due regole:
- si caricano solo le giornate che in lega sono vuote — una che ha gia'
anche un solo evento e' roba del Giudice e non si tocca;
- una giornata per volta, e se si rompe a meta' si ripulisce: mezza giornata
dentro non verrebbe mai piu' completata.
migrations/016-eventi-senza-doppioni.sql mette la stessa regola nel
database, dove vale anche se due Giudici aprono l'app insieme.
prove/referti-lega.cjs misura tutto: entrano da soli, riaprire non duplica,
una giornata svuotata rientra, una toccata a mano resta com'e'.
Ruoli
| Ruolo | Come si ottiene | Cosa può fare |
|---|
| Fantallenatore | entra in una lega con il codice | formazione, contestazioni, tutto in lettura |
| Admin di lega | crea la lega (o nominato da un admin) | partecipanti e ruoli, rose (draft automatico o a mano), invito |
| Giudice Dati | profiles.is_judge = true dal database | eventi, risultati, presenze, contestazioni, congelamento — per tutte le leghe |
Viste
Dashboard · Rosa · Formazione (moduli, capitano/vice, panchina ordinata, lock) · Calendario
(scontri di lega + partite reali con campo e Titani.TV) · Classifica · Voti (breakdown di ogni
fantavoto, segnalazione errori) · Live (campo lungo, panchina, totali) · Listone · Giocatore ·
Mercato libero · Regolamento · Scheda condivisibile · Impostazioni · Accesso · Le mie leghe · Gestione lega.
L'app ha sei stati d'ingresso, ciascuno con la sua schermata: server non configurato,
server irraggiungibile (con riprova), primo avvio (presentazione), non autenticato,
nessuna lega, pronta. La presentazione appare una sola volta per dispositivo. Non esiste
una modalità con dati finti: senza dati inseriti le viste lo dicono invece di inventare
risultati.
Giudice Dati: giornata (8 partite, avanzamento) · inserimento partita in 4 passi (risultato e
stato, chi ha giocato, eventi con tastiera, anteprima voti) · contestazioni · congelamento con
conferma digitata · registro modifiche.
Chi lo fa
Progetto di Alex Conti, che lo cura e ne decide le scelte. Gestito da
Mediterranean Digital Solutions Ltd (Malta), che è il titolare del trattamento:
i dati completi stanno in src/config.js ed escono nelle pagine legali dell'app.
Riferimenti
- Regolamento: Regolamento Fantatitano — Sistema a Voto Titano (bozza v1.0)
- README di prodotto: Fantatitano (contesto, priorità, modello dati, motore)
