# CMVR IoT 管理控制台

本目录是招商车研物联网平台的完整 Vue 3 前端，功能迁移自原 `cmvr-iot-ui`，旧前端目录保持不变。新前端继续使用原有 REST、WebSocket、文件和媒体接口，可直接连接本项目的 `cmvr-iot-admin`。

## 功能范围

- 系统管理：用户、角色、部门、岗位、菜单、字典、参数、通知和文件。
- 系统监控：在线用户、操作日志、登录日志、缓存、服务、Quartz 和 Druid。
- 设备管理：设备注册、终端、机器人、相机、机械臂、灵巧手、机器人头部、麦克风、扬声器和电机。
- 测试平台：测试项目、任务配置、任务编排、检测项、任务实例和执行流程。
- 智能巡检：机器人、地图、点位、任务、执行实例、巡检结果、告警和驾驶舱。
- 交互评价：语音交互、触控交互、评价指标、方案、项目和语料。
- 智能座舱：车机界面、车辆配置、功能配置、流程编辑和执行评价。
- 语料与媒体：语料管理、音频上传、图片预览、视频播放和 WebSocket 实时消息。
- 开发工具：代码生成、表单构建和 Knife4j 接口文档。

## 技术栈

- Vue 3.4
- Vite 5.3
- Element Plus 2.9
- Pinia 2
- Vue Router 4
- Axios、ECharts、LogicFlow、Monaco Editor、Three.js、XGPlayer

## 环境要求

- Node.js 18 或 20 LTS
- pnpm 9
- 后端 `cmvr-iot-admin`，默认地址 `http://localhost:13080`

## 开发运行

先启动后端，再执行：

```bash
cd ruoyi-ui
pnpm install
pnpm dev
```

默认地址：

- 前端：`http://localhost:80`
- 后端：`http://localhost:13080`
- 接口文档：`http://localhost:13080/doc.html`

开发代理配置位于 `.env.development`：

```dotenv
VITE_APP_BASE_API=/dev-api
VITE_API_URL=http://localhost:13080
VITE_WS_URL=ws://localhost:13080/ws
VITE_PORT=80
```

## 构建

```bash
pnpm build:dev
pnpm build:staging
pnpm build:prod
```

构建产物位于 `dist`。生产部署时需要由 Nginx 或网关转发 `/prod-api`，并正确处理 `/ws` WebSocket、文件上传和媒体请求。

## 目录说明

```text
src/api               REST API 封装
src/assets            样式、图片和图标
src/components        公共组件
src/layout            管理端布局
src/router            公共路由和隐藏业务路由
src/store             Pinia 状态管理
src/views/device      设备管理及设备控制
src/views/test        测试业务
src/views/flow        流程编排
src/views/inspection  智能巡检
src/views/evaluate    评价管理
src/views/vi          语音交互
src/views/is          智能座舱
src/views/corpusManger 语料管理
```

业务菜单由后端 `/getRouters` 动态返回。新增或调整页面时，需要同步检查数据库菜单中的 `component` 路径、权限字符和前端 `src/views` 实际路径。

