diff --git a/客户管理平台操作手册.md b/客户管理平台操作手册.md new file mode 100644 index 0000000..9f6e099 --- /dev/null +++ b/客户管理平台操作手册.md @@ -0,0 +1,579 @@ +# 管理平台客户操作手册 + +> 本文档用于指导客户完成管理平台的基础配置、设备管理、联动配置、数据转发及告警处理等操作。 +> 文档中的菜单名称和按钮名称应以实际发布版本为准。 + +## 文档信息 + +| 项目 | 内容 | +| --- | --- | +| 文档名称 | 管理平台客户操作手册 | +| 适用平台 | 管理平台 | +| 适用版本 | `待填写` | +| 文档版本 | V1.0 | +| 更新日期 | `待填写` | +| 编写人员 | `待填写` | + +## 阅读说明 + +- 操作前请确认当前账号具有对应功能权限。 +- 标有“注意”的内容可能影响设备运行或数据上报,请谨慎操作。 +- 页面布局、菜单名称若与本文档不同,请以实际部署版本为准。 +- 建议将操作截图统一保存在 `images` 目录中,并按章节编号命名。 + +--- + +# 1. 快速开始 + +## 1.1 平台访问要求 + +使用平台前,请确认: + +- 管理电脑与平台服务器网络连通。 +- 已获取平台访问地址、用户名和初始密码。 +- 浏览器版本符合平台要求,推荐使用最新版 Chrome 或 Edge。 +- 摄像机及相关设备已正确安装、通电并接入网络。 + +## 1.2 访问平台 + +1. 打开浏览器。 +2. 在地址栏输入平台地址:`http(s)://待填写`。 +3. 进入平台登录页面。 +4. 输入用户名和密码。 +5. 单击“登录”进入平台首页。 + +> 截图位置:平台登录页面。 + +## 1.3 首次使用流程 + +建议首次登录后按照以下顺序完成配置: + +1. 修改初始密码。 +2. 检查系统时间和时区。 +3. 配置平台网络。 +4. 添加摄像机。 +5. 检查摄像机在线状态及实时画面。 +6. 配置联动规则。 +7. 配置数据转发和报警转发。 +8. 触发一次测试告警,检查完整业务流程。 + +## 1.4 首页功能说明 + +平台首页通常包含设备状态、告警统计、快捷入口及系统运行信息。 + +| 区域 | 功能说明 | +| --- | --- | +| 设备统计 | 查看设备总数、在线数、离线数和异常数 | +| 告警统计 | 查看当前或指定时间范围内的告警数量 | +| 最新告警 | 查看最近产生的告警记录 | +| 系统状态 | 查看平台服务、存储及网络状态 | +| 快捷入口 | 快速进入常用管理页面 | + +> 截图位置:平台首页及各区域标注图。 + +--- + +# 2. 账号与登录 + +## 2.1 登录平台 + +1. 进入平台登录页面。 +2. 输入正确的用户名和密码。 +3. 如页面提供验证码,请按提示输入。 +4. 单击“登录”。 + +登录失败时,请检查: + +- 用户名和密码是否输入正确。 +- 是否误开大写锁定。 +- 账号是否被禁用或锁定。 +- 管理电脑与平台服务器是否网络连通。 +- 平台服务是否正常运行。 + +## 2.2 修改密码 + +1. 登录平台。 +2. 单击页面右上角的用户名称或头像。 +3. 选择“修改密码”。 +4. 输入原密码和新密码。 +5. 再次输入新密码进行确认。 +6. 单击“保存”。 + +建议密码同时包含大写字母、小写字母、数字和特殊字符,且不要使用容易猜测的信息。 + +## 2.3 退出登录 + +1. 单击页面右上角的用户名称或头像。 +2. 选择“退出登录”。 +3. 确认退出后返回登录页面。 + +在公共电脑上使用平台后,请务必退出登录并关闭浏览器。 + +## 2.4 忘记密码 + +如平台提供“忘记密码”功能,请按页面提示完成身份验证并重置密码;如未提供,请联系系统管理员重置。 + +## 2.5 账号权限说明 + +不同账号可能具有不同菜单及操作权限。若页面中没有某项功能或无法编辑,请联系管理员确认账号角色和权限范围。 + +--- + +# 3. 网络设置 + +## 3.1 网络参数说明 + +| 参数 | 说明 | 示例 | +| --- | --- | --- | +| IP 地址 | 平台或设备在局域网中的地址 | `192.168.1.100` | +| 子网掩码 | 用于划分网络范围 | `255.255.255.0` | +| 默认网关 | 用于访问其他网段 | `192.168.1.1` | +| 首选 DNS | 域名解析服务器地址 | `待填写` | +| 备用 DNS | 首选 DNS 不可用时使用 | `待填写` | + +## 3.2 查看当前网络配置 + +1. 进入“网络设置”页面。 +2. 选择需要查看的网卡或网络接口。 +3. 查看当前 IP 地址、子网掩码、网关和 DNS。 +4. 记录修改前的配置,以便发生异常时恢复。 + +## 3.3 设置静态 IP + +1. 进入“网络设置”页面。 +2. 选择“静态 IP”。 +3. 填写 IP 地址、子网掩码、默认网关和 DNS。 +4. 单击“保存”或“应用”。 +5. 等待网络服务重新加载。 +6. 使用新地址重新访问平台。 + +> **注意:** 修改 IP 地址可能导致当前页面断开。保存前请确认新地址未被其他设备占用,并确保管理电脑能够访问新网段。 + +## 3.4 设置自动获取地址 + +1. 进入“网络设置”页面。 +2. 选择“自动获取(DHCP)”。 +3. 单击“保存”或“应用”。 +4. 从路由器或 DHCP 服务器中查询平台获得的新地址。 + +## 3.5 网络连通性检查 + +网络异常时,依次检查: + +1. 网线、交换机及接口指示灯是否正常。 +2. IP 地址、子网掩码和网关是否正确。 +3. 是否存在 IP 地址冲突。 +4. 管理电脑与平台是否位于可互通的网络。 +5. 防火墙是否放行平台和设备使用的端口。 +6. 摄像机地址是否可以从平台所在网络访问。 + +--- + +# 4. 摄像机管理 + +## 4.1 摄像机列表 + +进入“摄像机管理”页面,可查看摄像机名称、IP 地址、通道、在线状态、启用状态及最近更新时间。 + +## 4.2 添加摄像机 + +1. 进入“摄像机管理”。 +2. 单击“新增”或“添加摄像机”。 +3. 填写摄像机信息。 +4. 单击“测试连接”。 +5. 测试成功后单击“保存”。 +6. 返回列表,确认摄像机状态为“在线”。 + +建议记录以下信息: + +| 参数 | 是否必填 | 说明 | +| --- | --- | --- | +| 摄像机名称 | 是 | 建议使用位置加编号,例如“1号仓库-东门” | +| IP 地址 | 是 | 摄像机的网络地址 | +| 端口 | 是 | 摄像机服务端口 | +| 用户名 | 是 | 摄像机登录账号 | +| 密码 | 是 | 摄像机登录密码 | +| 协议 | 是 | 按实际支持情况选择 | +| 码流地址 | 视情况 | RTSP 或其他视频流地址 | +| 安装位置 | 否 | 摄像机实际安装位置 | + +## 4.3 编辑摄像机 + +1. 在摄像机列表中找到目标摄像机。 +2. 单击“编辑”。 +3. 修改相关参数。 +4. 单击“测试连接”。 +5. 测试成功后保存。 + +## 4.4 删除摄像机 + +1. 在摄像机列表中选择目标摄像机。 +2. 单击“删除”。 +3. 阅读影响提示并确认删除。 + +> **注意:** 删除摄像机可能同时影响关联的联动规则、告警记录查询和转发任务。删除前请先确认关联关系。 + +## 4.5 查看实时画面 + +1. 在摄像机列表中单击“预览”。 +2. 等待视频加载。 +3. 检查画面是否清晰、时间是否正确、播放是否流畅。 + +## 4.6 摄像机离线排查 + +- 检查摄像机是否通电。 +- 检查摄像机网线和交换机端口。 +- 检查摄像机 IP 地址能否访问。 +- 检查用户名、密码和端口是否正确。 +- 检查视频协议或码流地址是否正确。 +- 检查平台与摄像机之间是否有防火墙限制。 +- 确认摄像机未超过最大连接数。 + +--- + +# 5. 联动管理 + +## 5.1 功能说明 + +联动管理用于配置事件触发后平台需要执行的动作,例如触发声光报警、输出控制信号、保存图片、录制视频或发送通知。 + +## 5.2 新增联动规则 + +1. 进入“联动管理”。 +2. 单击“新增联动”。 +3. 填写规则名称。 +4. 选择触发设备和触发事件。 +5. 设置生效时间。 +6. 选择联动动作及目标设备。 +7. 设置动作持续时间或恢复条件。 +8. 单击“保存”。 +9. 启用该规则。 + +## 5.3 生效时间设置 + +可根据业务要求设置全天生效或按星期、时间段生效。跨天时间段应确认平台是否需要拆分配置。 + +示例: + +| 时间计划 | 生效时间 | +| --- | --- | +| 全天 | 每天 00:00—24:00 | +| 工作时间 | 周一至周五 08:00—18:00 | +| 夜间 | 每天 18:00—次日 08:00 | + +## 5.4 编辑、停用和删除规则 + +- 编辑前建议记录原配置。 +- 临时停止规则时优先使用“停用”,避免误删。 +- 删除前确认规则不再使用,并确认是否影响现场设备。 + +## 5.5 联动测试 + +1. 确认测试不会影响现场生产或安全。 +2. 手动触发或模拟规则对应事件。 +3. 检查告警是否生成。 +4. 检查联动设备是否按预期动作。 +5. 检查图片、录像或通知是否生成。 +6. 检查事件结束后设备是否正确恢复。 + +--- + +# 6. 数据转发 + +## 6.1 功能说明 + +数据转发用于将平台产生的设备状态、业务事件或统计数据发送至第三方系统。 + +## 6.2 新增转发配置 + +1. 进入“数据转发”。 +2. 单击“新增”。 +3. 填写任务名称和接收地址。 +4. 选择转发协议。 +5. 选择需要转发的数据类型。 +6. 配置认证信息、请求头或其他必要参数。 +7. 设置超时时间和重试次数。 +8. 单击“测试”。 +9. 测试成功后保存并启用。 + +## 6.3 常用参数 + +| 参数 | 说明 | +| --- | --- | +| 接收地址 | 第三方系统提供的服务地址 | +| 请求方式 | 如 HTTP POST,按双方接口约定填写 | +| 数据格式 | 通常为 JSON,按接口文档确定 | +| 认证方式 | 无认证、Token、用户名密码或签名认证 | +| 超时时间 | 单次请求最大等待时间 | +| 重试次数 | 发送失败后的自动重试次数 | + +## 6.4 查看转发状态 + +在任务列表或转发日志中查看最近发送时间、发送结果、响应状态及失败原因。 + +## 6.5 转发失败排查 + +- 检查接收地址、端口和路径是否正确。 +- 检查平台与第三方服务器是否网络连通。 +- 检查认证信息是否有效。 +- 检查请求数据是否符合接口约定。 +- 检查第三方服务是否正常运行。 +- 检查防火墙、访问白名单和 HTTPS 证书。 +- 查看转发日志中的响应码和错误信息。 + +--- + +# 7. 告警信息 + +## 7.1 查看告警列表 + +进入“告警信息”页面,可按时间、设备、告警类型、处理状态和告警级别进行查询。 + +## 7.2 告警字段说明 + +| 字段 | 说明 | +| --- | --- | +| 告警时间 | 告警发生时间 | +| 告警设备 | 产生告警的摄像机或设备 | +| 告警类型 | 具体事件类型 | +| 告警级别 | 告警严重程度 | +| 处理状态 | 未处理、处理中或已处理 | +| 告警图片/视频 | 事件相关的图片或录像 | +| 处理人员 | 当前或最终处理人 | +| 处理说明 | 告警处置过程和结果 | + +## 7.3 查看告警详情 + +1. 在列表中找到目标告警。 +2. 单击告警记录或“详情”。 +3. 查看告警时间、位置、设备及相关图片或视频。 +4. 根据现场情况进行确认和处置。 + +## 7.4 处理告警 + +1. 打开告警详情。 +2. 确认告警真实性。 +3. 按现场流程完成处置。 +4. 填写处理说明。 +5. 上传相关凭证(如平台支持)。 +6. 将状态更新为“已处理”。 + +> **注意:** 不要在未核实现场情况时随意关闭或删除告警。 + +## 7.5 查询和导出 + +1. 设置查询时间范围。 +2. 选择设备、类型或处理状态。 +3. 单击“查询”。 +4. 确认结果后单击“导出”。 +5. 检查导出文件的内容和时间范围。 + +--- + +# 8. 报警转发 + +## 8.1 功能说明 + +报警转发用于将告警事件、告警图片或告警视频通知第三方平台。它与普通数据转发的主要区别是转发对象以告警事件为主。 + +## 8.2 新增报警转发任务 + +1. 进入“报警转发”。 +2. 单击“新增”。 +3. 填写任务名称。 +4. 配置第三方接收地址和认证信息。 +5. 选择需要转发的告警类型和告警级别。 +6. 选择是否包含图片、视频或设备信息。 +7. 设置生效时间、超时时间及重试策略。 +8. 单击“测试”。 +9. 测试成功后保存并启用。 + +## 8.3 重发告警 + +如平台支持手动重发: + +1. 进入报警转发记录。 +2. 筛选状态为“失败”的记录。 +3. 查看失败原因并修正配置。 +4. 选择目标记录。 +5. 单击“重新发送”。 +6. 确认发送结果。 + +## 8.4 重复报警处理 + +如果第三方平台收到重复告警,请检查: + +- 平台是否因超时自动重试。 +- 第三方是否已接收但未及时返回成功响应。 +- 是否存在多个相同的转发任务。 +- 第三方是否按照告警唯一标识进行去重。 + +--- + +# 9. 系统设置 + +## 9.1 基本信息 + +进入“系统设置”,可按实际权限查看或修改系统名称、站点名称、语言、时区和时间格式等信息。 + +## 9.2 日期、时间和时区 + +1. 进入系统时间设置。 +2. 选择正确时区。 +3. 选择自动同步或手动设置时间。 +4. 如使用自动同步,填写 NTP 服务器地址。 +5. 保存后检查平台时间和摄像机时间是否一致。 + +时间不一致可能导致告警、录像及转发记录无法准确对应。 + +## 9.3 存储设置 + +查看存储容量、已用空间、剩余空间及数据保留周期。修改保留周期前,应评估存储空间和客户的数据留存要求。 + +## 9.4 日志管理 + +系统日志通常包括: + +- 登录日志; +- 操作日志; +- 设备日志; +- 告警日志; +- 转发日志; +- 系统异常日志。 + +出现问题时,应记录故障时间,并导出该时间前后的相关日志。 + +## 9.5 配置备份与恢复 + +如平台支持配置备份: + +1. 进入“备份与恢复”。 +2. 单击“导出配置”或“创建备份”。 +3. 将备份文件保存到安全位置。 +4. 记录备份对应的平台版本和日期。 + +恢复配置前,请确认备份文件来源可靠、版本兼容,并安排业务维护时间。 + +## 9.6 重启系统 + +重启前请确认: + +- 当前无重要业务操作。 +- 无正在进行的升级、导入、导出或录像处理任务。 +- 已通知相关使用人员。 +- 已保存未提交的配置。 + +重启后检查平台访问、摄像机状态、联动规则和转发任务是否正常。 + +--- + +# 10. 其他问题解答 + +## 10.1 无法打开平台页面 + +1. 检查访问地址是否正确。 +2. 检查管理电脑网络是否正常。 +3. 检查平台服务器是否启动。 +4. 检查平台端口是否被防火墙拦截。 +5. 尝试清除浏览器缓存或更换浏览器。 + +## 10.2 登录后看不到某个菜单 + +通常是账号权限不足。请联系管理员检查账号角色、菜单权限和数据权限。 + +## 10.3 页面显示异常或按钮无响应 + +- 刷新页面后重试。 +- 清除浏览器缓存。 +- 使用推荐浏览器的最新版本。 +- 检查浏览器是否禁用了脚本或弹窗。 +- 记录发生时间并保存页面截图和浏览器控制台信息。 + +## 10.4 实时视频无法播放 + +- 检查摄像机是否在线。 +- 检查摄像机账号和密码。 +- 检查视频流地址和端口。 +- 检查浏览器是否支持当前播放方式。 +- 检查网络带宽及防火墙配置。 + +## 10.5 告警没有产生 + +- 检查摄像机和检测服务是否在线。 +- 检查相应检测或告警功能是否启用。 +- 检查规则生效时间。 +- 检查告警阈值和区域配置。 +- 检查平台时间是否正确。 + +## 10.6 告警产生但未联动 + +- 检查联动规则是否启用。 +- 检查告警类型是否与触发条件一致。 +- 检查规则当前是否处于生效时间。 +- 检查目标设备是否在线。 +- 查看联动执行日志。 + +## 10.7 告警没有转发到第三方平台 + +- 检查报警转发任务是否启用。 +- 检查告警类型是否在转发范围内。 +- 检查接收地址、认证信息和网络。 +- 查看转发日志和第三方服务日志。 +- 检查第三方是否返回正确的成功响应。 + +## 10.8 如何提交技术支持请求 + +提交问题时,请尽量提供: + +- 客户名称和项目名称; +- 平台版本; +- 问题发生时间; +- 问题现象和复现步骤; +- 相关设备名称及 IP 地址; +- 页面截图或录屏; +- 对应时间段的系统日志; +- 已尝试的处理方法。 + +## 10.9 技术支持联系方式 + +| 项目 | 内容 | +| --- | --- | +| 技术支持电话 | `待填写` | +| 技术支持邮箱 | `待填写` | +| 服务时间 | `待填写` | +| 紧急联系人 | `待填写` | + +--- + +## 附录 A:上线前检查清单 + +- [ ] 平台地址可正常访问。 +- [ ] 管理员和普通用户账号可正常登录。 +- [ ] 系统时间及时区正确。 +- [ ] 网络参数正确且无 IP 冲突。 +- [ ] 所有摄像机在线且实时画面正常。 +- [ ] 联动规则已启用并通过测试。 +- [ ] 数据转发已通过测试。 +- [ ] 报警转发已通过测试。 +- [ ] 告警查询、处理和导出正常。 +- [ ] 配置文件已完成备份。 +- [ ] 技术支持联系方式已填写。 + +## 附录 B:截图命名建议 + +建议采用“章节编号-功能-序号”的命名方式,例如: + +```text +images/ +├─ 01-登录页面-01.png +├─ 03-网络设置-01.png +├─ 04-添加摄像机-01.png +├─ 05-新增联动规则-01.png +└─ 07-告警详情-01.png +``` + +## 附录 C:版本修订记录 + +| 文档版本 | 修订日期 | 修订内容 | 修订人 | +| --- | --- | --- | --- | +| V1.0 | `待填写` | 首次编制 | `待填写` |