Approccio tecnico

C'è un solo insegnamento su cui abbiamo costruito per anni nel mondo del software: «funziona» non basta. Tra un progetto che in scena sembra «funzionare» e lo stesso progetto ancora facilmente estendibile, sicuro e veloce tre anni dopo c'è un baratro da milioni di dollari. Da un lato di quel baratro c'è il codice scritto per salvare la giornata, dall'altro il codice che costruisce il domani. In Partnerfy ogni riga che scriviamo segue principi precisi che la tengono dal lato giusto del baratro. Quei principi non li abbiamo inventati noi: li abbiamo presi dalla letteratura ingegneristica internazionale, testati sul campo e inseriti nel contratto. Il risultato: il codice consegnato al cliente della sua agenzia non è quello che funziona il primo giorno, ma quello che funzionerà ancora tra dieci anni. Questa pagina spiega come si applica concretamente questa disciplina e quali meccanismi di filtro garantiscono che nessuna riga vada in produzione senza la sua approvazione.

Il nostro filtro tecnico in tre fasi porta un progetto allo stato «pronto per il rilascio», ma per noi «pronto» non significa «rilasciato». Ogni progetto sviluppato le viene presentato prima nella sua dashboard ID.Partnerfy, attraverso un URL di staging riservato e chiuso all'esterno. A questo punto il suo cliente non vede ancora nulla. Lei controlla personalmente dalla dashboard design, funzioni e contenuti. Se ha richieste di revisione, le invia dalla dashboard; altrimenti dà la sua approvazione premendo «Go Live». Nel momento in cui la sua firma digitale e la sua approvazione entrano nel sistema, il progetto va automaticamente online sul dominio reale. Questo meccanismo non è solo interfaccia: è una decisione architetturale in cui si incontrano tre discipline distinte. Primo, inserisce un passaggio in più tra il suo cliente e noi; secondo, garantisce che l'ultima parola su una decisione tecnica resti la sua; terzo, permette di intercettare un eventuale errore tecnico reversibile «dietro le quinte anziché sul palco». «Go Live» non è un pulsante: è una sua decisione.

L'ultima domanda che un ingegnere dovrebbe porsi è questa: «Tra cinque anni, quando uno sviluppatore che non ho mai conosciuto aprirà questo codice, lo capirà anche senza di me?». Se la risposta è no, il codice non è stato scritto abbastanza bene. In Partnerfy rispondiamo di nuovo a questa domanda a ogni commit. Ogni classe, ogni funzione, ogni variabile che scriviamo è scritta come se fosse destinata a chi erediterà il progetto da noi. I nomi dicono ciò che fanno, le motivazioni delle decisioni architetturali stanno nel codice, la documentazione non è un file Word staccato dal codice: vive accanto al codice, nelle righe di commento, nel README del repository. Il vantaggio a lungo termine per un'agenzia che lavora con noi è questo: anche se smette di lavorare con noi, il codice che lasciamo resta alla sua agenzia e può proseguire con un altro team. Perché è stato scritto per raccontarsi da solo. La nostra reputazione non è solo ciò che Lei ha mentre lavora con noi: è il livello di qualità che lasciamo dietro di noi quando ce ne andiamo.