Tutte le note

Un interruttore per ogni integrazione fragile

L'ERP sta cambiando e il flusso di onboarding ci scrive dentro. Si ferma tutto finché non è pronto?

Ogni sistema in produzione ha integrazioni che prima o poi tradiscono: un ERP in transizione, un fornitore che cambia API, un certificato che scade in un giorno festivo. Se il flusso che le usa è scritto come se fossero sempre disponibili, il primo problema esterno diventa un fermo interno.

Il caso concreto: il flusso di onboarding dei medici in una rete sanitaria verificava documenti, li archiviava e poi scriveva su un ERP attraverso un'applicazione con dipendenze bloccate da due anni. L'ERP stava per cambiare. Le scritture dovevano potersi spegnere senza fermare le verifiche e l'archiviazione.

La decisione

Prima la mappa: tutte le integrazioni verso l'ERP dentro quel flusso, scritte una per una, prima di toccare il codice. Poi un interruttore esplicito, una variabile di configurazione, dietro cui stanno tutte le scritture. Con l'interruttore spento, verifica e archiviazione dei documenti continuano come sempre; i passi che scrivevano sull'ERP vengono saltati; e un'email parte verso indirizzi configurabili con tutto ciò che serve per completare il caso a mano.

C'è un dettaglio che la mappa ha fatto emergere: un codice che l'ERP generava e che il resto del flusso dava per scontato. Con le scritture spente quel codice va fornito a mano insieme ai dati. Senza la mappa lo si sarebbe scoperto in produzione.

Cosa vale in generale

Un'integrazione fragile deve poter degradare in modo leggibile: il flusso completa quello che può, salta quello che dipende dal sistema assente, e avvisa una persona con il contesto per chiudere il caso. L'interruttore è una variabile di configurazione: si spegne e si riaccende senza toccare il codice. E il comportamento degradato va scritto e collaudato prima che serva, perché il giorno in cui serve non c'è tempo di progettarlo.

Descrivici il sistema. Ti diciamo cosa vediamo.

Dieci minuti, una domanda alla volta. Alla fine, la nostra lettura onesta del caso. È il filtro, prima ancora della call.