AI生成成套文档-03-需求规格说明书

# 需求规格说明书

## 1. 文档信息

| 项目名称 | AI视频分析中台请填写项目全称 |
|---------|----------------|
| 文档版本 | v1.0 |
| 编写日期 | 2025-01-20请填写YYYY-MM-DD格式日期 |
| 编写人员 | 黄毅请填写姓名及所属部门 |
| 审核人员 | 邓大阳请填写姓名及所属部门 |
| 批准人员 | 董列涛请填写姓名及所属部门 |

---

**## 文档修订历史**

| 版本号 | 修订日期 | 修订人员 | 修订内容 |
|--------|---------|---------|----------|
| v1.0 | 2025-02-10YYYY-MM-DD | 黄毅姓名/部门 | 依据《AI视频分析中台初始版本 系统建设方案》与《模板|
| v1.1 | YYYY-MM-DD | 姓名/部门 | 修订内容简述 |

**填写说明**：
- 版本号：遵循语义化版本规范，如v1.0、v1.1等
- 修订日期：填写文档修订的具体日期
- 修订人员：填写负责此次修订的人员姓名及所属部门
- 修订内容：简要描述本次修订的主要内容和变更点

## 1. 概述

### 1.1 编写目的
**填写说明**：详细说明本需求规格说明书模板》编写初始版本 |

## 2. 概述

### 2.1 的编写目的、适用对象及用途。

**示例**：
- 本需求规格说明书用旨在详细描述基于明确 AI 大模型的视频分析中AI算法平台系统的功能需求、非功能需求、数据需求和接口需求及约束条件，为设计、开发、测试与验收团队提供明确的开发依据。
- 适用对象包括产品经理、开发工程师、测试工程师、项目管理人员、需求分析人员、设计等相关 stakeholders。
- 本文档作为项目开发人员、测试人员及、验收方；可用于需求评审、设计输入、测试用例编写及验收的重要依据，确保项目目标准制定的实现。

### 2.1.2 项目背景
**填写说明**：详细描述项目的来源、现状问题、目标和意义。

- **项目来源**：面向智慧园区[填写项目的发起方、楼宇资助方或来源背景]
- **现状问题**：[描述当前存在的问题和挑战，说明为什么需要该项目]
- **项目目标**：[明确项目的具体目标和期望达成的成果]
- **项目意义**：[阐述项目的业务价值、消防及安防场景技术价值和社会价值]

**示例**：
- **项目来源**：本项目由公司研发部门发起，旨在构建基于大模型的视频智能AI算法平台，提升视频分析管和处理平台建设需求，需对园区视频监控汇聚平台的视频流进行 AI 算法分析，实现事件告警汇聚、事件处置闭环、算法任务调度与设备通道统一管理能力。
- **现状问题**：园区现有的视频监控与 AI 分析能力分散，缺乏系统一的告警汇聚与处置闭环；存在算法与任务精度不足、设备与通道管处理不统一；与智慧园区管速度慢、扩展性差等问题，无法满足日益增长的视频处理平台的北向对接与南向取流缺乏标准化，运维与资源利用缺乏可视与可控手段需求。
- **项目目标**：构建以事件告警为核心一个高性能、可扩展的完整业务闭环，实现多源视频统一接入、AI算法平台，集成多种先进的视频分析算法与任务一体化管理、事件全生命周期管理、多场景 AI 安防能力及完善，提供便捷的运维与北向对接能力API接口和用户界面。
- **项目意义**：本项目将显著提升安全防控效率、规范事件处置流程、公司在视频AI领域的技术实力，为客户提供更优化算法与资源利用、降低集成与运维成本质的视频分析服务，支撑园区智能化升级创造更大的商业价值。

### 2.1.3 术语定义
**填写说明**：列出项目中涉及的主要术语及其定义，确保所有 stakeholders 对术语的理解一致。

| 术语 | 英文 | 定义 |
|------|------|------|
| RTSP大模型 | RealLarge Time Streaming ProtocolModel | 实时流传输协议指参数量巨大、能力强大的人工智能模型，用于从摄像头或流媒体服务器获取视频流。如GPT、DALL-E等 |
| GB/T28181视频AI | —Video AI | 国标《安全防范应用人工智能技术对视频监控联网系统信息传输内容进行分析、交换、控制处理和理解的技术要求》，用于设备与平台级视频联网。领域 |
| ONVIF算法平台 | OpenAlgorithm Network Video Interface ForumPlatform | 开放网络视频集成多种算法，提供统一接口论坛标准，用于网络摄像头和管理功能的发现与控制。软件平台 |
| 误检库模型推理 | FalseModel Positive LibraryInference | 存放被判定为误报使用训练好的告警模型对新数据，用于算法迭代与误报治理。进行预测或分析的过程 |
| 预置点批处理 | PresetBatch Processing | 球机预设的云台位置，可绑定不同算法任务并参与轮询调度。 |
| 轮询 | Polling | 在有限算力下按策略轮流对多路视频/预置点个数据项同时进行分析处理的调度操作方式。 |
| 警戒框/忽略框/标识线 | — | 在视频画面上绘制的算法生效区域、屏蔽区域及仅显示线，用于算法检测范围与显示配置。 |
| 南向/北向 | Southbound/Northbound | 南向指与下层系统（如视频监控汇聚平台）对接取流；北向指与上层系统（如智慧园区管理平台）对接推送告警与数据。 |

