040b7285d7
build / build (push) Successful in 2m7s
根据封存、授权和作业状态切换唯一主动作,保留独立签发与执行确认。 收起变更、完整性、恢复验证和历史;维护占用及失败作业保持可见。 补充挂载交互回归和流程说明,保持原有 API 与恢复所有者约束。 验证:make verify 退出 0,本地全部必需门禁通过;前端 574 项通过, Go 1536 项通过、487 项声明的可选集成跳过。候选构建经只读代理 接入测试 API,核验切库、折叠与快照入口;未执行真实发布/恢复。
3.8 KiB
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;代理拒绝所有写请求。界面验收与真实封存、生产同步及恢复演练分开记录;本任务不执行这些业务写入。完整仓库门禁和云端部署结论以实际运行结果为准,不用上述前端检查替代。