Files
knowledge-governance/docs/release-ui-flow.md
T
姚章浩 040b7285d7
build / build (push) Successful in 2m7s
style(release): 收敛发布主流程并折叠诊断明细
根据封存、授权和作业状态切换唯一主动作,保留独立签发与执行确认。
收起变更、完整性、恢复验证和历史;维护占用及失败作业保持可见。
补充挂载交互回归和流程说明,保持原有 API 与恢复所有者约束。

验证:make verify 退出 0,本地全部必需门禁通过;前端 574 项通过,
Go 1536 项通过、487 项声明的可选集成跳过。候选构建经只读代理
接入测试 API,核验切库、折叠与快照入口;未执行真实发布/恢复。
2026-11-17 13:38:25 +08:00

3.8 KiB

发布管理流程与页面精简

目标与边界

现有整库发布页面同时呈现日常发布、维护诊断、恢复演练与历史快照,且封存操作位于页面底部,版本入口重复。此次优化聚焦 ReleaseTargets 的信息层级和操作位置,沿用现有 API、权限、授权绑定、维护所有者与恢复确认。

基线采用云测试站当前前端对应的工作树 cbc6b98;该提交的 web 与部署版本 0b753e5 相同。并行主干及其他工作树不合并、不覆盖。

操作者主流程

顺序 页面操作 后台行为 完成边界
1 选择对内或对外知识库 读取该范围 overview、快照、作业及维护窗口 目标身份与版本来自所选范围;读取失败不当作空库
2 封存测试版本 POST /api/v1/library/captures,由队列及执行器捕获测试整库版本 投递不等于完成,以作业与登记快照为准;此步不发布生产
3 查看变更及发布条件 展开变更、备份与恢复验证;若缺基线或恢复证据,沿用对应管理员入口 逐条呈现服务端阻塞原因,不删除发布门槛
4 签发同步授权 管理员调用 /api/v1/library/authorizations,绑定目标与当前快照 有效期内仍需单独点击启动;不自动执行同步
5 启动同步 沿用现有同步请求与执行链:固定版本、生产预备份、同步、校验及收尾 只在接口条件允许时可执行;运行中主按钮改为查看任务
6 查看结果 自动刷新作业进度,终态按真实记录呈现 失败显示原始原因;维护占用不被其他作业成功覆盖
异常 从版本与快照选择恢复点 继续执行独立恢复授权、影响确认和恢复条件校验 恢复整套目标知识状态,不回退测试知识库

封存、签发授权、启动同步三个动作保持独立,不将其合并为一键生产写入。

页面保留规则

  • 顶栏:唯一的「版本与快照」入口和刷新。
  • 主工作区:实际目标身份、当前生产版本、候选测试版本、紧凑变更统计、当前主动作与一份阻塞原因。
  • 已有封存时提供次级「重新封存」;运行时不提供重复封存、授权或同步入口。
  • 「查看变更明细」「发布准备与恢复验证」「封存完整性」默认折叠;原有详情和验证回调继续存在。
  • 目标维护正常时折叠,持有维护窗口时自动展开;仍按窗口持有作业展示恢复信息。
  • 最近作业仅在有记录时展示,正常完成默认折叠,失败默认展开;运行中保留主进度,分项明细按需展开。
  • 版本抽屉保留历史筛选、分页、校验记录、恢复授权和影响确认,移除重复的封存按钮。
  • 旧文档级流程与历史来源关联继续保留在原有折叠入口,此次不改变其业务范围。

验收清单

  • 前端生产构建通过。
  • 原发布、恢复、维护所有者和刷新/切库回归通过。
  • 同一挂载下依次切换封存、授权、同步,点击只调用对应动作。
  • 折叠与展开、打开历史不触发业务写入。
  • 运行时主操作只查看任务,不调用封存、授权或同步。
  • 正常维护折叠、持有时展开、释放后折叠;切库重置明细展开状态。
  • 无作业不画空进度;失败原因默认可见。
  • 只读角色和读取失败时禁止主动作。

浏览器验收使用本地候选构建,GET/HEAD 通过已有 SSH 通道读取云测试 API;代理拒绝所有写请求。界面验收与真实封存、生产同步及恢复演练分开记录;本任务不执行这些业务写入。完整仓库门禁和云端部署结论以实际运行结果为准,不用上述前端检查替代。