### 2.1.4 参考资料
**填写说明**：列出本需求规格说明书参考的相关文档、标准和资料。

- [参考资料1名称]：[简要描述或链接]
- [参考资料2名称]：[简要描述或链接]
- [参考资料3名称]：[简要描述或链接]

**示例**：
- 《AI视人工智能算法平台技术规范》：公司内部技术标准文档
- 《视频分析中台 系统建设方案计指南》：行业最佳实践文档
- GB/T28181 安全防范视频监控联网系统信息传输、交换、控制《大模型应用开发手册》：技术要求
- 智慧园区管理平台安防管理需求参考资料

### 2.1.5 文档约定
**填写说明**：明确本文档中使用的各种约定和标准，确保文档的一致性和可读性。

- **优先级定义**：P0
  - P0（必须）：核心功能，项目成功的关键，必须实现，P1
  - P1（重要）：重要功能，应优先实现，P2
  - P2（一般）：一般功能，可延后，P3实现
  - P3（可选后续考虑。）：可选功能，根据资源情况决定是否实现

- **状态定义**：
  - 待实现、：需求已确认，尚未开始开发
  - 开发中、：需求正在开发中
  - 测试中、：开发完成，正在进行测试
  - 已验收。：测试通过，需求已实现

- **需求编号**：
  - 功能需求采用 ：REQ-F-xxx（与建设方案中如REQ-F-001）
  Fx.x- 对应），非功能需求采用 ：REQ-NF-xxx，xxx（如REQ-NF-001）
  - 接口需求采用 ：REQ-I-xxx。xxx（如REQ-I-001）
  - 数据需求：REQ-D-xxx（如REQ-D-001）

## 3.2. 系统概述

### 3.2.1 系统目标
- **总体目标**：建设一套面向智慧园区、楼宇、消防及安防场景的视频智能分析管理平台，通过接入园区视频监控汇聚平台的视频流进行 AI 算法分析，实现事件告警汇聚、事件处置闭环、算法任务调度与设备通道统一管理，为园区安全管理与运营决策提供智能化支撑。
- **业务目标**：以事件告警为核心，构建从设备接入、通道与算法绑定、任务调度与轮询、事件汇聚与处置到统计分析及第三方对接的完整业务闭环；支持火焰、通道阻塞、吸烟、人群聚集、高空抛物、电动车入楼等多类 AI 安防算法，实现告警集中展示、误检库管理及流程化处置。
- **技术目标**：支持 RTSP、GB/T28181、ONVIF 等南向取流；算法与任务一体化管理、预置点轮询与负载均衡；北向采用 JSON、RESTful、HTTP/HTTPS，数据加密与签名，与智慧园区管理平台对接。

### 3.2.2 系统范围
#### 3.2.2.1 系统边界
- **系统包含**：AI 应用（事件告警、事件处置、视频中心、AI 安防应用）、算法中心（算法调用概览、算法参数配置、算法调度、算法轮询、第三方对接）、设备管理（设备管理、通道管理）、系统管理（部门、权限、菜单、日志、运维管理、智能运维）。
- **系统不包含**：园区视频监控汇聚平台及摄像头硬件本身的建设与运维；训练平台的具体训练能力（仅通过标注数据推送对接）；梯控等第三方联动系统的具体实现（仅支持联动接口约定）。
- **与其他系统关系**：南向依赖园区视频监控汇聚平台提供视频流；北向向智慧园区管理平台推送告警事件与统计数据；可选与训练平台对接接收标注数据。

#### 3.2.2.2 用户范围
- **目标用户**：园区/楼宇安全管理人员、运维人员、值班人员、系统管理员及智慧园区管理平台集成方。
- **用户角色**：管理员（组织、权限、设备、算法、任务、运维配置）、业务用户（告警查看与处置、视频查看、统计）、只读/审计角色等。

### 3.2.3 系统环境
#### 3.2.3.1 运行环境
- **硬件环境**：支持部署分析节点（含 GPU 的推理服务器）、管理节点及存储；具体规格依并发路数与算法类型而定。
- **软件环境**：主流 Linux 服务器操作系统；支持容器化部署；浏览器支持 Chrome、Edge 等现代浏览器。
- **网络环境**：与视频汇聚平台、智慧园区管理平台网络互通；支持 HTTP/HTTPS、RTSP、GB/T28181 等协议所需端口与防火墙策略。

