窨井剖切与邻近管网监测设备查看

What to build

点击窨井进入井盖+剖切井筒示意场景，显示25/50/100米范围内附近管道和真实设备并支持内部设备详情。保留主图上下文与行业配色、聚焦和三键交互。设备/接管/状态缺资料时如实降级。

Acceptance criteria

窨井独立身份点选进入井下查看，不再将MANHOLE渲染成other方块。
井盖与剖切井筒、附近管道具有可辨模型，尺寸朝向均标为示意。
邻域范围可调，设备模型可点并显示真实详情，主图相机和筛选保留。
有真实关联才作井内接管；缺关联标“附近管道，接管关系未提供”，不强接。
管道状态和设备读数取已有字段，缺状态“未提供”；无设备不虚构，无关系不推断健康。
缺位置/悬空ID/无管线源/部分覆盖/切换关闭取消与资源释放用例。
入口到场景到设备详情离线集成证据，现场画面单独记录。

Blocked by

51, 52

Context

维护者经ask-matt/grilling确认采用剖切井筒+附近管道设备，新执行票；完整方案为本effort local-network-enhancement-spec.md。窨井网络ID历史数据可能悬空，不能当必有正式连接；共用前置邻域与设备能力。

进度

代码与离线回归完成，待维护者实际窨井场景验收。正式MANHOLE行业映射独立manhole模型，通过既有Cesium构件identity→共享选择进入大面板。井盖、开口剖切井筒和底座为示意；共用25/50/100米邻域、管道状态清单、设备模型与内部详情。缺状态写未提供；缺正式关系明确附近管道非实证接管，不造连接或设备。

验证：t53-manhole覆盖窨井计划/井盖井筒/邻近管道/悬空关联、无管线源独立设备取景、深雨水与浅燃气设备真实NDC在初始视锥；t52实际设备raycast/遮挡、内部详情及旧请求隔离共用通过。t23-click-flow实际Vue窗口/设备详情/范围change回归与原三键/颜色/释放回归通过。12个针对性离线脚本通过。依AGENTS未build/dev/browser/GPU，未实际井下安装资料或现场画面核验。

Status: claimed Assignees: codex Assignee: codex Type: task Blocked by: #51, #52 Labels: ready-for-human, wayfinder:task

为什么需要人工接手（2026-10-23 复核）

归类：需人工测试。 判定成立。

代码已实现、7 条验收全部勾选、离线证据齐备；剩下的只有真实画面目检——井盖/剖切井筒的比例朝向是否合理、邻域管道是否可辨、设备图标能否点、内部详情是否正常、定位飞行观感。
AI 不代劳的原因：AGENTS.md 明确禁止自动运行 build/dev/preview/本地服务与浏览器调试、截图，只有维护者在当前对话中明确要求才可执行。因此「跑起来看一眼」这一步只能你来。

不属判断类/外部权限/设计决策：本票没有待裁定的开放问题，也没有待申请的权限；缺真实井内安装资料一项早已按批准的口径降级（「附近管道，接管关系未提供」，不造假连接）。

上游阻塞已实质解除

Blocked by: #51, #52 两张上游票均已关闭（51 于 2026-10-21、52 于 2026-10-23 维护者验收通过）。台账里若仍显示 open，是 Blocked by 静态行与状态不同步，不构成本票的实际阻塞。

与票 52 的共用面（本次必须一起看）

窨井场景复用了邻域与设备能力，票 52 在验收后又改过四处，都会体现在井下场景：

设备图标改为主图同款合成（水滴母版 + 行业内层 + 状态色）；离线态 point-offline、未知态 point-unknown。
管道状态清单分页（每页 8 条）。
设备详情为三维场景内浮动面板（不再是右侧栏内嵌）。
点击设备为 620ms 缓动飞行定位，终点按「设备 + 图标都完整可见」解析求解。

窨井数据来源（2026-10-23 实测，验收前必读）

接口：GET /api/cockpit/v1/infrastructure/geometry（免认证只读，见票 30）。 源头表：manhole_base（feature 的 properties.source 字段直接写着）。 识别方式：industry === 'MANHOLE' + typeCode === 'MANHOLE'；前端 domain/pipeNetwork.js 按 geometry.type === 'Point' 归为构件进 facilities，不按行业判别（契约没有 kind 字段）。

