2026-08-27

目标

完成 T1“供水设施查询与批量导出”的前后端垂直切片，并进行最终验收与代码审查。

结论

五类供水设施支持分页查询、详情查看和按当前筛选条件批量导出。
管网查询支持管径、铺设年份筛选，导出包含铺设年份；日期范围使用顶层 startTime/endTime。
GIS 设施详情缺失和查询异常返回可解释提示；单条线性设施术语使用“供水管线”。
所属区域 尚无已确认实体字段、KingbaseES 字段或接口契约，本轮未臆造实现。

文件变更

后端新增/修正供水设施查询分页、导出映射、GIS 详情错误契约及测试。
前端新增统一查询参数转换、五类设施导出接口、错误提示与详情重试状态及测试。
后端导出接口补齐与前端一致的 yyyy-MM-dd HH:mm:ss 日期绑定契约及反射测试。
本会话追加本文件，记录验收和风险。

验证

mvn -o -pl pipe-network-service/zksy-admin -am test -DfailIfNoTests=false：通过；供水相关测试共 21 项通过。
node --test (Get-ChildItem -Path tests -Filter *.mjs).FullName：12/12 通过。
npm run build:prod：通过，仅有既有 Sass 弃用警告。
根 Maven 全量构建受既有 com.zksy:net-device:1.0.0 外部依赖解析失败阻塞。
浏览器真实冒烟因登录态过期阻塞，未执行任何业务写操作；KingbaseES 生产数据源已确认但未完成带认证的端到端验证。

风险与后续

需在有效登录态和真实 KingbaseES 环境完成五类页面查询、详情、下载冒烟。
后续补齐“所属区域”字段前，需先确认生产 schema 和跨前后端契约。
五个页面及后端服务存在可选重复代码重构项，不作为本 ticket 阻塞项。