# 管网业务服务

该上下文承载“城市地下管网及设施建设改造智能化系统项目”软件平台中“地下管网管控平台”的管网业务。当前交付边界聚焦供水子系统“供水管网安全运行监测系统”，覆盖供水设施、监测设备、运行监测、监测报警和工单处置；供水前端与管理端后端共同构成该子系统的完整业务体验。

## Product Boundary

**供水管网安全运行监测系统**：地下管网管控平台中的供水业务子系统，覆盖首页、供水设施管理、监测设备管理、运行监测、监测报警及其关联的查询、统计、GIS、报警和工单操作。
_Avoid_：把供水子系统等同于单一的报警页面，或把监测设备等同于供水设施

## 供水子系统功能需求结构

以下结构描述供水管网安全运行监测系统的业务能力边界，并与已确认的菜单层级保持一致。供水系统的设备台账、异常、监测和工单页面只处理设备类型树判定为“供水”的对象；设备类型未知或未归属时不得静默归入供水。

清单、查询和统计页面不各自嵌入 GIS 联动定位；设施、监测设备和报警的定位与空间详情分别集中在本组的 GIS 一张图中。批量导出属于各清单或统计能力的一部分，但不改变 GIS 集中承载规则。

### 1. 供水设施管理

1.1 **管网信息查询**：清单化展示供水管线和管点，支持按管材、管径、建设年代、所属区域及关键字进行多条件查询和批量导出。

1.2 **水厂信息查询**：提供水厂信息的关键字和分类查询，以及批量导出。

1.3 **泵站信息查询**：提供泵站信息的分类查询和批量导出。

1.4 **水源地信息查询**：提供水源地信息的分类查询和批量导出。

1.5 **用水户信息查询**：面向居民、工业、商业、行政事业等全部用水户，提供多维分类查询和批量导出。

1.6 **管网数据统计分析**：对供水管网数据进行多维统计分析，以柱状图、饼图、表格等形式展示，并支持结果下载导出。

1.7 **供水设施 GIS 一张图**：在同一地图中展示水源地、水厂、泵站、供水管线和用水户，支持设施搜索、定位和详情查看；本功能范围不包含消火栓。

### 2. 监测设备管理

2.1 **设备台账管理**：对供水监测设备进行台账化管理，提供分类统计、查询和批量导出。

2.2 **设备异常管理**：集中展示当前运行异常的供水监测设备，提供异常分类查询、处置状态跟踪和批量导出；可从异常设备进入故障维修工单派发，但本页面的主要职责是异常态势和台账管理。

2.3 **设备维修派单**：面向已判定运行故障且不存在适用未结束同类工单的供水监测设备，创建并派发 `1-故障维修` 工单。

2.4 **设备维修记录**：管理设备历史维修记录，支持多维查询、修改、删除、批量导入和批量导出。

2.5 **监测设备 GIS 一张图**：在地图中展示各类供水监测设备及其监测点位，支持设备搜索、定位和详情查看。

### 3. 运行监测

3.1 **流量监测**：接入既有流量计监测数据，清单化展示流量监测点位，支持多条件查询和批量导出。

3.2 **压力监测**：接入既有压力计监测数据，清单化展示压力监测点位，支持多条件查询和批量导出。

3.3 **漏失监测**：接入新建漏失声波监测数据，清单化展示漏失监测点位，支持多条件查询和批量导出。

### 4. 监测报警

4.1 **报警管理**：依据各类监测设备的阈值规则和其他自动报警规则触发报警，展示报警等级、设备报警状态、报警记录状态及关联工单；报警记录进入工单处置流程时生成不指定责任人的待派单故障维修工单，本页面可发起责任人派发但不承载后续完整处置。不同报警类型可形成不同工单；同一设备同一报警类型同时只能存在一个未结束的同类报警工单。

4.2 **报警审核**：提供报警审核或解除结果、意见和附件录入，并跟踪报警关联工单的完整处置流程；在供水系统内，该入口重点承载供水设备故障维修工单的派发、接单、处理、提交验收、验收、驳回和结案。

4.3 **阈值管理**：支持按传感器分类批量设置阈值、设置分时阈值并查询已配置点位的阈值详情。

4.4 **监测报警一张图**：在地图中展示供水各类报警点位，按报警级别以一级红色、二级橙色、三级蓝色、四级绿色突出显示，支持报警搜索、定位和详情查看。

### 工单视图分工

