24-24.md 2.8 KB

24: 前端执行票 —— 设施点位与管线真实几何图层接线

Type: task Status: ready-for-agent Label: ready-for-agent Category: frontend-execution

来源

票 18 真实联调与真人走查第 1、4 项(2026-10-10):地图上监测点、设备、设施、管道全部没有正确显示。

现状事实

  1. 前端图层未接线:CockpitShell.vue 构造 modeLayerPlan 时恒传 facilities: null、pipelines: null,因此设施与管线图层在任何模式都处于「未就绪」降级态,cesiumEngine 只有 PIPELINE_SOURCE 常量与查找逻辑,没有创建管线数据源的写入路径。
  2. 后端已有可复用的真实几何链路(未接入驾驶舱):供水 GIS 读取 water_source_info / water_plant_info / pump_station(water_supply) / pipe_network_base(network_type='2') / water_user_info,控制器路由为 /waterSupply/gis/map/features(需 waterSupply:gis:map 权限),几何为两点 LineString,且只做非空检查、不做范围与零坐标校核。
  3. 坐标全部未校验:真实监测点与设备的 coordinateValidation 均为 UNVERIFIED / renderable=false,按契约不得上图。这是「没有显示」的一个独立且正确的成因,与图层接线问题必须分开处理。
  4. 设施统计口径:界面设施总数 1001,真实管网表 5268 条(成因归后端执行票 20)。

范围

  1. 明确设施点位与管线几何的权威读取路径(复用供水 GIS 链路还是驾驶舱自建读模型),并给出跨行业(燃气/供水/排水/窨井)覆盖判定。
  2. 前端接线:把真实设施与管线数据接入 modeLayerPlan,并补齐引擎侧管线数据源的写入与渲染路径(含按行业/片区/模式过滤)。
  3. 设施点位与管线不得借用监测点口径;坐标缺失或不合法时如实呈现为「无地图位置」,不静默隐藏、不伪造位置。
  4. 几何校核纪律与决策票 07 一致:范围、零坐标、未验证坐标都不得静默渲染。
  5. 与后端执行票 20 的设施映射修复协同:映射未修好前不得宣称设施数据真实完整。

验收

浏览器实测:主场景内设施点位与管线按真实几何绘制,切换行业/片区/模式时图层正确显隐;无合法坐标的对象出现在「无地图位置」清单并给出原因;设施总数与后端真实口径一致。

关联

发现于票 18;依赖后端执行票 20(设施映射);坐标校核来源缺失需另行排期。

进度

Status: ready-for-agent Type: task Blocked by: #20 Labels: ready-for-agent, frontend-execution, wayfinder:task

Comments

Answer