city-life-line/memory/sessions/2026-08-27.md

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 为固定点。