live-call-asr-monitor/frontend/README.md

ASR 事件监控前端

这是与仓库 Spring Boot 后端配套的新版 React + Vite 前端。

本地联调

先在仓库根目录启动后端（默认端口 8080），再启动前端：

cd frontend
npm install
npm run dev

访问 http://localhost:3000。Vite 会把 /api 请求代理到 http://localhost:8080，无需额外配置 CORS。

生产打包

cd frontend
npm run build

构建结果位于 frontend/dist。如需与 Spring Boot 打成同一个 JAR， 在执行 Maven 打包前，将 dist 内的文件复制到：

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、启用状态、关键词以及重复数据，并替换页面工作副本。
• “导出”按照相同模板格式导出当前页面中的规则。
• 导入不会自动发布，确认数据后仍需点击“保存并发布”。