KYC Studio — процессы на основе схем

Проблема

Процессы проверки для более чем 100 стран означали дублирование кода и инженерный тикет каждый раз, когда комплаенс или продукт хотели изменить региональное правило.

Подход

• Формы строятся по схеме. Интерфейс читает конфигурацию JSON или YAML через jsonform: схема создаёт поля и правила валидации. Собственные действия — например, запуск нативного NFC-моста или проверки liveness — остаются в коде.
• Один шаг, разные результаты. Конфигурация определяет, что делает шаг для каждой страны и платформы (веб, мобильное приложение или Mini Program). Где поддерживается NFC, шаг показывает подсказки по сканированию и кнопку «Сканировать через NFC»; в остальных случаях — обычные поля формы и кнопку «Продолжить». Продукт и комплаенс меняют это в конфигурации, а не в коде.
• Конфигурация как код. Специалисты по комплаенсу и продукту предлагают изменения через Git. Каждое изменение автоматически открывает pull request и запускает CI со строгой проверкой схемы на основе типов TypeScript, так что некорректная конфигурация падает ещё до продакшена.

Два решения, которые стоит объяснить

jsonform для отображения, код для действий. Полностью серверный интерфейс, исполняющий произвольную логику с сервера, открывает дорогу удалённому выполнению кода и проблемам с производительностью. Отображение на основе данных, где действия привязаны к заранее скомпилированным обработчикам, сохраняет гибкость без этого риска.

Git вместо админ-формы. Лёгкие правки без контроля ломают процессы в продакшене. Pull request, проверка типов и CI делают каждое изменение прослеживаемым, проверенным и легко откатываемым.

Результат

Выпуск конфигурации больше не зависит от деплоя фронтенда, поэтому обновления комплаенса для разных рынков сократились с недель до часов, а региональное дублирование кода перестало расти.