AI生成成套文档-03-需求规格说明书
# 需求规格说明书
## 1. 文档信息
| 项目名称 | AI视频分析中台 |
|---------|----------------|
| 文档版本 | v1.0 |
| 编写日期 | 2025-01-20 |
| 编写人员 | 黄毅 |
| 审核人员 | 邓大阳 |
| 批准人员 | 董列涛 |
---
**文档修订历史**
| 版本号 | 修订日期 | 修订人员 | 修订内容 |
|--------|---------|---------|---------|
| v1.0 | 2025-02-10 | 黄毅 | 依据《AI视频分析中台 系统建设方案》与《模板-需求规格说明书模板》编写初始版本 |
## 2. 概述
### 2.1 编写目的
本需求规格说明书用于明确 AI 视频分析中台系统的功能需求、非功能需求、接口需求及约束条件，为设计、开发、测试与验收提供依据。适用对象包括项目管理人员、需求分析人员、设计开发人员、测试人员及验收方；可用于需求评审、设计输入、测试用例编写及验收标准制定。
### 2.2 项目背景
- **项目来源**：面向智慧园区、楼宇、消防及安防场景的视频智能分析管理平台建设需求，需对园区视频监控汇聚平台的视频流进行 AI 算法分析，实现事件告警汇聚、事件处置闭环、算法任务调度与设备通道统一管理。
- **现状问题**：园区视频监控与 AI 分析能力分散，缺乏统一的告警汇聚与处置闭环；算法与任务、设备与通道管理不统一；与智慧园区管理平台的北向对接与南向取流缺乏标准化，运维与资源利用缺乏可视与可控手段。
- **项目目标**：构建以事件告警为核心的完整业务闭环，实现多源视频统一接入、算法与任务一体化管理、事件全生命周期管理、多场景 AI 安防能力及完善的运维与北向对接能力。
- **项目意义**：提升安全防控效率、规范事件处置流程、优化算法与资源利用、降低集成与运维成本，支撑园区智能化升级。
### 2.3 术语定义
| 术语 | 英文 | 定义 |
|------|------|------|
| RTSP | Real Time Streaming Protocol | 实时流传输协议，用于从摄像头或流媒体服务器获取视频流。 |
| GB/T28181 | — | 国标《安全防范视频监控联网系统信息传输、交换、控制技术要求》，用于设备与平台级视频联网。 |
| ONVIF | Open Network Video Interface Forum | 开放网络视频接口论坛标准，用于网络摄像头的发现与控制。 |
| 误检库 | False Positive Library | 存放被判定为误报的告警数据，用于算法迭代与误报治理。 |
| 预置点 | Preset | 球机预设的云台位置，可绑定不同算法任务并参与轮询调度。 |
| 轮询 | Polling | 在有限算力下按策略轮流对多路视频/预置点进行分析的调度方式。 |
| 警戒框/忽略框/标识线 | — | 在视频画面上绘制的算法生效区域、屏蔽区域及仅显示线，用于算法检测范围与显示配置。 |
| 南向/北向 | Southbound/Northbound | 南向指与下层系统（如视频监控汇聚平台）对接取流；北向指与上层系统（如智慧园区管理平台）对接推送告警与数据。 |
### 2.4 参考资料
- 《AI视频分析中台 系统建设方案》
- GB/T28181 安全防范视频监控联网系统信息传输、交换、控制技术要求
- 智慧园区管理平台安防管理需求
### 2.5 文档约定
- **优先级定义**：P0 必须实现，P1 重要应实现，P2 一般可延后，P3 可选后续考虑。
- **状态定义**：待实现、开发中、测试中、已验收。
- **需求编号**：功能需求采用 REQ-F-xxx（与建设方案中 Fx.x 对应），非功能需求采用 REQ-NF-xxx，接口需求采用 REQ-I-xxx。
## 3. 系统概述
### 3.1 系统目标
- **总体目标**：建设一套面向智慧园区、楼宇、消防及安防场景的视频智能分析管理平台，通过接入园区视频监控汇聚平台的视频流进行 AI 算法分析，实现事件告警汇聚、事件处置闭环、算法任务调度与设备通道统一管理，为园区安全管理与运营决策提供智能化支撑。
- **业务目标**：以事件告警为核心，构建从设备接入、通道与算法绑定、任务调度与轮询、事件汇聚与处置到统计分析及第三方对接的完整业务闭环；支持火焰、通道阻塞、吸烟、人群聚集、高空抛物、电动车入楼等多类 AI 安防算法，实现告警集中展示、误检库管理及流程化处置。
- **技术目标**：支持 RTSP、GB/T28181、ONVIF 等南向取流；算法与任务一体化管理、预置点轮询与负载均衡；北向采用 JSON、RESTful、HTTP/HTTPS，数据加密与签名，与智慧园区管理平台对接。
### 3.2 系统范围
#### 3.2.1 系统边界
- **系统包含**：AI 应用（事件告警、事件处置、视频中心、AI 安防应用）、算法中心（算法调用概览、算法参数配置、算法调度、算法轮询、第三方对接）、设备管理（设备管理、通道管理）、系统管理（部门、权限、菜单、日志、运维管理、智能运维）。
- **系统不包含**：园区视频监控汇聚平台及摄像头硬件本身的建设与运维；训练平台的具体训练能力（仅通过标注数据推送对接）；梯控等第三方联动系统的具体实现（仅支持联动接口约定）。
- **与其他系统关系**：南向依赖园区视频监控汇聚平台提供视频流；北向向智慧园区管理平台推送告警事件与统计数据；可选与训练平台对接接收标注数据。
#### 3.2.2 用户范围
- **目标用户**：园区/楼宇安全管理人员、运维人员、值班人员、系统管理员及智慧园区管理平台集成方。
- **用户角色**：管理员（组织、权限、设备、算法、任务、运维配置）、业务用户（告警查看与处置、视频查看、统计）、只读/审计角色等。
### 3.3 系统环境
#### 3.3.1 运行环境
- **硬件环境**：支持部署分析节点（含 GPU 的推理服务器）、管理节点及存储；具体规格依并发路数与算法类型而定。
- **软件环境**：主流 Linux 服务器操作系统；支持容器化部署；浏览器支持 Chrome、Edge 等现代浏览器。
- **网络环境**：与视频汇聚平台、智慧园区管理平台网络互通；支持 HTTP/HTTPS、RTSP、GB/T28181 等协议所需端口与防火墙策略。
#### 3.3.2 开发环境
- **开发框架**：按项目技术选型确定（如前后端分离、微服务等）。
- **技术架构**：南向取流、算法调度与推理、事件汇聚与北向推送分层架构；支持多算法实例负载均衡与任务同步。
- **协议与标准**：RTSP、GB/T28181、ONVIF；北向 RESTful、JSON、HTTP/HTTPS，数据加密与签名。
## 4. 功能需求
### 4.1 功能需求概述
系统分为四大功能域：**AI 应用**（事件告警、事件处置、视频中心、AI 安防应用）、**算法中心**（算法调用概览、算法参数配置、算法调度、算法轮询、第三方对接）、**设备管理**（设备管理、通道管理）、**系统管理**（部门、权限、菜单、日志、运维管理、智能运维）。功能需求采用**多级编号**（如 4.2.2.1、4.3.3.1），每个具体功能点包含需求编号、优先级、需求描述、输入/处理/输出、业务规则、性能要求及**业务流程**（步骤化描述）。
### 4.2 AI 应用
#### 4.2.1 功能描述
- **功能概述**：面向业务用户的事件告警汇聚展示、筛选与处置，以及实时视频查看与多类 AI 安防场景的告警产出。
- **功能目标**：将算法分析结果转化为可操作的事件信息，通过统计与流程配置支撑运营与决策。
- **业务价值**：告警集中展示与多维度筛选提升查阅效率；误检库与标注数据推送支持算法优化；事件流程配置与处置审核规范处置闭环；实时画面与录像满足监控与取证需求。
#### 4.2.2 事件告警
##### 4.2.2.1 告警信息汇聚展示
**需求编号**：REQ-F-001
**优先级**：P0
**需求描述**：将各算法产生的事件分析告警汇聚并集中展示，提供统一告警视图。
**输入**：各算法任务产生的告警事件。
**处理**：汇聚、排序、分页展示；支持查看事件名称、报警时间、事件开始/结束时间、抓拍图。
**输出**：告警列表；支持回溯告警录像、查看点位实时画面。
**业务规则**：无。
**性能要求**：列表加载与筛选响应时间满足常规操作体验。
**业务流程**：① 各算法任务产生告警并上报至事件库；② 系统按报警时间汇聚、排序并分页；③ 用户进入事件告警页，系统展示告警列表（事件名称、报警时间、开始/结束时间、抓拍图）；④ 用户点击某条告警可查看详情、回溯告警录像或查看点位实时画面。
---
##### 4.2.2.2 告警筛选
**需求编号**：REQ-F-002
**优先级**：P0
**需求描述**：在事件库中按多维度筛选目标告警。
**输入**：事件类型、识别方式、点位、时间段、任务类型等筛选条件。
**处理**：按条件过滤事件库，结果在列表中展示。
**输出**：筛选后的告警列表。
**业务规则**：支持组合筛选。
**性能要求**：筛选结果返回时间可接受。
**业务流程**：① 用户进入事件告警页，设置筛选条件（事件类型、识别方式、点位、时间段、任务类型等）；② 用户点击查询；③ 系统按条件过滤事件库并返回结果；④ 列表展示筛选后的告警，用户可进一步查看或操作。
---
##### 4.2.2.3 标注数据推送
**需求编号**：REQ-F-003
**优先级**：P1
**需求描述**：将推理系统的图片数据预处理后推送至训练平台，用于算法优化。
**输入**：选定告警/图片及目标训练平台配置。
**处理**：预处理后按约定接口推送。
**输出**：推送成功/失败状态。
**业务规则**：需配置训练平台地址与鉴权。
**性能要求**：大批量推送可异步处理。
**业务流程**：① 用户在告警列表中勾选需推送的告警（或按筛选结果批量选择）；② 用户选择目标训练平台并确认推送；③ 系统对图片等数据进行预处理；④ 系统按约定接口将数据推送至训练平台；⑤ 返回推送成功/失败状态，大批量时可异步并通知完成。
---
##### 4.2.2.4 误检库管理
**需求编号**：REQ-F-004
**优先级**：P0
**需求描述**：支持将告警数据添加至误检库、从误检库移除，用于误报管理与算法迭代。
**输入**：告警记录、添加/移除操作。
**处理**：维护误检库记录，供算法调参与模型优化使用。
**输出**：操作结果。
**业务规则**：误检库数据可被算法侧引用。
**性能要求**：单条与批量操作响应及时。
**业务流程**：① 添加至误检库：用户在告警列表中选择误报告警，执行“添加至误检库”，系统将告警标记/写入误检库并返回结果；② 从误检库移除：用户在误检库列表或告警详情中选择记录，执行“从误检库移除”，系统解除误检标记并返回结果；③ 误检库数据可供算法调参与模型优化使用。
---
##### 4.2.2.5 告警批量操作
**需求编号**：REQ-F-005
**优先级**：P0
**需求描述**：对告警数据批量执行批注、忽略、确认、删除。
**输入**：勾选的多条告警及操作类型。
**处理**：批量更新状态或执行删除。
**输出**：成功/失败数量及结果。
**业务规则**：删除等敏感操作可要求二次确认。
**性能要求**：批量操作在合理时间内完成。
**业务流程**：① 用户在告警列表中勾选多条告警；② 用户选择批量操作类型（批注、忽略、确认、删除）；③ 若为删除等敏感操作，系统弹窗二次确认；④ 系统批量更新状态或执行删除；⑤ 返回成功/失败数量及明细。
---
##### 4.2.2.6 导出历史事件
**需求编号**：REQ-F-006
**优先级**：P1
**需求描述**：将历史事件数据导出为文件，便于归档、审计或与外部系统对接。
**输入**：筛选条件、导出格式、时间范围。
**处理**：按条件查询并生成文件。
**输出**：导出文件（如 Excel/CSV）。
**业务规则**：可限制单次导出条数或需审批。
**性能要求**：大批量导出可异步生成并通知下载。
**业务流程**：① 用户设置筛选条件、时间范围及导出格式（如 Excel/CSV）；② 用户点击导出，系统校验条数限制或审批规则；③ 系统按条件查询并生成文件；④ 大批量时异步生成并通知用户下载，小批量可直接下载。
#### 4.2.3 事件处置
##### 4.2.3.1 按组织树事件统计
**需求编号**：REQ-F-007
**优先级**：P0
**需求描述**：对系统产生的告警事件按组织树进行统计，支持告警事件趋势、告警事件 TOP5/TOP10、告警点位 TOP5/TOP10。
**输入**：组织节点、时间范围。
**处理**：按组织聚合统计，计算趋势与 TOP 排行。
**输出**：图表与列表展示。
**业务规则**：统计范围受用户组织权限约束。
**性能要求**：统计结果在可接受时间内返回。
**业务流程**：① 用户选择组织节点（可选多级）及时间范围；② 用户点击统计；③ 系统按用户组织权限过滤事件，按组织树聚合；④ 系统计算告警事件趋势、告警事件 TOP5/TOP10、告警点位 TOP5/TOP10；⑤ 以图表与列表形式展示结果。
---
##### 4.2.3.2 事件流程配置
**需求编号**：REQ-F-008
**优先级**：P0
**需求描述**：支持自定义事件处置流程及流程节点（如研判、处理、审核），按组织范围与用户权限将事件推送至对应节点。
**输入**：流程定义、节点类型、组织与角色绑定。
**处理**：保存流程配置，事件按规则进入对应节点。
**输出**：流程配置生效，事件状态与节点关联。
**业务规则**：不同组织可配置不同流程。
**性能要求**：配置保存与事件推送及时。
**业务流程**：① 管理员进入事件流程配置页，选择组织范围；② 定义流程节点（如研判、处理、审核）及顺序；③ 为各节点绑定角色/用户权限；④ 保存流程配置；⑤ 新产生或待处置事件按组织与权限自动推送至对应节点。
---
##### 4.2.3.3 事件处置与审核
**需求编号**：REQ-F-009
**优先级**：P0
**需求描述**：处理节点支持查看告警图像/视频/实时视频、上传凭证等；审核节点对处理过程和结果进行审查确认，形成处置—审核闭环。
**输入**：处置操作、凭证上传、审核通过/驳回。
**处理**：更新事件处置状态、记录操作人与时间。
**输出**：处置与审核结果，状态流转。
**业务规则**：审核通过后事件可闭环。
**性能要求**：页面与附件上传响应正常。
**业务流程**：① 处理节点：用户进入待处理事件列表，点击某条事件，查看告警图像/视频/实时视频，填写处置说明并上传凭证，提交处理结果；② 审核节点：审核人进入待审核列表，查看处置过程与凭证，执行通过或驳回；③ 驳回后事件回到处理节点；④ 审核通过后事件闭环，状态更新并记录操作人与时间。
#### 4.2.4 视频中心
##### 4.2.4.1 实时告警展示
**需求编号**：REQ-F-010
**优先级**：P0
**需求描述**：支持显示实时分析画面与告警结果，并支持切换实时画面。
**输入**：点位/通道选择。
**处理**：拉取实时流与当前告警状态并展示。
**输出**：实时画面与告警叠加显示。
**业务规则**：与算法分析结果联动。
**性能要求**：画面延迟在业务可接受范围内。
**业务流程**：① 用户进入视频中心，选择点位/通道；② 系统拉取该点位实时流并获取当前告警状态；③ 画面展示实时分析结果与告警叠加（如有）；④ 用户可切换其他点位实时画面，系统重复拉流与告警联动展示。
---
##### 4.2.4.2 点位列表与多画面播放
**需求编号**：REQ-F-011
**优先级**：P0
**需求描述**：列表显示接入点位，支持 4 画面播放实时视频。
**输入**：点位筛选、选中的 1～4 路点位。
**处理**：列表查询、多路实时流拉取与渲染。
**输出**：点位列表与多画面实时视频。
**业务规则**：仅展示用户有权限的点位。
**性能要求**：多路同时播放不卡顿。
**业务流程**：① 用户进入视频中心，系统按权限展示点位列表（可筛选）；② 用户选择 1～4 路点位；③ 系统并发拉取多路实时流并在多画面区域渲染播放；④ 用户可切换选中的点位或布局。
---
##### 4.2.4.3 录像下载
**需求编号**：REQ-F-012
**优先级**：P1
**需求描述**：支持下载实时流某时间段的录像，满足取证、归档与审计需求。
**输入**：点位、时间段。
**处理**：按时间段截取/录制并生成可下载文件。
**输出**：录像文件。
**业务规则**：可限制单次时长与并发下载数。
**性能要求**：生成与下载在合理时间内完成。
**业务流程**：① 用户选择点位并设置时间段；② 系统校验单次时长与并发下载限制；③ 系统按时间段从实时流截取/录制或从录像服务获取并生成可下载文件；④ 用户触发下载，浏览器下载录像文件。
#### 4.2.5 AI 安防应用
##### 4.2.5.1 高空抛物检测
**需求编号**：REQ-F-013
**优先级**：P0
**需求描述**：支撑楼宇定制场景的高空抛物检测算法，对楼宇周边/窗户等区域监测，识别高空抛物行为并产生告警。
**输入**：视频流、算法参数与检测区域。
**处理**：运行高空抛物检测算法，输出告警事件。
**输出**：告警记录（时间、位置、抓拍等）。
**业务规则**：楼宇场景定制算法。
**性能要求**：满足实时或准实时分析要求。
**业务流程**：① 通道绑定高空抛物检测算法并配置检测区域（如楼宇周边/窗户）；② 算法任务拉流并对画面进行实时/准实时分析；③ 识别到高空抛物行为时产生告警事件；④ 告警写入事件库并推送展示，含时间、位置、抓拍图等。
---
##### 4.2.5.2 电动车入楼检测
**需求编号**：REQ-F-014
**优先级**：P0
**需求描述**：支撑电动车/电瓶车进电梯等入楼场景检测，识别电动车进入电梯、楼道等禁入区域并产生告警，支持与梯控等联动。
**输入**：视频流、算法参数。
**处理**：运行电动车入楼检测算法，输出告警并可触发联动。
**输出**：告警记录及联动信号（若配置）。
**业务规则**：楼宇场景定制算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 通道（如电梯、楼道）绑定电动车入楼检测算法；② 算法任务拉流并实时分析；③ 识别到电动车进入禁入区域时产生告警；④ 告警写入事件库；⑤ 若配置梯控等联动，系统向联动接口发送信号。
---
##### 4.2.5.3 火焰检测
**需求编号**：REQ-F-015
**优先级**：P0
**需求描述**：支撑火焰检测场景，对监控画面中的明火、烟雾进行识别并产生告警，适用于消防重点区域。
**输入**：视频流、算法参数。
**处理**：运行火焰/烟雾检测算法。
**输出**：告警记录。
**业务规则**：标准算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 消防重点区域通道绑定火焰检测算法；② 算法拉流并实时识别明火、烟雾；③ 检测到明火或烟雾时产生告警；④ 告警写入事件库并推送展示。
---
##### 4.2.5.4 通道阻塞检测
**需求编号**：REQ-F-016
**优先级**：P0
**需求描述**：支撑堵塞通道场景，识别消防通道、安全出口、楼道等被杂物或车辆堵塞并产生告警。
**输入**：视频流、算法参数与检测区域。
**处理**：运行通道阻塞检测算法。
**输出**：告警记录。
**业务规则**：标准算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 通道绑定通道阻塞检测算法并配置检测区域（消防通道、安全出口、楼道等）；② 算法拉流并分析；③ 识别到杂物或车辆堵塞时产生告警；④ 告警写入事件库并推送。
---
##### 4.2.5.5 吸烟检测
**需求编号**：REQ-F-017
**优先级**：P0
**需求描述**：在禁烟区域识别吸烟行为并产生告警，适用于仓库、机房、公共场所等禁烟区域。
**输入**：视频流、算法参数。
**处理**：运行吸烟检测算法。
**输出**：告警记录。
**业务规则**：标准算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 禁烟区域通道绑定吸烟检测算法；② 算法拉流并识别吸烟行为；③ 识别到吸烟时产生告警；④ 告警写入事件库并推送。
---
##### 4.2.5.6 人群聚集检测
**需求编号**：REQ-F-018
**优先级**：P0
**需求描述**：识别指定区域内人员异常聚集并产生告警，支持人数阈值与区域配置，适用于疫情防控、秩序管理。
**输入**：视频流、算法参数、人数阈值与区域。
**处理**：运行人群聚集检测算法。
**输出**：告警记录。
**业务规则**：标准算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 通道绑定人群聚集检测算法，配置检测区域与人数阈值；② 算法拉流并分析区域内人数；③ 超过阈值时产生告警；④ 告警写入事件库并推送。
---
##### 4.2.5.7 机动车乱停放检测
**需求编号**：REQ-F-019
**优先级**：P1
**需求描述**：识别禁停区域的机动车违停行为并产生告警，可通过扩展算法或与现有能力组合实现。
**输入**：视频流、算法参数与禁停区域。
**处理**：运行机动车乱停放检测算法。
**输出**：告警记录。
**业务规则**：标准/扩展算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 通道绑定机动车乱停放检测算法并配置禁停区域；② 算法拉流并识别机动车违停；③ 识别到违停时产生告警；④ 告警写入事件库并推送。
---
##### 4.2.5.8 人员跨线检测
**需求编号**：REQ-F-020
**优先级**：P1
**需求描述**：在划定区域内识别人员跨线（越界）行为并产生告警，可通过扩展算法或与现有能力组合实现。
**输入**：视频流、算法参数与标识线/区域。
**处理**：运行人员跨线检测算法。
**输出**：告警记录。
**业务规则**：标准/扩展算法。
**性能要求**：满足实时分析要求。
**业务流程**：① 通道绑定人员跨线检测算法并绘制标识线/区域；② 算法拉流并识别人员跨线（越界）行为；③ 识别到跨线时产生告警；④ 告警写入事件库并推送。
### 4.3 算法中心
#### 4.3.1 功能描述
- **功能概述**：对视频 AI 算法进行统一管理、配置与调度，包含算法调用概览、算法参数配置、算法调度、算法轮询及第三方对接。
- **功能目标**：将设备通道与算法能力关联，通过任务调度与轮询策略在有限算力下支撑多路视频分析，并实现南向取流与北向告警推送。
- **业务价值**：算法与参数统一管理、通道级/预置点级绑定与图形绘制、任务调度与轮询策略完善、南向北向对接规范。
#### 4.3.2 算法调用概览
##### 4.3.2.1 算法列表展示
**需求编号**：REQ-F-021
**优先级**：P0
**需求描述**：展示已授权算法列表（图标、中英文名称），支持按算法名称模糊检索。
**输入**：检索关键词。
**处理**：查询已授权算法并筛选。
**输出**：算法列表。
**业务规则**：仅展示已授权算法。
**性能要求**：列表与检索响应及时。
**业务流程**：① 用户进入算法调用概览页，系统加载已授权算法列表（图标、中英文名称）；② 用户输入算法名称关键词；③ 系统按名称模糊检索并刷新列表；④ 用户从列表中选择算法进行后续参数查阅或配置。
---
##### 4.3.2.2 查阅算法参数
**需求编号**：REQ-F-022
**优先级**：P0
**需求描述**：支持查阅每个已授权算法的参数，包括通用配置、算法参数、高级参数。
**输入**：算法标识。
**处理**：读取该算法参数定义与当前值。
**输出**：参数项与取值展示。
**业务规则**：无。
**性能要求**：页面加载正常。
**业务流程**：① 用户在算法列表中选择某算法；② 系统加载该算法的参数定义与当前值；③ 按通用配置、算法参数、高级参数分组展示；④ 用户可据此评估并进入统一修改或模板管理。
---
##### 4.3.2.3 算法参数统一修改与同步
**需求编号**：REQ-F-023
**优先级**：P0
**需求描述**：对算法参数进行统一修改，修改后支持批量同步到已配置该算法的所有任务。
**输入**：算法标识、修改后的参数、同步范围。
**处理**：更新算法级参数并下发至关联任务。
**输出**：修改与同步结果。
**业务规则**：同步后任务需按策略重启或刷新。
**性能要求**：批量同步在合理时间内完成。
**业务流程**：① 用户在算法参数页修改该算法的参数；② 用户选择“同步到已配置该算法的所有任务”；③ 系统将算法级参数下发至所有关联任务；④ 按策略刷新任务参数或重启任务；⑤ 返回同步成功/失败数量。
---
##### 4.3.2.4 查询算法配置视频数
**需求编号**：REQ-F-024
**优先级**：P1
**需求描述**：支持查询每个算法已配置的视频/通道数量，便于容量与授权管理。
**输入**：算法标识或全部。
**处理**：统计绑定该算法的通道/任务数。
**输出**：数量展示。
**业务规则**：无。
**性能要求**：统计结果准确、响应快。
**业务流程**：① 用户在算法调用概览中选择某算法（或查看全部）；② 系统统计该算法已配置的视频/通道数量；③ 在列表或详情中展示数量；④ 便于容量与授权管理。
---
##### 4.3.2.5 算法参数模板管理
**需求编号**：REQ-F-025
**优先级**：P0
**需求描述**：支持默认配置模板、新增/删除/修改配置模板名称；同一算法可维护多套参数模板，供不同场景按需加载。
**输入**：模板名称、参数内容、新增/删除/修改操作。
**处理**：维护模板与算法关联，校验删除条件。
**输出**：模板列表与操作结果。
**业务规则**：默认配置模板不可删除；已应用于前端设备的模板需先解除应用后再删除；模板名称限中文/英文/数字、长度 20 字符。
**性能要求**：增删改查响应及时。
**业务流程**：① 新增：用户选择算法后新增配置模板，输入模板名称（≤20 字符，中文/英文/数字）并保存参数；② 修改：用户修改模板名称或参数内容并保存；③ 删除：用户选择模板删除，系统校验未应用于前端设备，否则提示先解除应用；默认模板不可删除；④ 同一算法可维护多套模板供不同场景加载。
---
##### 4.3.2.6 能力批量应用
**需求编号**：REQ-F-026
**优先级**：P0
**需求描述**：将选定参数模板批量应用于所选通道（枪机/球机）；球机应用时覆盖所有预置点。
**输入**：模板、通道/预置点选择。
**处理**：将模板参数下发至选中通道或球机所有预置点。
**输出**：成功/失败数量。
**业务规则**：球机覆盖所有预置点。
**性能要求**：大批量应用可分批或异步执行。
**业务流程**：① 用户选择某算法的参数模板；② 在通道列表中选择目标通道（枪机/球机，可多选）；③ 用户确认批量应用；④ 系统将模板参数下发至所选通道；球机应用时覆盖该通道下所有预置点；⑤ 返回成功/失败数量，大批量时可分批或异步执行。
---
##### 4.3.2.7 恢复默认配置
**需求编号**：REQ-F-027
**优先级**：P1
**需求描述**：将当前算法参数恢复为算法初始默认配置。
**输入**：算法标识、确认操作。
**处理**：重置为默认参数。
**输出**：恢复结果。
**业务规则**：仅影响当前算法配置视图，是否同步到任务可配置。
**性能要求**：即时生效。
**业务流程**：① 用户在算法参数页选择“恢复默认配置”；② 系统弹窗确认；③ 系统将该算法参数重置为算法初始默认值；④ 用户可选择是否同步到已配置该算法的任务；⑤ 返回恢复结果。
#### 4.3.3 算法参数配置
##### 4.3.3.1 通道列表展示与筛选
**需求编号**：REQ-F-028
**优先级**：P0
**需求描述**：以相机列表形式按通道展示，支持按组织节点树筛选；列表展示设备名称、编码、IP/域名、类型、接入协议、所属组织；支持分页（10/20/30/40/50 条）。
**输入**：组织节点、分页参数。
**处理**：按组织与权限查询通道并分页。
**输出**：通道列表。
**业务规则**：展示范围受组织与权限控制。
**性能要求**：分页与筛选响应及时。
**业务流程**：① 用户进入算法参数配置页，按组织节点树筛选（可选）；② 系统按用户权限查询通道，以相机列表形式展示设备名称、编码、IP/域名、类型、接入协议、所属组织；③ 用户设置分页（10/20/30/40/50 条）并浏览；④ 用户可点击通道进入基础信息或算法绑定。
---
##### 4.3.3.2 通道导出
**需求编号**：REQ-F-029
**优先级**：P1
**需求描述**：支持对已选通道导出为 Excel；导出前弹窗二次确认；文件名格式为“通道数据+年月日时分秒”。
**输入**：已选通道、确认。
**处理**：生成 Excel 并触发下载。
**输出**：Excel 文件。
**业务规则**：文件名格式固定。
**性能要求**：大量通道导出可异步。
**业务流程**：① 用户在通道列表中勾选要导出的通道；② 用户点击导出，系统弹窗二次确认；③ 用户确认后，系统生成 Excel，文件名格式为“通道数据+年月日时分秒”；④ 触发下载；大量通道时可异步生成并通知下载。
---
##### 4.3.3.3 通道基础信息管理
**需求编号**：REQ-F-030
**优先级**：P0
**需求描述**：支持编辑通道名称、选择通道类型（枪机/球机）、选择所属组织节点、录入经纬度（地图拾取或手动）、录入安装高度、展示已绑定算法、支持实时预览；所属组织可选设备所在组织及下级组织。
**输入**：通道标识、各项编辑内容。
**处理**：校验并保存，实时预览拉流展示。
**输出**：保存结果、预览画面。
**业务规则**：所属组织可选设备所在组织及下级组织。
**性能要求**：保存与预览响应正常。
**业务流程**：① 用户选择通道并进入基础信息编辑；② 编辑通道名称、类型（枪机/球机）、所属组织（可选设备所在组织及下级）、经纬度（地图拾取或手动）、安装高度、备注等；③ 用户可点击实时预览查看当前画面；④ 保存后系统更新通道信息，所属组织仅能从设备所在组织及下级中选择。
---
##### 4.3.3.4 通道算法绑定
**需求编号**：REQ-F-031
**优先级**：P0
**需求描述**：按通道/预置点绑定已授权算法；每路视频流支持不少于 2 个算法任务；支持预置点分别绑定、已授权算法选择、首预置点配置继承至其他预置点；支持单通道算法参数与显示配置（警戒框/忽略框/标识线）；同一通道多预置点可按预置点分别配置；球机支持预置点切换与任务联动。
**输入**：通道/预置点、算法选择、参数与显示配置。
**处理**：保存绑定关系并创建/更新任务。
**输出**：绑定与任务创建结果。
**业务规则**：每路不少于 2 个算法任务；球机预置点可分别配置并联动。
**性能要求**：绑定与任务创建及时。
**业务流程**：① 用户选择通道/预置点，从已授权算法中选择算法并配置参数与显示项（警戒框/忽略框/标识线）；② 每路视频流至少绑定 2 个算法；球机可对首预置点配置后继承至其他预置点，也可按预置点分别配置；③ 保存后系统创建或更新任务，球机预置点切换时任务联动；④ 返回绑定与任务创建结果。
---
##### 4.3.3.5 警戒框/忽略框/标识线绘制
**需求编号**：REQ-F-032
**优先级**：P0
**需求描述**：在实时流上绘制警戒框（算法生效区域）、忽略框（屏蔽区域内目标）、标识线（仅显示）；支持清空全部图形、按绘制顺序撤销上一步；通过点击起点、中间节点、双击结束节点完成绘制。
**输入**：绘制类型、鼠标点击序列。
**处理**：在视频坐标系下记录多边形/线并保存。
**输出**：图形数据与画面叠加显示。
**业务规则**：警戒框/忽略框/标识线通过点击起点、中间节点、双击结束节点完成绘制。
**性能要求**：绘制与撤销即时响应。
**业务流程**：① 用户在通道算法配置页打开实时流；② 选择绘制类型（警戒框/忽略框/标识线）；③ 在画面上点击起点、中间节点、双击结束节点完成绘制；④ 可清空全部或按顺序撤销上一步；⑤ 图形数据保存并与算法参数关联，在分析时生效。
---
##### 4.3.3.6 配置任务概览
**需求编号**：REQ-F-033
**优先级**：P0
**需求描述**：以相机列表形式展示每个点位运行的任务，包括相机名称、抓拍图、配置状态、关联相机；支持查看算法名称、创建时间、任务状态等任务概览信息。
**输入**：组织/通道筛选。
**处理**：查询任务与通道、算法关联。
**输出**：任务概览列表。
**业务规则**：无。
**性能要求**：列表加载及时。
**业务流程**：① 用户进入配置任务概览页，按组织/通道筛选（可选）；② 系统以相机列表形式展示每个点位的任务，含相机名称、抓拍图、配置状态、关联相机；③ 用户点击某点位可查看算法名称、创建时间、任务状态等任务概览信息；④ 便于掌握各点位任务配置与运行状态。
---
##### 4.3.3.7 离线视频上传与验证
**需求编号**：REQ-F-034
**优先级**：P1
**需求描述**：支持上传离线视频、为离线视频配置算法场景、提交分析并查看验证结果，便于算法选型与参数调优验证。
**输入**：视频文件、算法场景与参数。
**处理**：上传存储、调度分析、结果展示。
**输出**：分析结果与告警预览。
**业务规则**：不占用实时流资源。
**性能要求**：上传与分析在合理时间内完成。
**业务流程**：① 用户上传离线视频文件；② 为离线视频选择算法场景并配置参数；③ 用户提交分析；④ 系统调度分析任务（不占用实时流）；⑤ 分析完成后展示验证结果与告警预览，便于算法选型与参数调优。
#### 4.3.4 算法调度
##### 4.3.4.1 任务绑定与更新
**需求编号**：REQ-F-035
**优先级**：P0
**需求描述**：通道/预置点绑定能力时自动创建或更新任务；能力配置或流地址变更时支持刷新任务参数并自动重启任务。
**输入**：绑定/变更操作。
**处理**：创建或更新任务记录，刷新参数并触发重启。
**输出**：任务状态更新。
**业务规则**：任务与配置、流地址保持一致。
**性能要求**：自动创建/更新与重启及时。
**业务流程**：① 通道/预置点绑定能力时，系统自动创建或更新对应任务；② 能力配置或流地址变更时，用户或系统触发刷新任务参数；③ 系统刷新任务参数并自动重启任务；④ 任务状态更新，保证任务与配置、流地址一致。
---
##### 4.3.4.2 任务查询
**需求编号**：REQ-F-036
**优先级**：P0
**需求描述**：在任务管理页面按条件查询任务数据，查看任务与通道/预置点、算法、状态的对应关系。
**输入**：筛选条件。
**处理**：查询任务及关联信息。
**输出**：任务列表。
**业务规则**：无。
**性能要求**：查询响应及时。
**业务流程**：① 用户进入任务管理页，设置筛选条件（通道/预置点、算法、状态等）；② 用户点击查询；③ 系统返回任务及与通道/预置点、算法、状态的对应关系；④ 列表展示任务数据，便于运维排查与容量查看。
---
##### 4.3.4.3 任务启停控制
**需求编号**：REQ-F-037
**优先级**：P0
**需求描述**：支持云台锁与任务启停联动（启云台锁时停止对应任务，关云台锁时启动任务）；任务管理页面支持手动启动、暂停、重启、终止任务。
**输入**：云台锁状态或手动启停/暂停/重启/终止操作。
**处理**：更新任务状态并通知调度与算法实例。
**输出**：任务状态变更结果。
**业务规则**：云台锁与任务联动规则固定。
**性能要求**：控制指令及时生效。
**业务流程**：① 云台锁联动：用户开启云台锁时，系统自动停止对应任务；关闭云台锁时自动启动任务；② 手动控制：用户在任务管理页选择任务，执行启动、暂停、重启或终止；③ 系统更新任务状态并通知调度与算法实例；④ 返回状态变更结果。
---
##### 4.3.4.4 任务日志查询
**需求编号**：REQ-F-038
**优先级**：P1
**需求描述**：任务状态变更时记录任务日志；任务管理页面提供任务日志查询功能。
**输入**：任务标识、时间范围等筛选。
**处理**：记录状态变更，查询日志。
**输出**：日志列表。
**业务规则**：关键状态变更均需记录。
**性能要求**：查询与分页正常。
**业务流程**：① 任务状态变更（创建、启动、暂停、重启、终止等）时，系统自动记录任务日志；② 用户在任务管理页进入任务日志查询，按任务标识、时间范围等筛选；③ 系统返回日志列表并分页展示；④ 便于问题回溯与审计。
---
##### 4.3.4.5 并发路数配置
**需求编号**：REQ-F-039
**优先级**：P0
**需求描述**：支持设置租户下可同时运行的并发路数上限；超过上限时按策略停止部分任务；并发超限时可按“运行最久优先停止”等策略停止任务。
**输入**：租户、并发路数上限、停止策略。
**处理**：调度器按上限与策略分配与回收任务。
**输出**：配置生效，超限时自动停任务。
**业务规则**：并发超限时按策略停止任务。
**性能要求**：策略执行及时。
**业务流程**：① 管理员为租户设置可同时运行的并发路数上限及超限停止策略（如运行最久优先停止）；② 保存配置；③ 调度器在分配任务时检查当前并发路数；④ 超过上限时按策略停止部分任务，释放资源；⑤ 新任务可被调度至空闲实例。
---
##### 4.3.4.6 无告警分析时长配置
**需求编号**：REQ-F-040
**优先级**：P0
**需求描述**：支持配置无告警分析时长，控制单任务/预置点运行时长及轮询让出策略；预置点任务可配置收到告警即停止让出资源。
**输入**：任务/预置点、无告警时长、是否告警即停。
**处理**：调度器按时长与告警事件决定是否让出。
**输出**：配置生效。
**业务规则**：预置点可配置告警即停。
**性能要求**：时长与事件判断准确。
**业务流程**：① 用户为任务/预置点配置无告警分析时长；② 预置点任务可勾选“收到告警即停止让出资源”；③ 保存配置；④ 调度器在运行中按时长与告警事件判断是否让出资源；⑤ 让出后该任务/预置点释放实例，其他任务可被调度。
#### 4.3.5 算法轮询
##### 4.3.5.1 启动调度
**需求编号**：REQ-F-041
**优先级**：P0
**需求描述**：预置点任务按配置的分析时间段及预置点 ID 顺序调度；普通任务按上次分析完成时间优先级调度；支持预置点切换并将视频流与能力参数下发算法进行拉流分析。
**输入**：调度策略、任务列表、算法实例列表。
**处理**：按策略选择任务，下发流与参数到算法实例。
**输出**：任务运行状态。
**业务规则**：预置点按时间段与 ID 顺序；普通任务按完成时间优先级。
**性能要求**：调度决策与下发及时。
**业务流程**：① 调度器根据并发路数等约束选择待运行任务；② 预置点任务按配置的分析时间段及预置点 ID 顺序调度；普通任务按上次分析完成时间优先级调度；③ 预置点任务需切换预置点并将视频流与能力参数下发算法；④ 算法实例拉流并分析；⑤ 任务进入运行状态。
---
##### 4.3.5.2 停止调度
**需求编号**：REQ-F-042
**优先级**：P0
**需求描述**：按并发路数、无告警分析时长、产生告警等策略停止轮询任务，释放资源给其他任务。
**输入**：策略触发条件。
**处理**：停止当前任务、释放实例资源。
**输出**：任务停止、资源释放。
**业务规则**：与 F2.19、F2.20 策略一致。
**性能要求**：停止与释放及时。
**业务流程**：① 当并发路数超限、无告警分析时长到达或预置点任务产生告警且配置告警即停时，调度器触发停止；② 调度器向算法实例发送停止指令；③ 任务停止，实例释放资源；④ 释放的资源可被其他待调度任务使用。
---
##### 4.3.5.3 调度负载均衡
**需求编号**：REQ-F-043
**优先级**：P0
**需求描述**：在多台算法实例时，优先将同一路相机算法下发到同一台算法实例；均衡各算法实例下发的任务对应相机路数。
**输入**：任务队列、算法实例状态。
**处理**：负载均衡算法分配任务到实例。
**输出**：任务—实例分配结果。
**业务规则**：同路相机优先同实例；均衡路数。
**性能要求**：分配结果合理、稳定。
**业务流程**：① 调度器在有多台算法实例时，对待下发任务进行分配；② 优先将同一路相机的多个算法任务下发到同一台算法实例；③ 在满足上述前提下均衡各实例下发的任务对应相机路数；④ 将任务下发至选定实例，保证负载均衡与稳定性。
---
##### 4.3.5.4 任务同步
**需求编号**：REQ-F-044
**优先级**：P0
**需求描述**：定时同步算法实例与任务调度的任务数据，保证数据最终一致性。
**输入**：定时触发或事件触发。
**处理**：与算法实例对账任务状态与结果。
**输出**：本地任务数据更新。
**业务规则**：最终一致性。
**性能要求**：同步周期与延迟可配置。
**业务流程**：① 调度器按配置周期或事件触发任务同步；② 与各算法实例对账任务状态与结果；③ 将实例侧任务数据与调度侧比对并更新；④ 保证任务调度与实例侧数据最终一致，避免状态不一致。
#### 4.3.6 第三方对接
##### 4.3.6.1 南向视频流对接
**需求编号**：REQ-F-045
**优先级**：P0
**需求描述**：支持 RTSP、GB/T28181 等协议与园区视频监控汇聚平台对接，获取视频流数据供算法分析。
**输入**：平台地址、协议类型、通道/流地址与鉴权。
**处理**：按协议拉流并供算法使用。
**输出**：稳定视频流。
**业务规则**：协议与平台能力匹配。
**性能要求**：取流稳定、延迟可接受。
**业务流程**：① 系统配置园区视频监控汇聚平台地址、协议类型（RTSP/GB/T28181 等）及通道/流地址与鉴权；② 算法任务或取流服务按协议向平台请求视频流；③ 平台返回视频流数据；④ 系统将视频流供算法分析使用，保证取流稳定与延迟可接受。
---
##### 4.3.6.2 北向告警与数据推送
**需求编号**：REQ-F-046
**优先级**：P0
**需求描述**：支持与智慧园区管理平台对接，推送视频 AI 分析告警事件信息及客流等统计数据；提供解析任务控制、解析任务运行状态、事件告警推送、事件告警查询等对外服务接口；接口采用 JSON、RESTful，HTTP/HTTPS 传输，数据加密与签名。
**输入**：告警事件、统计数据、平台调用请求。
**处理**：按接口规范推送与响应。
**输出**：推送结果、查询响应。
**业务规则**：JSON、RESTful，HTTP/HTTPS，数据加密与签名。
**性能要求**：推送及时、接口响应满足 SLA。
**业务流程**：① 告警与数据推送：系统产生告警事件或统计数据后，按约定格式（JSON、加密与签名）通过 HTTP/HTTPS 推送至智慧园区管理平台；② 对外服务：平台调用解析任务控制、解析任务运行状态、事件告警推送、事件告警查询等接口时，系统按 RESTful 规范校验、处理并返回响应；③ 保证推送及时与接口 SLA。
### 4.4 设备管理
#### 4.4.1 功能描述
- **功能概述**：对安防摄像头设备及其视频通道进行统一接入与维护，包含设备管理与通道管理。
- **功能目标**：为算法中心提供稳定的设备与通道数据基础，支撑按组织筛选与权限划分、球机预置点与流地址配置。
- **业务价值**：设备统一接入与状态监控、通道与组织关联清晰、球机预置点管理支撑轮询分析。
#### 4.4.2 设备管理
##### 4.4.2.1 安防摄像头设备列表
**需求编号**：REQ-F-047
**优先级**：P0
**需求描述**：以设备列表形式展示已接入的安防摄像头；支持按组织节点、设备类型、在线状态筛选；展示设备名称、编码、IP/域名、型号、厂商、接入协议、所属组织、最后心跳时间。
**输入**：筛选条件、分页。
**处理**：查询设备并过滤。
**输出**：设备列表。
**业务规则**：无。
**性能要求**：列表与筛选响应及时。
**业务流程**：① 用户进入设备管理页，设置筛选条件（组织节点、设备类型、在线状态）及分页；② 系统查询已接入设备并过滤；③ 列表展示设备名称、编码、IP/域名、型号、厂商、接入协议、所属组织、最后心跳时间；④ 用户可点击设备进入详情或通道管理。
---
##### 4.4.2.2 设备添加与接入
**需求编号**：REQ-F-048
**优先级**：P0
**需求描述**：支持手动添加安防摄像头设备（录入 IP/域名、端口、协议类型、认证信息）；支持通过 GB/T28181、ONVIF 等协议自动发现与批量接入；同一设备不可重复接入。
**输入**：单设备信息或协议发现参数。
**处理**：校验唯一性、接入并拉取基础信息与通道。
**输出**：接入成功/失败及设备与通道列表。
**业务规则**：同一设备不可重复接入。
**性能要求**：发现与接入在合理时间内完成。
**业务流程**：① 手动添加：用户录入 IP/域名、端口、协议类型、认证信息，系统校验唯一性后接入并拉取基础信息与通道列表；② 自动发现：用户选择 GB/T28181 或 ONVIF 等协议并执行发现，系统扫描并列出可接入设备，用户选择设备批量接入；③ 同一设备不可重复接入；④ 返回接入结果及设备与通道列表。
---
##### 4.4.2.3 设备基础信息维护
**需求编号**：REQ-F-049
**优先级**：P0
**需求描述**：支持编辑设备名称、所属组织、安装位置、备注；支持启用/停用设备，停用后该设备及其通道不参与算法任务与展示。
**输入**：设备标识、编辑内容、启用/停用操作。
**处理**：更新设备信息与状态。
**输出**：保存结果。
**业务规则**：停用后不参与任务与展示。
**性能要求**：保存即时生效。
**业务流程**：① 用户选择设备并进入基础信息编辑；② 编辑设备名称、所属组织、安装位置、备注；③ 用户可启用/停用设备；④ 保存后系统更新设备信息与状态；⑤ 停用后该设备及其通道不参与算法任务与展示。
---
##### 4.4.2.4 设备状态与诊断
**需求编号**：REQ-F-050
**优先级**：P0
**需求描述**：展示设备在线/离线状态、网络延迟、码流信息；支持对设备进行连通性检测、取流测试。
**输入**：设备标识、诊断操作。
**处理**：心跳与探测、取流测试。
**输出**：状态信息与诊断结果。
**业务规则**：无。
**性能要求**：诊断结果准确、响应及时。
**业务流程**：① 用户进入设备详情或列表，系统展示设备在线/离线状态、网络延迟、码流信息；② 用户点击连通性检测，系统对设备进行 ping 或协议探测并返回结果；③ 用户点击取流测试，系统按配置拉流并返回成功/失败及码流信息；④ 便于排查接入与拉流问题。
---
##### 4.4.2.5 设备删除与解绑
**需求编号**：REQ-F-051
**优先级**：P0
**需求描述**：支持将设备从平台解绑删除；删除前校验是否有关联算法任务或告警数据，有关联时需先解除任务或做数据迁移后再删除。
**输入**：设备标识、确认删除。
**处理**：校验关联、执行删除。
**输出**：删除结果或校验失败提示。
**业务规则**：有关联任务或告警时禁止直接删除或提示先处理。
**性能要求**：校验与删除及时。
**业务流程**：① 用户选择设备并点击删除/解绑；② 系统校验是否有关联算法任务或告警数据；③ 有关联时提示需先解除任务或做数据迁移，禁止直接删除；④ 无关联时弹窗二次确认；⑤ 用户确认后系统执行删除，返回结果。
#### 4.4.3 通道管理
##### 4.4.3.1 通道列表与筛选
**需求编号**：REQ-F-052
**优先级**：P0
**需求描述**：以通道维度展示安防摄像头视频通道；支持按设备、组织、通道名称、类型（枪机/球机）筛选；展示通道名称、所属设备、通道编号、分辨率、码流地址、绑定算法数。
**输入**：筛选条件、分页。
**处理**：查询通道及绑定统计。
**输出**：通道列表。
**业务规则**：无。
**性能要求**：列表与筛选响应及时。
**业务流程**：① 用户进入通道管理页，设置筛选条件（设备、组织、通道名称、类型（枪机/球机））及分页；② 系统查询通道及绑定算法数；③ 列表展示通道名称、所属设备、通道编号、分辨率、码流地址、绑定算法数；④ 用户可点击通道进入详情或算法配置。
---
##### 4.4.3.2 通道与设备关联
**需求编号**：REQ-F-053
**优先级**：P0
**需求描述**：设备接入后自动拉取或手动同步其通道列表；支持通道与设备的一对多关系维护（一设备多通道）；支持通道启用/停用。
**输入**：设备标识、同步操作、通道启用/停用。
**处理**：拉取或同步通道、更新启用状态。
**输出**：通道列表与状态。
**业务规则**：一设备多通道。
**性能要求**：同步与状态更新及时。
**业务流程**：① 设备接入后系统自动拉取该设备通道列表，或用户手动触发同步；② 系统维护通道与设备的一对多关系（一设备多通道）；③ 用户可对单条通道执行启用/停用；④ 启用/停用后通道状态更新，停用通道不参与任务与展示。
---
##### 4.4.3.3 通道流地址与协议
**需求编号**：REQ-F-054
**优先级**：P0
**需求描述**：支持查看与配置通道的主/子码流地址（RTSP/GB28181 等）；支持按通道配置取流参数（协议、端口、鉴权），供算法拉流使用。
**输入**：通道标识、流地址与参数。
**处理**：校验并保存，供调度与取流使用。
**输出**：配置结果。
**业务规则**：与南向对接协议一致。
**性能要求**：配置保存即时生效。
**业务流程**：① 用户选择通道并进入流地址与协议配置；② 查看或配置主/子码流地址（RTSP/GB28181 等）及取流参数（协议、端口、鉴权）；③ 保存后系统更新配置；④ 配置供算法拉流使用，与南向对接协议一致。
---
##### 4.4.3.4 球机预置点管理
**需求编号**：REQ-F-055
**优先级**：P0
**需求描述**：对球机类设备的预置点进行维护；支持预置点列表展示、预置点添加/编辑/删除、预置点与算法任务绑定，支撑球机轮询分析；仅球机类型通道显示预置点管理。
**输入**：通道标识（球机）、预置点信息、绑定关系。
**处理**：维护预置点及与任务绑定。
**输出**：预置点列表与操作结果。
**业务规则**：仅球机显示预置点管理。
**性能要求**：增删改查响应及时。
**业务流程**：① 仅球机类型通道显示预置点管理入口；② 用户进入预置点列表，可新增、编辑、删除预置点；③ 预置点可与算法任务绑定，支撑球机轮询分析；④ 保存后预置点列表与绑定关系更新；⑤ 返回操作结果。
---
##### 4.4.3.5 通道与组织归属
**需求编号**：REQ-F-056
**优先级**：P0
**需求描述**：支持将通道归属到组织节点下，便于按组织进行权限划分、任务配置与告警统计；支持批量修改通道所属组织；归属组织可选设备所在组织及下级组织。
**输入**：通道选择、目标组织、批量修改。
**处理**：更新通道所属组织。
**输出**：保存结果。
**业务规则**：归属组织可选设备所在组织及下级组织。
**性能要求**：批量修改在合理时间内完成。
**业务流程**：① 用户选择通道（可多选）并进入组织归属配置；② 选择目标组织节点（仅可选设备所在组织及下级组织）；③ 保存后系统批量更新通道所属组织；④ 便于按组织进行权限划分、任务配置与告警统计。
### 4.5 系统管理
#### 4.5.1 功能描述
- **功能概述**：对组织、权限、菜单、日志及运维监控进行统一管理，包含部门管理、权限管理、菜单管理、日志管理、运维管理与智能运维。
- **功能目标**：提供组织与权限基础、操作可追溯性及运行状态可视，支撑多租户/多组织使用与日常运维保障。
- **业务价值**：组织树与权限范围清晰、角色与用户管理完善、菜单可配置、操作日志完整、组件与资源及告警监控、智能运维资源分析。
#### 4.5.2 部门管理
##### 4.5.2.1 场所/组织管理
**需求编号**：REQ-F-057
**优先级**：P0
**需求描述**：对分析摄像机点位所在场所（区域）进行管理；支持用户自定义场所与组织节点，用于组织树与权限范围，为设备归属、告警统计、权限划分提供组织维度基础。
**输入**：组织/场所名称、层级、父节点。
**处理**：维护组织树。
**输出**：组织树结构。
**业务规则**：无。
**性能要求**：树形展示与编辑响应及时。
**业务流程**：① 用户进入部门/场所管理页，系统展示组织树；② 用户可新增、编辑、删除组织节点（删除时校验是否有关联设备/用户）；③ 设置节点名称、父节点与层级；④ 保存后组织树更新，用于设备归属、告警统计与权限划分。
#### 4.5.3 权限管理
##### 4.5.3.1 角色管理
**需求编号**：REQ-F-058
**优先级**：P0
**需求描述**：支持新增、修改、删除角色；具备权限分级与审查体系，禁止越权操作。
**输入**：角色名称、权限范围。
**处理**：维护角色与权限绑定。
**输出**：角色列表与操作结果。
**业务规则**：权限分级与审查，禁止越权。
**性能要求**：增删改查响应及时。
**业务流程**：① 管理员进入角色管理页，可新增、修改、删除角色；② 为角色配置权限范围（菜单、功能、组织范围等），具备权限分级与审查体系；③ 保存后角色与权限绑定生效；④ 用户仅能执行其角色权限内的操作，禁止越权。
---
##### 4.5.3.2 用户账号管理
**需求编号**：REQ-F-059
**优先级**：P0
**需求描述**：支持为用户账户分配角色、修改信息、修改密码、启用/禁用账户。
**输入**：用户信息、角色、状态操作。
**处理**：维护用户与角色、状态。
**输出**：用户列表与操作结果。
**业务规则**：无。
**性能要求**：操作即时生效。
**业务流程**：① 管理员进入用户账号管理页，可新增用户或选择已有用户；② 为用户分配角色、修改基本信息、修改密码、启用/禁用账户；③ 保存后用户与角色绑定及账号状态更新；④ 禁用后该用户无法登录，启用后可正常登录并享有角色权限。
#### 4.5.4 菜单管理
##### 4.5.4.1 菜单配置
**需求编号**：REQ-F-060
**优先级**：P0
**需求描述**：对系统首页菜单与子菜单进行配置管理，使菜单结构、名称与权限可控。
**输入**：菜单名称、层级、图标、权限、排序。
**处理**：维护菜单树与权限关联。
**输出**：菜单配置结果。
**业务规则**：菜单与权限一致，不同角色可见不同菜单。
**性能要求**：配置保存即时生效。
**业务流程**：① 管理员进入菜单配置页，系统展示首页菜单与子菜单树；② 可新增、编辑、删除菜单项，设置菜单名称、层级、图标、关联权限、排序；③ 保存后菜单树与权限关联更新；④ 用户登录后根据角色权限展示可见菜单，不同角色可见不同菜单。
#### 4.5.5 日志管理
##### 4.5.5.1 操作日志
**需求编号**：REQ-F-061
**优先级**：P0
**需求描述**：记录所有用户在本系统上的操作，以列表形式提供概览；信息包括操作用户、请求路径、请求时间、请求地址、请求内容、请求结果、错误日志。
**输入**：筛选条件、分页。
**处理**：记录请求与结果，支持查询。
**输出**：操作日志列表。
**业务规则**：关键操作均需记录。
**性能要求**：记录完整、查询与导出可用。
**业务流程**：① 用户在本系统的每次操作（请求）由系统自动记录，包含操作用户、请求路径、请求时间、请求地址、请求内容、请求结果、错误日志；② 管理员进入操作日志页，按条件筛选并分页查询；③ 列表展示日志明细，支持导出；④ 支撑审计与故障排查。
#### 4.5.6 运维管理
##### 4.5.6.1 组件监控
**需求编号**：REQ-F-062
**优先级**：P0
**需求描述**：监测软件组件，提供组件名称、类型、版本、所属服务器 IP、运行状态等信息。
**输入**：无（自动采集）。
**处理**：采集组件信息并展示。
**输出**：组件监控列表与状态。
**业务规则**：无。
**性能要求**：数据定期刷新、状态准确。
**业务流程**：① 系统自动采集各软件组件的运行信息（组件名称、类型、版本、所属服务器 IP、运行状态）；② 用户在运维管理页进入组件监控，系统展示组件列表与状态；③ 数据按配置周期刷新；④ 便于掌握各组件部署与运行情况。
---
##### 4.5.6.2 资源监控
**需求编号**：REQ-F-063
**优先级**：P0
**需求描述**：监测硬件资源，涵盖 CPU、内存、硬盘、显卡、网络的使用情况。
**输入**：无（自动采集）。
**处理**：采集资源指标并展示。
**输出**：资源监控图表/列表。
**业务规则**：无。
**性能要求**：采集周期与展示及时。
**业务流程**：① 系统自动采集各节点硬件资源使用情况（CPU、内存、硬盘、显卡、网络）；② 用户在运维管理页进入资源监控，系统以图表或列表形式展示；③ 数据按配置周期刷新；④ 为容量规划与性能问题定位提供数据。
---
##### 4.5.6.3 告警监控
**需求编号**：REQ-F-064
**优先级**：P0
**需求描述**：针对组件与资源监控数据实现健康状态检测，异常时发出告警通知。
**输入**：监控数据、阈值或规则。
**处理**：判断健康状态、触发告警与通知。
**输出**：告警列表与通知。
**业务规则**：可配置阈值与通知方式。
**性能要求**：告警及时、通知可达。
**业务流程**：① 系统根据组件监控与资源监控数据及配置的阈值/规则进行健康状态检测；② 异常时生成告警记录并触发通知（如站内消息、邮件等）；③ 运维人员在告警监控页查看告警列表并处理；④ 支持配置阈值与通知方式。
#### 4.5.7 智能运维
##### 4.5.7.1 资源分析
**需求编号**：REQ-F-065
**优先级**：P1
**需求描述**：对分析节点可用资源进行实时统计与查看（节点信息、视频流路数、分析路数、正在分析路数）；提供推理服务节点资源列表（分析服务器 IP、节点数、视频流路数、有效分析路数、有效空闲路数）。
**输入**：无（自动汇总）。
**处理**：汇总各节点与任务数据。
**输出**：资源分析视图与列表。
**业务规则**：无。
**性能要求**：数据与调度一致、刷新及时。
**业务流程**：① 系统汇总各分析节点的可用资源数据（节点信息、视频流路数、分析路数、正在分析路数）；② 汇总推理服务节点资源列表（分析服务器 IP、节点数、视频流路数、有效分析路数、有效空闲路数）；③ 用户在智能运维页查看资源分析视图与列表；④ 数据与调度一致并定期刷新，支撑资源调配与容量管理。
### 4.6 第三方接口与集成
- **南向**：与园区视频监控汇聚平台通过 RTSP、GB/T28181、ONVIF 等协议对接，获取视频流（见 REQ-F-045）。
- **北向**：与智慧园区管理平台通过 RESTful、JSON、HTTP/HTTPS 对接，推送告警与统计数据，提供解析任务控制、运行状态、事件告警推送与查询等接口（见 REQ-F-046）。
- **训练平台**：可选对接，接收本系统推送的标注数据（见 REQ-F-003）。
## 5. 非功能需求
### 5.1 性能需求
#### 5.1.1 响应时间
| 功能模块 | 响应时间要求 | 说明 |
|---------|-------------|------|
| 告警列表/事件查询 | ≤3s | 常规筛选与分页 |
| 实时视频调阅 | ≤5s | 首帧出现 |
| 任务启停/配置保存 | ≤5s | 操作反馈 |
| 统计与报表 | ≤10s | 单次统计 |
| 北向接口 | 按 SLA 约定 | 与智慧园区平台约定 |
#### 5.1.2 吞吐量
- **并发用户数**：支持至少 50 个并发登录用户（可依实际规模调整）。
- **并发分析路数**：支持租户级并发路数配置，单租户可根据授权与实例数配置上限；多实例下负载均衡支撑总路数扩展。
- **告警吞吐**：支持每秒百级告警写入与查询（可依规模细化）。
#### 5.1.3 资源利用
- 算法实例 GPU/CPU 利用率可监控，支持通过并发路数、无告警时长与轮询策略在有限算力下覆盖更多点位。
- 管理端与数据库资源占用在常规负载下保持稳定。
### 5.2 可靠性需求
- **可用性**：核心服务（管理端、调度、取流与算法推理）目标可用性不低于 99%（不含计划停机）；关键单点可采用主备或集群。
- **容错与恢复**：单算法实例故障时，任务可迁移或重新调度至其他实例；流中断时支持重连与任务恢复。
- **数据备份**：配置数据、关键业务数据具备定期备份与恢复能力。
### 5.3 安全性需求
#### 5.3.1 身份认证
- 用户登录采用账号密码认证，支持强密码策略；可选支持与现有统一认证（如 LDAP/SSO）集成。
#### 5.3.2 权限控制
- 基于角色与组织的访问控制；禁止越权操作；菜单与数据范围按角色与组织过滤。
#### 5.3.3 数据安全
- 北向接口采用 HTTPS、数据加密与签名；敏感配置（如密码、密钥）加密存储；视频流传输按协议与网络策略保障。
#### 5.3.4 安全审计
- 关键操作与登录行为记录在操作日志中，支持审计与问题回溯。
### 5.4 可用性需求
- 界面符合常规 Web 使用习惯，关键操作有明确提示与二次确认；重要列表支持分页、筛选与导出，便于日常使用与运维。
### 5.5 可维护性需求
- 组件与资源监控、告警监控、任务日志、操作日志完整，便于故障定位与运维；版本与部署方式可管理，支持日志与配置外置。
### 5.6 兼容性需求
- 浏览器兼容 Chrome、Edge 等主流现代浏览器；南向协议兼容 RTSP、GB/T28181、ONVIF；北向接口兼容 RESTful、JSON、HTTP/HTTPS。
### 5.7 可扩展性需求
- 算法能力支持新增与授权扩展；算法实例可水平扩展并参与负载均衡；组织与角色可扩展，满足多园区/多租户演进。
## 6. 数据需求
### 6.1 数据实体
#### 6.1.1 组织/场所
**实体描述**：分析摄像机点位所在场所（区域），组织树节点。
**属性列表（概念级）**：组织 ID、名称、父组织 ID、层级、排序、创建/更新时间等。
#### 6.1.2 设备
**实体描述**：安防摄像头设备。
**属性列表（概念级）**：设备 ID、名称、编码、IP/域名、端口、协议类型、厂商、型号、所属组织、启用状态、最后心跳时间等。
#### 6.1.3 通道
**实体描述**：设备下的视频通道。
**属性列表（概念级）**：通道 ID、设备 ID、通道名称、编号、类型（枪机/球机）、主/子码流地址、取流参数、所属组织、安装高度、经纬度等。
#### 6.1.4 预置点
**实体描述**：球机预置点。
**属性列表（概念级）**：预置点 ID、通道 ID、预置点名称/ID、排序等。
#### 6.1.5 算法与参数
**实体描述**：已授权算法及其参数、参数模板。
**属性列表（概念级）**：算法 ID、名称、图标、参数定义、默认值、模板 ID、模板名称、参数快照等。
#### 6.1.6 任务
**实体描述**：通道/预置点与算法的分析任务。
**属性列表（概念级）**：任务 ID、通道/预置点 ID、算法 ID、流地址、状态、并发策略、无告警时长、创建/更新时间等。
#### 6.1.7 事件/告警
**实体描述**：算法产生的告警事件。
**属性列表（概念级）**：事件 ID、任务 ID、事件类型、报警时间、开始/结束时间、抓拍图、点位信息、处置状态、误检库标记等。
#### 6.1.8 用户与角色
**实体描述**：用户账号、角色及权限。
**属性列表（概念级）**：用户 ID、账号、角色 ID、组织范围、启用状态；角色 ID、名称、权限集合等。
### 6.2 数据关系
- 组织与设备、通道为一对多；设备与通道为一对多；通道与预置点为一对多（仅球机）；通道/预置点与任务为一对多；任务与算法多对一；任务与事件一对多；用户与角色多对多；用户与组织范围关联。
### 6.3 数据约束
- 设备编码/唯一标识不可重复；同一设备不可重复接入；通道所属组织限于设备所在组织及下级；任务与流地址、算法参数一致；关键业务数据需满足一致性与审计追溯要求。
### 6.4 数据字典
- 详细字段与类型以数据设计文档或数据库 DDL 为准；本文档仅给出概念级实体与关系，便于需求与设计衔接。
## 7. 接口需求
### 7.1 用户界面需求
- **界面风格**：简洁、清晰，符合安防/运维类管理平台习惯；支持主要信息集中展示与快捷操作。
- **布局与交互**：列表+筛选+分页；表单校验与二次确认；关键操作（删除、批量操作）有明确提示；实时视频与地图等需兼容当前主流分辨率。
### 7.2 外部接口需求
| 接口名称 | 接口类型 | 接口描述 | 调用方/被调用方 |
|---------|---------|---------|----------------|
| 南向视频流 | RTSP/GB28181/ONVIF | 从园区视频监控汇聚平台获取视频流 | 本系统调用视频平台 |
| 北向-解析任务控制 | RESTful/HTTP(S) | 解析任务创建、更新、启停等 | 智慧园区管理平台调用本系统 |
| 北向-解析任务运行状态 | RESTful/HTTP(S) | 查询任务运行状态 | 智慧园区管理平台调用本系统 |
| 北向-事件告警推送 | RESTful/HTTP(S) | 本系统向园区平台推送告警事件 | 本系统推送至智慧园区管理平台 |
| 北向-事件告警查询 | RESTful/HTTP(S) | 按条件查询告警事件 | 智慧园区管理平台调用本系统 |
| 标注数据推送 | HTTP(S) 等 | 向训练平台推送标注用图片/数据 | 本系统推送至训练平台（可选） |
### 7.3 内部接口需求
- 管理端与调度服务、算法实例间具备任务下发、状态上报、日志与监控数据上报等内部接口；接口形式与协议按技术方案实现（如 RPC、消息队列、REST 等）。
## 8. 约束条件
### 8.1 技术约束
- 南向依赖园区视频监控汇聚平台提供的 RTSP/GB/T28181/ONVIF 等能力；北向接口需符合智慧园区管理平台约定的 JSON、RESTful、HTTP/HTTPS 及加密与签名要求；算法以已授权算法库与运行环境为准。
### 8.2 业务约束
- 每路视频流不少于 2 个算法任务；球机预置点按配置参与轮询；事件处置流程按组织配置；并发路数、无告警分析时长等按租户与策略配置；误检库、标注数据推送等需符合数据与隐私管理要求。
### 8.3 法律约束
- 视频与告警数据的采集、存储、共享需符合网络安全、数据安全及个人信息保护等相关法律法规与行业规定。
### 8.4 其他约束
- 模板名称等字段长度与字符集限制见各功能业务规则；部署与网络需满足与视频平台、园区平台的连通性与安全策略。
## 9. 需求优先级
### 9.1 优先级定义
- **P0（必须）**：核心业务与运维必备，首版必须实现。
- **P1（重要）**：对运营与优化重要，应尽快实现。
- **P2（一般）**：可延后迭代。
- **P3（可选）**：后续版本或按需实现。
### 9.2 需求优先级列表
| 需求编号 | 需求名称 | 优先级 | 说明 |
|---------|---------|--------|------|
| REQ-F-001～REQ-F-002 | 告警汇聚展示、告警筛选 | P0 | 事件告警核心 |
| REQ-F-004～REQ-F-005 | 误检库管理、告警批量操作 | P0 | 事件运维与效率 |
| REQ-F-007～REQ-F-009 | 组织树统计、流程配置、处置与审核 | P0 | 事件处置闭环 |
| REQ-F-010～REQ-F-011 | 实时告警展示、多画面播放 | P0 | 视频中心核心 |
| REQ-F-013～REQ-F-018 | 高空抛物～人群聚集等 6 类检测 | P0 | AI 安防核心场景 |
| REQ-F-021～REQ-F-023、REQ-F-025～REQ-F-026 | 算法列表、参数查阅与同步、模板、批量应用 | P0 | 算法中心核心 |
| REQ-F-028、REQ-F-030～REQ-F-033 | 通道列表、基础信息、算法绑定、图形绘制、任务概览 | P0 | 算法参数配置核心 |
| REQ-F-035～REQ-F-037、REQ-F-039～REQ-F-044 | 任务绑定更新、查询、启停、并发与时长、轮询与同步 | P0 | 算法调度与轮询核心 |
| REQ-F-045～REQ-F-046 | 南向取流、北向告警与数据推送 | P0 | 第三方对接核心 |
| REQ-F-047～REQ-F-056 | 设备与通道管理全功能 | P0 | 设备管理核心 |
| REQ-F-057～REQ-F-064 | 部门、权限、菜单、日志、运维监控 | P0 | 系统管理核心 |
| REQ-F-003、REQ-F-006、REQ-F-012 等 | 标注推送、导出、录像下载、资源分析等 | P1 | 重要增强与运维 |
## 10. 验收标准
### 10.1 功能验收标准
- **完整性**：第 4 章所列 P0 功能需求全部实现，且与建设方案描述一致；关键业务规则（如每路不少于 2 个算法任务、同一设备不重复接入、组织可选范围等）得到落实。
- **正确性**：告警汇聚与筛选、事件统计与处置、任务调度与轮询、设备与通道管理、南向北向对接等核心流程按需求正确运行，无重大功能缺陷。
### 10.2 性能验收标准
- 响应时间、并发用户数/分析路数、北向接口 SLA 等满足第 5.1 节要求或双方约定指标；在典型负载下系统稳定、无异常崩溃。
### 10.3 质量验收标准
- 通过系统测试与回归测试；安全性满足第 5.3 节要求；操作日志与审计信息完整可用；关键配置与数据可备份恢复。
