Le integrazioni si rompono: l'importante è accorgersene per primi
Un collegamento fra due sistemi non è un lavoro che finisce. Serve sapere quando smette di funzionare, prima che te lo dica un cliente.
Un'integrazione fra due sistemi non è un lavoro che si consegna e finisce. È una cosa viva che dipende da software di altri: un'API cambia versione, un certificato scade, il fornitore del gestionale aggiorna e sposta un campo, la password di un servizio viene cambiata da chi non sapeva che serviva anche a quello.
Prima o poi si ferma. La differenza fra un fastidio e un danno è chi se ne accorge per primo.
Il caso peggiore
Il caso peggiore non è il collegamento che si rompe con un errore evidente. È quello che si ferma in silenzio: gli ordini smettono di arrivare nel gestionale il martedì, nessuno lo nota perché non c'è niente da notare, e il venerdì un cliente chiama per chiedere dov'è la sua spedizione. A quel punto ci sono tre giorni di ordini da recuperare a mano, e una persona che deve capire quali sono già passati e quali no.
Tutto quello che segue serve a evitare questa telefonata.
Cosa deve esserci
Ripetere senza duplicare. Se un ordine viene mandato due volte, nel gestionale deve restare un documento solo. È la proprietà che rende sicuro riprovare dopo un errore — senza, ogni recupero è un rischio.
Tentativi automatici, con pause crescenti. La maggior parte dei guasti dura minuti: il sistema dall'altra parte è occupato, la rete ha avuto un singhiozzo. Riprovare da soli dopo un minuto, poi cinque, poi venti, risolve la maggioranza dei casi senza che nessuno se ne accorga.
Una coda visibile. Quello che non è ancora passato deve stare da qualche parte dove si può guardare, contare e rimandare. Se il dato fallito sparisce, l'unico modo per ritrovarlo è cercarlo nel sistema di partenza, a mano.
Un allarme sulla quantità, non solo sull'errore. Un errore singolo può essere normale. Zero ordini importati in sei ore di giorno feriale non lo è, anche se nessun errore è stato registrato. Il secondo controllo è quello che intercetta i guasti silenziosi.
Log leggibili. Non «Error 500», ma quale ordine, quale campo, quale risposta è arrivata. La differenza fra risolvere in dieci minuti e passare un pomeriggio a indovinare.
La domanda da fare a chi te la costruisce
Una sola, e la risposta dice tutto: «Se questa integrazione si ferma stanotte, chi lo scopre e come?»
Se la risposta è «ce ne accorgiamo quando ci chiamate», l'integrazione è finita a metà. Il collegamento che sposta i dati è la parte facile; la parte che vale è quella che ti dice, prima del cliente, che i dati hanno smesso di spostarsi.