← Tutti gli episodi
Copertina di La cartella è la mappa: il routing per convenzione
Stagione 48 · Episodio 005

La cartella è la mappa: il routing per convenzione

8 settembre 2026 5:06
0:00 5:06

Ciao, e benvenuto nella quinta puntata della quarantottesima stagione. Oggi prendiamo un'idea più piccola e concreta, ma che racchiude in miniatura tutta la filosofia di Next. Ogni sito con più pagine ha bisogno di una mappa: quando qualcuno visita questo indirizzo, mostragli quella pagina. E Next risolve questa mappa in un modo quietamente rivoluzionario. Oggi capiamo come la cartella diventa la mappa: il routing per convenzione.

Partiamo dal problema della mappa, perché ce l'hanno tutti i siti. Un'applicazione con più pagine deve sapere come collegare gli indirizzi alle pagine: questo indirizzo porta a questa pagina, quello a quell'altra. La maggior parte dei sistemi ti fa scrivere questa mappa a mano: una configurazione, un elenco che accoppia indirizzi e pagine, da mantenere aggiornato tu. E come ogni elenco tenuto a mano, può sbagliarsi, invecchiare, allontanarsi dalla realtà: cambi una pagina e ti dimentichi di aggiornare l'elenco.

Voglio darti la soluzione di Next, perché è sorprendente per la sua semplicità. Next fa una cosa quietamente radicale: la struttura delle tue cartelle è la mappa. Un file messo in un certo punto del progetto diventa automaticamente la pagina all'indirizzo corrispondente. Metti un file qui, e l'indirizzo compare lì. Nessun elenco da scrivere, nessuna configurazione da mantenere, e nessuna possibilità che la mappa e la realtà si allontanino, perché sono la stessa identica cosa. La struttura su disco e la struttura del sito coincidono: non due cose da tenere allineate, ma una sola. Sparisce un'intera categoria di piccoli errori noiosi: la pagina che c'è ma non ha un indirizzo, l'indirizzo che punta a una pagina che hai cancellato, l'elenco che dice una cosa e le cartelle un'altra. Non possono più accadere, perché non c'è più un elenco separato che possa contraddire la realtà.

Voglio darti il nome di questa idea, perché è più grande di Next. Questo è un principio che si chiama convenzione al posto della configurazione, reso fisico, tangibile. Invece di dire al framework, per iscritto, come è collegata ogni cosa, la configurazione, tu disponi le cose nel modo concordato, la convenzione, e il framework deduce da solo i collegamenti. Non spieghi: sistemi le cose al posto giusto, e il posto stesso è la spiegazione. È una scommessa sul fatto che, la maggior parte delle volte, un modo ragionevole e condiviso di fare le cose valga più della libertà di farle ognuno a modo proprio. È lo stesso spirito di tanti framework, quello di casa tua, per esempio: segui la convenzione, e in cambio ti risparmi montagne di configurazione.

Voglio darti i due lati della medaglia, perché ci sono entrambi. Il vantaggio è doppio: meno da scrivere, meno da tenere sincronizzato, e chiunque può guardare le cartelle e capire all'istante la forma del sito. La mappa non può mentire, perché è il territorio. Il rovescio, onesto: la convenzione è insieme una comodità e una gabbia. Fai le cose a modo loro, e finché il tuo bisogno rientra nella convenzione, tutto è liscio. Ma quando ciò che ti serve non ci rientra, ti ritrovi a combattere contro il framework, a forzare una forma che non era prevista.

Voglio darti l'immagine che rende chiara questa idea, perché è precisa. Pensa a una biblioteca dove la posizione fisica di un libro sullo scaffale è la sua scheda del catalogo. Non tieni un indice separato che potrebbe finire fuori data: dove sta il libro è dove il catalogo dice che sta, sempre, perché sono lo stesso fatto. Semplicissimo, verissimo. Finché non hai un libro che non rientra nello schema degli scaffali: un volume gigante, una mappa arrotolata. Allora la convenzione, che era tutta comodità, diventa un vincolo con cui devi combattere.

Voglio trarre la lezione generale, perché va oltre Next. La lezione è che ci sono due modi per far combaciare le parti. Puoi descrivere l'accordo, con una configurazione, che però può allontanarsi dalla realtà nel tempo. Oppure puoi disporre le cose in modo che l'accordo sia strutturale, e non possa allontanarsi, perché la mappa è il territorio. La convenzione compra semplicità e verità, al prezzo della flessibilità: sceglierla significa accettare la forma del framework come tua. È lo stesso baratto di sempre, ma visto da un angolo nuovo: dove la struttura è la verità, non c'è nulla da tenere allineato, ma nemmeno molto da spostare.

Per oggi ci fermiamo qui. Abbiamo visto un'idea piccola che racchiude tutta la filosofia di Next: la cartella è la mappa. Ogni sito ha bisogno di collegare indirizzi a pagine, e di solito scrivi questa mappa a mano, un elenco che può invecchiare e sbagliarsi. Next fa sì che la struttura delle cartelle sia la mappa: metti un file in un punto, e l'indirizzo compare, senza configurazione, senza possibilità che mappa e realtà divergano, perché sono la stessa cosa. È la convenzione al posto della configurazione, resa fisica: disponi le cose al posto giusto, e il posto è la spiegazione. Vantaggio, semplicità e verità; prezzo, la convenzione è anche una gabbia quando esci dai binari. Come una biblioteca dove lo scaffale è il catalogo. La lezione: descrivere l'accordo, o disporlo perché non possa mentire. Nella prossima puntata, il pendolo del web che torna al server. Nelle note trovi qualche spunto. Se ti è utile, condividila. Grazie per l'ascolto, e ci sentiamo alla prossima.