diff --git a/docs/产品化改进计划.md b/docs/产品化改进计划.md index d2de29b..847d372 100644 --- a/docs/产品化改进计划.md +++ b/docs/产品化改进计划.md @@ -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-5(HLS 修复) +已完成:P0-5(HLS 修复) ↓ -第 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(长期优化) ``` ## 技术债务同步处理 diff --git a/docs/实施跟踪.md b/docs/实施跟踪.md index b3307e4..b5d0a39 100644 --- a/docs/实施跟踪.md +++ b/docs/实施跟踪.md @@ -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