项目协同迁移工具

这是一个用于迁移项目协同数据的工具，支持在不同平台之间迁移项目、事项、属性等信息。

• 一、迁移教程
  • 1. 最新迁移姿势
  • 2. 传统迁移姿势
• 二、当前支持迁移什么数据？
  • 1. CODING -> TAPD
  • 2. CODING -> CNB
• 三、环境变量说明
• 四、访问Web应用
• 五、注意事项
• 六、文档相关
  • 1. 文档地址
  • 2. 配置获取

• fork本仓库到你任意组织下
• 点击一键部署迁移按钮，等待加载出项目协同迁移界面
• 在弹窗中填写token等信息
• 开始迁移

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分为发布计划和发布版本，需要手动映射）
• ✅ 图片、附件（需提issue，附上TAPD的api user申请权限，附件上限250MB）
• ✅ 迭代（自动同步）
• ✅ 需求描述（自动同步）
• ✅ 用户（自动同步，使用了用户的相关属性也会自动同步，包含系统属性和自定义用户属性）
• ❌ wiki（开发中，预计7.10上线）
• ❌ 需求评论（排期中，预计7.20上线）
• ❌ 配置方案
• ❌ 项目集
• ❌ 甘特图
• ❌ 测试用例
• ❌ 工时记录

• ✅ Issue
• ✅ 系统字段

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

http://localhost:8088

1. 目标平台为TAPD时，请确定目标项目内至少有一个需求类型
2. 目标平台为TAPD时，需求类型需要手动映射（A需求类型 -> B需求类型）
3. 目标平台为TAPD时，需求属性、状态会自动同名迁移
4. 目标平台为TAPD时，默认没有上传附件的权限，需要联系TAPD开通（也可直接在仓库内提交Issue，附上tapd的user即可）

• 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 -> 左下角用户头像 -> 个人账户设置 -> 访问令牌（项目读权限 + 项目协同读写权限 + 团队成员读权限）
• TAPD：
  • companyId: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> 右上角头像下面的ID
  • user: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> API帐号
  • token: 登录tapd.cn -> 左下角公司管理 -> API账号管理 -> API秘钥（勾选项目协作所有读写权限）
• CNB:
  • token: 登录cnb.cool，右上角头像 -> 个人设置 -> 添加访问令牌（使用范围选全部仓库/制品，仓库权限 + 组织权限 ）