#### 3.2.3.2 开发环境
- **开发框架**：按项目技术选型确定（如前后端分离、微服务等）。
- **技术架构**：南向取流、算法调度与推理、事件汇聚与北向推送分层架构；支持多算法实例负载均衡与任务同步。
- **协议与标准**：RTSP、GB/T28181、ONVIF；北向 RESTful、JSON、HTTP/HTTPS，数据加密与签名。

## 4.3. 功能需求

### 4.3.1 功能需求概述
**填写说明**：对系统分为四大功能域：进行总体描述，列出主要子系统或模块，概述系统的核心功能。

**AI 应用示例**（事件告警、事件处置、：
基于大模型的视频中心AI算法平台主要包含以下子系统：
- **视频处理子系统**：负责视频的上传、AI转码、存储和管理
安防应用）、- **算法中心管理子系统**（：负责算法调用概览的部署、算法参数配置、算法调度、算法轮询、第三方对接）、和管理
- **设备模型推理子系统**：负责视频AI算法的推理和分析
- **结果管理子系统**（设备：负责分析结果的存储、查询和可视化
- **用户管理子系统**：负责用户的认证、通道授权和管理）、**系统管理**（部门、权限、菜单、日志、运维管理、智能运维）。功能需求采用**多级编号**（如 4.2.2.1、4.3.3.1），每个具体功能点包含需求编号、优先级、需求描述、输入/处理/输出、业务规则、性能要求及**业务流程**（步骤化描述）。

### 4.3.2 AI[子系统/模块一名称]
应用**填写说明**：详细描述子系统或模块的功能、目标和业务价值。

#### 4.3.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 算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.3.2.2 部门管理

##### 4.5.2.1 场所/组织管理[功能点名称]
**填写说明**：详细描述具体功能点的需求，包括需求编号、优先级、描述、输入、处理、输出、业务规则、性能要求和业务流程。

**功能点模板**：

需求编号：REQ-F-057xxx  
**优先级**：P0[P0/P1/P2/P3]  
**需求描述**：对分析摄像机[详细描述功能点位所在场所（区域）进行管理；支持用户自定义场所与组织节点，用于组织树与权限范围，为设备归属、告警统计、权限划分提供组织维度基础。的具体需求]  
**输入**：组织/场所名称、层级、父节点。[描述功能的输入参数和数据]  
**处理**：维护组织树。[描述功能的处理逻辑和流程]  
**输出**：组织树[描述功能的输出结构。果和格式]  
**业务规则**：无。[描述功能相关的业务规则和约束]  
**性能要求**：树形展示与编辑响应及时。[描述功能的性能指标和要求]  
**业务流程：[描述功能的具体业务流程，可使用步骤编号]  

**示例**：

需求编号：REQ-F-001  
优先级：P0  
需求描述：支持视频文件的上传、转码和存储，支持多种视频格式。  
输入：视频文件（支持MP4、AVI、MOV等格式）、上传参数（如视频名称、描述、标签等）。  
处理：① 接收用户上传的视频文件；② 验证视频文件格式和大小；③ 对视频进行转码处理，统一格式；④ 将转码后的视频存储到指定位置；⑤ 生成视频缩略图和元数据。  
输出：上传成功/失败状态、视频存储路径、视频元数据信息。  
业务规则：视频文件大小不超过10GB，支持的视频格式包括MP4、AVI、MOV等主流格式。  
性能要求：上传速度达到5MB/s以上，转码时间不超过视频时长的2倍。  
业务流程：① 用户登录系统；② 进入部门/场所视频管理页，系统展示组织树；② 用户可新增、编辑、删除组织节点（删除时校验是否有关联设备/用户）面；③ 设置节点名称、父节点与层级击"上传视频"按钮；④ 保存后组织树更新，用于设备归属、告警选择本地视频文件；⑤ 填写视频信息；⑥ 点击"开始上传"；⑦ 系统计与权限划分。

#### 4.5.3 权限管理

##### 4.5.3.1 角色管理
**需求编号**：REQ-F-058  
**优先级**：P0  

**需求描述**：支持新增、修改、删除角色；具备权限分级与审查体系，禁止越权操作。  
**输入**：角色名称、权限范围。  
**处理**：维护角色与权限绑定。并显示上传进度；⑧ **输出**：角色列表与操作上传完成后显示结果。

### 3.3 [子系统/模块二名称]
**业务规则填写说明**：权限分级与审查，禁止越权。  
**性能要求**：增删改查响应及时。  
**业务流程**：① 管理员进入角色管理页，可新增、修改、删除角色；② 为角色配置权限范围（菜单、按上述结构继续描述各功能、组织范围等），具备权限分级与审查体系；③ 保存后角色与权限绑定生效；④ 用户仅能执行其角色权限内的操作，禁止越权。

