Fantaregia
Un'app a file singolo per condurre l'asta del fantacalcio e poi gestirci la stagione. Si apre con un doppio clic su un .html, non ha bisogno di un server, di un account o di una connessione: i dati stanno dentro la pagina e i tuoi restano sul tuo computer.
Non è un altro listone con i filtri. La differenza è che quasi ogni numero qui dentro è stato verificato contro qualcosa di reale prima di finire nell'interfaccia, e dove la verifica ha detto "non serve", la funzione non è stata aggiunta. Le prove stanno più in basso, in Da dove vengono i numeri.
Nel repo non c'è nessun dato. Il listone, i voti di giornata, le statistiche e il calendario te li procuri tu — sono di chi li pubblica, non miei. Qui trovi il codice e gli strumenti per caricare i tuoi. Vedi I dati te li porti tu.
Cosa fa
Durante l'asta
- Prezzo atteso — quanto un giocatore dovrebbe costare nella tua lega, non in una generica: si ricalcola su budget, numero di squadre, slot e piano di spesa. Ad asta iniziata diventa il prezzo di adesso, aggiornato sui crediti ancora in circolazione e sui giocatori ancora liberi.
- Chi resta, chi cerca — per ogni ruolo, i titolari ancora liberi contro quanti ne servono ancora alle squadre. Sopra 1 quel reparto sta per rincarare; sotto 0,6 puoi aspettare.
- Console di chiamata — cerchi, premi Invio, assegni. Mentre digiti il prezzo ti dice di quanto sei sopra il consigliato e quante alternative equivalenti restano libere.
- Indicatore di mercato — di quanto la lega sta pagando sopra o sotto il listino, in tempo reale.
Durante la stagione
- Formazione per ognuna delle 38 giornate, con un punteggio per casella e la frase che lo spiega ("gioca sempre · calendario duro"), e un confronto fra i tuoi giocatori di quel ruolo.
- Rendimento dai voti che carichi: presenze, medie, bonus, dettaglio giornata per giornata.
- Indisponibili da segnare a mano: escono da tutti gli indici e dalla formazione automatica.
- Riepilogo d'asta con un giudizio per ogni rosa, esportabile in Excel e stampabile in due fogli.
Un interruttore "modalità asta" riordina il menu: acceso mette davanti le pagine per comprare, spento quelle per giocare le giornate.
Come si costruisce
git clone https://github.com/FrancescoIrace/fantaregia.git
cd fantaregia
./build.sh
Ne esce Fantaregia.html: aprilo con un doppio clic. Parte vuota e ti chiede un listone, che puoi importare direttamente da Lega e dati senza toccare la riga di comando.
Per vedere subito l'app in funzione con dati finti:
node tools/dati.mjs listone esempi/listone-esempio.csv
node tools/dati.mjs calendario esempi/calendario-esempio.csv
./build.sh dati/
I giocatori di esempi/listone-esempio.csv sono inventati, generati a sillabe: servono a far vedere come si comporta l'app, non a giocarci.
Per i csv non serve installare niente: basta node. npm install serve solo se il tuo listone o le statistiche sono in .xlsx.
I dati te li porti tu
Questo repo contiene solo codice. I file veri li scarichi tu, da dove preferisci, e restano sul tuo computer: nessuno di essi viene mai spedito da nessuna parte, perché l'app non parla con nessun server.
| Cosa serve | Dove si trova di solito | Come entra nell'app |
|---|
| Listone quotazioni | l'area download del sito di fantacalcio che usi | direttamente da Lega e dati → Listone, oppure node tools/dati.mjs listone <file> |
| Voti di giornata | le pagelle della giornata, in xlsx | da Lega e dati → Voti di giornata, anche più file insieme |
| Calendario di serie A | il calendario ufficiale, o qualsiasi elenco delle partite | node tools/dati.mjs calendario <file.csv> |
| Statistiche della stagione scorsa | l'archivio statistiche del tuo sito | node tools/dati.mjs statistiche <file.xlsx> |
Formato del listone — xlsx o csv con le colonne Id, R, Rm, Nome, Squadra, Qt.A, FVM. Il riconoscimento delle intestazioni è tollerante (accetta Ruolo per R, Quotazione per Qt.A, e così via) e se manca l'Id se lo calcola dal nome. Serve un solo dato per riga: nome, squadra, ruolo e quotazione.
Formato del calendario — un csv con giornata;casa;ospite;data, una riga per partita. La data è facoltativa. Con questo formato puoi usare qualunque fonte: basta che i nomi delle squadre coincidano con quelli del listone.
Formato delle statistiche — le colonne del file ufficiale di fine stagione: Id, R, Rm, Nome, Squadra, Pv, Mv, Fm, Gf, Gs, Rp, Rc, R+, R-, Ass, Amm, Esp, Au. L'aggancio ai giocatori avviene per Id, quindi funziona anche se i nomi sono scritti diversamente.
Tutto ciò che metti in dati/ è escluso dal versionamento, e con esso il file .html costruito, che i dati se li porta dentro.
Da dove vengono i numeri
Questa è la parte che rende il progetto diverso da un foglio di calcolo con i colori.
Il prezzo atteso è tarato sulle aste vere
Le quotazioni non sono prezzi: sommate, quelle dei giocatori che verranno comprati fanno circa metà dei crediti che girano in una lega. Il modello redistribuisce i crediti di ogni reparto fra i giocatori che verranno davvero presi, in proporzione a quanto la quotazione supera quella del giocatore "da un credito".
L'esponente che governa quanto il prezzo si concentra sui primi non è stato scelto a occhio: è stato tarato sui prezzi medi delle aste realmente concluse e pubblicati da fantacalcio-online.com. Con dieci squadre e cinquecento crediti il modello ricostruisce quei prezzi entro il 5%. Prima della taratura il primo attaccante veniva prezzato il 60% sopra il vero.
Nello stesso passaggio è saltato fuori che il piano di spesa consigliato in origine (8/15/27/50) era sbagliato: la mediana di quello che i fantallenatori spendono davvero è 7/19/32/42, meno attacco e più difesa. Ora è quello preimpostato.
Lo script della taratura è in tools/taratura-prezzi.cjs (ha bisogno del tuo dati/data.json).
La forma delle squadre non esiste, e l'ho misurato
L'indice calendario stima la forza di ogni squadra dalle quotazioni e la corregge con i risultati veri. La domanda era: conviene pesare di più le partite recenti? La risposta, misurata su serie A 2025/26 — 280 partite, giornate 1-28, dati incrociati fra due fonti e classifica verificata contro Wikipedia — è no, e senza ambiguità:
| Stima | RMSE | contro "non so niente" |
|---|
| media di lega | 1,161 | — |
| attacco × difesa, tutte le giornate uguali | 1,115 | −3,9% |
| con emivita 10 giornate | 1,124 | −3,2% |
| con emivita 6 giornate | 1,137 | −2,1% |
| con emivita 4 giornate | 1,159 | −0,2% |
| con emivita 2 giornate | 1,252 | +7,8% |
La forza di una squadra è persistente (correlazione fra andata e ritorno 0,58 in attacco, 0,55 in difesa), ma la forma — lo scarto dal proprio livello — non ha memoria: autocorrelazione −0,06 sui gol fatti e −0,09 sui subiti, uguale a due, tre e cinque giornate di distanza. Più peso dai al recente, peggio prevedi. Chi guarda solo le ultime due giornate fa peggio di chi non guarda niente.
Lo smorzamento invece serve eccome: la stima grezza sulle prime giornate sbaglia il 34% più che non sapere niente, e l'ottimo sta intorno a dieci partite di prior. Da qui il peso n/(n+10) con cui i risultati entrano nell'indice.
Lo studio è in tools/studio-forma.cjs e gira sui risultati in esempi/serie-a-2025-26-risultati.txt, che sono risultati di partite — fatti, non un dataset di qualcuno — presi da openfootball e verificati contro football-data.co.uk.
Corollario utile: qui non serve un modello di serie temporali, foundation model compresi. Non c'è struttura temporale da modellare oltre al livello, e il livello lo cattura una media.
Gli altri indici, in breve
- Titolarità — prima dei voti è dedotta dalle quotazioni (dentro squadra e ruolo, chi costa di più è dato titolare: alla controprova 17 dei 18 primi rigoristi risultano titolari). Si somma per il 40% alle presenze della stagione scorsa, perché quotazioni e presenze si correlano solo a 0,50: ciascuna dice qualcosa che l'altra non dice. Appena arrivano i voti passa ai fatti, con fiducia piena alla sesta giornata.
- Convenienza — l'FVM di un giocatore contro quello atteso per la sua fascia di prezzo nel suo ruolo, da una regressione log-log su tutto il listone. Evita la distorsione del semplice rapporto FVM/quotazione, che premia solo i top.
- Mentalità — dal ruolo Mantra. Entra nel punteggio solo per i difensori, dove la correlazione con quello che il prezzo non spiega è +0,29; sui centrocampisti è +0,006, cioè il mercato l'ha già scontata, e infatti lì non viene usata.
- Rendimento della stagione scorsa — mostrato nella scheda del giocatore ma non pesato in nessun indice, perché quotazione e fantamedia dell'anno prima si correlano a 0,79 sugli attaccanti: il mercato l'ha già prezzata.
Com'è fatto dentro
src/part1..part6.html i frammenti: stile, markup, motore, viste, eventi
build.sh li assembla in un unico file e controlla la sintassi
tools/dati.mjs prepara i bundle dai tuoi file
tools/*.cjs gli script di analisi che hanno tarato gli indici
esempi/ dati finti per far girare l'app senza dati veri
dati/ i tuoi file — mai versionati
Le modifiche vanno fatte nei frammenti, mai sul file assemblato: build.sh lo rigenera e le sovrascriverebbe. È già successo una volta e gli adattamenti al mobile sono spariti in silenzio.
L'app funziona anche pubblicata come pagina condivisa che riscrive sé stessa a ogni modifica: comodo per far vedere l'asta agli altri in tempo reale, ma va usata con un solo banditore — se due registrano nello stesso istante, la seconda pubblicazione trova un conflitto e quella modifica salta. Per un'asta di una sera va benissimo; non è un database.
Cosa non fa
- Non scarica niente da solo: nessun aggiornamento automatico di quotazioni, voti o infortuni. È il prezzo di un'app che gira da un file locale senza account.
- Non conosce infortuni e squalifiche: si segnano a mano, ed è l'unica informazione che nessun file ti dà.
- Non replica la classifica della tua lega. La piattaforma dove giocate lo fa già meglio.
- Non è un consulente. Gli indici reggono per orientarsi; le partite le decide il campo.
Licenza
Il codice è MIT: fanne quello che vuoi.
I dati non sono coperti da questa licenza perché non sono in questo repo e non sono miei: listoni, voti, statistiche e calendari restano di chi li pubblica, con le loro condizioni d'uso. Prima di ridistribuire un file che hai scaricato, guarda cosa c'è scritto dentro — alcuni lo vietano esplicitamente.
