103 lines
3.5 KiB
Markdown
103 lines
3.5 KiB
Markdown
# CMVR IoT 管理控制台
|
||
|
||
招商车研物联网平台 Vue 3 管理端。项目以 RuoYi-Vue3 3.9.2 为新版基础框架，完整迁移原 `cmvr-iot-ui` 的业务页面、API、机器人模型和运行配置，并连接 `RuoYi-Vue-master` 中的 Spring Boot 4 后端。
|
||
|
||
旧前端仅作为迁移来源，不参与本项目构建。
|
||
|
||
## 功能范围
|
||
|
||
- 系统管理：用户、角色、部门、岗位、菜单、字典、参数、通知和文件。
|
||
- 系统监控：在线用户、操作日志、登录日志、缓存、服务、Quartz 和 Druid。
|
||
- 设备管理：设备注册、终端、机器人、相机、机械臂、灵巧手、机器人头部、麦克风、扬声器和电机。
|
||
- 测试平台：测试项目、任务配置、任务编排、检测项、任务实例和执行流程。
|
||
- 智能巡检：机器人、地图、点位、任务、执行实例、巡检结果、告警和驾驶舱。
|
||
- 交互评价：语音交互、触控交互、评价指标、方案、项目和语料。
|
||
- 智能座舱：车机界面、车辆配置、功能配置、流程编辑和执行评价。
|
||
- 语料与媒体：语料管理、音频上传、图片预览、视频播放和 WebSocket 实时消息。
|
||
- 开发工具：代码生成、表单构建和 Knife4j 接口文档。
|
||
|
||
## 技术栈
|
||
|
||
| 组件 | 版本 |
|
||
| --- | --- |
|
||
| Vue | 3.5.26 |
|
||
| Vite | 6.4.1 |
|
||
| Element Plus | 2.13.1 |
|
||
| Pinia | 3.0.4 |
|
||
| Vue Router | 4.6.4 |
|
||
| 可视化 | ECharts、Vue Flow、Three.js、Monaco Editor、XGPlayer |
|
||
|
||
## 环境要求
|
||
|
||
- Node.js 20 LTS
|
||
- pnpm 10
|
||
- 后端 `RuoYi-Vue-master/cmvr-iot-admin`
|
||
|
||
## 开发运行
|
||
|
||
先启动后端，确认 `http://localhost:13080` 可以访问，然后执行：
|
||
|
||
```bash
|
||
pnpm install
|
||
pnpm dev
|
||
```
|
||
|
||
默认地址：
|
||
|
||
- 前端：`http://localhost:80`
|
||
- 后端：`http://localhost:13080`
|
||
- Knife4j：`http://localhost:13080/doc.html`
|
||
|
||
开发配置位于 `.env.development`：
|
||
|
||
```dotenv
|
||
VITE_APP_TITLE=招商车研物联网平台管理系统
|
||
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:stage
|
||
pnpm build:prod
|
||
pnpm preview
|
||
```
|
||
|
||
生产构建输出到 `dist`。部署时需要由 Nginx 或网关转发 `/prod-api`，并支持 `/ws` WebSocket、文件上传和媒体请求。
|
||
|
||
## 目录说明
|
||
|
||
```text
|
||
public/models 机器人 URDF 和网格模型
|
||
public/inspection 巡检机械臂模型
|
||
src/adapters URDF/Xacro 模型适配
|
||
src/api REST API 封装
|
||
src/components 公共及业务组件
|
||
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` 下的实际页面路径一致，权限字符必须与后端控制器保持一致。
|
||
|
||
## 配置说明
|
||
|
||
- `.env.development`：本地开发地址。
|
||
- `.env.staging`：测试环境地址。
|
||
- `.env.production`：生产环境地址、Node-RED 和 MinIO。
|
||
- `vite.config.js`：代理、端口、Monaco 和构建分包。
|
||
- `src/settings.js`：布局、页签和版权配置。
|
||
|
||
生产密码、访问密钥和内部网络配置应通过部署环境注入，不要提交新的敏感信息。
|