---

##### 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.63.4 第三方接口与集成
-**填写说明**：描述系统与第三方系统的接口和集成需求。

**南向示例**：与园区视频监控汇聚平台通过 RTSP、GB/T28181、ONVIF 等协议对接，获取视频流（见 REQ-F-045）。
- **北向接口名称**：与智慧园区管理平台通过 RESTful、JSON、HTTP/HTTPS 对接，推送告警与统计数据，提供解析任务控制、运行状态、事件告警推送与查询等[填写第三方接口（见 REQ-F-046）。名称]
- **训练平台接口类型**：可选[填写接口类型，如REST API、SDK等]
- **接口描述**：[详细描述接口的功能和用途]
- **调用方/被调用方**：[填写接口的调用方和被调用方]
- **集成方式**：[填写集成的具体方式和步骤]

**示例**：
- **接口名称**：阿里云对象存储OSS接口
- **接，口类型**：REST API
- **接收本口描述**：用于存储和管理视频文件和分析结果
- **调用方/被调用方**：视频处理子系统推送的标注数据（见 REQ-F-003）。/ 阿里云OSS服务
- **集成方式**：通过阿里云SDK进行集成，使用AccessKey和SecretKey进行身份认证

## 5.4. 非功能需求

### 5.4.1 性能需求
#### 5.4.1.1 响应时间
**填写说明**：详细描述各功能模块的响应时间要求。

| 功能模块 | 响应时间要求 | 说明 |
|---------|-------------|------|
| 告警列表视频上传 | ≤30秒（100MB文件） | 包括文件传输和初步处理时间 |
| 视频转码 | ≤2×视频时长 | 标准清晰度转码 |
| 算法推理 | ≤5秒/事件分钟视频 | 标准视频分析算法 |
| 结果查询 | ≤3s2秒 | 常规筛选与分页查询操作 |
| 实时视频调阅页面加载 | ≤5s3秒 | 首帧出现 |
| 任务启停/配置保存 | ≤5s | 操作反馈 |
| 统计与报表 | ≤10s | 单次统计 |
| 北向接口 | 按 SLA 约定 | 与智慧园区平台约定屏加载时间 |

#### 5.4.1.2 吞吐量
**填写说明**：详细描述系统的并发处理能力和吞吐量指标。

- **并发用户数**：支持至少 50 个500个并发登录用户（可依实际规模调整）。
- **并发分析路数视频处理能力**：支持租户级并发路数配置，单租户可根据授权与实例数配置上限；多实例下负载均衡支撑总路数扩展。每小时处理≥1000个视频文件
- **告警算法推理吞吐量**：支持每秒百级告警写入与查询（可依规模细化）。处理≥10个视频分析请求

#### 5.4.1.3 资源利用
- 算法实例 GPU/CPU **填写说明**：详细描述系统的资源利用率可监控要求，支持通过并发路数包括CPU、内存、无告警时长与轮询策略在有限算力下覆盖更多点位存储等。

- 管理端与数据库资源占**CPU利用在常规负载下保持稳定。率**：峰值不超过80%
- **内存利用率**：峰值不超过75%
- **存储利用率**：预留20%以上的存储空间

### 5.4.2 可靠性需求
**填写说明**：详细描述系统的可靠性需求，包括可用性、容错与恢复、数据备份等指标。

- **可用性**：核心服务（管理端、调系统年度、取流与算法推理）目标可用性不低于≥99.9%（即年度 99%（不含计划停机downtime≤8.76小时）；关键单点可采用主备或集群。
- **容错与恢复**：单算法实例
  - 系统具备自动故障时检测和告警能力
  - 关键组件具备冗余备份，任务可迁移或重新调度至其他实例；流中断时支持重连与任务单点故障不影响整体系统运行
  - 系统故障恢复。时间≤30分钟
- **数据备份**：配置
  - 核心数据、关键业务每日自动备份
  - 备份数据具备定期至少保留30天
  - 支持备份与数据的快速恢复能力。

### 5.4.3 安全性需求
#### 5.4.3.1 身份认证
- 用户登录采用账号密码**填写说明**：详细描述系统的身份认证需求，支持强包括认证方式、密码策略；可选等。

- 采用多因素认证机制（如密码+验证码）
- 支持与现有统一认证单点登录（如 LDAP/SSO）集成。
- 密码强度要求：至少8位，包含大小写字母、数字和特殊字符
- 登录失败次数限制：连续5次失败后账户锁定

#### 5.4.3.2 权限控制
**填写说明**：详细描述系统的权限控制需求，包括权限管理方式、权限粒度等。

- 基于角色与组织的访问控制；禁止越（RBAC）
- 支持细粒度的权限设置（如功能权限、数据权限）
- 权限变更需记录操作；菜单与数据范围按角色与组织过滤。日志

