فهرست منبع

docs(issue-53): record real manhole data source and dangling networkId

ChenJZ 15 ساعت پیش
والد
کامیت
6e42556e5f
1فایلهای تغییر یافته به همراه23 افزوده شده و 0 حذف شده
  1. 23 0
      .scratch/cockpit-shell-panel-layout/issues/53-untitled.md

+ 23 - 0
.scratch/cockpit-shell-panel-layout/issues/53-untitled.md

@@ -59,6 +59,29 @@ Labels: ready-for-human, wayfinder:task
 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. 现场画面验收(只有你能执行)