Note di ingegneria
Quattro decisioni prese costruendo da solo una piattaforma gestionale, scritte per chi non vedrà mai il codice. Ognuna è una cosa che si è rivelata sbagliata, quanto è costato scoprirlo, e la regola che le è sopravvissuta.
Nascono da un progetto solo: una piattaforma gestionale multi-tenant per studi professionali, dove clienti, commesse, ore, preventivi e fatture sono collegati dall’inizio alla fine invece di essere venduti come cinque strumenti che condividono un login. Attorno le stanno i siti pubblici, la documentazione e gli strumenti di sviluppo con cui è costruita: sette applicazioni in produzione e un solo database Postgres, in un unico repository.
È costruita e mantenuta da una persona sola, fuori dall’orario di un lavoro a tempo pieno. È un dato di contesto, non un vanto, ed è la ragione per cui queste note suonano così: da solo non puoi rimediare a un errore lavorando di più, e quindi conta la leva — cosa automatizzare, cosa rifiutarsi di dichiarare, e quali controlli restituiscono più tempo di quanto ne costino.
Il codice è privato e qui non se ne regala niente. Quello che queste pagine descrivono è un metodo: come una cosa è stata misurata, cosa la misura ha smentito, e cosa è cambiato di conseguenza. Un metodo vale più letto che tenuto per sé — ed è la parte che nessuno può copiare senza prima averla capita.
La GA va guadagnata
Un registro di maturità il cui default è "non dimostrato", e uno strumento che rifiuta di promuovere più spesso di quanto promuova.
Scritta agosto 2026
Un check verde che non ha mai guardato
La sonda riportava "ok, 7 fibre React". Stava misurando la pagina 500 del framework, che è React, e si idrata.
Scritta agosto 2026
Un booleano che rispondeva a due domande
Un flag significava insieme "questi dati sono usa e getta" e "non toccare il mondo esterno". Si è rotto sull'unico workspace che aveva bisogno di risposte opposte.
Scritta agosto 2026
Tre test rossi, e due copie del runner
Su 2 743 test ne fallivano tre, tutti su snapshot, e nient'altro. La causa era un package manager che risolveva una dipendenza due volte.
Scritta agosto 2026