用途:指导从其他电子签名平台(DocuSign、HelloSign、PandaDoc、Adobe Sign)迁移到 Documenso,采用 Strangler Fig(绞杀者)模式实现零停机迁移,配合功能开关与回滚支持。前置条件:已梳理当前签名平台(API、模板、Webhook)、已配置 Documenso 账号(参见 documenso-install-auth)、具备功能开关基础设施(LaunchDarkly、环境变量等)、迁移期间可双平台并行运行。
主要能力:分阶段迁移策略(阶段一影子日志、阶段二按功能开关逐步切换、阶段三全量迁移并下线旧平台);平台功能映射表(信封/模板/签署人/CC/字段/Webhook 等);模板迁移(模板无法通过 API 迁移,需按代码中的模板定义在 Documenso UI 中重建并记录模板 ID);Webhook 事件映射与统一处理器;功能开关双写与影子发送;回滚流程;迁移时间表与错误处理对照表。
使用方式:1) 迁移前评估当前系统用量;2) 建立功能映射;3) 用模板定义在 UI 中重建模板;4) 编写事件映射与统一 Webhook 处理器;5) 用功能开关实现双写(USE_DOCUMENSO 环境变量控制);6) 按回滚流程,通过 export USE_DOCUMENSO=false 或功能开关服务关闭并重新部署。
适用场景:平台切换、再平台化到 Documenso;敏感文档不建议批量迁移作为测试。
限制:模板无法通过 API 迁移,只能手动重建;字段坐标系不同(旧平台像素制与 Documenso 百分比制)需映射;Webhook 载荷结构不同需适配器;文档中未提供具体价格与收费信息。