• 这是一个用于迁移CODING项目协同数据的工具，有任何问题欢迎提交Issue讨论

• ⚠️⚠️⚠️如果事项较多（超过1000个，建议拉取镜像到本地部署迁移，云开发环境8个小时自动回收）

• fork本仓库到你任意组织下
• 点击一键部署迁移按钮，等待加载出项目协同迁移界面
• 在弹窗中填写token等信息(参考-六、文档相关)
• 开始迁移
• 迁移日志可以在迁移完毕之后页面的下载日志按钮点击下载
• 迁移日志也可以在云原生构建名称是云原生开发的构建记录登录调试按钮，docker logs -f migrate-collaboration-web

docker run -d -p 8088:8088 \
  -e CODING_TOKEN="xx" \
  -e TAPD_TOKEN="xx" \
  -e TAPD_USER="xx" \
  -e TAPD_COMPANY_ID="xx" \
  -e CNB_TOKEN="xx" \
  -e CNB_ROOT_ORGANIZATION="xx" \
  --name migrate-collaboration-web \
  docker.cnb.cool/coding/tool/migrate-collaboration/web:latest

• ✅ Issue（包含用户故事、需求、自定义需求、缺陷、任务、自定义任务、史诗、子工作项）

• ✅ Issue父子关系、Issue和缺陷的关联关系

• ✅ 系统字段、自定义字段（自动同步）

• ✅ 需求状态（包含自定义状态，但不包含工作流里面的流程和事件，注意：TAPD内任务不支持自定义工作流，可以用自定义需求代替）

• ✅ 版本（TAPD分为发布计划和发布版本，需要选择映射）

• ✅ 图片、附件（图片上限5MB，附件上限250MB）

• ✅ 迭代（自动同步）

• ✅ 需求描述（自动同步） 3 ✅ 用户迁移 团队成员迁移到TAPD公司组织下，项目成员迁移到TAPD空间组织下

• ✅ 文档管理-wiki

• ✅ 需求评论（包含图片和附件）

• ✅ 组织机构迁移 CODING组织机构迁移到TAPD公司组织下,并迁移CODING组织与成员关系到TAPD组织

• ✅ 事项活动日志迁移 CODING事项活动日志迁移到TAPD对应事项评论

• ✅ 迁移日志实时展示

• ✅ 迁移详细日志文件提供下载

• ✅ 工时记录

• ✅ 事项在Coding创建时间，更新时间，事项Code迁移到TAPD自定义字段中

• ❌ 批量迁移（不支持）

• ❌ 测试管理（不支持）

• ❌ 测试协同（不支持）

• ❌ 项目集 (不支持)

• ❌ 甘特图 (不支持)

• ❌ 配置方案 (不支持)

• ❌ 文件网盘（不支持）

• ✅ Issue
• ✅ 系统字段(优先级、起止时间，事项类型映射在标签)
• ✅ 迁移详细日志文件提供下载
• ✅ 事项评论（包含图片和附件）
• ✅ 批量迁移

环境变量	说明	是否必填
CODING_TOKEN	CODING平台的访问令牌	是（如需迁移CODING数据）
TAPD_TOKEN	TAPD平台的访问令牌	是（如需迁移到TAPD）
TAPD_USER	TAPD平台的用户名	是（如需迁移到TAPD）
TAPD_COMPANY_ID	TAPD平台的公司ID	是（如需迁移到TAPD）
CNB_TOKEN	CNB平台的访问令牌	是（如需迁移到CNB）
CNB_ROOT_ORGANIZATION	CNB平台的根组织	是（如需迁移到CNB）
PORT	Web应用的监听端口	否（默认为8088）

构建并运行容器后，可以通过浏览器访问：

http://localhost:8088

如果事项较多时，迁移会比较慢，因为openapi有限频机制，需要耐心等待

1. 目标平台为TAPD时，请确定目标项目内至少有一个需求类型
2. 目标平台为TAPD时，需求类型需要手动映射（A需求类型 -> B需求类型）
3. 目标平台为TAPD时，需求属性、状态会自动同名迁移
4. 目标平台为TAPD时，推荐创建模板为大型团队敏捷研发且创建时在更多配置里面取消勾选默认加载示例数据
5. 目标平台为TAPD时，自动导入的用户可使用邮箱登录，点击忘记密码，重新设置即可登录
6. 目标平台为TAPD时，迁移支持自定义时间段事项进行迁移
7. 目标平台为TAPD时，迁移支持并发迁移，开启后将使用多协程并发迁移事项，可显著提升迁移速度。数值越高速度越快但越容易触发API限流（TAPD:默认API限流为每分钟60次/CODING:默认限流单接口每秒30次）,请合理调整,如需提高迁移速度可联系管理员调整TAPD限流频率
8. 目标平台为TAPD时，事项迁移时，可自定义迁移的时间范围，迁移指定时间范围内的事项，如历史事项不需要迁移，可采用这个方式

• CODING：https://coding.net/help/openapi#/
• TAPD: https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/
• CNB: https://api.cnb.cool

• CODING：
  • token：登录coding.net -> 左下角用户头像 -> 个人账户设置 -> 访问令牌（项目读权限 + 项目协同读写权限 + 团队成员读权限 + 文档读权限）
  • coding账号需要设置团队管理员（这里与上面的token是两个不同的设置，设置路径在：团队设置中心 / 全局设置 / 成员管理）

---

• TAPD：(需要将当前团队 升级为付费版本（推荐试用企业版）才可以在左下角“公司管理”->“开放集成”->“API账号管理”中获取所需TAPD平台的用户名及访问令牌)
  • companyId: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> 左上角头像下面的ID
  • user: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> API帐号
  • token: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> API秘钥（勾选项目协作所有读写权限）

---

• CNB:
  • token: 登录cnb.cool，右上角头像 -> 个人设置 -> 添加访问令牌（使用范围选全部仓库/制品，常见场景选择迁移工具凭据）
  •