docs: update improvement plan and tracking based on code review

This commit is contained in:
tian 2026-07-17 16:28:46 +08:00
parent 2b989aa368
commit c14173acd2
2 changed files with 29 additions and 22 deletions

View File

@ -17,23 +17,23 @@
## P0必须立即完成交付底线
### 1. 告警中心重做
### 1. 告警中心增强
**现状问题**:告警存内存、重启就丢;只读日志无操作;无严重等级
**现状**:告警已持久化到 SQLite、有日期筛选分页、仪表盘有今日统计。缺的是工作流和等级。
**改什么**
- 告警数据迁移到 SQLite `alarms` 表持久化存储
- 增加告警状态流转:未处理 → 已确认 → 已关闭,每条操作记录操作人和时间
- 增加严重等级:`info / warning / critical / emergency`,用颜色+图标区分
- 增加类型筛选:设备维度、规则类型维度、时间维度
- 增加告警详情弹出层,展示完整抓拍图、识别信息、时间线
- DB 迁移:`alarm_records` 表增加 `status`, `severity`, `acknowledged_at`, `acknowledged_by`, `resolved_at`, `resolved_by`
- 告警状态流转:未处理 → 已确认 → 已关闭,记录操作人和时间
- 严重等级:`info / warning / critical`,默认值 `warning`
- 筛选增强:加设备下拉筛选、规则类型下拉筛选(现有日期筛选保留)
- SSE 实时推送:新告警到达时推送浏览器
**实现要点**
- 新建 `alarms` 表(`id, device_id, channel, rule, label, confidence, severity, status, snapshot_path, clip_path, created_at, acknowledged_at, acknowledged_by, resolved_at, resolved_by`
- `AlarmCollector` 收到告警后写入 DB
- 告警页面改为从 DB 查询,保留现有分页
- 行内添加操作按钮(确认/关闭),调用 API
- 表头加严重等级列
- migration 用 `hasColumn` 检查列存在,`ALTER TABLE ADD COLUMN` 增量添加
- `AlarmRecord` 结构体扩展字段,`saveAlarm` 设置默认值
- API`POST /ui/alarms/{id}/acknowledge`、`/resolve`、`/severity`
- 模板:加严重等级列(蓝/橙/红 pill、状态列、操作按钮列
- SSE`GET /api/alarms/stream`,浏览器 EventSource 连接,为 P0-2 仪表盘打基础
### 2. 仪表盘重做
@ -200,17 +200,11 @@
## 实施时序
```
第 1-2 周P0-4登录 + P0-5HLS 修复)
已完成:P0-5HLS 修复)
第 2-4 周P0-1告警重做 + P0-2仪表盘重做
进行中P0-1告警增强 P0-2仪表盘重做
第 4-6 周P0-3配置向导
第 6-8 周P1-6告警通知 + P1-7服务健康 + P1-8结果提示
第 8-10 周P1-9术语统一 + P2-10时序图表 + P2-13报告导出
后续迭代P2 其余项
待开始P0-3配置向导 → P1体验打磨 → P0-4登录 → P2长期优化
```
## 技术债务同步处理

View File

@ -4,7 +4,7 @@
| # | 事项 | 状态 | 开始 | 完成 |
|---|------|------|------|------|
| 1 | 告警中心重做(持久化+工作流+等级) | ⬜ 待开始 | - | - |
| 1 | 告警中心增强 | 🔄 进行中 | 2026-07-17 | - |
| 2 | 仪表盘重做(实时告警流+统计卡片) | ⬜ 待开始 | - | - |
| 3 | 一键配置向导(场景化部署 3 步流程) | ⬜ 待开始 | - | - |
| 4 | 基础登录鉴权 | ⬜ 待开始 | - | - |
@ -30,6 +30,19 @@
| 14 | 模型管理简化 | ⬜ 待开始 | - | - |
| 15 | 人脸库优化(搜索+质量评分) | ⬜ 待开始 | - | - |
## 进行中
### P0-1 告警中心增强
| # | 子任务 | 状态 |
|---|--------|------|
| 1.1 | DB 迁移 — alarm_records 加 status/severity/resolved 列 | ⬜ |
| 1.2 | AlarmRecord 结构体扩展 + saveAlarm 默认值 | ⬜ |
| 1.3 | API — acknowledge/resolve/severity 端点 | ⬜ |
| 1.4 | 模板 — 严重等级列 + 状态列 + 操作按钮 | ⬜ |
| 1.5 | 筛选增强 — 设备下拉 + 规则类型下拉 | ⬜ |
| 1.6 | SSE — /api/alarms/stream 实时推送 | ⬜ |
## 已完成事项
### 2026-07-17