---
status: accepted
---

# Parallel Web cockpit baseline

沅陵县城市生命线驾驶舱先建立独立 Web 前端工程，与 UE5 驾驶舱并行开发，最终可能替代 UE5。首期覆盖一张图和总体概览、基础设施、运行监测、预警处置四个只读模块，不提供管理端写操作；复用现有驾驶舱专用只读接口契约和后端解析的点位状态。

技术栈采用 Vue3 + Three.js + CesiumJS。Cesium 负责地理空间地图、瓦片、3D Tiles 和空间交互；Three.js 负责管线三维表现、构件增强和特写效果。后端统一发布 WGS84(EPSG:4326)，前端只消费发布坐标，不做原始管网数据转换；管网空间数据由用户另行处理并导入数据库。

工程基座沿用当前前端开源项目的技术栈，并新增 CesiumJS。UI 语义沿用 UE 驾驶舱：中央一张图常驻，总体概览、基础设施、运行监测、预警处置四个业务模式切换，行业作为全局筛选，地面/管线作为全局视图条件（同时驱动相机预设与图层可见性）。首期地理底图优先使用天地图，正式交付优先使用甲方提供的本地瓦片、地形、3D Tiles 或模型。管线首期以 Cesium 地理管线为主，Three.js 只用于重点管线、交叉点或构件的增强表达。首期验收优先 3840x2160 横向 16:9，兼容 1920x1080。

后端接入沿用 UE 驾驶舱策略：专用只读接口、部署层注入凭据、`/ws/deviceStatus` 推送、失败分区独立展示。四个只读模块按 UE 现有信息结构重新实现为 Vue/Cesium 页面，不复制 UE 视觉实现。

## 视频操作例外（2026-11-10，需求已决、尚未实施）

维护者在[视频监控讨论票117](<../../.scratch/cockpit-shell-panel-layout/issues/117-监控设备最新指标增加视频监控入口-需求讨论.md#L55-L107>)确认：摄像机自身的实时视频、设备/NVR已有录像回放和云台操作是驾驶舱的有限视频例外；不扩传感器视频关联，不开放其他管理写操作，不改管理端页面或旧接口权限，不重建台账、信令或媒体系统。独占互斥、申请按钮和控制权租约不纳入本期；动作上限、停止保护与真实验收仍保留。匿名接口及网络边界见[ADR0005的视频例外](<0005-web-integration-and-performance.md#L17>)。本记录修订需求边界，不表示接口已发布或设备/网络已验证。

## Considered Options

- 不把首期开发放入当前 TvT.js 仓库或做成 TvT 插件；当前仓库只作为 Vue3、Three.js 组件和工程参考。
- 不使用 BD09 或原始 CAD 坐标作为系统基准；BD09 只用于百度地图展示，原始施工图坐标在入库前完成转换和校验。