KYC Studio, flujos guiados por esquemas
Una plataforma de interfaz guiada por configuración, con la configuración gestionada como código en Git, para que los cambios de cumplimiento salgan en horas sin desplegar el frontend.
- Rol
- Senior Frontend Engineer
- Periodo
- 2025–actualidad
- Stack
- TypeScript · jsonform · Mini Program · Git · CI/CD · Schema validation
El problema
Los flujos de verificación para más de 100 países suponían código duplicado y un ticket de ingeniería cada vez que cumplimiento o producto querían cambiar una regla regional.
El enfoque
- Formularios generados a partir del esquema. La interfaz lee configuración JSON o YAML mediante jsonform: el esquema genera los campos y las reglas de validación. Las acciones a medida, como iniciar el puente NFC nativo o una prueba de liveness, siguen en el código.
- Un paso, resultados distintos. La configuración decide qué hace un paso en cada país y plataforma (web, móvil o Mini Program). Donde hay NFC, el paso muestra instrucciones de escaneo y un botón «Escanear con NFC»; en otros casos, los campos de formulario habituales y un botón «Continuar». Producto y cumplimiento lo cambian en la configuración, no en el código.
- La configuración como código. Los responsables de cumplimiento y producto envían los cambios mediante Git. Cada cambio abre automáticamente una pull request y ejecuta CI con una validación de esquema estricta basada en tipos de TypeScript, de modo que una configuración mal formada falla antes de llegar a producción.
Dos decisiones que merecen explicación
jsonform para mostrar, código para las acciones. Una interfaz totalmente guiada por el servidor que ejecuta lógica arbitraria enviada desde él abre la puerta a la ejecución remota de código y a problemas de rendimiento. Mostrar a partir de datos, con las acciones ligadas a manejadores precompilados, mantiene la flexibilidad sin ese riesgo.
Git en lugar de un formulario de administración. Las ediciones fáciles sin gobernanza rompen los flujos en producción. Las pull requests, las comprobaciones de tipos y la CI hacen que cada cambio tenga autor conocido, esté revisado y sea fácil de revertir.
El resultado
Las publicaciones de configuración ya no dependen de desplegar el frontend, así que las actualizaciones de cumplimiento en varios mercados pasaron de semanas a horas, y la duplicación de código por región dejó de crecer.