quantometto.it: come abbiamo costruito un sito di calcolatori scritto a mano
quantometto.it è il nostro sito di calcolatori di risparmio: undici strumenti gratuiti, con formule e fonti in chiaro. Qui non parliamo di soldi ma di come è fatto: HTML senza framework, calcoli che non escono dal browser, pubblicazione automatica su un hosting condiviso, test a ogni modifica e una SEO che proviamo a misurare invece di indovinare. Con i problemi che abbiamo incontrato, compresi quelli che ci hanno fatto perdere tempo.
di Alessandro Grassi · pubblicato e aggiornato il · 17 minuti di lettura
In breve
| Scelta | Perché | Cosa ci è costato |
|---|---|---|
| HTML, CSS e JavaScript scritti a mano, senza framework | Pagine leggere, nessuna dipendenza da aggiornare, ogni byte sotto controllo | Il codice comune (fondo pagina, menu) va tenuto uguale in tutte le pagine: lo controllano i test |
| Calcoli solo nel browser | I numeri di chi usa il sito non arrivano a noi né a nessun altro | Un errore nostro sui link condivisi, trovato e corretto (lo raccontiamo sotto) |
| Hosting condiviso Aruba, caricamento via FTPS | Costa poco e lo avevamo già | Niente server da configurare, ma anche poco controllo: cache, rimandi e certificati sono di Aruba |
| Pubblicazione con GitHub Actions dopo i test | Nessun caricamento a mano, nessuna pagina rotta online | Una pipeline da costruire e mantenere |
| Statistiche con Plausible, senza cookie | Nessun banner, nessun consenso da chiedere | Meno dati di Google Analytics, che abbiamo tolto |
| SEO guidata da Google Trends e Search Console | Costruire solo ciò che qualcuno cerca davvero | Pazienza: con poco traffico ogni cambio va misurato per settimane |
Il progetto
quantometto.it nasce dall’unione di due passioni: i numeri e la costruzione di siti. È online dal 16 ottobre 2026 e oggi ha undici calcolatori: dall’obiettivo alla rata e dalla rata all’obiettivo, rivalutazione ISTAT, potere d’acquisto dal 1861, interesse composto, rata o contanti, durata del capitale, debiti, dove vanno i soldi del mese, vivere di rendita e interessi legali. Accanto ci sono quattro esempi pronti, una pagina di note metodologiche con tutte le formule e due pagine per chi usa i calcolatori a scuola e in uno studio professionale.
Ogni modifica è una versione con il suo numero: dalla 0.1 alla 1.4 sono più di duecento, tutte scritte nella tabella del README. Sembra tanto, ma è la conseguenza di una regola: cambiamenti piccoli, ognuno verificato, ognuno reversibile.
Perché HTML scritto a mano
Un calcolatore è una pagina sola: un modulo, un po’ di JavaScript per il calcolo, un grafico, le spiegazioni e le domande frequenti. Non servono un database, un tema o dei plugin, e ognuno di questi sarebbe una cosa in più da aggiornare e da difendere. Così ogni pagina di quantometto.it è un file index.html nella sua cartella, con l’indirizzo che è il nome della cartella: /rivalutazione/, /interesse-composto/ e così via.
Lo stile comune sta in pochi fogli di stile; i caratteri (Inter e Poppins) sono ospitati sul sito, così il browser non contatta Google Fonts. Anche i grafici sono disegnati a mano: il diagramma di Sankey di “Dove vanno i soldi del mese” è un SVG costruito dal nostro codice, senza D3 o Chart.js. Una libreria esterna avrebbe voluto dire un’altra fonte da ammettere nella Content Security Policy e qualche centinaio di kilobyte in più per disegnare poche curve.
Il prezzo da pagare è la ripetizione: il fondo pagina, il menu e l’avvertenza “quantometto.it non dà consigli finanziari” sono copiati in ogni pagina. Invece di introdurre un sistema di modelli, abbiamo scelto di far controllare ai test che siano identici dappertutto, stampa A4 compresa. La stessa strada l’abbiamo poi presa per officinasottocasa.it, che il 19 ottobre 2026 ha lasciato WordPress.
I numeri restano nel browser
Su un sito che chiede quanto guadagni, quanto spendi e quanto hai da parte, la promessa più importante è che quei numeri non vadano da nessuna parte. I calcoli si fanno nel browser; le ultime ipotesi inserite restano nella memoria del browser di chi le ha scritte, per ritrovarle alla visita dopo.
Il 17 ottobre 2026 abbiamo verificato la promessa sul sito pubblicato, registrando ogni richiesta di rete. E abbiamo trovato un errore nostro: i link “Condividi questa simulazione” portavano le ipotesi dopo il ?, cioè nella parte dell’indirizzo che il browser manda al server. I numeri finivano nei log di Aruba e, come pagina di provenienza, nelle statistiche di visita.
La correzione sta in poche righe, all’inizio di ogni strumento, prima di qualsiasi altro script. Le ipotesi viaggiano dopo il #, che il browser non invia mai al server; la pagina le legge e le toglie subito dall’indirizzo, così non arrivano alle statistiche e non restano nella cronologia. I link vecchi, con il ?, funzionano ancora.
(function () {
var p = location.hash.length > 1 ? location.hash.slice(1) : location.search.slice(1);
if (/(^|&)(data|importo)=/.test(p)) {
window.QM_IPOTESI = p;
try { history.replaceState(null, '', location.pathname); } catch (e) {}
}
})();
Per le statistiche, all’inizio usavamo Google Analytics con il banner dei cookie, in modalità base: lo script di Google partiva solo dopo “Accetta”. Dal 17 novembre 2026 lo abbiamo tolto: le visite le conta solo Plausible, che non usa cookie né la memoria del browser e riceve solo l’indirizzo della pagina, senza nulla dopo ? o #. Niente banner, e una pagina dei cookie che può dire “nessun cookie”.
Dati ufficiali che si aggiornano da soli
Alcuni strumenti mostrano dati del momento: inflazione, obiettivo della BCE, rendimento dei BTP a 10 anni, tasso dei depositi vincolati. Altri si basano su serie storiche, come gli indici dei prezzi ISTAT mese per mese per la rivalutazione. Dati del momento e indici li scaricano due script Python dalle fonti ufficiali (Eurostat, il portale dati della BCE, il servizio dati dell’ISTAT), a ogni pubblicazione e il 20 di ogni mese.
La regola è una: lo script non inventa numeri e non accetta dati che non sa controllare. Un valore nuovo deve essere plausibile e più recente del precedente; se una fonte non risponde, resta l’ultimo dato buono e la pubblicazione va avanti. Per gli indici ISTAT il controllo è più severo: prima di accettare dati nuovi, lo script ricalcola con il metodo ufficiale tutte le variazioni annue dal 1997 (357 per indice) e le confronta con quelle pubblicate dall’ISTAT. Se una non torna, o compare una base degli indici che non conosce, i dati nuovi vengono scartati.
Ci è servito: dal 2026 l’indice europeo dei prezzi usa una classificazione nuova e la vecchia serie della BCE si è fermata a dicembre 2025. Lo script non ha preso un numero sbagliato: è rimasto sull’ultimo dato buono finché non l’abbiamo spostato sulla serie di Eurostat.
Per i calcoli il criterio è lo stesso. L’interesse composto lo abbiamo confrontato con il calcolatore della Banca d’Italia su quattro casi: stessi centesimi. Quei casi sono scritti nelle note metodologiche e i test li rifanno a ogni modifica.
Dalla modifica al sito: GitHub Actions su Aruba
Il codice sta su GitHub, il sito su un hosting condiviso di Aruba. In mezzo c’è un workflow di GitHub Actions. Si lavora sul ramo sviluppo; per pubblicare si apre una pull request verso produzione. Sulla pull request partono i test, e l’esito compare prima del merge, che fa sempre una persona. Dopo il merge lo stesso workflow aggiorna i dati, prepara i file e li carica via FTPS.
Alcuni dettagli che abbiamo imparato strada facendo:
- Il certificato FTPS: con il nome del nostro dominio la verifica del certificato falliva, perché il certificato è intestato al server di Aruba. Invece di spegnere la verifica, usiamo quel nome come indirizzo del server: la connessione è cifrata e verificata per intero.
- Solo i file cambiati: sul server c’è un elenco con le impronte dei file caricati. Il caricamento le confronta e manda solo ciò che è cambiato.
- Solo i test che servono: uno script guarda i file cambiati e sceglie i test che li riguardano. Se cambia solo uno script Python, nel browser non si prova nulla e non si installa nemmeno Chromium.
- Versioni e tag: il numero di versione sta nel messaggio del commit, per esempio “(v1.4.0)”, e un secondo workflow crea il tag da lì. Versione e data nel fondo di ogni pagina le scrive un solo file JavaScript, così una nuova versione non costringe a ricaricare tutte le pagine.
Fino a fine ottobre, con i test in fila, dal merge al sito aggiornato passavano circa sei minuti e mezzo. Abbiamo messo i test in parallelo, provato insieme gli strumenti che prima si aspettavano uno dopo l’altro e caricato solo i file cambiati. Nessun test è stato tolto per andare più veloci.
Il .htaccess che può spegnere il sito
Su un hosting condiviso con Apache, il file .htaccess è l’unico modo di aggiungere le intestazioni di sicurezza: X-Content-Type-Options, Referrer-Policy, Permissions-Policy, Strict-Transport-Security, la Content Security Policy. Ma una direttiva che il server non accetta dà un errore 500 su tutto il sito. Per questo ci sono tre protezioni:
- prima di pubblicare, un test prova il
.htaccesscon un vero Apache, con e senza i moduli facoltativi, e controlla che un.htaccesssbagliato dia davvero 500: un test che non sa fallire non serve; - subito dopo il caricamento, uno script controlla che le pagine rispondano 200 e che il dominio senza
wwwporti al sito; - se non rispondono, il workflow rimette da solo il
.htaccessdel commit precedente e finisce in rosso.
- name: Ripristino del .htaccess precedente
if: failure() && steps.controllo.outcome == 'failure'
run: |
mkdir -p ripristino
git show HEAD^:.htaccess > ripristino/.htaccess
python3 carica_ftp.py ripristino
Anche le intestazioni più rischiose le abbiamo introdotte con prudenza. Strict-Transport-Security dice al browser di usare solo https per un certo tempo, e non si può annullare prima: l’abbiamo messa con una durata di un giorno, da allungare a un anno dopo qualche settimana senza problemi. La Content Security Policy è partita in sola segnalazione: un test nel browser la prova su tutte le pagine e conta zero violazioni, ma prima di renderla obbligatoria vogliamo qualche settimana di sito vero.
I test
I test sono più di trenta file, in Python per i calcoli e in JavaScript con Playwright per il browser. Non sono solo test di codice: molti controllano promesse fatte a chi usa il sito.
- Calcoli: casi di controllo calcolati a parte, andata e ritorno tra strumenti inversi (dalla rata all’obiettivo e ritorno), il confronto con la Banca d’Italia.
- Browser: ogni strumento a 390 px (telefono) e a 1280 px, nessun errore JavaScript, nessuno scorrimento orizzontale, la stampa che sta su un foglio A4 con l’avvertenza leggibile.
- Privacy: si registrano le richieste di rete e si controlla che verso l’esterno parta solo Plausible, e solo con l’indirizzo pulito.
- Fonti: i link esterni sono ammessi solo verso un elenco di domini ufficiali (ISTAT, BCE, Banca d’Italia, Agenzia delle Entrate, EUR-Lex…). Una fonte nuova va aggiunta all’elenco apposta, non per caso.
- SEO: un test confronta ogni pagina con quella pubblicata. Ne parliamo nel prossimo capitolo.
La SEO: prima si misura, poi si costruisce
Google Trends prima di scrivere codice
Prima di costruire un calcolatore guardiamo se qualcuno lo cerca. Google Trends non dà il numero delle ricerche, solo valori relativi, e confronta al massimo cinque ricerche per volta. Per mettere in fila decine di idee abbiamo usato un riferimento fisso, “interesse composto” uguale a 100, presente in ogni gruppo di cinque, così i gruppi diventano confrontabili. Sotto 5 consideriamo il valore rumore.
È così che sono nati i debiti (“carta revolving” intorno a 25, “sovraindebitamento” 126) e gli interessi legali (202, la ricerca più forte di tutte). E così abbiamo scartato idee simpatiche che nessuno cerca, o le abbiamo tenute per i social invece che per Google. Un limite pratico: dopo qualche gruppo di fila Google Trends risponde con l’errore 429, troppe richieste, e bisogna riprovare un altro giorno.
Una pagina per ogni domanda
Ogni strumento risponde a una domanda precisa e ha il suo indirizzo, il suo titolo e la sua descrizione, scritti sulle parole che le persone usano davvero. Ha anche i suoi dati strutturati (applicazione web, percorso, domande frequenti). Due pagine non devono rispondere alla stessa ricerca, altrimenti si fanno concorrenza: quando la nuova homepage rischiava di fare concorrenza a “Dall’obiettivo alla rata”, abbiamo cambiato il titolo della homepage.
Sulle domande frequenti una nota onesta: dall’agosto 2023 Google mostra i risultati arricchiti delle FAQ quasi solo per siti governativi e sanitari molto autorevoli. I dati strutturati FAQPage li teniamo, uguali al testo visibile, ma non ci aspettiamo che ci diano più spazio nei risultati.
Quello che Google non vede
La scelta del # per la privacy ha un rovescio: gli esempi già compilati, come l’adeguamento di un canone al 75% dell’indice FOI, per Google non sono pagine, perché tutto ciò che segue il # non conta come indirizzo. L’idea è fare pagine fisse solo per i casi più cercati, ognuna con un testo suo e il calcolo già compilato, per non riempire il sito di pagine quasi uguali. Prima però vogliamo le ricerche vere da Search Console.
Rifare la grafica senza toccare la SEO
A metà novembre abbiamo rifatto la veste grafica di tutto il sito. Il rischio di un restyling è cambiare per sbaglio ciò che Google legge: un titolo, un testo nascosto sul telefono, un link sparito. Per questo, prima di toccare lo stile, abbiamo scritto un test che confronta ogni pagina con la stessa pagina pubblicata:
- indirizzo canonico,
<title>, descrizione e dati per i social; - dati strutturati, confrontati dopo averli letti come dati e non come testo;
- titoli H1–H6 nel loro ordine, testo visibile, link e testi alternativi, letti con JavaScript spento e a due larghezze, 390 e 1280 px, perché Google indicizza la versione per telefono;
- stabilità del caricamento (CLS) e peso dei file.
Il CLS ci ha insegnato qualcosa: sulla stessa pagina, con file identici, oscillava tra 0 e 0,047 a seconda di quando arrivavano i caratteri. Un confronto semplice avrebbe dato falsi allarmi. Il test misura tre volte per parte e confronta il valore più basso di ora con il più alto pubblicato: un peggioramento vero, presente a ogni caricamento, si vede; uno spostamento casuale no.
Anche il menu cambiava apposta nel restyling, e non volevamo che coprisse le differenze vere: il test lo controlla a parte e chiede solo che sia uguale in tutte le pagine della stessa famiglia.
I numeri veri, per ora piccoli
Il sito è giovane e i numeri sono piccoli. Nella settimana dal 9 al 15 novembre 2026 Search Console ha contato 1.960 impressioni e 6 clic. Quasi tutte le impressioni vengono da una pagina, Potere d’acquisto: 1.810 impressioni, posizione media 7,7, ma solo lo 0,3% di clic. Il problema non è farsi trovare, è farsi scegliere: per questo il prossimo intervento su quella pagina sarà il titolo, non la grafica, e in settimane diverse da altri cambi, per capire quale ha avuto effetto.
Un altro dato che non ci aspettavamo: delle 1.960 impressioni solo il 5,4% aveva la ricerca visibile, il resto Google lo anonimizza. Con questi volumi le decisioni si prendono su impressioni e posizione per ricerca, su almeno due settimane, non sui clic di un giorno. E su dati come quelli reali di velocità di Chrome (CrUX) non si può contare: con poco traffico Search Console risponde “dati insufficienti”.
Un file per gli assistenti AI
Nella cartella principale c’è anche llms.txt, una descrizione del sito pensata per assistenti e motori basati sull’intelligenza artificiale: gli strumenti, gli esempi, i parametri dei link condivisibili, il metodo. È una proposta, non uno standard, e non sappiamo quanto venga letto; costa poco, e un test controlla che link e parametri scritti lì esistano davvero.
I problemi che abbiamo incontrato
- Il ciclo di reindirizzamenti al primo caricamento. Il sito girava in tondo tra http e https. Non era colpa nostra: era la cache di Aruba (HiSpeed Cache), che serviva una risposta vecchia. Svuotata e disattivata, e da allora niente rimandi nel nostro
.htaccess, perché si scontrano con quelli di Aruba. - I link condivisi che mandavano i numeri al server. Raccontato sopra: lo abbiamo trovato solo perché abbiamo verificato la promessa invece di darla per buona.
- La serie della BCE che si è fermata. Lo script ha fatto quello per cui era fatto: niente numeri inventati.
- Il CLS che cambia da solo. Una misura che oscilla con file identici va misurata più volte, o diventa una fonte di falsi allarmi.
- Il lancio su Reddit. Su r/ItaliaPersonalFinance gli strumenti si possono presentare solo in un thread mensile dedicato, e solo se non hanno “qualsiasi forma di profitto diretto o indiretto”: per questo abbiamo tolto dal sito la richiesta di una mancia volontaria. Il primo commento l’ha bloccato il moderatore automatico, perché l’account era troppo nuovo. È uscito il 15 novembre 2026.
- Più sessioni sullo stesso repository. Su quantometto.it lavorano anche sessioni automatiche, per esempio l’analisi SEO del lunedì. Due versioni con lo stesso numero creano conflitti, quindi il numero nuovo si sceglie guardando tutti i rami e le pull request aperte.
Come usiamo l’intelligenza artificiale
Lo diciamo apertamente: quantometto.it è costruito con due strumenti di intelligenza artificiale, con due ruoli diversi.
- Gemini lo usiamo per allargare un’idea e trovare strade parallele: piani di sviluppo, proposte di strumenti nuovi, un parere sulla SEO di un restyling.
- Claude Code, che lavora direttamente nel repository, lo usiamo per lo sviluppo e le verifiche analitiche: scrive il codice e i test, controlla le fonti sul testo originale e valuta le proposte di Gemini.
Le decisioni restano nostre, e sono scritte con la data nella checklist del progetto. Non tutto quello che arriva passa. Un piano di Gemini proponeva un confronto tra cedolare secca e IRPEF ordinaria: lo abbiamo scartato, perché diventava consulenza fiscale. Nel parere sulla SEO del restyling, Gemini parlava di un CLS “migliorato” e di un rischio di leggibilità “azzerato”. La verifica ha corretto entrambe le cose: il CLS non era peggiorato, ma nemmeno migliorato, perché oscillava da solo; e il test controlla che il testo ci sia, non i contrasti dei colori. Il valore sta proprio qui: un’idea che si allarga, e una verifica che la riporta ai fatti.
Cosa faremmo diversamente
- Le statistiche senza cookie dal primo giorno. Banner e consenso li abbiamo costruiti, provati e poi tolti: lavoro che con Plausible da subito non sarebbe servito.
- I link condivisi con il
#dall’inizio. Un errore piccolo, ma su una promessa di privacy. - Il test della SEO prima della prima modifica grafica, non al momento del restyling: è il genere di rete di sicurezza che conviene avere prima di averne bisogno.
Cosa viene dopo: il titolo di Potere d’acquisto, le pagine fisse per gli esempi più cercati, la Content Security Policy obbligatoria e Strict-Transport-Security a un anno. Ogni passo, come sempre, misurato.
Domande frequenti
Perché non avete usato WordPress o un generatore di siti statici?
Perché un calcolatore è una pagina sola, con il suo codice e le sue domande frequenti: non servono database, temi o plugin. Con file HTML scritti a mano sappiamo esattamente cosa arriva al browser, e lo possiamo verificare con i test. Lo stesso vale per officinasottocasa.it, che ha lasciato WordPress nell’ottobre 2026.
I numeri che inserisco su quantometto.it vengono salvati da qualche parte?
No: i calcoli si fanno nel browser e le ipotesi restano nella memoria del browser di chi le inserisce. Anche un link condiviso porta le ipotesi dopo il #, una parte dell’indirizzo che il browser non invia al server, e la pagina la toglie dall’indirizzo appena l’ha letta. Lo abbiamo verificato registrando tutte le richieste di rete del sito pubblicato.
Perché le domande frequenti non compaiono nei risultati di Google?
Perché dall’agosto 2023 Google mostra i risultati arricchiti delle domande frequenti quasi solo per siti governativi e sanitari molto autorevoli. I dati strutturati FAQPage restano validi e li teniamo, uguali al testo visibile, ma non contiamo su di loro per avere più spazio nei risultati.
Serve saper programmare per fare un sito come quantometto.it?
Il codice lo ha scritto Claude Code, ma le decisioni no: cosa costruire, quali fonti usare, cosa pubblicare e quando. Serve soprattutto saper leggere quello che si riceve e pretendere una verifica per ogni affermazione, con test automatici e confronti con calcolatori ufficiali.
Quanto ci mette una modifica ad arrivare online?
Dipende dai test che deve passare: girano solo quelli dei file cambiati, in parallelo. Fino a fine ottobre 2026, con tutti i test in fila, dal merge al sito aggiornato passavano circa sei minuti e mezzo; poi abbiamo messo i test in parallelo e caricato solo i file cambiati. A questo si aggiunge il tempo di Google per rileggere le pagine, che è di giorni.
Link correlati
- quantometto.it: i calcolatori
- Note metodologiche di quantometto.it: formule, fonti, casi di controllo e registro delle modifiche ai calcoli
- Changes to HowTo and FAQ rich results, l’annuncio di Google sulle domande frequenti nei risultati (in inglese)
- La proposta llms.txt (in inglese)