← 返回总览 / 智慧施工管理系统 · Leyon-Construction-Console 🏢 展示 📖 说明书 🕘 日志 技术架构说明
📐 Architecture

智慧施工管理系统 · Leyon-Construction-Console

Leyon 开发 · 投控基建项目智慧施工管理系统 · 环境监测 + 历史落盘 + 3D-CAD + 16 路视频中转

📁 平台开发 🕑 更新于 2026-10-25
1

项目定位

Positioning
一句话定位

投控基建智慧施工管理系统,代号 智慧施工管理系统,是把 ==16 路摄像头实时画面==、扬尘环境八项读数、现场人员与班组构成、==730 天历史趋势==与三维沙盘汇报视图汇总进同一个网页的工地指挥中心。

点击查看全文 ⤢
研发方式

由 Leon 林奕铮个人独立研发,从前端控制台、协议兼容客户端、HLS 流媒体 Hub、采集归档引擎、OA 统一准入门禁到 3D 与 CAD 查看器全部开发与优化。

点击查看全文 ⤢
与上游的关系

工地会线平台负责工地设备接入与现场管理数据的流量汇总,是摄像头、扬尘监测设备与班组工人库的源头。

点击查看全文 ⤢
零侵入原则

不改动现场原有摄像头、扬尘监测设备与账号体系,!!不下发任何控制指令!!,不写回上游任何数据。

点击查看全文 ⤢
能力清单

十大业务模块全部在同一个单页控制台内完成,分别是视频监控 16 路一屏切换与逐路控制、环境监测扬尘八项实时读数与限值判定、项目管理现场人数与班组构成汇总、安全质量设备在线率与环保达标情况、通讯录项目账号与企业账号与 ==162 万条集团工人库==检索、智慧看板一屏汇报视图、历史回顾按日期追溯与曲线对比与表格导出、3D 与 CAD 查看器浏览器内自由漫游工地沙盘、系统管理服务体检与接口健康与坏通道明细、统一门禁不建账号的票据换入体系、AI 分析中台数据供数(工程反馈/安全管理/智慧工地等多系统融合分析)。

点击查看全文 ⤢
数据诚实边界

施工方未提供的数据如进度填报、质量整改闭环、成本台账、配电箱与塔吊细节等,如实显示为接口无数据,!!不编数字凑页面!!。

点击查看全文 ⤢
服务对象

现场值班员看视频画面是否正常、环境是否超标,发现红标立刻处理。

点击查看全文 ⤢
技术栈

后端为 Python 标准库异步思路的同步多线程 HTTP 服务,基于 ThreadingHTTPServer 手写路由与请求处理,不引入第三方 Web 框架与流媒体框架。

点击查看全文 ⤢
规模基线

16 路视频通道全量接入,含 2 路球机变焦,通道命名支持中文标注与 JSON 原子落盘。

点击查看全文 ⤢
性能基线

单路建流首帧约 @@20 到 30 秒@@^^由上游建流耗时决定,不可压缩^^,这是上游建流本身的耗时,不可压缩,页面以等待态与进度提示承接而不是假装秒开。

点击查看全文 ⤢
运维基线

服务端口固定(生产环境),用户级 systemd 单元守护,异常退出 @@5 秒@@后自动拉起。

点击查看全文 ⤢
本页读者

面向实施与运维与二次开发者,先看架构总图与三张时序图建立心智模型,再按数据流、接口清单与部署形态逐段深入。

点击查看全文 ⤢
演进路线

中控台从最初的单页视频代理起步,先啃最硬的取流额度与建流等待,再把环境与人员与历史逐一收编。

点击查看全文 ⤢
质量红线

页面数字必须与上游接口健康状态对得上,缓存数据必须打标告知新鲜度,失败必须给出原因而不是转圈。

点击查看全文 ⤢
口径统一

看板指标卡、实测表、系统管理体检页与历史回顾共用同一份底层结论,坏通道只有一份服务端试播结论,环境阈值只有一份对照表,通道命名只有一份服务端落盘。

点击查看全文 ⤢
2

技术架构

Architecture
01现场层
摄像头扬尘班组零侵入
设备与网关现场侧

16 路摄像头来自海康 NVR,型号 DS-7816N-Z2,设备序列号 AE5693790,在线 16 路满格,含 2 路球机支持变焦,通道命名支持中文标注并持久化。

