KYC Studio, flussi guidati da schema
Una piattaforma di interfaccia guidata dalla configurazione, con la configurazione gestita come codice in Git, così le modifiche di conformità escono in poche ore senza un deploy del frontend.
- Ruolo
- Senior Frontend Engineer
- Periodo
- 2025–oggi
- Stack
- TypeScript · jsonform · Mini Program · Git · CI/CD · Schema validation
Il problema
I flussi di verifica per oltre 100 paesi significavano codice duplicato e un ticket di ingegneria ogni volta che la conformità o il prodotto volevano cambiare una regola regionale.
L’approccio
- Moduli generati dallo schema. L’interfaccia legge una configurazione JSON o YAML tramite jsonform: lo schema genera i campi e le regole di convalida. Le azioni su misura, come avviare il bridge NFC nativo o un controllo di liveness, restano nel codice.
- Un passaggio, esiti diversi. La configurazione decide cosa fa un passaggio per ogni paese e piattaforma (web, mobile o Mini Program). Dove l’NFC è supportato, il passaggio mostra le istruzioni di scansione e un pulsante «Scansiona con NFC»; altrove, i normali campi del modulo e un pulsante «Continua». Prodotto e conformità lo cambiano nella configurazione, non nel codice.
- Configurazione come codice. I referenti di conformità e prodotto inviano le modifiche tramite Git. Ogni modifica apre automaticamente una pull request ed esegue la CI con una convalida dello schema rigorosa basata sui tipi TypeScript, così una configurazione malformata fallisce prima di arrivare in produzione.
Due scelte che meritano una spiegazione
jsonform per la visualizzazione, codice per le azioni. Un’interfaccia interamente guidata dal server, che esegue logica arbitraria inviata dal server, apre la porta all’esecuzione di codice da remoto e a problemi di prestazioni. Una visualizzazione guidata dai dati, con le azioni legate a gestori precompilati, mantiene la flessibilità senza quel rischio.
Git invece di un modulo di amministrazione. Modifiche facili senza governance rompono i flussi in produzione. Pull request, controlli dei tipi e CI rendono ogni modifica tracciabile, revisionata e facile da annullare.
Il risultato
I rilasci della configurazione non dipendono più dai deploy del frontend: gli aggiornamenti di conformità multi-mercato sono passati da settimane a ore e la duplicazione di codice tra regioni ha smesso di crescere.