当前位置：首页 > news >正文

Ballerine SDK完整指南：Web UI SDK与Workflow SDK对比分析

news 2026/7/15 14:21:58

Ballerine SDK完整指南：Web UI SDK与Workflow SDK对比分析

【免费下载链接】ballerineOpen-source infrastructure and data orchestration platform for risk decisioning项目地址: https://gitcode.com/gh_mirrors/ba/ballerine

Ballerine是一个开源的风险决策基础设施和数据编排平台，提供了Web UI SDK和Workflow SDK两种核心工具，帮助开发者快速构建身份验证和风险管理流程。本文将深入对比分析这两种SDK的功能特性、适用场景和集成方法，助你轻松选择最适合的解决方案。

一、Web UI SDK：打造流畅的用户身份验证体验 ✨

Web UI SDK是Ballerine提供的前端开发工具包，专注于为用户提供直观、高效的身份验证流程界面。它采用Svelte框架构建，具有轻量级（小于50kb gzipped）和高性能的特点，支持多平台部署，包括桌面端、移动网页和原生应用。

核心功能与优势

Web UI SDK提供了丰富的预构建KYC/KYB模板和UI组件，开发者可以轻松自定义界面风格以匹配品牌形象。其主要优势包括：

高度可定制的UI：支持主题样式、组件样式和特定步骤样式的三级配置，满足不同品牌需求
多平台支持：覆盖桌面端、移动网页和原生应用，适配各种设备
完善的流程管理：内置文档选择、拍摄、验证等完整流程，减少开发工作量
轻量级设计：体积小、加载快，提升用户体验

集成与使用方法

Web UI SDK支持CDN和包管理器两种集成方式。通过简单的初始化和挂载操作，即可将身份验证流程嵌入到现有应用中：

<!-- CDN集成示例 --> <script src="https://cdn.ballerine.io/1.1.22/ballerine-sdk.umd.min.js"></script> <script> BallerineSDK.flows.init({ flows: { "my-kyc-flow": { steps: [ {"name": "welcome", "id": "welcome" }, { "name": "document-selection", "id": "document-selection", "documentOptions": ["id_card", "drivers_license", "passport"]}, // 更多步骤... ] } } }).then(() => { BallerineSDK.flows.mount('my-kyc-flow', 'flow-host-element', {}); }); </script>

实际应用场景展示

Web UI SDK适用于需要直接与用户交互的身份验证场景，如：

Ballerine Web UI SDK提供的身份验证流程界面，支持文档上传和自拍验证等步骤

二、Workflow SDK：强大的后端流程编排能力 🚀

Workflow SDK是Ballerine的后端工作流编排工具，专注于提供灵活、可扩展的流程定义和执行能力。它允许开发者通过代码定义复杂的业务流程，实现自动化的风险决策和数据处理。

核心功能与优势

Workflow SDK基于NestJS框架构建，提供了丰富的工作流管理功能，主要优势包括：

灵活的流程定义：支持复杂的流程逻辑和状态转换，满足各种业务需求
版本控制：内置工作流版本管理，支持平滑升级和回滚
事件驱动架构：通过事件机制实现流程间的解耦和集成
强大的扩展能力：支持自定义步骤和集成第三方服务

工作流定义与管理

Workflow SDK允许开发者通过代码定义工作流，并提供了完整的生命周期管理：

// 工作流版本升级示例 async upgradeDefinitionVersion( id: string, updateArgs: Partial<Prisma.WorkflowDefinitionUpdateArgs['data']>, projectId: TProjectId, ) { const workflowDefintionToUpdate = await this.getLatestVersion(id, [projectId]); // 创建新版本工作流 const createArgs = replaceNullsWithUndefined( merge(workflowDefintionToUpdate, updateArgs, { version: workflowDefintionToUpdate.version + 1, }), ); return this.workflowDefinitionRepository.create({ data: createArgs }); }

实际应用场景展示

Workflow SDK适用于后端流程自动化场景，如：

Ballerine工作流管理界面，展示流程状态和任务分配情况

三、Web UI SDK与Workflow SDK对比分析 🆚

功能定位对比

特性	Web UI SDK	Workflow SDK
主要功能	前端用户界面和交互流程	后端工作流定义和执行
技术栈	Svelte	NestJS, TypeScript
集成方式	CDN或包管理器	包管理器
核心优势	快速构建用户界面，良好的用户体验	灵活定义复杂业务流程，强大的后端处理能力
适用场景	用户身份验证、文档收集	自动化业务流程、风险决策

性能与扩展性对比

Web UI SDK以轻量级和高性能为特点，适合对前端体验要求高的场景。Workflow SDK则以其强大的流程编排能力和扩展性，适合处理复杂的后端业务逻辑。

最佳组合使用方式

在实际项目中，Web UI SDK和Workflow SDK通常配合使用，形成完整的端到端解决方案：

使用Web UI SDK构建用户友好的身份验证界面
通过Workflow SDK定义后端处理流程
两者通过API接口实现数据交互和流程协同

Ballerine SDK组合使用架构示意图，展示前后端协同工作流程

四、如何选择适合的SDK？

根据项目需求选择

如果你的项目需要快速构建用户友好的身份验证界面，Web UI SDK是理想选择
如果需要处理复杂的后端业务流程和自动化决策，Workflow SDK更适合

快速上手指南

Web UI SDK：
```
npm install --save @ballerine/web-ui-sdk
```
详细文档：sdks/web-ui-sdk/README.md
Workflow SDK：
```
npm install --save @ballerine/workflow-node-sdk
```
核心代码：services/workflows-service/src/workflow-defintion/workflow-definition.service.ts