#### 5.4.3.3 数据安全
**填写说明**：详细描述系统的数据安全需求，包括数据传输、存储和处理的安全措施。

- 北向接口敏感数据传输采用HTTPS加密
HTTPS、- 敏感数据加密与签名；敏感配置（如密码、密钥）存储采用加密存储；视频流传输按协议与网络策略保障。
- 定期进行安全漏洞扫描和渗透测试
- 遵循数据最小化原则，只收集必要的数据

#### 5.4.3.4 安全审计
**填写说明**：详细描述系统的安全审计需求，包括日志记录、审计内容等。

- 系统操作日志完整记录，至少保留6个月
- 关键操作与登录行为（如权限变更、数据删除）需记录在操作日志中，详细审计信息
- 支持审计与问题回溯。日志的查询和分析

### 5.4.4 可用性需求
**填写说明**：详细描述系统的可用性需求，包括系统的访问方式、用户体验等方面。

- 系统支持7×24小时不间断运行
- 提供友好的用户界面符合常规 Web 使用习惯，关键操作有简单直观
- 系统错误提示清晰明确提示与二次确认；重要列表支持分页、筛选与导出，便于日常使用与运维。户理解和处理
- 支持多终端访问（PC端、移动端） 

### 5.4.5 可维护性需求
**填写说明**：详细描述系统的可维护性需求，包括代码质量、文档完整性、故障诊断等方面。

- 组件与资源代码遵循统一的编码规范和风格
- 系统架构清晰，模块划分合理
- 提供完整的系统文档，包括架构文档、API文档、运维文档等
- 支持系统监控、告警监控、任务日志、操作日志完整和故障诊断，便于故障问题定位与运维；版本与部署方式可管理，支持日志与配置外置。和解决 

### 5.4.6 兼容性需求
- **填写说明**：详细描述系统的兼容性需求，包括硬件、软件、浏览器等方面的兼容性。

Chrome、Edge- 等支持主流现代操作系统：Windows 10/11、Linux（CentOS 7+、Ubuntu 18.04+）
- 支持主流浏览器；南向协议兼容：Chrome RTSP、GB/T28181、ONVIF；北向接口兼容90+、Firefox RESTful、JSON、HTTP/HTTPS。88+、Safari 14+、Edge 90+
- 支持主流数据库：MySQL 8.0+、PostgreSQL 12.0+
- 支持主流云服务平台：阿里云、腾讯云、AWS 

### 5.4.7 可扩展性需求
**填写说明**：详细描述系统的可扩展性需求，包括系统架构、功能扩展、性能扩展等方面。

- 采用微服务架构，支持服务的独立部署和扩展
- 支持算法能力插件化管理，便于新算法的集成和部署
- 支持新增与授权扩展；算法实例可水平扩展并参与负载均衡；，通过增加节点提高系统性能
- 支持功能模块的灵活组织与角色可扩展，满足多园区/多租户演进。合和配置 

## 6.5. 数据需求

### 6.5.1 数据实体（概要）
**填写说明**：详细描述系统中涉及的主要数据实体，包括实体名称、描述和属性列表。

#### 6.5.1.1 组织/场所[实体名称]
**填写说明**：详细描述单个数据实体的结构和属性。

**基本信息**：
| 项目 | 描述 |
|------|------|
| 实体名称 | [填写实体名称] |
| 实体描述**：分析摄像机点位所在场所（区域），组织树节点。 | [填写实体的详细描述] |

**属性列表（概念级）**：组织
ID、| 属性名称 | 数据类型 | 长度 | 约束 | 描述 |
|---------|---------|------|------|------|
| [填写属性名称] | [填写数据类型，如字符串、父组织整数、日期等] ID、层级| [填写数据长度，如适用] | [填写约束条件，如是否必填、排序、创建/更新时间是否唯一等。] | [填写属性的详细描述] |

**示例**：

#### 6.5.1.21 设备视频文件

**基本信息**：
| 项目 | 描述 |
|------|------|
| 实体名称 | 视频文件 |
| 实体描述**：安防摄像头设备。 | 存储上传的视频文件信息 |

**属性列表（概念级）**：设备
ID、| 属性名称、编码、IP/域名、端口、协议 | 数据类型、厂商、型号、所属组织、启用 | 长度 | 约束 | 描述 |
|---------|---------|------|------|------|
| 视频ID | 字符串 | 36 | 主键，必填 | 视频文件的唯一标识 |
| 视频名称 | 字符串 | 255 | 必填 | 视频文件的名称 |
| 存储路径 | 字符串 | 512 | 必填 | 视频文件在存储系统中的路径 |
| 大小 | 长整数 | - | 必填 | 视频文件的大小（字节） |
| 格式 | 字符串 | 10 | 必填 | 视频文件的格式（如MP4、AVI等） |
| 上传时间 | 日期时间 | - | 必填 | 视频文件的上传时间 |
| 状态、最后心跳时间等。 ####| 6.1.3字符串 通道| **实体描述**：设备下的20 | 必填 | 视频通道。  
**属性列表（概念级）**：通道 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.5.2 数据关系
- 组织与设备**填写说明**：详细描述数据实体之间的关系，如一对一、通道为一对多；设备与通道为、多对多等。

