# 检测室数据可视化系统

面向电池检测室的桌面优先运维管理前端，采用 Vue 3、TypeScript、Vite、Element Plus 与 ECharts。

## 启动

```powershell
npm install
npm run dev
```

开发环境默认地址：`http://127.0.0.1:5173`

测试账号：`admin` / `admin123`

仓库默认开发配置会同时启用 `druid` 和 `dev-simulator` Profile。`dev-simulator` 负责驱动开发模拟器的发现、采样和实时快照调度；未启用时模拟器页面仍可打开，但不会向模拟器请求数据。需要显式指定时可执行：

```powershell
cd E:\YeGproject\jcs\BatteryDetection
mvn -pl ruoyi-admin -am spring-boot:run -Dspring-boot.run.profiles=druid,dev-simulator
```

普通 IntelliJ IDEA `RuoYiApplication` 启动会读取该默认配置；若运行配置填写了 Active profiles，则应设为 `druid,dev-simulator`。真实设备部署必须覆盖活动 Profile 并移除 `dev-simulator`。

## 文档

- [项目说明、目录、页面树与开发记录](docs/PROJECT.md)
- [页面功能说明索引](docs/pages/README.md)

## 校验

```powershell
npm run build
```

Ticket04 设备登记浏览器冒烟测试会自行启动隔离的 MySQL 8、Redis、Spring Boot、Vite 和开发模拟器，完成后停止并删除临时进程与容器：

```powershell
npm run test:e2e:ticket04
```

测试默认使用端口 `15174`、`18001`、`63306` 和 `56379`，端口已占用时会直接失败而不复用现有服务。可通过 `TICKET04_WEB_PORT`、`TICKET04_API_PORT`、`TICKET04_MYSQL_PORT`、`TICKET04_REDIS_PORT` 覆盖；镜像仓库可通过 `TICKET04_MYSQL_IMAGE` 和 `TICKET04_REDIS_IMAGE` 覆盖。

模拟器与历史导入 Ticket05 的完整验收复用同一隔离环境，还使用模拟器端口 `15021`（可由 `TICKET04_SIMULATOR_PORT` 覆盖）：

```powershell
npm run test:e2e:simulator-import-acceptance
```

运行前需安装 Chrome、Java/Maven，并提供可用的 Docker 或 WSL Docker。默认读取根工作区 `outputs/ticket03-excel/277#(5)(1)_补充三项测试值.xls`；可用 `PARTY_EXCEL` 指定同一甲方验收样例的副本路径，样例应包含 7605/129/33 行实时、工步、循环数据。

流程通过真实页面登记设备、导入文件，使用真实后端与独立 MySQL/Redis，按墙上时间等待分钟采样和离线空档，验证 5 秒预警、三表刷新、退出重登、后端重启、重复导入及数据流隔离。测试约需数分钟，不使用倍速或历史补采；结束后清理临时服务和容器。截图在 `test-results`，后端日志在 `tests/e2e/.artifacts/backend.log`；在命令后追加 `-- --reporter=list,html` 可保留含数值验收附件的 HTML 报告。该验证不证明真实 BTS 或采集器协议兼容性。