点击查看全文 ⤢
02接入层
逆向白名单缓存单飞令牌托管
开发与优化协议兼容客户端

上游原本只有网页没有开放接口,中控台把生产站 25 个只读查询请求逐个抓包还原成可编程调用。

点击查看全文 ⤢
03流媒体层
HLS扇出额度回收坏通道验签
开发与优化 HLS 分发 Hub

上游账号全应用同时只允许 1 路取流,这是整个视频方案的总约束。

点击查看全文 ⤢
04数据层
归档幂等补录730天导出
开发与优化采集归档引擎

上游只给现在不给过去,历史必须自己一轮一轮攒出来。

点击查看全文 ⤢
05访问层
OA票据零账号豁免
借 OA 统一准入的门禁

不自建账号密码体系,公网入口复用 OA 会话判定身份。

点击查看全文 ⤢
06呈现层
单页原生脚本看板快照三维
原生单页前端控制台

无框架无构建,原生脚本加样式表直接运行,十个模块共用同一套路由与请求层,任何一处修好全站受益。

点击查看全文 ⤢
07发布层
静态站导出分享回滚
静态四入口导出

工作区源码与知识库经导出器生成展示、说明书、架构与日志四个静态入口,由全球加速网络发布,外部可访问可扫码分享。

点击查看全文 ⤢
08韧性层
重试降级打标自愈
失败预案贯穿全栈的兜底

上游查询统一 3 次重试加退避,失败返回空而不是抛异常拖垮页面。

点击查看全文 ⤢
09可观测层
体检健康表统计日志
体检先行的排障体系

平台体检页聚合服务状态、上游接口健康、坏通道明细与中转分发统计,是全站排障的第一入口。

点击查看全文 ⤢
3

模块组成

Modules
文件 / 目录类型说明
ARCHITECTURE.md 文件 15.6 KB
index.html 文件 36.6 KB
promo.html 文件 40.1 KB
shot-board.jpg 文件 92.5 KB
shot-cad.jpg 文件 527.0 KB
shot-contacts.jpg 文件 94.6 KB
shot-env.jpg 文件 120.6 KB
shot-gate.jpg 文件 82.9 KB
shot-hist.jpg 文件 127.0 KB
shot-hist2.jpg 文件 140.3 KB
shot-project.jpg 文件 123.1 KB
shot-safety.jpg 文件 92.3 KB
shot-sys.jpg 文件 144.9 KB
shot-video.jpg 文件 100.6 KB
源码与素材清单
文件 / 目录类型说明
ARCHITECTURE.md 文件 15.6 KB
index.html 文件 36.6 KB
promo.html 文件 40.1 KB
4

数据流转

Data Flow
工地会线平台 → 协议兼容客户端 → 中控台服务 → HLS Hub 一对多扇出 → 多端观众

观看主链的约束是上游全应用同时只允许一路取流,Hub 在服务器端独占这一路后向全部观众广播,观众之间共享同一路上游,互相不抢名额。最后一个观众离开立即断开上游并归还并发额度,下一位观众申请时重新建流,全程额度统计可在系统管理页查到 采集归档链为上游环境与运行指标先做时间戳三形态归一与年份校验,再按设备加时间去重写入信创库。库不可用或断网时先落本地暂存,恢复后先把积压按去重键补进库再抓新数,保证历史不断档,补录计数对外可见 身份准入链为公网请求先经 OA 只读代理核验会话,身份有效则自铸 120 秒一次性票据并跳转换入控制台会话。媒体分片路径只做本地验签以保流畅,业务数据路径回源 OA 做分级校验,退出 OA 会话立即失效,全程不缓存身份 通道标注链为前端提交的 16 路名称经服务端校验后原子落盘,看板与系统管理与视频列表共用同一份标注,改一处全站生效,避免三处各说各话 坏通道判定链为服务端每 25 分钟逐路真实试播,失败写入坏通道表并附失败原因,再与通道标注合并成同一份实测结果,看板红标与视频页红标同源,前端不自行判定 看板快照链为 10 余个上游慢接口经同键单飞并发拉取,再按分级缓存收敛成一份快照,前端只读快照。多人同时打开看板时合并为一次上游调用,命中缓存 1 秒内返回,未命中由后台刷新,前台不阻塞等待 模型浏览链为模型文件经大小校验后入库,三维页按需加载并在切换时逐网格释放显存,视角与姿态持久化到本地,下次打开接着看,低配电脑长时间投屏不爆内存 令牌续期链为服务端独占持有的上游令牌在到期前由后台自动续期,续期成功无缝替换,续期失败立即在接口健康表标红并让依赖模块显示暂无数据。服务重启会清空内存中的令牌缓存,需等待自动续期补齐后再核验看板,这是宁可短暂无数据也不把令牌下发到浏览器的安全取舍,全程前端接触不到令牌原文 缓存刷新链为所有上游查询先查分级缓存,命中直接返回并附带新鲜度,过期则由首个请求触发回源,其余同键并发等待同一结果。回源成功更新缓存并刷新快照,回源失败继续返回旧快照并打标,后台按退避重试。这一设计让多人同时打开看板或同时刷新时,上游实际只承受一次调用,既保住了慢接口的响应体验,也守住了不打爆上游的底线 故障定位链为任何异常先看平台体检页的四块汇总,服务状态看进程与端口,接口健康看逐个上游调用的通过失败,坏通道明细看每路试播时间与原因,分发统计看额度占用。四块全部正常再看对应日志文件,按服务分离的主服务与中转与采集日志互不覆盖,值班员按固定顺序排查,不靠猜测重启碰运气 AI 融合链:中控台采集的视频、环境、人员、历史数据,与工程反馈系统、安全管理平台、智慧工地等多系统数据汇聚至 AI 中台,经统一分析生成领导决策支持报告,形成数据流动与 AI 融合设计。平台作为 AI 中台的数据供数层,所有报告均结合多系统上下文进行 AI 分析