**示例**：
- 一个用户可以上传多个视频文件（一对多；通道与预置点为关系）
- 一个视频文件可以被多个算法分析（一对多关系）
- 一个算法可以分析多个视频文件（仅球机）；通道/预置点与任务为一对多；任务与关系）
- 一个分析结果对应一个视频文件和一个算法多（一对一；任务与事件一对多；用户与角色多对多；用户与组织范围关联。系）

### 6.5.3 数据约束
**填写说明**：详细描述数据的约束条件，包括业务规则、数据完整性约束等。

**示例**：
- 设备编视频文件大小不得超过10GB
- 视频文件格式必须是系统支持的格式（如MP4、AVI、MOV等）
- 用户密码/唯一标识不可重复；同一设备不可重复接入；通道所属组织限于设备所在组织及下级；任务必须符合强度要求
- 分析结果数据必须与流地址、视频文件和算法参数一致；关键业务数据需满足一致性与审计追溯要求。联

### 6.5.4 数据字典
- 详细字段与类型以**填写说明**：提供系统中使用的主要数据设计文档或字典，包括代码值、状态值等的定义。

**示例**：

| 数据库项 DDL| 为准；本文档仅给出概念级实体与关系，便于需求与设计衔接。代码值 | 描述 |
|--------|--------|------|
| 视频状态 | UPLOADING | 上传中 |
| 视频状态 | COMPLETED | 上传完成 |
| 视频状态 | PROCESSING | 处理中 |
| 视频状态 | FAILED | 处理失败 |
| 分析状态 | PENDING | 待分析 |
| 分析状态 | RUNNING | 分析中 |
| 分析状态 | SUCCESS | 分析成功 |
| 分析状态 | ERROR | 分析失败 |
| 用户角色 | ADMIN | 管理员 |
| 用户角色 | OPERATOR | 操作员 |
| 用户角色 | VIEWER | 查看员 |

## 7.6. 接口需求

### 7.6.1 用户界面需求
**填写说明**：详细描述系统的用户界面需求，包括界面风格、布局与交互等方面。

- **界面风格**：
  - 采用现代化、简洁、清晰的设计风格
  - 配色方案：主色调[填写主色调]，符合安防/运维辅助色调[填写辅助色调]
  - 字体：[填写字体类管理平台习惯；支型和大小]
  - 图标：采用[填写图标库名称]图标库，保持主要信息集中展示与快捷操作。风格一致

- **布局与交互**：列表
  - 响应式布局，适配不同屏幕尺寸
  - 左侧导航栏+筛选顶部状态栏+分页；表单校验与二次确认；关键主内容区的经典布局
  - 交互方式：支持鼠标操作（删除、批量键盘快捷键
  - 操作）有明确反馈：提供清晰的操作成功/失败提示；实
  - 加载状态：提供适当的加载动画

**示例**：
- **界面风格**：
  - 采用现代化、简洁的设计风格
  - 配色方案：主色调#1890ff（蓝色），辅助色调#52c41a（绿色）
  - 字体：Microsoft YaHei，14px
  - 图标：采用Ant Design图标库，保持风格一致

- **布局与交互**：
  - 响应式布局，适配1280px以上的屏幕
  - 左侧导航栏+顶部状态栏+主内容区的经典布局
  - 交互方式：支持鼠标操作、常用键盘快捷键
  - 操作反馈：操作成功时视频与地图等需兼容当前主流分辨率。显示绿色提示，失败时显示红色提示
  - 加载状态：采用Ant Design的Spin组件作为加载动画

### 7.6.2 外部接口需求
**填写说明**：详细描述系统与外部系统的接口需求，包括接口名称、类型、描述、调用方/被调用方等。

| 接口名称 | 接口类型 | 接口描述 | 调用方/被调用方 | 集成方式 |
|---------|---------|---------|----------------|----------|
| 南向视频流[接口名称] | RTSP/GB28181/ONVIF[接口类型] | 从园区视频监控汇聚平台获取视频流[详细描述接口的功能和用途] | 本[填写调用方和被调用方] | [填写集成方式] |

**示例**：

