版本与升级维护

版本与升级维护用于让 FactVerse 环境保持更新，同时保护生产运行。流程应明确版本范围、审批、维护窗口、验证、沟通和回退预期。

前提条件

安排生产变更前，先确认部署模型、产品范围、客户变更流程、维护窗口、验证负责人和回退条件。

发布流程

输入信息

输入	示例
版本范围	平台更新、产品模块更新、连接器变更、证书续期、安全补丁。
影响用户	操作员、管理员、集成负责人、移动端用户、AI 工作流负责人。
验证计划	登录、产品导航、关键工作流、连接器任务、API Key、报表、文件访问。
维护窗口	日期、时间、预计时长、沟通负责人、升级路径。
回退条件	暂停、回退或改期的判断条件。
已知问题	已接受限制、临时处理方式和后续负责人。

变更类型

类型	典型验证
平台版本	登录、租户访问、导航、产品 smoke test、关键集成。
产品模块更新	目标产品工作流、角色权限、数据显示、用户验收样本。
连接器或数据变更	源连接、映射、样例记录、同步计划、失败处理。
证书或域名变更	浏览器访问、客户端访问、SSO 回调、API 调用、监控检查。
API 或 MCP scope 变更	工具发现、允许调用、服务身份归属、审计记录。

验证步骤

1. 确认环境和版本范围。
2. 与产品负责人评审版本说明或变更描述。
3. 确认受影响用户、集成和关键工作流。
4. 为维护窗口准备验证清单。
5. 沟通时间和预期影响。
6. 应用版本或配置变更。
7. 验证登录、租户访问、产品工作流、集成和监控。
8. 沟通完成情况、未关闭问题和后续负责人。

沟通清单

维护窗口前，应告知受影响用户哪个环境将发生变化、窗口开始时间、预计持续时间、用户访问是否可能中断、哪些工作流应暂缓，以及窗口期间由谁负责支持。变更完成后，应沟通结果、验证状态、已知问题、临时处理方式和后续负责人。对于影响集成的变更，还应通知源系统负责人和计划任务负责团队。

沟通内容应事实清楚、简短直接。版本通知的目标是帮助用户安排工作，并帮助支持团队识别预期行为。只有当变更引入用户需要采用的可见业务能力时，才适合使用更偏产品发布的表达。

预期结果

约定验证清单通过、客户负责人了解结果、未关闭问题已记录、支持团队理解新行为或临时处理方式后，版本维护才算完成。

常见问题

现象	检查
发布后用户反馈权限缺失	角色包、租户成员、会话刷新、导航权限或产品权益变化。
客户端表现和 Web 控制台不一致	客户端版本、环境设置、SSO 跳转支持、缓存或功能支持范围。
升级后连接器失败	凭据、schema 变化、源系统可用性、网络路径或连接器配置。
回退决策不清	预先约定的回退条件、业务负责人、技术负责人和影响说明。