docs: 补充当前故障刷新按钮需求

main
wangqiyang 3 days ago
parent ecb6bf5ad3
commit c04a601335

@ -86,6 +86,25 @@ AddTaskByFunc("ScanM9z", "ScanM9z", "@every 10m", m9zTtyApi.ScanM9z)
当前无故障 当前无故障
``` ```
建议在该区域增加一个手动刷新按钮:
```text
刷新当前故障
```
按钮用途:
1. 现场人员可以立即重新读取当前故障,不必等待下一次自动刷新
2. 调试和验收时可以快速确认故障是否已恢复
3. 当通信短暂异常或页面刚恢复时,可以主动刷新当前状态
交互建议:
1. 点击后调用实时监控接口重新读取当前故障
2. 按钮请求期间显示 loading 或禁用,避免连续点击造成串口请求堆积
3. 刷新成功后更新当前故障区域
4. 刷新失败时提示“当前故障刷新失败”或保留原状态并显示错误提示
每条故障建议包含: 每条故障建议包含:
| 字段 | 说明 | | 字段 | 说明 |
@ -314,6 +333,16 @@ internal/module/m9zTtyApi/cron.go
当前无故障 当前无故障
``` ```
当前故障区域需要提供手动刷新按钮:
```text
刷新当前故障
```
点击后重新调用 `/m9z/getDeviceStatus2`,只刷新实时监控状态和当前故障显示,不需要弹确认框。
按钮请求期间应显示 loading 或禁用,避免连续点击造成重复串口请求。
### 2. 适配实时接口字段 ### 2. 适配实时接口字段
调用接口: 调用接口:
@ -359,7 +388,7 @@ Loops[].faults
2. 后端改 `/m9z/getDeviceStatus2` 返回当前故障 2. 后端改 `/m9z/getDeviceStatus2` 返回当前故障
3. 后端增加实时写入历史和去重 3. 后端增加实时写入历史和去重
4. 后端增加 `loopCount` 配置 4. 后端增加 `loopCount` 配置
5. 前端实时监控页增加当前故障区域 5. 前端实时监控页增加当前故障区域和“刷新当前故障”按钮
6. 前端适配接口字段 6. 前端适配接口字段
7. 联调真实 0x17 报文:`01`、`02`、`04 01`、`04 02`、`04 03` 7. 联调真实 0x17 报文:`01`、`02`、`04 01`、`04 02`、`04 03`

Loading…
Cancel
Save