CMVR-IOT/ruoyi-ui/README.md

88 lines
2.8 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.

# 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` 实际路径。