点击查看全文 ⤢
5

接口与集成

API
/gate
GET

统一入口门禁,先核验 OA 会话再决定放行或跳转,公网访问的第一道门,同域回环自动豁免以防跳转死循环,支持内网直连豁免与公网核验两套形态,异常跳转均有明确提示

点击查看全文 ⤢
/sso
GET

OA 换票建立中控台会话,核验通过后签发一次性票据并跳转控制台,全程不暴露上游令牌,票据一次有效且限时120秒,过期需重新换票

点击查看全文 ⤢
/whoami
GET

查询当前登录身份,控制台右上登录人徽章的数据源,未登录返回明确的未登录态,同时作为门禁是否放行的判定依据

点击查看全文 ⤢
/logout
GET

注销中控台会话并清理本地票据,退出 OA 后会话同样立即失效,不残留可复用凭证,不残留可在无会话状态下复用的凭证

点击查看全文 ⤢
/console
GET

控制台主界面,十大业务模块的单页外壳,路由与请求层全站共用,首屏按需加载各模块,各模块按需加载保证弱网可开

点击查看全文 ⤢
/cad
GET

三维模型查看器,开发与优化漫游与姿态编辑,含模型库列表、上传入口与视角保存,视角进度自动保存下次接着看

点击查看全文 ⤢
/diag
GET

平台体检页,聚合服务状态、接口健康、坏通道明细与中转分发统计,排障先看这里,逐项给出通过失败与耗时明细

点击查看全文 ⤢
/relay
GET

码流中转入口,携带上游地址参数接入开发与优化中转通道,参数非法直接拒绝,上游地址非法或越权直接拒绝

