20-20-0-1.md 2.6 KB

20: 后端执行票 —— 管网编码 0/1 映射与设备边界设施类型命名空间

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

来源

票 18 真实数据口径核对(2026-10-10),并由真人走查第 4 项佐证(界面设施总数 1001,实际 5268)。

现象

  1. 管网数字编码漏计:业务 GIS 既有规则为 pipe_network_base.network_type 0=燃气 / 1=排水 / 2=供水(见 zksy-admin 的 GIS 控制器)。但基础档案、管理信息、运行信息、总体概览四个适配器只兼容 2=供水、3=燃气 与行业文字,0/1 被直接跳过。真实分组 0=537、1=3735、2=996 → 4272 条管网未进入任何正式统计。因过滤发生在适配器内,响应 excluded=0 不能作为完整性证据。
  2. 设施类型命名空间误用:设备边界只用 equipment_type(监测设备类型)建字典,却用同一编码去解释设施 network_type,导致真实 3735 条排水设施被标为「供水设备 / WATER_SUPPLY」、996 条供水设施被标为「排水设备 / DRAINAGE」。
  3. 概览强制置空:overview/infrastructure 把所有管网设施行业置 null,正式行业统计只得到 8(水厂 3 + 供水泵站 5),excluded.unknownTypeCount=5268。

范围

  1. 建立管网设施类型与行业的单一权威来源,与既有 GIS 规则一致,覆盖 0/1/2 与历史字符串。
  2. 修正基础档案、管理信息、运行信息、总体概览四个适配器的映射与行业归属,不再静默 continue。
  3. 修正设备边界的设施类型解析:设施不得借用监测设备类型字典。
  4. 保留口径差异说明:base-archives(水厂/泵站/管网/排水工程设施)与 management(窨井/管网/水源地)本属不同对象域,但两者都必须包含全部管网。
  5. 补契约测试:四行业管网各自计数正确、0/1/2 不再丢失、跨端点管网总量一致。

验收

真实环境复验:base-archives 管网计数应覆盖 537+3735+996;概览不再把管网整体排除;设备边界设施类型名称与行业正确。编译 + Cockpit*Test 全绿 + 提交推送 + 基线卡片更新。

关联

发现于票 18;与票 25 后端契约缺口台账同源,需回写。

进度

Status: ready-for-agent Type: task Blocked by: Labels: ready-for-agent, backend-execution, wayfinder:task

Comments

Answer