Bladeren bron

feat(cockpit): 水户设施点与详情接入

ChenJZ 17 uur geleden
bovenliggende
commit
8352bff54e

+ 22 - 0
src/modules/cockpit/domain/entityDetail.js

@@ -175,6 +175,7 @@ const UNIT_BY_CATEGORY = {
     ENGINEERING_FACILITY: { designFlow: 'm³/s' },
     DRAINAGE_GATE: { designFlow: 'm³/s' },
     DRAINAGE_STORAGE: { designFlow: 'm³/s' },
+    WATER_USER: { initialReading: 'm³', currentReading: 'm³', annualWaterConsumption: 'm³' },
     MANHOLE: { manholeDepth: 'm' },
     EMERGENCY_RESOURCE: {},
     HAZARD: {},
@@ -216,6 +217,13 @@ const SUMMARY_LABELS = {
     manholeDepth: '井深',
     manholeShape: '井形',
     ownershipUnit: '权属单位',
+    userType: '用水户类型',
+    address: '用水地址',
+    contactPerson: '联系人',
+    meterNumber: '水表编号',
+    initialReading: '初始读数',
+    currentReading: '当前读数',
+    annualWaterConsumption: '年用水量',
 }
 /** 同类字段在不同设施里的业务名不同(隐患等级 vs 设施等级),差异只在这里登记。 */
 const SUMMARY_LABELS_BY_CATEGORY = {
@@ -232,6 +240,7 @@ function assetSummary(category, a, status, location) {
         ENGINEERING_FACILITY: ['facilityLevel', 'designFlow', 'storageCapacity'],
         DRAINAGE_GATE: ['facilityLevel', 'designFlow', 'storageCapacity'],
         DRAINAGE_STORAGE: ['facilityLevel', 'designFlow', 'storageCapacity'],
+        WATER_USER: ['currentReading', 'annualWaterConsumption', 'userType'],
         PUMP_STATION: ['pumpCount', 'designFlow', 'powerCapacity'],
         PIPE_NETWORK: ['lengthMeters', 'diameterMillimeters', 'material'],
         MANHOLE: ['manholeDepth', 'manholeShape', 'material', 'ownershipUnit'],
@@ -289,6 +298,7 @@ const FACILITY_CATEGORY_TEXT = {
     ENGINEERING_FACILITY: '排水工程设施',
     DRAINAGE_GATE: '闸门',
     DRAINAGE_STORAGE: '调蓄设施',
+    WATER_USER: '用水户',
     MANHOLE: '窨井',
     EMERGENCY_RESOURCE: '应急资源',
     HAZARD: '危险源',
@@ -396,6 +406,18 @@ const ASSET_FIELD_ROWS = {
     ENGINEERING_FACILITY: ENGINEERING_FACILITY_FIELD_ROWS,
     DRAINAGE_GATE: DRAINAGE_FACILITY_FIELD_ROWS,
     DRAINAGE_STORAGE: DRAINAGE_FACILITY_FIELD_ROWS,
+    // 票 05:用水户字段按后端 water_user_info 实体登记,不借用水厂/泵站/工程设施词表。
+    WATER_USER: [
+        { label: '用水户类型', key: 'userType' },
+        { label: '用水地址', key: 'address', wide: true },
+        { label: '联系人', key: 'contactPerson' },
+        { label: '联系电话', key: 'contactPhone' },
+        { label: '水表编号', key: 'meterNumber' },
+        { label: '初始读数', key: 'initialReading' },
+        { label: '当前读数', key: 'currentReading' },
+        { label: '年用水量', key: 'annualWaterConsumption' },
+        { label: '备注', key: 'remark', wide: true },
+    ],
     PUMP_STATION: [
         { label: '泵站类型', key: 'stationType', format: (v) => pumpStationTypeText(v) },
         { label: '水泵数量', key: 'pumpCount' },

+ 5 - 4
src/modules/cockpit/domain/facilityPoints.js

@@ -16,7 +16,7 @@
  *   · `PUMP_STATION`(泵站)—— 后端两类 `WATER_PUMP_STATION` / `DRAINAGE_PUMP_STATION`
  *     在图例上并为一类,实体类别统一为 `PUMP_STATION`;
  *   · `WATER_SOURCE`(水源地)—— 档案有计数,但 cockpit 未下发实体/坐标(契约缺口);
- *   · `WATER_USER`(用水户)—— 全部 cockpit 端点均未下发(数据/契约缺口)。
+ *   · `WATER_USER`(用水户)—— 票 05 起前端已按目标契约接入详情;旧载荷若未下发则如实留空。
  */
 
 import { NO_MAP_LOCATION_TEXT } from './coordinate.js'
@@ -24,7 +24,7 @@ import { facilityStatusTone } from './entityDetail.js'
 import { districtQuery, industryQuery } from './filterOptions.js'
 // MANHOLE(维护者 2026-11-16):后端 CockpitEntityCategory 与详情服务已支持窨井,
 // 本白名单同步放行 —— 否则后端能回详情、界面却仍提示「设施类别未发布」。
-export const FACILITY_DETAIL_CATEGORIES = Object.freeze(['WATER_PLANT', 'PUMP_STATION', 'PIPE_NETWORK', 'DRAINAGE_GATE', 'DRAINAGE_STORAGE', 'MANHOLE'])
+export const FACILITY_DETAIL_CATEGORIES = Object.freeze(['WATER_PLANT', 'PUMP_STATION', 'PIPE_NETWORK', 'DRAINAGE_GATE', 'DRAINAGE_STORAGE', 'WATER_USER', 'MANHOLE'])
 
 /** 设施点类型的稳定键(进 filterStore、data-* 断言面与测试,不用中文)。 */
 export const FACILITY_POINT_TYPE = Object.freeze({
@@ -98,7 +98,8 @@ export const FACILITY_POINT_TYPES = Object.freeze([
         unit: '户',
         symbol: 'facilityUser',
         archiveCodes: ['WATER_USER'],
-        detailCategory: '',
+        // 票 05:后端目标态已提供 WATER_USER 详情类别,用水户不再是有名无实的图例项。
+        detailCategory: 'WATER_USER',
     },
 ])
 
@@ -357,7 +358,7 @@ export function facilityInventory(archivePayload, points) {
         if (distribution) {
             // 档案类型码经同一个归一函数归到四类(真实 `WATER_PUMP_STATION`/mock `PUMP_STATION` 都认)。
             const matched = distribution.filter((row) => normalizeFacilityType(row && row.code) === meta.key)
-            // 类型没出现在档案分布里=后端未发布该类型(用水户),不是「0 个」。
+            // 类型没出现在档案分布里=后端未发布该类型,不是「0 个」(票 05 的用水户按目标契约应出现)。
             archiveCount = matched.length ? matched.reduce((sum, row) => sum + countOf(row && row.count), 0) : null
         }
         const rows = list ? list.filter((row) => row && row.type === meta.key) : []

+ 5 - 5
src/modules/cockpit/domain/infrastructurePanels.js

@@ -498,9 +498,9 @@ const EMERGENCY_DETAIL_CATEGORY = Object.freeze({
  * 口径:运行信息端点每条指标对应**一个设施**(管网按段逐条),所以按 `facilityKind` 计数
  * 就是设施数量,不需要第二套聚合。四项是维护者点名的:管段 / 水厂 / 水源地 / 用水户 / 泵站。
  *
- * 诚实边界:本端点当前只产出 PIPE_NETWORK / WATER_PLANT / PUMP_STATION / ENGINEERING_FACILITY;
- * 水源地(WATER_SOURCE)与用水户(WATER_USER)在这里**没有数据**,卡片按占位符 + 说明呈现,
- * 不拿别的类型凑数(缺口写进面板的 gap)。
+ * 诚实边界:旧载荷可能只产出 PIPE_NETWORK / WATER_PLANT / PUMP_STATION / ENGINEERING_FACILITY;
+ * 水源地(WATER_SOURCE)与用水户(WATER_USER)若没下发明细指标,卡片按占位符 + 说明呈现,
+ * 不拿别的类型凑数(缺口写进面板的 gap)。票 05 起前端已按目标契约支持用水户详情。
  *
  * @param {Array} metrics `operatingScope()` 交出的指标行(带 `facilityKind`)
  * @returns {Array} 五张 KPI 卡(管段独占一行)
@@ -581,7 +581,7 @@ export const OPERATING_FACILITY_SOURCE_NOTE =
     '设施数量由后端按设施实体逐条下发(水厂、泵站、管网、排水设施各一条),前端只做按类别计数,不做第二套聚合。' +
     '「管段数量」数的是管网类设施条数(一段管网一条记录),与「基础档案」的设施类型分布同源;' +
     '「水厂」「泵站」按设施类别计数。' +
-    '水源地与用水户当前不在本端点的下发范围内,读数按占位符呈现,不拿别的类别凑数。'
+    '水源地与用水户按本端点实际下发的指标计数;若当前载荷未含该类指标则读数留空,不拿别的类别凑数。'
 export function operatingFacilityCards(metrics, extra = {}) {
     const list = Array.isArray(metrics) ? metrics : []
     // 设施类别优先取后端的 facilityKind;老载荷/测试样例没有这个字段时按 metricCode 后缀兜底
@@ -619,7 +619,7 @@ export function operatingFacilityCards(metrics, extra = {}) {
         },
         { key: 'waterPlantCount', label: '水厂', value: valueText(plants), unit: '座' },
         { key: 'waterSourceCount', label: '水源地', value: valueText(sources), unit: '处', hint: sources === null ? '本端点不提供水源地指标,数量见基础档案的设施类型分布' : '' },
-        { key: 'waterUserCount', label: '用水户', value: valueText(users), unit: '户', hint: users === null ? '后端尚未提供用水户台账,读数留空' : '' },
+        { key: 'waterUserCount', label: '用水户', value: valueText(users), unit: '户', hint: users === null ? '本端点未下发用水户指标,读数留空' : '' },
         { key: 'pumpStationCount', label: '泵站', value: valueText(pumps), unit: '座' },
     ]
 }