Blog
Architecture
8 novembre 20256 min

Da 800 righe a un'architettura pulita — refactoring di 16 schermate

C'è un momento in cui apri un file e senti fisicamente il peso del debito tecnico. La mia schermata principale era di 800 righe. Un solo file. Tutto mescolato.

La strategia di scomposizione

Ho rifattorizzato 16 schermate seguendo una struttura coerente: un hook personalizzato per la logica di business, sottocomponenti per il rendering, un componente principale per l'orchestrazione. L'hook trasforma un componente di 800 righe in 100 righe.

ESLint: da 71 a 0

In parallelo, ho eseguito ESLint sul backend. 71 errori. Non disattivando le regole — ma correggendo il codice. Ogni any sostituito da un tipo esplicito. Ogni promessa correttamente awaited.

Perché adesso?

"Lei è solo, chi leggerà questo codice?" Io. Io tra tre mesi quando avrò dimenticato perché questa schermata fa quello che fa. Il debito tecnico non è una metafora. È un costo reale che si paga in tempo, in bug e in motivazione.

Dopo il refactoring: 16 schermate pulite, 0 errori ESLint, un'architettura che posso spiegare in 30 secondi. La migliore settimana del progetto.