KYC Studio, des parcours pilotés par schéma
Une plateforme d’interface pilotée par la configuration, avec une configuration versionnée dans Git, pour que les changements de conformité soient livrés en quelques heures, sans déploiement frontend.
- Rôle
- Senior Frontend Engineer
- Période
- 2025–aujourd’hui
- Stack
- TypeScript · jsonform · Mini Program · Git · CI/CD · Schema validation
Le problème
Les parcours de vérification pour plus de 100 pays signifiaient du code dupliqué et un ticket d’ingénierie chaque fois que la conformité ou le produit voulait changer une règle régionale.
L’approche
- Générer les formulaires à partir du schéma. L’interface lit une configuration JSON ou YAML via jsonform : le schéma génère les champs et les règles de validation. Les actions sur mesure, comme lancer le pont NFC natif ou un contrôle de liveness, restent dans le code.
- Une étape, des résultats différents. La configuration détermine ce que fait une étape selon le pays et la plateforme (web, mobile ou Mini Program). Là où la NFC est prise en charge, l’étape affiche des consignes de scan et un bouton « Scanner avec la NFC » ; ailleurs, les champs de formulaire habituels et un bouton « Continuer ». Les équipes produit et conformité le changent dans la configuration, pas dans le code.
- La configuration comme du code. Les responsables conformité et produit soumettent leurs changements via Git. Chaque changement ouvre automatiquement une pull request et lance une CI avec une validation de schéma stricte appuyée sur les types TypeScript, de sorte qu’une configuration mal formée échoue avant d’atteindre la production.
Deux décisions qui méritent une explication
jsonform pour l’affichage, le code pour les actions. Une interface entièrement pilotée par le serveur, qui exécute une logique arbitraire envoyée par celui-ci, ouvre la porte à l’exécution de code à distance et à des problèmes de performance. Un affichage piloté par les données, avec des actions liées à des gestionnaires précompilés, garde la souplesse sans ce risque.
Git plutôt qu’un formulaire d’administration. Des modifications faciles sans gouvernance cassent les parcours en production. Les pull requests, les vérifications de types et la CI rendent chaque changement traçable, relu et facile à annuler.
Le résultat
Les publications de configuration ne dépendent plus des déploiements frontend : les mises à jour de conformité multi-marchés sont passées de plusieurs semaines à quelques heures, et la duplication de code régionale a cessé de croître.