点击查看全文 ⤢
/hls/*
GET

分片分发路径,按通道标识定位分片文件,全程本地验签,路径含上级目录或为空直接返回拒绝

点击查看全文 ⤢
/api/relay/stats
GET

中转分发统计,返回每路在线观众数、上游占用总数、下游分发总数与明细,用于额度争用排查,观众为零且空闲超限自动断上游

点击查看全文 ⤢
/api/stream/*
GET

单路流状态与控制,查询参数驱动,含坏通道表结论,试播失败原因一并返回

点击查看全文 ⤢
/api/snapshot
GET

智慧看板聚合快照,含 8 张指标卡与 16 路实测表,后端收敛一次返回,前端只读,命中缓存1秒内返回前台不阻塞

点击查看全文 ⤢
/api/site
GET

项目管理与安全质量聚合,含概况卡、班组维度汇总与扬尘阈值对照,缺项如实标空,班组口径与工人库检索保持一致

点击查看全文 ⤢
/api/history
GET

按日期查询环境明细与运行指标,支持分页与多指标对比,时间参数非法返回明确错误,脏时间参数直接拒绝并提示范围

点击查看全文 ⤢
/api/history/export
GET

按日期导出历史表格,带签名格式保证办公软件直接打开中文不乱码,大区间分段生成防超时,默认按天分段避免大区间超时

点击查看全文 ⤢
/api/workers
GET

工人库分页检索,支持姓名与证件号搜索与工种分组,证件号做隐私遮蔽,只读不写回,大结果集强制分页避免卡死浏览器

点击查看全文 ⤢
/api/workers/group
GET

工人库分组统计,按工种与性别与籍贯等维度汇总,与检索页口径一致,空维度如实留空不编造分布

点击查看全文 ⤢
/api/names
GET

通道命名读取,全站标注的读入口,看板与列表共用同一份,与看板列表共用同一份真相源

点击查看全文 ⤢
/api/names
POST

通道命名保存,请求体为结构化数据,服务端校验后原子落盘,非法输入直接拒绝,并发写入互斥避免覆盖丢失

点击查看全文 ⤢
/api/proxy
POST

协议兼容客户端出口,把只读查询按固化模板转发到上游工地会线接口,非白名单路径直接拒绝,重试退避失败返回空而不抛异常

点击查看全文 ⤢
/api/xc/health
GET

上游工地会线接口健康自检,逐个接口打一遍并返回通过失败清单,供系统管理页展示,失败项附带原因供体检页展示

点击查看全文 ⤢
/api/cad/list
GET

模型库列表,返回可用模型文件与大小信息,供三维页选择加载,含体积信息供加载前预判

点击查看全文 ⤢
/api/cad/upload
POST

模型上传入口,仅允许常见三维格式,超限直接断开防半读拖垮服务,入库后即刻可在三维页选用

点击查看全文 ⤢
/api/cad/delete
POST

模型删除入口,按文件名精确删除,误删可按历史快照找回,规则外路径一律拒绝执行

点击查看全文 ⤢
/api/env/realtime
GET

环境监测八项实时读数与限值判定,含最近 10 条明细联动展示,上游抖动时读缓存快照并打标

点击查看全文 ⤢
/seeyon/leonapi/api/leon/whoami
GET

上游 OA 身份只读代理,供公网链路核验会话,不透传多余身份信息,最小化透传不暴露多余身份字段

点击查看全文 ⤢
6

部署形态

Deployment
直连形态

服务端口固定(生产环境),用户级 systemd 单元随系统自启,异常退出 5 秒后自动拉起。

点击查看全文 ⤢
公网形态

OA 单点登录准入,OA 侧多入口依次核验。

点击查看全文 ⤢
数据层

信创 PostgreSQL 常驻,库内含环境表与运行指标表,历史保留 ==730 天==,到期自动滚动清理。

点击查看全文 ⤢
静态四入口

展示、说明书、架构与日志四个页面,由工作区源码与知识库静态导出,经全球加速网络发布,外部可访问可扫码分享。

点击查看全文 ⤢
版本与回滚

每次发布在项目历史目录留快照,含元数据快照,可按版本回退后重新导出。

点击查看全文 ⤢
凭据管理

令牌与口令走独立部署凭据文件与环境变量注入,文件权限收紧,不写入代码仓库,不出现在文档正文与日志明文。

点击查看全文 ⤢
运维纪律

服务启停统一走用户级服务管理命令,重启会清空缓存的上游令牌,需等待自动续期补齐后再核验看板。

点击查看全文 ⤢
容量规划

16 路视频全量接入下 Hub 内存与带宽按一路上游加多路分发估算,观众数只影响分发侧。

点击查看全文 ⤢
日志与排障

三类日志按服务分离,主服务、中转与采集各记各的文件,互不覆盖。

点击查看全文 ⤢
安全基线

转发只走白名单,分片只认合法路径,上传只认白名单格式与大小上限,票据只认 120 秒一次性,比较只用恒定时间算法。

点击查看全文 ⤢
备份策略

代码仓库、历史快照与数据库备份三线并行。

点击查看全文 ⤢
二次开发约定

新增上游接口先加白名单模板再写调用,先定缓存分档再定刷新时机,先想好无数据时的空态再写正常态。

点击查看全文 ⤢
验收标准

页面字数与信息量服从准确性,可读性服从可验证性。

点击查看全文 ⤢
© 2026 Leyon WorkStation · 智慧施工管理系统 · Leyon-Construction-Console 🏢 展示 📖 说明书 🕘 日志 ← 返回项目总览