SuperAPI AI 工具集

navan-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:在 Navan 的 API、文件、身份或直连集成契约发生变更时,完成可审计的升级迁移,避免静默数据丢失。任何上线动作前须先产出一份可审计的决策或工件。

前置条件:可访问所选租户当前的 Navan Help Center 与已签约集成文档;指定业务负责人和数据负责人;准备已移除密钥与旅客数据的非生产证据集。

当前契约:即使没有公开语义版本,也应把租户文档、交付的模式与已启用功能集视为带版本证据,区分追加式漂移与破坏性的字段、身份、生命周期或投递变更。

认证:重新确认作用域、主机、凭证格式、轮换要求与环境隔离;不要因为旧调用仍成功就沿用废弃凭证。

主要步骤:盘点当前操作、字段、映射、消费方与控制;采集新旧契约证据并分类每项差异;先更新夹具与适配器再切流;在有限窗口内双读或影子处理且不重复写入;核对记录、汇总、敏感字段与下游确认;在明确停止条件下切换并保留经测试的回滚窗口。

工具纪律:用 Read、Glob、Grep 检查文档、模式、配置、代码、夹具与证据;Write 和 Edit 仅用于已批准的仓库工件。仅调用本身不授权网络访问、凭证、旅客或费用数据、预订、支付、政策或身份变更、文件传输、部署或删除。

审批边界:范围变更、新字段、凭证替换、双跑成本、写入切换与回滚到期均需指定的负责人批准。

错误处理:不得静默为新增必填字段设默认值;请求成功仍可能产生语义错误映射;出现无法解释的对账差异时冻结切换。

输出:契约差异、消费者影响图、夹具变更、双跑证据、切换计划与回滚截止时间,并明确列出假设、负责人、到期项与证据缺口。

验证:用两个版本重放历史夹具,并在部分切换后测试回滚,记录预期与观测结果,包括失败关闭行为。限制:具体命令、安装方式、收费与平台信息资料未提供。