local-network-enhancement-spec.md 8.0 KB
局部邻域管网与窨井剖切查看
Status: ready-for-agent
Problem Statement
现有局部增强只显示一条圆柱状管段，缺少管壁、接头等形态细节，独立中心定位环容易被误认为设施。用户需要在局部场景内理解附近地下管网、真实监测设备及其信息，并从窨井入口查看井下场景。
Solution
主选管段采用中空管壁、端部法兰/螺栓与分节接缝的行业色示意模型，删除独立中心环。围绕整条选中管段呈现默认50米邻域，可切换25/50/100米；主选段完整、邻近段裁切。设备优先按真实关联示意挂载，无关联但具合法坐标的邻近设备可按同业最近管段固定槽位示意摆放，明确标签。设备点击在增强面板内部展示真实详情。新增窨井剖切入口及井盖/井筒/附近管道设备场景。
User Stories
- 作为值班人员，我希望看见中空管壁和接头细节，以便辨认管道形态而非单根圆柱。
- 作为值班人员，我希望删除场景中心定位环，以免将其误认为实际设施。
- 作为值班人员，我希望主选管段有更精细的细节，以便从周围管网中辨认目标。
- 作为值班人员，我希望行业颜色与主图一致，以便区分燃气、供水、污水、雨水、窨井及未知分类。
- 作为值班人员，我希望查看整条选中管段周围50米的地下管道，以便理解局部空间环境。
- 作为值班人员，我希望切换25/50/100米范围，以便平衡局部细节和周围环境。
- 作为值班人员，我希望主选管段完整显示、邻近管道在范围边缘裁切，以免长管道拉远相机。
- 作为值班人员，我希望邻域尊重当前行业筛选，以便主图与局部场景一致。
- 作为值班人员，我希望看见真实附近设备的示意模型，以便找到可查看信息的设备。
- 作为值班人员，我希望明确区分真实关联设备和仅空间邻近的设备，以免把示意挂载当实际安装资料。
- 作为值班人员，我希望无坐标且无关联的设备留在清单，不伪造安装位置。
- 作为值班人员，我希望在局部场景点击设备后由内部详情栏显示档案、状态和已有读数，以便保留当前场景视角。
- 作为值班人员，我希望缺数据时显示未知/未提供或失败与重试，以免误读为正常或零值。
- 作为值班人员，我希望点击窨井查看井盖与剖切井筒，以便观察井下管网和设备。
- 作为值班人员，我希望窨井缺接管关系时仍可查看附近管道，但明确不是井内接管。
- 作为值班人员，我希望管道状态仅来自已有后端字段，不由设备正常推导健康。
- 作为值班人员，我希望大面板、左键平移、右键旋转、滚轮缩放和视口右键菜单抑制保持一致。
- 作为值班人员，我希望关闭/换选/筛选/离开时取消旧请求并释放资源，以便没有旧模型和旧设备详情残留。
Implementation Decisions
- 已确认扩展局部增强为有界邻域场景，Cesium继续承担全市主图；Three不重建全城。
- 半径口径是到整条主选管段的空间距离；默认50米，选项25/50/100米。窨井使用井位置为中心。
- 主选管段完整；邻近折线仅保留邻域内片段。裁切端是显示边界，不标成事故断口或真实节点。
- 领域计划负责准入、邻域选择/裁切、真实ID、关系类型、示意槽位和语义标签；服务层负责取数、模型、拾取、资源生命周期；Pinia持有选中对象与范围。
- 管壁/法兰/螺栓/接缝是外观示意，不冒充真实安装尺寸、工程连接、实测埋深。图片仅作形态参考，不添加无依据的支墩。
- 设备使用真实身份和真实详情数据。已有监测点设备图层不是邻域全部设备来源，必须核对并补齐可用读取契约。
- 设施关联以真实主键和正式关系为准；保留管段sourceId/networkId，不将code误当关联主键。空间近邻不证明实际连接。
- 无明确关联但坐标合法的邻近设备可按同业最近管段固定槽位示意挂载，显示“邻近设备·示意安装”；没有合适管段按真实位置独立呈现。无坐标无关联仅列清单。
- 点击设备在增强面板内打开详情，复用现有设备详情读取接口，不依赖被覆盖的主图详情浮层；保留真实父监测点身份。
- 窨井场景独立执行票，剖切井筒、井盖和附近管网设备共享邻域/取数能力；缺关系不强行接管。
- 状态与行业颜色分开。状态、读数只来自真实字段，缺管道状态显示“状态未提供”，不默认流动、满水、堵塞或由设备推导健康。
- 保持已交付的大面板、共享配色、场景聚焦、左平移/右旋转/滚轮缩放、关闭与Esc语义。
- 密集邻域需要复杂度/加载状态与实际覆盖提示；不能静默截断后声称完整。具体性能阈值由实施测量记录，不对未知性能作保证。
Testing Decisions
- 用户确认公开领域计划、实际渲染场景对象/材质/输入事件与外壳Vue交互边界；优先完整用户流而非匹配源码字符串。
- 外观：实际Three几何输出检查中空壁、法兰/螺栓与行业色，确认无独立定位环及销毁释放。
- 邻域：已知米制样例、范围边界、折线穿越、主选完整、邻近裁切、多片段、行业筛选、无准入/坏坐标/空集合、数据更新不改源对象。
- 设备：真实ID关联优先、同业邻近示意标签、固定槽位不重叠、无位置清单、不创设备、不借父点坐标；点击真实设备请求并显示内部详情、失败/未知/过期取消。
- 窨井：入口身份、剖切模型、附近与接管区别、缺设备/缺状态/关系悬空、管道设备点击及返回。
- 保持颜色、焦点菜单边界、三键相机行为、关闭/替换/卸载资源释放回归。
- 本仓已有直接Node离线领域、Three renderer注入、Cesium受控拾取、Vue编译/渲染回归可复用。
- 依项目规则不自动build/dev/browser/GPU。离线证据与维护者画面验收分开，不能由对象断言冒称真实视觉验收。
Out of Scope
- Three重建全市、替换Cesium、真实安装/BIM建模、高精工程尺寸、猜测连接或健康状态。
- 未提供依据的混凝土支墩、强行接管、虚构传感器或假读数。
- 修改后端业务数据或设备绑定关系。
维护者后续修订（票54、55）
正式名称为“地下管线详情视图”。精粗和主图管体均由源管径驱动，但按最新反馈恢复8倍横向可视放大（替代54的无放大要求），源管径/显示管径分别保存；长度全部保持地理路径，后端length只保留原值，不拉伸源坐标。主选精模描边、邻管模型或列表可点选切换完整详情。源材质用可辨的程序纹理/凹凸/反射示意，保留行业色，未知码不猜。
详情基础设施模式中必须能查看附近设备，不继承主图设备全隐规则；摘要缺设备清单与显式空清单要分开。逐点返回即呈现已有设备，稳定槽位不随数量重排，示意模型避让8倍显示后的附近管壁；坐标不准入且无关联者仅清单，点击有模型的设备可聚焦。渐进设备/半径变化不重建相机实例。最近视距独立于整场景长度，滚轮沿鼠标命中射线接近，左拖速度依当前和命中视距降低。
执行证据与现场验收边界见54和55；离线通过不代表GPU画面已验收。
Further Notes
方案经8项设计问答、最终方案及4张票粒度/依赖与测试边界确认。执行顺序：50 管道外观/去环；51 邻域管网；52 设备及详情（依赖51）；53 窨井（依赖51、52）。原增强票仍保留现场验收缺口，新需求分票记录，不覆盖其历史。