DevOps Connector

连接与 Provider

• DevOpsConnection v1alpha1 只保存 connectionId、adapterId、配置/Secret 引用和逐项目读写范围，不保存凭据正文；credentialRef 复用平台统一的 env://、secret://、managed-secret://、file-ref:// 协议。
• adapterConfigRef 与 credentialRef 只是声明：宿主必须先经既有配置/Secret Store 解析并构造 providerContext，Registry 本身不读取配置文件、不解析凭据正文。
• Provider Registry 按 adapterId 和 projectUnitId 失败关闭地装配 read/write Adapter。legacy 明确留在旧路径，shadow 强制只读，只有 standard 可取得写 Adapter。
• Choerodon 与 Fake 在契约测试中通过同一注册边界；未注册、越权项目、能力缺失或 Provider ID 漂移均在调用前拒绝。
• 现有生产宿主仍保留已验收的显式构造/兼容 Facade；新 Registry 是新增 Provider 和后续逐项迁移的加法入口，不制造第二条写链。
• 旧 generic 模式名继续归一为 standard；旧构造器、命令、配置和账本仍可回退。

标准模型

• Project：外部项目及平台绑定。
• Iteration：进行中或历史迭代。
• Work Item：需求、任务、缺陷及父子关系的通用投影。
• Status、Comment、User 与 Relation：状态、评论、用户和关联关系。
• Work Item Transition：受控状态流转，不是直接改产品字段。

读取边界

• 读取项目、迭代、工作项、状态、评论、用户和关系。
• 返回来源、同步时间、分页与完整性信息。
• 读取失败不能用旧缓存冒充实时结果。
• 通用返回值不能出现 Choerodon、Jira 或 GitLab 专属字段。

写入边界

• 先生成可审阅的写入计划。
• 写入必须具备人工确认或明确策略授权。
• 每个动作携带幂等键、权限上下文和审计标识。
• 返回逐动作回执并执行写后核验；结果不明确时禁止盲目重试。

数据归属

已验收第一阶段

1. 已冻结通用模型、读接口、写命令与错误语义。
2. 已用 Fake Adapter 建立上层契约测试。
3. Choerodon Adapter 已通过同一套契约和显式注册边界。
4. 五粮浓香读取链与受控写入链已有既有 live 证据。
5. 旧成熟链完成零回归，新增 Registry 完成独立契约验收；幂等、恢复和项目范围继续受兼容测试保护。

当前状态