| 接口名称 | 接口类型 | 接口描述 | 调用方/被调用方 | 集成方式 |
|---------|---------|---------|----------------|----------|
| 阿里云对象存储OSS接口 | REST API | 用于存储和管理视频文件和分析结果 | 视频处理子系统调 / 阿里云OSS服务 | 通过阿里云SDK进行集成，使用视频平台AccessKey和SecretKey进行身份认证 |
| 北向-解腾讯云智能视频分析任务控制接口 | RESTful/HTTP(S)REST API | 解提供视频内容分析任务创建能力，如人脸识别、更新、启停场景识别等 | 智慧园区管模型推理平台调用本子系统 / 腾讯云智能视频分析服务 | 通过API Key调用，使用HTTPS协议进行通信 |
| 北向-解析任务运行状态企业内部用户认证接口 | RESTful/HTTP(S)REST API | 查询任务运行状态用于用户身份认证和授权 | 智慧园区用户管理平台调用本子系统 |/ 企业内部认证服务 | 北向-事件告警推送通过OAuth | RESTful/HTTP(S) | 本系统向园区平台推送告警事件 | 本系统推送至智慧园区管理平台 |
| 北向-事件告警查询 | RESTful/HTTP(S) | 按条件查询告警事件 | 智慧园区管理平台调用本系统 |
| 标注数据推送 | HTTP(S) 等 | 向训练平台推送标注用图片/数据 | 本系统推送至训练平台（可选）2.0协议进行集成 |

### 7.6.3 内部接口需求
**填写说明**：详细描述系统内部各模块之间的接口需求，包括接口名称、功能、参数、返回值等。

**示例**：

| 接口名称 | 功能描述 | 调用方 | 被调用方 | 参数 | 返回值 |
|---------|---------|--------|----------|------|--------|
| 视频上传接口 | 上传视频文件 | 前端页面 | 视频处理子系统 | videoFile: File, metadata: Object | {success: boolean, videoId: string, message: string} |
| 视频转码接口 | 对视频进行转码处理 | 视频处理子系统 | 视频处理子系统 | videoId: string, quality: string | {success: boolean, status: string, message: string} |
| 算法推理接口 | 对视频进行AI分析 | 前端页面 | 模型推理子系统 | videoId: string, algorithmId: string | {success: boolean, resultId: string, message: string} |
| 结果查询接口 | 查询分析结果 | 前端页面 | 结果管理端与调度服务、算法实例间具备任务下发、状态上报、日志与监控数据上报等内部接口；接口形式与协议按技术方案实现（如子系统 RPC、消息队列、REST| 等）。resultId: string | {success: boolean, result: Object, message: string} | 

## 8.7. 约束条件

### 8.7.1 技术约束
**填写说明**：详细描述系统开发和运行过程中的技术约束，包括技术栈、架构限制等。

**示例**：
- 南向依赖园区系统必须基于微服务架构进行开发
- 后端采用Java Spring Boot框架
- 前端采用React框架
- 数据库使用MySQL和MongoDB
- 必须支持容器化部署（Docker/Kubernetes）
- 视频监控汇聚平台提供的 RTSP/GB/T28181/ONVIF 等能力；北向接口需符合智慧园区管处理平台约定的 JSON、RESTful、HTTP/HTTPS 及加密与签名要求；算法以已授权算法库与运行环境为准。必须使用FFmpeg库 

### 8.7.2 业务约束
**填写说明**：详细描述系统开发和运行过程中的业务约束，包括业务规则、流程限制等。

**示例**：
- 每路视频流文件大小不少于得超过10GB
2- 单个用户最多同时上传5个视频文件
- 算法任务；球机预置点按配置参与轮询；事件处置流程按组织配置；并发路数、无告警分析时长等按租户与策略配置；误检库、标注数据推送等需符合数据与隐私管理要求。结果必须保存至少30天
- 系统必须支持中英文双语界面
- 必须提供API接口供第三方系统集成 

### 8.7.3 法律约束
**填写说明**：详细描述系统开发和运行过程中的法律约束，包括法律法规、合规要求等。

**示例**：
- 视频与告警数据的采集、存储、必须遵守《中华人民共享需符合和国网络安全、法》
- 必须遵守《中华人民共和国数据安全及法》
- 必须遵守《中华人民共和国个人信息保护等法》
- 视频内容分析必须符合相关法律法规与行业规定。要求
- 数据存储和处理必须符合GDPR等国际标准 

### 8.7.4 其他约束
**填写说明**：详细描述系统开发和运行过程中的其他约束，包括时间、资源等方面的限制。

**示例**：
- 项目开发周期为6个月
- 开发团队规模板名称等字段长度与字符集为10人
- 系统必须在现有硬件环境下运行
- 必须兼容企业内部现有系统
- 预算限制见各功能业务规则；部署与网络需满足与视频平台、园区平台的连通性与安全策略。：总开发成本不超过200万元 

## 9.8. 需求优先级