全库只有 3 条窨井，且只有 1 条能用：

code	name	坐标	geometry	renderable
YL-YJ-001	沅陵县窨井001	`[1212, 1212]`（占位脏值）	null	false
YL-YJ-002	沅陵县窨井002	`[1212, 1212]`（占位脏值）	null	false
YL-YJ-003	沅陵县窨井003	`[110.402358, 28.449897]`	Point	true

因此主图上只会出现 1 个窨井（YL-YJ-003）。现场验收时找不到多个窨井是数据现状，不是渲染缺陷。

networkId 三条全部悬空，不指向任何真实管段：

af8192999537c0b7f0013b96e809e96c 被 YL-YJ-001 / YL-YJ-002 / GD-001（煤气管点） 三个 feature 共用 —— 它不是管段主键，而是这批脏数据共享的占位值；
8ae1ad16f3d4ce2e02fabf7218614a49 只被 YL-YJ-003 自己引用，管段表里不存在。

结论：当前不存在可信的「窨井 → 真实管段」关系，所以井下场景显示「附近管道，接管关系未提供」是正确降级，不是未实现。要显示真实井内接管，需运维把这些 network_id 修到真实管段主键（与票 52 的设施关系缺口同源）。

给维护者的实施清单

A. 现场画面验收（只有你能执行）

启动前端（yarn dev），打开 http://127.0.0.1:8000/#/cockpit。
在主图切到窨井/排水相关行业或筛选，找到一处窨井并点击。
- 检查点：窨井应作为独立对象进入「地下管线详情视图」，不能被画成 other 方块。
目检场景构成：
- 井盖在顶、井筒为开口剖切、有底座；三者比例朝向合理（票面标为示意，不要求工程精度）。
- 附近管道可辨，按行业配色，与主图配色一致。
设备：场景里应有设备图标；点击图标 → 从场景浮动弹出内部详情；再点右侧清单里的设备，应同样先飞行过去再开详情。
- 检查点：设备与它的点位图标都不能被画面裁切（票 52 末次修复点）。
邻域切换 25 / 50 / 100 米，确认管道与设备随之变化、旧详情被取消。
关闭视图：确认主图相机与筛选保持原状，三维资源正常释放（无控制台报错、无残留画布）。
边界抽查（如数据中存在）：没有真实关联的窨井应显示「附近管道，接管关系未提供」，不得画出井内接管；无设备的窨井不虚构设备；无状态的管道/设备显示「未提供」。

B. 需要你留意的两处既有降级（不是缺陷）

井内接管：当前没有可信的窨井-管道正式关系数据，界面按已批准口径标「附近管道，接管关系未提供」。若你要求显示真实接管，需要运维补数据（与票 52 的设施关系缺口同源）。
行业缺失的独立设备：没有 industry 的设备与主图规则一致，不会显示类型图标。

C. 不在本票范围

邻域裁切范围（51）、设备示意挂载与关联契约（52）、真实管径与材质（54）、按设备类型取指标（56）。本票不作真实井内安装声明。

本轮复核记录（2026-10-23）

复跑 t53-manhole（窨井身份计划 → 剖切井筒与井盖、邻近管道、不造接管/状态）通过；票 52 共用能力 t52-camera-flight、t52-device-pick、t23-click-flow、t23-sfc-compile 均通过；整套 t50-53-local-enhancement 12/12。
代码路径核对：threePipeEnhancement.js 内 renderKind === 'manhole' 分支产出 manhole-shaft / manhole-cover，窨井不复用 other 方块。
按 AGENTS 未跑 build/dev/browser，未做任何画面核验。

Comments

Answer

窨井剖切代码与离线验证完成；不作真实井内安装声明，待现场视觉确认。

当前状态：已认领（codex），7 条验收勾选，离线回归全绿；唯一剩余动作是维护者到 http://127.0.0.1:8000/#/cockpit 点窨井做画面目检（按上表 A 的 7 步）。验收通过后关闭本票并在 map 的 Decisions so far 追加一行。

53-untitled.md 8.6 KB Historie Surový