统一工单视图集中检索和处置所有供水类型工单，包括 `1-故障维修`、`2-日常巡检` 和 `3-设备保养`；报警审核视图聚焦供水故障维修工单。巡检或保养工单即使由其他系统派发给供水用户，仍可在统一工单视图中继续接单、处理和验收。

## 供水设施

**供水设施**：
构成供水系统并被登记、查询、统计或在地图上展示的业务对象，包括水源地、水厂、泵站、供水管线和用水户；水厂、泵站等是设施，不是监测设备。
_Avoid_：把监测设备统称为供水设施

**水源地**：
为供水系统提供原水的来源地。
_Avoid_：水源、水源点

**水厂**：
对原水进行处理并形成可供给用水户水量的生产设施。
_Avoid_：供水厂、制水厂

**泵站**：
通过水泵为输水过程提供输送或增压能力的设施。泵站为供水/排水共用对象，物理表 `app_user.pump_station`（由 `water_pump_station` 迁移改名）以 `station_type` 区分：`water_supply`=供水泵站、`drainage`=排水泵站；各系统只读写本系统类型的行，类型由后端按入口强制写入（ADR-0007）。
_Avoid_：加压站
_规则_：查询、统计、GIS、回收站与导入导出必须带 `station_type` 归属条件；禁止出现"一张泵站表两个系统共用却不过滤"的查询。

**供水管线**：
连接供水设施并输送水的线性设施。
_Avoid_：管网、管道（指单条设施时）

**管点**：
供水管线上的节点或点状设施，作为管网查询、统计和空间展示的独立业务对象。
_Avoid_：监测点（指监测设备所在位置时）

**用水户**：
接受供水服务的居民、工业、商业或行政事业主体。
_Avoid_：大用水户（除非明确指满足特定用水量或重要性标准的子集）、用户

兼容映射：既有设施类型编码 `user`、接口区块 `waterUser`、Java 类型 `WaterUserInfo`、
持久化表 `water_user_info` 及其 `user_*` 字段均表示“用水户”，覆盖居民、工业、商业和
行政事业等全部类型。为保持现有接口与数据兼容，这些技术标识继续保留，不表示“大用水户”子集。

**契约缺口**：
当前五类供水设施实体、查询服务签名和 KingbaseES DDL 均未定义 `region`/所属区域字段；在字段和数据来源确认前，不得为区域筛选臆造数据库列或查询条件。区域筛选需另行完成 REST、模型和数据库契约评审。

## 运行监测

**驾驶舱事件等级展示颜色**：
面向城市生命线驾驶舱的预警/报警事件展示统一使用 1 级红色、2 级黄色、3 级蓝色、4 级绿色；该展示约定不改变后端等级数值的业务含义，也不等同于监测点主图标的正常/预警/报警/工单/离线状态色。
_Avoid_：将历史预警颜色配置直接当作驾驶舱点位状态色

**驾驶舱地图摘要接口**：
面向 UE/大屏只读展示的分页接口，返回监测点、关联设备摘要和未关联设备摘要，以及后端解析后的点位状态、原因、统计、新鲜度和快照时间。专用接口 JSON 字段统一使用驼峰命名，包括 `deviceCode`、`pointCode`、`pointStatus` 和 `snapshotAt`。默认分页大小为 500，最大 1000；UE 不通过拼接管理接口自行计算点位状态。

**驾驶舱设备详情聚合接口**：
按数据库设备编码 `equipment_base.equipment_code` 查询并以 `deviceCode` 返回设备基础档案、类别、当前状态、最新监测数据、预警、报警、工单当前状态、工单状态时间线和最新设备图片的只读接口。内部可以联查多张表，但对 UE 暴露稳定聚合契约。

**驾驶舱监测点详情聚合接口**：
按 `point_code` 返回监测点基础信息、坐标校验、所属管网、点位状态、关联设备摘要及关联异常说明的只读接口。管理端监测点接口不自动等同于驾驶舱契约。

**监测设备**：
用于采集供水运行数据的带传感器智能设备，例如水位、压力或流量监测设备；带传感器的井盖也属于监测设备。它与被监测的供水设施是不同业务对象。
_Avoid_：供水设施、监测点（指设备本身时）

**设备编码**：
平台内监测设备的唯一业务标识，格式为“区域-类型-YYYYMMDD+4位流水号”。区域取 CN/CB/TC，业务类型取 RQ/GS/PS/YJ，排水可再细分为 YS/WS；例如 CN-GS-202609020001、TC-PS-YS-202609020012。设备编码用于跨系统定位设备，不承载设备当前状态或报警语义。
_Avoid_：数据库主键、报警编号、工单编号

