系统管理 · 智慧施工管理系统展示说明书架构日志
第 09 章

⚙️系统管理

运维

平台自己的「体检报告」。出问题时先看这里。

左侧点击「系统管理」。

本页操作说明:体检页只读——所有状态由平台自动探测,无需点击;按下面的「故障排查表」对照处理即可。

系统管理:平台状态卡、接口健康表、坏通道明细

页面分区(对照上图)

图上位置 区块 出问题时先看它
第一排 平台状态卡(6 张) 网页服务、坏通道标注数
第二块 接口健康表 哪个上游接口异常
第三块 坏通道明细 具体哪几路、什么原因

平台状态卡逐张详解

卡片 含义 正常值 异常时怎么办
页面服务 网页服务是否活着 5090 正常 找技术人员重启服务
中转流路数 当前有几路在转码 看你正在看几路 与「正在输出」对不上 = 自愈中
正在输出 已出画面的路数 同上 差值大说明建流慢,等 20-30 秒
坏通道标注 平台实测不可用的路数 0 最理想 现场查对应通道接线
已标注名称 起过名字的通道数 16 少了说明还没标完,不影响使用
快照时间 数据最近更新时间 看时钟 长期不动 = 采集线程卡住

接口健康表

列出中控台对接的 10 个上游工地会线接口(经开发与优化协议兼容客户端——原平台只有网页没有开放接口,这些对接是逐个抓包逆向生产站通信协议实现的,前端从不接触上游令牌),每个标注:

  • 来源——对应哪个数据接口
  • 状态——正常 / 空数据 / 异常
  • 数据量——拿到了多少条

看到「空数据」不用慌——那是该模块数据施工方未提供(比如配电箱、BIM)。 只有红色「异常」才需要找技术人员。

十个接口速查(哪个数据来自哪)

接口 供哪个模块用 典型状态
视频通道列表 项目管理 / 视频监控 正常,16 条
设备心跳状态 看板「通道在线」 正常
项目档案 项目管理概况卡 正常
班组列表 项目管理班组表 正常,10 组
平台账号 通讯录账号表 正常,4 条
工人库分页 通讯录工人库 正常,162 万条
扬尘实时值 安全质量 / 环境监测 正常
排放记录 安全质量「排放记录条数」 空数据(尚无记录)
配电箱数据 项目管理配电箱 空数据(施工方未提供)
9908 号模块 —— 空数据(如实留白,不造数)

为什么要分「空数据」和「异常」两种状态? 空数据 = 接口调通了但上游没有内容;异常 = 接口本身调不通(网络、令牌、协议变更)。 只有异常需要修,空数据是项目侧事实。

坏通道明细

列出每一路被判为不可用的通道,以及具体原因。

当前实测不可用(8 路,平台服务端每 25 分钟探测一次):

通道 原因
CH1 / CH5 / CH7 / CH8 / CH10 / CH13 / CH14 / CH16 设备返回错误码4:该通道/NVR 当前不可用

这是摄像头侧的问题,不是平台的问题。 需要现场检查这几路的摄像头和 NVR 接线。

这份名单会随摄像头状态变动,以平台「系统管理」页实时显示为准。 最近一次变化(2026-10-15 复核):CH5 / CH8 / CH10 / CH13 由可用转为不可用。

探测机制怎么跑

  1. 服务端每 25 分钟起一轮探测,对 16 路逐路真实建流试播(不是查心跳表)。
  2. 设备侧返回的错误码归一化后分类:「错误码4」= 通道/NVR 不可用。
  3. 判定的结果直接写进通道标注,不依赖网页端,所以没人打开平台时也在探。
  4. 摄像头修好后,下一轮探测自动消掉红色标记,无需人工点击「刷新」。

本页可点元素一览

体检页全是自动探测结果,没有需要点击的按钮;能点的只有导航与跳转:

可点元素 位置 作用 注意
左侧模块菜单「系统管理」 控制台左侧 打开体检页 只读,页面不会自动刷新,按需重进
6 张平台状态卡 第一排 逐张判断哪一项异常 「坏通道标注」不为 0 需现场查线路
接口健康表「状态」列 第二块 分辨「空数据」与「异常」 空数据不用修,红色「异常」才要修
坏通道明细表 第三块 看具体哪几路、错误码是什么 名单随 25 分钟一轮探测更新
故障排查表「重新连接」 排查表第 2 行 视频卡住时去视频页重试 见《视频监控》一章的按钮速查
页尾跳转卡 页尾 跳到快速开始 / 视频 / 现场 / 历史 出问题时按这张卡逐层排查

故障排查表

现象 原因 怎么办
网页打不开 服务没启动 找技术人员重启服务
视频一直转圈 首次建流需 20-30 秒 等 1 分钟,超时点击「重新连接」
「并发数达到上限」 有人其他位置正在播放视频 关掉原平台视频页和其他标签页
顶部红字「分发异常」 转码器自愈中 等十几秒自动恢复
某通道一直不可用 摄像头或线路故障 现场查那一路的摄像头接线
环境数据很久没变 上游没推送 该设备「数据推送」显示「未开通」,属项目侧配置
看板数字不刷新 采集线程卡住 看「快照时间」,不前进就找技术人员
进不去、提示登录 OA 会话失效 重新登录 OA,再进中控台

给技术人员的四条硬约束

这部分不用记,出事时技术人员照着做就行。

  1. 上游只许 1 路流,但观众侧靠中转共享——中转服务独占那 1 路并向所有观众 1→N 分发,同一路多人同看互不踢;一个观众都不剩立即断流、归还并发名额(额度自动回收,不会白占)。
  2. 「直连」是独占模式——会把唯一名额吃在你这里,其他用户(含中转服务)均无法访问;切换前有弹窗警告,看完记得切回中转。
  3. 摄像头不可用由平台自动判定——探测引擎每 25 分钟对 16 路逐路真实试播,错误码归一后标注坏通道,不依赖网页端;分发异常另有十几秒级自愈,自愈不好的才需要人工介入。
  4. 登录态随 OA 失效——身份每次回问 OA 复核(媒体高频路径只做本地签名验证以保流畅),OA 一注销中控台立即失守,不缓存身份。
团队联系方式
📇

团队联系方式 · 预留位

管理员可在后台「说明书设置」配置联系方式图片
本说明书由 Leon 独立整理维护 · 内容以现场实际为准