从 Toggl 迁移到 OpenTickly
使用 Toggl 账号导出 ZIP 和详细时间记录 CSV 迁移到 OpenTickly，并核对工作区、项目、标签、成员和报表总时长。
OpenTickly 提供了迁移 Toggl Track 数据的导入流程，不需要手工重建每个工作区。先用账号导出包导入账号结构，再把详细时间记录 CSV 导入对应工作区。
在核对完工作区和报表总数之前，请保留原始导出文件。导入文件不能代替源 Toggl 账号的备份。
迁移前准备
- 创建或登录目标 OpenTickly 账号。
- 确认目标实例有足够空间保存上传文件和 PostgreSQL 数据。
- 约定切换时间，核对期间不要在两个系统里同时产生新记录。
- 记下每个 CSV 对应的工作区和日期范围。
第一步：导出 Toggl 账号数据
打开 Toggl Track 设置并申请账号数据导出。下载生成的 ZIP，不要修改包内文件。
账号导入会在 OpenTickly 中创建一个新组织：
- 在 OpenTickly 打开 导入。
- 输入新组织名称。
- 选择 Toggl 导出 ZIP。
- 开始导入，并等待成功或失败提示。
导入任务在后台执行。第一个任务还未结束时，不要重复上传同一个包。
第二步：导入详细时间记录
从 Toggl 按所需日期范围导出详细时间记录 CSV。回到 OpenTickly 的 导入 页面：
- 选择目标组织和工作区。
- 选择一个或多个 CSV 文件。
- 上传并等待每个导入任务完成。
- 切换到另一个工作区前，再次确认目标选择器。
可以用工作区和日期范围命名文件，例如 consulting-2025-q4.csv，这样更容易发现遗漏或重复区间。
核对迁移结果
- 比较组织和工作区名称。
- 抽查客户、项目、标签和成员。
- 在 报表 中比较一个已知的日、周和月。
- 检查仍在运行以及跨越午夜的记录。
- 抽查计费状态、时长、描述、项目、成员和标签。
- 重试或提交问题前，先保存失败任务的错误信息。
报表总数是最有效的端到端核对方式，可以暴露遗漏日期、目标工作区选错和同一批记录重复导入等问题。
安全切换
核对通过后，明确通知团队今后在哪个系统创建新记录。按照组织的回滚要求，继续保留 Toggl 导出文件和新 OpenTickly 实例的数据库备份。