51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
# ASR 事件监控前端
|
||
|
||
这是与仓库 Spring Boot 后端配套的新版 React + Vite 前端。
|
||
|
||
## 本地联调
|
||
|
||
先在仓库根目录启动后端（默认端口 `8080`），再启动前端：
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
访问 `http://localhost:3000`。Vite 会把 `/api` 请求代理到
|
||
`http://localhost:8080`，无需额外配置 CORS。
|
||
|
||
## 生产打包
|
||
|
||
```bash
|
||
cd frontend
|
||
npm run build
|
||
```
|
||
|
||
构建结果位于 `frontend/dist`。如需与 Spring Boot 打成同一个 JAR，
|
||
在执行 Maven 打包前，将 `dist` 内的文件复制到：
|
||
|
||
```text
|
||
src/main/resources/static/
|
||
```
|
||
|
||
之后访问 Spring Boot 的 `http://localhost:8080/` 即可使用前端。
|
||
|
||
## 后端接口
|
||
|
||
- `GET /api/v1/admin/rules`：读取当前生效规则
|
||
- `PUT /api/v1/admin/rules`：保存并发布完整规则文档
|
||
- `POST /api/v1/asr-events`：提交 ASR Final 并获取会话告警
|
||
- `POST /api/v1/calls/{callId}/close`：关闭并释放通话会话
|
||
|
||
规则数据和生效版本以后端为准；浏览器不再通过 localStorage 模拟发布。
|
||
|
||
## Excel 导入导出
|
||
|
||
- “模板下载”生成 `.xlsx` 规则模板。
|
||
- 每行填写一条规则，多个关键词在同一个单元格内换行填写。
|
||
- 新增规则无需填写事件 ID，页面和 Excel 导入都会自动生成唯一 ID。
|
||
- “导入”会校验已有事件 ID、启用状态、关键词以及重复数据，并替换页面工作副本。
|
||
- “导出”按照相同模板格式导出当前页面中的规则。
|
||
- 导入不会自动发布，确认数据后仍需点击“保存并发布”。
|