01 · 背景 & 目标
为什么做:告警数据已有,业务闭环未成
项目已导入海康智能分析能力,但告警事件并未与自在云平台的业务联动,业务闭环仅局限在项目监控中心,实际运行效果有限。MVP 版本围绕"自动派单闭环"与"人工判断补位"两条路径展开。
⌂项目背景 · 新天地花园
- 规模:1600 户房间,4 栋住宅 + 1 栋公寓(公寓 500 多户),当前仅改造 F 区园区。
- 设备:园区共有 70 多个海康摄像头,本次新装智能分析摄像头 32 个,含枪机、半球、枪球一体机等形态。
- 高价值场景:项目反馈价值较高的为高空抛物、电瓶车高温预警、垃圾满溢、人员轨迹。
- 核心问题:告警未与业务系统联动,处置停留在监控中心内部。
◎MVP 版本目标
- 平台对接:云平台对接海康云眸的报警消息(事件订阅)。
- 自动闭环:对精准度较高的场景(电瓶车高温预警、人员离岗、电瓶车入梯、消防通道占用),自动生成工单指派到项目值班人员,形成业务闭环。
- 人工补位:对精准度较低的场景(如高空抛物),增加人为判断环节后再进行指派。
| 告警场景 | 日均告警量 | 精准度 | 处置策略 |
|---|---|---|---|
| 高空抛物 | 200+ | 较低 | 人工判断后指派 |
| 人员离岗 | 130+ | 较高 | 自动生成工单 |
| 电瓶车高温预警 | 20+ | 较高 | 自动生成工单 |
| 消防通道占用 | 20+ | 较高 | 自动生成工单 |
| 电瓶车入梯 | 20+ | 较高 | 自动生成工单 |
| 周界告警 | <10 | — | 告警中心统一查看 |
| 垃圾满溢 | 无告警事件产生 | — | 纳入自动派单场景设计 |
数据取自原型「项目介绍」页。按告警精准度与实地用户研究,MVP 优先实现人员离岗、电瓶车高温预警、消防通道占用、电瓶车入梯等场景的工单业务联动。
02 · 核心业务流程
从设备告警到企微处理的全链路
整体流程分三层:平台配置层完成云眸社区与自在云项目的绑定、事件订阅;运行层完成告警获取与"自动派发 / 人工判断"分流;移动层在企微完成接单、处理与解除。
配置层
(管理端)
(管理端)
通道管理绑定云眸社区 ID ↔ 自在云项目
→
订阅报警事件community_event_alarm
→
事件管理事件类型 · 通知频率 · 人员关联
→
数据管家关联项目 / 职位 / 人员
运行层
(告警判断)
(告警判断)
路径 A · 自动
报警事件获取
→
自动生成任务派发垃圾满溢 / 电瓶车高温 / 消防通道占用
→
派到个人选择人员 / 个人推送
路径 B · 人工
告警推送
→
人工判断查看图片 / 分类 / 点位实时视频
→
误报 → 解除告警
/
确认告警 → 指派任务
移动层
(企微端)
(企微端)
接收告警通知
→
打开告警详情
→
接单
→
现场处理 / 转派
→
提交完成 / 误报 / 重复告警
→
告警解除
03 · 功能模块
管理端四大模块 + 企微移动端
管理端导航为「系统配置(通道管理 / 事件管理)· 告警中心 · 智慧大屏 · AI 工单」;企微端承载全部处理动作。点击任意截图可跳转到线上原型的对应页面。
1
通道管理
系统配置 · 云眸设备通道的接入与归属维护
- 数据来源:通道列表通过海康云眸平台 API 获取展示;通道名称、通道号取自云眸,所属楼栋由用户在自在云平台编辑保存。
- 列表与筛选:字段含通道名称、事件类型、所属楼栋、通道号、实时查看、操作;支持按城市 → 社区 → 事件类型 → 楼栋逐级筛选。
- 编辑规则:厂商、通道号、通道 ID、通道名称来自云眸 API 不可编辑;所属项目必选(数据取自数据管家项目列表),所属楼栋级联可选至楼栋 / 楼层。
- 实时查看:点击弹出当前通道实时视频流,支持全屏;必填项未填无法保存。
2
事件管理
系统配置 · 事件类型定义与人员关联(仅系统管理员可见)
- 事件类型管理:事件列表含事件名称、关联岗位、操作;添加事件时选择「海康事件类型」(消息码 10201–10221,覆盖设备离线、区域入侵、越界侦测、电瓶车遗留、高空抛物、移动侦测、停车侦测、温度过高等 20+ 种)并填写「自在事件命名」(必填,20 汉字以内)。
- 通知配置:推送频率、静默时间在事件管理中灵活配置(V1.2 调整)。
- 事件人员关联:按「关联项目 + 关联职位(按部门筛选)+ 关联人员」配置告警的触达对象。
- 编辑联动:事件被通道关联后,编辑事件需同步更新该通道涉及字段。
3
告警中心
告警事件的查询、详情与实时查看
- 告警列表:字段含事件类型(自在定义)、通道名称、告警内容、时间、告警状态、图片、操作;支持按城市、社区、事件类型、视频通道筛选。
- 告警状态:告警中(产生即为告警中)/ 已解除(被忽略,或转工单完成后标记);解除原因:误报、重复告警、已处理。
- 事件详情:告警分类(按通道关联的事件分类)、告警内容(取自云眸「报警事件订阅消息」的 eventDescription)、通道名称、关联抓图、实时查看入口。
- 细节规则:图片列点击打开关联抓图,无图则提示"没有图片";告警已转工单且处理中时,不显示解除原因字段。
4
AI 工单
告警转化工单的列表、详情与流转记录
- 工单列表:字段含编号、跟进人、事件类型、处理时间、状态、操作;支持按城市、社区、事件类型、状态筛选。
- 状态定义:待接单(系统自动转派 / 前台调度 / 他人转派)→ 处理中(跟进人在企微点击"接单")→ 已完成(提交后工单完成,关联告警变为"已解除")。
- 工单详情:告警分类、内容、详细地址、图片与告警详情一致;处理描述为企微填写的文字反馈(≤300 汉字);图片反馈 ≤9 张。
- 历史记录:完整呈现派单链路——AI 监控系统发起告警待办 → 转派(XX→YY 待接单)→ 已接单 → 已完成。
- 数据权限:系统管理员可见全部;项目成员仅可见当前项目的工单列表。
5
企微 AI 工单(移动端)
告警判断、接单处理、转派与解除的移动闭环
- 任务列表三分屏:「待判断 / 待处理 / 已解除」三个选项卡,用绿、黄、红区分处理进度;派单角色可见全部,接单人员仅见派给自己的单和自己处理完的单。
- 待判断:查看告警图片与分类、查看对应监控点位实时视频推流;判断为「误报 / 重复告警」流转至已解除,「确认告警」则指派任务。
- 待处理:含「待接单 / 处理中」两种页面状态;点击接单后处理,支持「转派」(调起项目组织架构,单选用户;转派后原人员不可见)。
- 已解除:处理完成、误报、重复告警三种状态归档。
- 通知卡片:接收角色分两类——处理告警的人员(前台)与接收派单任务的业务线人员;点击卡片直接进入处理页。
- 交互约束:处理描述 ≤300 字、图片 ≤9 张;摄像头图标可调起点位直播,权限限平台运营、集团 / 城市 / 项目管理员、前台与中央监控人员;视频支持全屏横屏查看。
6
文档页:项目介绍 & 业务流程图
原型内附的背景数据与系统对接说明
- 项目介绍:新天地花园概况、MVP 目标、各场景告警日均量与精准度评估。
- 业务流程图:整体流程泳道 + 企微端流程;列出本次需求需重点关注的 4 个海康云眸接口及调用链路(按社区 ID 获取通道列表 → 订阅报警事件)。
- 入口页:从「IOC 智慧运营中心 → 系统配置 → 通道管理」进入系统。
04 · 状态流转
告警与工单的状态机
同一个事件在三个视角下流转:告警事件(告警中 / 已解除)、AI 工单(待接单 → 处理中 → 已完成)、企微待办(待判断 → 待处理 → 已解除)。
⚑告警事件
告警中→
忽略 / 转工单→
已解除
解除原因:误报、重复告警、已处理;告警转工单后处于"处理中"时,详情页不显示解除原因。
☰AI 工单
待接单企微点「接单」→
处理中提交 →
已完成⇒
关联告警 → 已解除
进入「待接单」的三种方式:告警事件被系统自动转派给跟进人 / 被前台岗位判断后调度给某岗位人员 / 被转派给某个人。
▣企微待办(移动端视角)
待判断确认告警 →
待处理(待接单 / 处理中)误报 / 重复告警 ↘
已解除(处理完成 / 误报 / 重复告警)
派单角色可见所有选项卡;接单人员仅能看到「待处理」中派给自己的单,和「已解除」中自己处理完的单。
05 · 数据与集成
海康云眸 OpenAPI 与权限模型
系统通过 4 个云眸接口完成「项目绑定 → 通道获取 → 事件订阅 → 实时取流」;人员与组织主数据来自自在云「数据管家」。
接口 1海康报警事件订阅消息
核心集成点:按社区订阅 community_event_alarm 报警事件,驱动后续判断与派单;告警内容取自 eventDescription。
接口 2查询社区下的设备列表
获取云眸社区下的设备清单,用于通道数据的初始同步。
接口 3查询社区下设备通道列表
根据社区 ID 获取当前项目的通道列表(含楼栋 / 楼层归属),支撑通道管理页面。
接口 4标准取流预览
管理端「实时查看」与企微端「查看点位直播」的视频流来源,支持全屏播放。
⛊角色与数据权限
- 系统管理员:可见事件类型管理、事件人员关联等配置模块。
- 项目成员:仅可见当前项目的工单列表、告警事件与事件岗位关联。
- 视频查看权限:平台运营、集团管理员、城市区域管理员、项目管理员、前台人员 & 中央监控人员(派单调度角色)。
06 · 版本记录
原型迭代历程(2021-09)
V0.12021-09-13 · 龙海
- 初版。
V1.02021-09-13 · 龙海
- 增加「概述 & 业务流程图」;更新事件管理设计。
V1.12021-09-16 · 龙海
- 企微端流程与需求更新。
- 通道管理增加「是否人工判断」开关;通道名称与地址命名统一。
- 告警列表增加告警筛选;告警分类统一为「事件分类」。
- 事件关联中「岗位」改为「职位」并按部门筛选;事件告警频率改为灵活配置。
V1.22021-09-17 · ZEN
- 通道管理:删除「原始事件分类」,去掉通道与事件的直接关联。
- 事件管理:添加事件时需建立与海康事件类型的关联。
- 推送频率、静默时间挪入事件管理。