V2/告警列表

告警列表 V2 · 巡检+登记

数据源 /api/zt/alerts/list + /api/zt/alerts/stats · 行内下钻 /app/v2/alerts-detail/?id=AL-xxx
页型 列表告警域 C总量 —逾期 —时间 —
A1身份区
中台 · V2 · 告警域
A3版本区
tokens v1.1.0 · API —
B1筛选区
状态与级别可叠加:先选状态,再点级别
B2列表主区
序号告警级别状态到期剩余
加载骨架 · 拉取 /api/zt/alerts/list
B3统计区
—告警总数
—已逾期
—待处理
—平均处置(分钟)
级别分布—
状态分布—
C1来源区
/api/zt/alerts/list?limit=200 · —
C2下钻区
行 → 告警详情(来源/引用/处置记录/剩余时长)|详情页支持 ?id=AL-xxx 直达
C3帮助区
逾期=dueAt 已过且未处理,剩余时长显示为红字负值
点击展开,每项均为可下钻说明(门禁 P8:details≥6)
字段口径 · 一列一义

序号=seq;告警=title;级别=level(P0/P1/P2/P3);状态=state(待处理/已处理);到期=dueAt 换算北京时间(UTC+8);剩余=remainSec 换算(<0 即逾期,红字);overdue 为服务端判定的布尔值。

接口清单 · 调用方式

/api/zt/alerts/list?limit=200&state=&level= · 列表(GET,支持状态与级别过滤)|/api/zt/alerts/stats · 统计(byLevel/byState/overdue/avgCostMin,GET)|/api/zt/alerts/ack · 处置回执(POST)|/api/zt/ui/version · 版本(GET)|/api/zt/time/now · 北京时间(GET)

级别口径 · 响应时限

P0=15 分钟内响应|P1=1 小时|P2=4 小时|P3=当天(时限取自 /api/zt/settings 的 alertDueP*Min,页面不写死)。

三态触发 · 何时出现

加载态:接口未返回或不足 300ms;空态:筛选后 0 条(显示图标+原因+“看全部”动作);错误态:fetch 失败显示「—」+重试。

操作手册 · 三步走

① 默认「待处理」优先处置;② 叠加级别只看 P0/P1;③ 点告警标题进详情,可回本列表;处置完成后再刷新核对统计条。

验收口径 · 本页 DoD

P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5;P8 details≥6;P9 card≥6;@media 1024/520 两段;tokens?v=1.1.0;body 不裁切(无 overflow 隐藏);下钻可回上一级。

数据 /api/zt/alerts/list + stats下钻 /app/v2/alerts-detail/← 返回 V2 总览—