vdi-cloud/docs/cloud-editions-20261111.md

49 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 通用版与高级版:首批实现
日期:2026-11-11。真实控制台:`http://127.0.0.1:5182`。
## 使用入口
登录后,侧栏上方可切换“通用版 / 高级版”。新账号默认进入通用工作台;浏览器按管理员账号记住选择。直接打开旧的专业页面仍可访问,并切到高级导航。两版共用真实后台、数据、任务和审计,切换界面不会获得额外权限。本期实现的是两种操作界面,尚未实施商业许可、收费或组织功能包限制。
## 通用版
| 页面 | 已接入的真实功能 |
| --- | --- |
| 工作台 `/workbench` | 运行中的桌面、在线设备、活动连接;员工分配、设备检查和问题处理捷径;未分配员工、离线/待激活设备、未确认任务摘要 |
| 员工与桌面 `/people` | 查找、添加员工;先选桌面、查看方案,再追加或撤销指定授权;桌面名称、使用人、电源和连接状态;单台开机、正常关机、重启的确认提交 |
| 终端设备 `/devices` | 查找设备、在线状态、使用人、当前桌面;登记设备并显示一次性激活密钥;进入指定设备诊断 |
| 问题处理 `/help` | 只读检查设备启用、在线、员工关联、员工启用、有效桌面授权、电源、初始化及已知连接服务状态;当前触发中告警前 20 条与总数 |
| 操作记录 `/records` | 人员/配置审计和设备/桌面任务两类查询,服务端分页与关键词检索,展示实际结果和操作人 |
员工新增、授权、设备登记仍要求超级管理员;桌面电源允许运维人员;只读人员只能查看。本人密码、双重验证和主题切换在两版均保留,超级管理员也能从通用版顶部进入系统设置。
授权复用已有批量增减接口,只修改选定员工与桌面的关系,保留其他授权、员工状态和关联设备。查看方案不会写入;保存成功不代表桌面已经开机或完成串流。撤销会作废未消费的旧票据,已有串流不被强制断开。
电源操作提交后等待实际任务回执;界面不会将提交成功显示为设备已执行成功。存在排队、执行中或结果未知的关联任务时,通用版阻止再次操作。生产环境验收没有操作业务桌面的电源。
连接服务为“未检测”时不能认定桌面不可用;首页展示真实电源运行数量,详细诊断保留“尚未确认就绪”的说明。设备在线、服务状态通过也不能替代实际网络、画面与输入延迟验收。全局数据或告警读取失败时明确报错,不显示“没有告警”作为正常结论。
## 高级版
保留 13 个专业入口:总览、桌面、远程会话、终端、终端策略、计算资源、GPU、监控告警、模板、桌面池、用户授权、任务审计和系统设置。导入、批量电源预检、连接配置、规格、快照、模板/池、指标/规则、管理账号与登录会话等继续使用原有实现及验收范围。
本轮另补齐“任务与审计 → 执行任务 → 任务详情 → 核对显卡准备结果”,接入已有 `POST /tasks/{id}/gpu-reconcile`。仅超级管理员/运维人员可核对 `gpu-prepare` 类型且结果未知的任务。提交前说明:只读取原 PVE 任务与组内实际电源状态,不重发开关机;核对成功结束未确认流程并释放预留,原任务标记失败,需要重新准备时另行发起。缺少原 UPID、原任务未结束、实际电源未知时显示后台拒绝,保留待查状态。
## 测试与真实验收
- 前端 lint、TypeScript、生产 Docker 构建通过;6 项单元测试通过。
- 12 项版本/通用页面浏览器测试、4 项 GPU 核对浏览器测试,以及 18 项双重验证、任务历史、审计、在线会话回归通过,共 34 项。首页摘要调整后另复验默认入口、账号隔离及深浅窄屏 3 项。
- 4 项 GPU 服务端集成测试通过,包括未知提交不重放、原任务无法读取时拒绝、可核对后释放预留。使用一次性 PostgreSQL 与 PVE 测试服务,没有对真实业务库运行集成测试。
- 真实浏览器完成:登录默认通用、两版切换、按账号记忆、临时员工新增、查看方案无写入、两次追加授权、仅撤销其中一个、真实审计查询。临时员工与其授权已清理,保留操作审计。
- 真实 1440 / 390 宽度、深浅主题及五个通用页面检查通过;无脚本错误或失败 API 响应。
- 原账号、授权、桌面连接配置、设备身份及告警规则快照一致;API 镜像与数据库容器保持原部署,业务库 `fsync=on`。此次只发布经过隔离比对的控制台改动。
证据:[浏览器验收](evidence/cloud-editions-20261111/browser-verification.json)、[原状态核对](evidence/cloud-editions-20261111/state-verification.json)、[真实通用工作台](evidence/cloud-editions-20261111/live-common-workbench-dark.png)、[高级界面](evidence/cloud-editions-20261111/live-advanced-overview.png)。
## 后续边界
按用户要求,本轮不接模型,不展示假的“一句话 AI”。现有向导为明确选择对象的真实授权流程,跨步骤方案持久化、模型解释、受控脚本目录尚未实现。当前尚未把员工关联设备、员工停用、批量业务操作简化到通用版,这些仍在高级版完成。
高级版页面归类不改变原未完成功能的状态:通用 GPU 绑定与健康、扩展终端策略、外部通知、OTA、目录认证、公共池自动领取/还原、自动初始化、独立交付等继续按原计划逐项完成。GPU 核对以隔离集成与页面测试验收,没有为验收人为制造真实显卡切换超时。专用 VM、Windows 副本、额外存储准备和真实恢复验收仍按用户要求暂缓。