CMVR-IOT/ruoyi-ui/README.md

88 lines
2.8 KiB
Markdown
Raw Normal View History

2026-07-28 16:33:32 +08:00
# 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` 实际路径。