Flynor 文档/DevOps Adapter
稳定
Choerodon Adapter
Choerodon Adapter 处理猪齿鱼认证、接口、字段、状态和错误转换。
必须留在 Adapter 的内容
- OAuth、Token 刷新和产品认证方式。
- 猪齿鱼接口路径、分页和版本差异。
- issue、fixVersion、status、transform 等专属字段。
- 项目/组织映射、状态名称映射与错误转换。
- 产品侧幂等恢复、乐观锁和写后核验。
不得泄露到上层
- Server 策略不能理解猪齿鱼状态名。
- Test Intake 和 Test Writeback 不能读取产品字段。
- BA 与 Robot 只能使用 Work Item 标准模型。
- 通用配置只能引用 connectionId、projectBinding、adapterConfigRef 和统一 credentialRef;解析后的配置与凭据只由受控宿主注入 Provider。
当前兼容面
现有 integration-choerodon 包、命令名、配置和服务入口全部保留。DevOpsConnection/Provider Registry 已提供新增 Provider 的显式装配契约,现有宿主仍走已验收的显式构造/兼容 Facade;Test Writeback、Test Intake、Tech Codex、BA/Server 建单与 Robot 缓存刷新已进入通用边界;产品字段和成熟缓存实现留在 Provider。真实只读、缓存和专用测试任务写回均已有 live 证据;Robot MCP 结果进一步归一属于非阻塞 Provider 演进。
迁移与回滚
- 读取链已完成工作项数量、状态、父子关系和迭代的契约与 live 验收。
- 评论和 Work Item Transition 已验证权限、幂等和回执。
- 旧 generic 模式继续解释为 standard,项目仍可显式选择 legacy 回退。
- 异常时切回 legacy 模式,保留原账本、评论标记和回执,禁止清空状态或双写。
弃用窗口
兼容优先
通用接口正式发布后,Choerodon v1 配置、命令和协议别名至少保留两个正式小版本且不少于 90 天。