KYC Studio, 스키마 기반 흐름

문제

100개가 넘는 국가의 인증 흐름은 코드 중복을 낳았고, 규제 담당이나 제품 팀이 지역 규칙을 바꾸려 할 때마다 엔지니어링 티켓이 필요했습니다.

접근 방식

• 스키마로 폼을 렌더링. UI는 jsonform을 통해 JSON 또는 YAML 설정을 읽고, 스키마가 필드와 검증 규칙을 만듭니다. 네이티브 NFC 브리지나 라이브니스 검사 시작 같은 커스텀 동작은 코드에 둡니다.
• 같은 단계, 다른 결과. 각 단계가 국가와 플랫폼(웹, 모바일, Mini Program)마다 무엇을 할지는 설정이 정합니다. NFC를 지원하는 곳에서는 스캔 안내와 "NFC로 스캔" 버튼을, 그렇지 않은 곳에서는 일반 폼 필드와 "계속" 버튼을 보여 줍니다. 제품과 규제 담당자는 코드가 아니라 설정에서 이를 바꿉니다.
• 설정을 코드로. 규제·제품 담당자는 Git으로 변경을 제출합니다. 변경마다 자동으로 pull request가 열리고, TypeScript 타입에 기반한 엄격한 스키마 검증이 CI에서 실행되어 잘못된 설정은 운영에 닿기 전에 실패합니다.

설명할 가치가 있는 두 가지 결정

렌더링은 jsonform, 동작은 코드. 서버가 보낸 임의의 로직을 실행하는 완전한 서버 주도 UI는 원격 코드 실행 위험과 성능 문제를 부릅니다. 데이터 기반 렌더링에 동작은 미리 컴파일된 핸들러에 묶으면, 그 위험 없이 유연성을 지킬 수 있습니다.

관리자 폼 대신 Git. 통제 없는 손쉬운 수정은 운영 흐름을 망가뜨립니다. Pull request, 타입 검사, CI 덕분에 모든 변경은 누가 했는지 분명하고, 리뷰를 거치며, 쉽게 되돌릴 수 있습니다.

결과

설정 배포가 더는 프론트엔드 배포에 묶이지 않아 다중 시장 규제 업데이트가 몇 주에서 몇 시간으로 줄었고, 지역별 코드 중복도 더 늘어나지 않았습니다.