### 9.8.1 优先级定义
- **P0（必须）**：核心业务与运维必备，首版必须实现。
- **P1（重要）**：对运营与优化重要，应尽快实现。
- **P2（一般）**：可延后迭代。
- **P3（可选）**：后续版本或按需实现。

### 9.8.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.9. 验收标准

### 10.9.1 功能验收标准
**填写说明**：详细描述系统功能的验收标准，包括完整性、正确性等方面。

- **完整性**：第
  4- 章所列 P0 有功能需求全部项都已实现，且与建设方案描述一致；关键
  - 功能覆盖所有业务规则（如每路不少于场景
  2- 个算法任务、同一设备不重复接入、组织可选范围等）得到落实。界面元素完整，无缺失

- **正确性**：告警汇聚与筛选、事件统计与
  - 功能实现符合需求描述
  - 数据处置、任理结果准确
  - 业务调度与轮询、设备与通道管理、南向北向对接等核心流程按需求执行正确运行，无重大功能缺陷。

### 10.9.2 性能验收标准
- **填写说明**：详细描述系统性能的验收标准，包括响应时间、吞吐量等方面。

**示例**：
- **响应时间**：
  - 视频上传（100MB文件）≤30秒
  - 视频转码≤2×视频时长
  - 算法推理≤5秒/分钟视频
  - 结果查询≤2秒
  - 页面加载≤3秒

- **吞吐量**：
  - 支持500个并发用户数/
  - 每小时处理≥1000个视频文件
  - 每秒处理≥10个视频分析路数、北向接口请求

SLA- 等满足第**资源利用**：
  5.1- 节要求或双方约定指标；在典型负载下系统稳定、无异常崩溃。CPU利用率峰值不超过80%
  - 内存利用率峰值不超过75%

### 10.9.3 质量验收标准
**填写说明**：详细描述系统质量的验收标准，包括可靠性、安全性、可用性等方面。

**示例**：
- **可靠性**：
  - 系统年度可用性≥99.9%
  - 故障恢复时间≤30分钟
  - 无重大系统故障

- **安全性**：
  - 通过安全漏洞扫描，无高危漏洞
  - 身份认证和权限控制有效
  - 敏感数据传输和存储加密

- **可用性**：
  - 界面友好，操作简单直观
  - 错误提示清晰明确
  - 支持多终端访问

- **可维护性**：
  - 代码符合编码规范
  - 文档完整，包括架构文档、API文档、运维文档等
  - 支持系统监控和故障诊断

## 10. 填写指南与最佳实践

### 10.1 填写指南
**填写说明**：本指南旨在帮助用户正确填写需求规格说明书，确保文档质量和一致性。

- **文档结构**：按照模板章节顺序填写，确保内容完整覆盖所有需求点。
- **语言风格**：使用清晰、准确、简洁的语言，避免歧义。
- **内容详细程度**：根据项目规模和复杂度，适当调整内容详细程度，确保关键信息不缺失。
- **格式规范**：
  - 标题层级：使用Markdown标题层级（#、##、###等）
  - 列表：使用无序列表（-）或有序列表（1.、2.等）
  - 表格：使用Markdown表格格式，确保对齐整齐
  - 代码/命令：使用Markdown代码块格式

### 10.2 最佳实践
**填写说明**：以下是编写需求规格说明书的最佳实践，供用户参考。

- **需求明确性**：需求描述应具体、可测量、可验证，避免模糊不清的描述。
- **需求可追溯性**：每个需求都应有唯一的编号，便于后续跟踪和管理。
- **需求优先级**：根据业务价值和技术可行性，合理设置需求优先级。
- **需求完整性**：确保覆盖所有功能需求、非功能需求、数据需求和接口需求。
- **需求一致性**：确保需求之间无冲突，与项目目标一致。
- **需求可测试与回归性**：每个需求都应有明确的验收标准，便于测试；安全验证。
- **团队协作**：需求编写过程中应充分征求相关方意见，确保需求的合理性满足第和可行性。
5.- **版本控制**：对需求规格说明书进行版本控制，记录每次变更。

### 10.3 常见问题与解决方案
**填写说明**：以下是填写需求规格说明书时常见的问题及解决方案。

- **问题**：需求描述过于模糊
  **解决方案**：使用具体的数字、时间、条件等量化指标，避免使用"大概"、"可能"等模糊词汇。

- **问题**：需求遗漏
  **解决方案**：采用结构化的方法，按照模板章节要逐一检查，确保无遗漏。

- **问题**：需求；操作日志冲突
  **解决方案**：在编写过程中充分沟通，确保需求之间无冲突，与审计信息完整项目目标一致。

- **问题**：需求不可测试
  **解决方案**：为每个需求定义明确的验收标准，确保可测试性。

- **问题**：文档格式不一致
  **解决方案**：遵循模板格式规范，使用；关键配置与数据可备份恢复。统一的标题层级、列表格式和表格格式