**设备异常**：
监测设备当前处于报警或维修状态的统称，可由一个或多个报警记录或处置过程造成。
_Avoid_：报警记录（指一次事件时）、故障（原因尚未确认时）

**设备报警状态**：
表示监测设备当前是否处于报警中的设备级状态；`0` 表示正常，`1` 表示报警，是判断设备当前是否报警的主要依据，由运行系统根据设备的有效报警原因自动维护。
_Avoid_：报警记录状态、工单状态

**有效报警原因**：
当前仍满足报警条件、尚未自行恢复的设备异常原因；同一设备可以同时存在多个有效报警原因。
_Avoid_：报警记录、未结工单

**报警记录**：
设备因阈值越界或其他自动报警原因而产生的一次事件记录，用于保留报警事实和历史，不作为设备当前是否报警的主要依据。
_Avoid_：设备报警状态、设备异常

**报警记录状态**：
表示单条报警记录是否已经人工处置的辅助状态；它不决定设备当前是否处于报警中。
_Avoid_：设备报警状态

**报警恢复**：
某个有效报警原因不再满足报警条件的结果，可由实时监测数据、上游恢复事件或有权限人员的人工确认产生。
_Avoid_：报警记录已处理、工单结案

**清警复核**：
汇总检查设备是否仍有有效报警原因的活动；报警恢复或工单结案可以触发复核，但只有不存在有效报警原因时才允许清警。
_Avoid_：直接清警、工单验收

**自动清警**：
运行系统确认设备的所有有效报警原因均已消除后，将设备报警状态从报警恢复为正常；任一报警原因仍有效时不得清警。
_Avoid_：工单结案、报警记录已处理

**报警转工单**：
报警记录进入工单处置流程时生成待派单的故障维修工单，生成时不指定接单责任人；后续派发和处置由工单流程完成。
_Avoid_：报警派单、报警处理

## 工单处置

**工单**：
对设备故障、日常巡检或设备保养进行分派、执行和跟踪的跨系统统一处置载体；供水、排水、燃气、窨井等系统通过关联设备类型区分业务归属，共享工单生命周期。
_Avoid_：维修任务、报警工单（作为独立于工单的概念）

**工单系统归属**：
工单所属系统由关联设备的设备类型树确定，而不是由前端页面名称或单独的“报警工单”概念确定；未知或未归属设备不得被静默归入某个系统。
_Avoid_：用页面入口、工单标题或报警记录状态推断系统归属

**故障维修工单**：
用于核实并修复设备故障的工单，工单类型为 `1`；由设备维修需求或监测报警转入的处置都属于此类型。
_Avoid_：维修任务、报警工单

**同类报警工单**：
同一设备针对同一报警类型建立的故障维修工单；同一设备同一报警类型同时只能存在一个未结束的同类报警工单。
_Avoid_：同一报警记录、同设备全部工单

**工单派发**：
为待派单工单指定唯一接单责任人的活动；可从设备维修派单、设备异常管理或报警管理入口进入，但报警转工单本身不等同于派发。
_Avoid_：报警处理、报警审核

**工单处置**：
被派单人员对工单执行接收、处理、提交验收和结案等后续活动；工单进度不直接决定设备报警状态，也不阻止设备满足恢复条件时自动清警。
_Avoid_：报警审核（指工单后续操作时）、报警记录已处理

**工单验收**：
对工单处置结果是否满足要求进行确认的活动；验收通过可以使工单结案，但不直接清除设备报警状态。
_Avoid_：报警审核、自动清警

**工单处置证据**：
与工单处置阶段关联的说明和图片，至少区分处理前与处置后，用于责任人处理、验收审核和历史追溯。
_Avoid_：把处置证据等同于报警记录状态或设备当前状态

**随同修复**：
一次故障维修同时消除了同一设备其他有效报警原因的处置结果；设备是否清警仍由运行系统复核有效报警原因决定，相关工单记录继续保留并按各自流程验收结案。
_Avoid_：自动结案、重复维修

**日常巡检工单**：
用于执行计划内或临时巡查的工单，工单类型为 `2`。
_Avoid_：巡检任务

**设备保养工单**：
用于执行设备预防性保养的工单，工单类型为 `3`。
_Avoid_：保养任务、维修工单