Vikunja项目：从Todoist迁移数据的完整指南

迁移准备

在开始从Todoist迁移到Vikunja之前，需要确保你的Vikunja实例已经正确部署并且可以通过公网访问。这是一个关键前提条件，因为整个迁移过程需要通过OAuth协议进行授权验证。

Todoist应用配置

1. 创建开发者应用
   首先需要在Todoist开发者控制台创建一个新的应用。这个应用将作为Vikunja与Todoist之间的桥梁。在创建应用时，需要指定应用的名称和服务URL，其中服务URL应该指向你的Vikunja实例地址。

2. 获取认证凭据
   创建应用后，系统会生成客户端ID(Client ID)和客户端密钥(Client Secret)。这两个参数是OAuth认证的核心要素，需要在后续的Vikunja配置中使用。

3. 配置重定向URL
   必须正确设置OAuth重定向URL，格式为https://你的Vikunja域名/migrate/todoist。这个URL是Todoist完成授权后回调的地址，任何错误都会导致迁移失败。

4. 安装应用
   最后一步是在Todoist中安装刚刚创建的应用，确保迁移权限已经就绪。

Vikunja服务端配置

1. 环境变量设置
   在Vikunja的docker-compose配置文件中，需要添加以下环境变量：

   • 启用Todoist迁移功能
   • 设置从Todoist获取的Client ID和Client Secret
   • 配置与Todoist应用中一致的重定向URL

2. 容器重启
   修改配置后需要重启Vikunja容器使设置生效。

执行迁移

1. 启动迁移流程
   登录Vikunja后，在用户设置中找到"从其他服务导入"选项，选择Todoist图标开始迁移。

2. 后台处理
   迁移过程会在后台自动执行，对于一般数量的任务，整个过程通常只需要几秒钟即可完成。

3. 常见问题排查
   如果遇到"redirect_uri_not_configured"等错误，需要检查Todoist应用中的重定向URL设置是否正确，并确认该URL可公开访问。

迁移后处理

1. 清理配置
   对于一次性迁移，建议在完成后删除Todoist中的集成应用，并从Vikunja配置中移除相关的环境变量，以增强系统安全性。

2. 数据验证
   迁移完成后，建议仔细检查所有任务是否完整转移，特别注意周期性任务可能需要额外处理。

技术原理

整个迁移过程基于OAuth 2.0协议实现，通过安全的授权机制获取用户信息。Vikunja作为客户端，通过预注册的应用信息与Todoist API进行交互，获取用户的任务数据并转换为Vikunja的内部格式存储。

这种设计既保证了用户信息的安全性，又提供了便捷的迁移体验。值得注意的是，由于Todoist和Vikunja在数据模型上的差异，某些特殊类型的任务(如周期性任务)可能需要额外的处理才能完美迁移。