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 阻塞项。

追加验收

提交 src/api/pipeNetwork/waterSupply.js，使设施导出 API 在干净检出后可解析。
提交五个 waterSupply/facility 路由包装组件，保证动态菜单组件路径可加载。
用水户页面的可见字段、校验和删除提示统一使用“用水户”术语。
追加验证：node --test tests/waterFacilityQuery.test.mjs 5/5 通过，npm run build:prod 通过；代码审查以 origin/master...HEAD 为固定点。

Issue #5 人工验收与详情抽屉修正

用户在本地 8301 后端与 5173 前端环境完成 Issue #5 人工验收，核心功能基本通过。
用户已修复部分页面字段自动换行造成的布局错位。
设备异常/维修相关详情及报警详情由居中弹窗改为右侧抽屉，长字段允许在内容区换行，768px 以下抽屉使用全宽。
验证：前端 Node 测试 12/12 通过，npm run build:prod 通过，仅存在既有 Sass 弃用警告。
两轴代码审查固定点为 origin/master。抽屉与响应式字段处理通过；审查保留的后续风险包括报警/设备状态字段分离、设备异常页活动工单过滤、报警到工单两步流程、唯一责任人、多阶段工单图片及原位错误重试。