# 窨井剖切与邻近管网监测设备查看 ## What to build 点击窨井进入井盖+剖切井筒示意场景，显示25/50/100米范围内附近管道和真实设备并支持内部设备详情。保留主图上下文与行业配色、聚焦和三键交互。设备/接管/状态缺资料时如实降级。 ## Acceptance criteria - [x] 窨井独立身份点选进入井下查看，不再将MANHOLE渲染成other方块。 - [x] 井盖与剖切井筒、附近管道具有可辨模型，尺寸朝向均标为示意。 - [x] 邻域范围可调，设备模型可点并显示真实详情，主图相机和筛选保留。 - [x] 有真实关联才作井内接管；缺关联标“附近管道，接管关系未提供”，不强接。 - [x] 管道状态和设备读数取已有字段，缺状态“未提供”；无设备不虚构，无关系不推断健康。 - [x] 缺位置/悬空ID/无管线源/部分覆盖/切换关闭取消与资源释放用例。 - [x] 入口到场景到设备详情离线集成证据，现场画面单独记录。 ## 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 在验收后又改过四处，**都会体现在井下场景**： 1. 设备图标改为**主图同款**合成（水滴母版 + 行业内层 + 状态色）；离线态 `point-offline`、未知态 `point-unknown`。 2. 管道状态清单**分页**（每页 8 条）。 3. 设备详情为**三维场景内浮动面板**（不再是右侧栏内嵌）。 4. 点击设备为 **620ms 缓动飞行定位**，终点按「设备 + 图标都完整可见」解析求解。 ## 窨井数据来源（2026-10-23 实测，验收前必读） **接口**：`GET /api/cockpit/v1/infrastructure/geometry`（免认证只读，见 [票 30](30-untitled.md)）。 **源头表**：`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. 现场画面验收（只有你能执行） 1. 启动前端（`yarn dev`），打开 `http://127.0.0.1:8000/#/cockpit`。 2. 在主图切到**窨井/排水**相关行业或筛选，找到一处窨井并点击。 - 检查点：窨井应作为**独立对象**进入「地下管线详情视图」，**不能**被画成 other 方块。 3. 目检场景构成： - 井盖在顶、井筒为开口剖切、有底座；三者比例朝向合理（票面标为示意，不要求工程精度）。 - 附近管道可辨，按行业配色，与主图配色一致。 4. 设备：场景里应有设备图标；点击图标 → 从场景**浮动**弹出内部详情；再点右侧清单里的设备，应同样先**飞行**过去再开详情。 - 检查点：设备与它的点位图标**都不能被画面裁切**（票 52 末次修复点）。 5. 邻域切换 25 / 50 / 100 米，确认管道与设备随之变化、旧详情被取消。 6. 关闭视图：确认主图相机与筛选**保持原状**，三维资源正常释放（无控制台报错、无残留画布）。 7. 边界抽查（如数据中存在）：没有真实关联的窨井应显示「附近管道，接管关系未提供」，**不得**画出井内接管；无设备的窨井不虚构设备；无状态的管道/设备显示「未提供」。 ### B. 需要你留意的两处既有降级（不是缺陷） - **井内接管**：当前没有可信的窨井-管道正式关系数据，界面按已批准口径标「附近管道，接管关系未提供」。若你要求显示真实接管，需要运维补数据（与票 52 的设施关系缺口同源）。 - **行业缺失的独立设备**：没有 `industry` 的设备与主图规则一致，不会显示类型图标。 ### C. 不在本票范围 邻域裁切范围（[51](51-untitled.md)）、设备示意挂载与关联契约（[52](52-untitled.md)）、真实管径与材质（[54](54-untitled.md)）、按设备类型取指标（[56](56-untitled.md)）。本票**不作**真实井内安装声明。 ## 本轮复核记录（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 追加一行。