# VDI Web 管理控制台

Vue 3、TypeScript、Vite、Element Plus、Pinia、Vue Router。使用者是管理员，与盒子上的 Qt 桌面选择页分开。

运行、演示账号和完整能力边界见[开发说明](../docs/cloud-platform-development.md)。

后台样式已按仓库 `ui/` 设计稿接入，支持深浅主题、桌面卡片与列表、远程会话页和窄屏导航；详见 [UI 接入记录](../docs/cloud-console-ui-20261109.md)。真实现场入口为 `http://127.0.0.1:5182`。

```text
src/api/          从 OpenAPI 生成的类型与统一 HTTP 适配
src/stores/       会话与平台数据
src/router/       登录与角色路由守卫
src/layouts/      控制台导航与定时刷新
src/views/        第一阶段功能页面
src/components/   共用状态等组件
src/styles/       UI 可替换的设计 token
src/mocks/        开发专用 MSW 模拟接口
e2e/              Playwright 主路径验收
```

`npm run api:generate` 更新接口契约与类型；API 适配使用 openapi-fetch，页面不直接发网络请求。默认 `npm run dev` 通过 `/api` 代理到本机 `8088` 端口。开发时设 `VITE_API_MODE=mock` 则使用浏览器模拟接口，生产构建不会启用模拟 Worker。