gunshi-project-ss/deprecated/第5章_功能设计.md

# 第5章 功能设计 - 代码库映射

## 5.1 梳理集成基础数据

### 5.1.1 设计思路

为梳理集成完整的、准确的、权威的湖北山洪灾害基础数据，需对基础数据进行全量调研和评估，分析其质量、完整性、准确性，识别可能存在的数据缺失、错误或不一致等问题。

**代码库实现**：
- **数据模型**：`src/main/java/com/gunshi/project/hsz/model/AttResBase.java` - 防治对象基础数据模型
- **数据服务**：`src/main/java/com/gunshi/project/hsz/service/AttResBaseService.java` - 防治对象基础数据管理服务
- **数据验证**：通过JSR-303验证注解和业务逻辑验证确保数据质量

### 5.1.2 梳理集成防治对象调查评价成果

对2013年以来调查评价未覆盖的重要经济活动区和旅游景区及因脱贫攻坚等规划战略实施整体搬迁、风险源发生变化的村庄等开展调查评价。

本次97个重点防治对象调查评价成果数据包含：

1. **调查评价成果报告**：描述调查评价的组织过程、实施过程和调查评价成果
2. **调查评价成果图集**：将调查和评价成果以防治对象为单元形成图集
3. **调查评价成果数据**：将调查收集的资料、表格、照片整理形成纸质版和电子版数据体系

**代码库实现**：
- **防治对象管理**：`src/main/java/com/gunshi/project/hsz/service/AttResBaseService.java:75-78` - 防治对象信息管理
- **数据关联**：`src/main/java/com/gunshi/project/hsz/service/FileAssociationsService.java` - 文件关联和数据关联
- **树形结构**：`src/main/java/com/gunshi/project/hsz/service/AttResBaseService.java:44-67` - 防治对象树形结构展示

### 5.1.3 风险隐患调查与影响分析成果集成

山洪灾害风险隐患调查与影响分析工作以受山洪威胁的城镇、集镇、沿河村落、经济活动区、旅游景区等对象为调查对象。

本次107条小流域风险隐患调查和影响分析的结论性成果主要包括：

1. **电子数据**
   - 风险隐患要素及防治对象数据
   - 断面数据
   - 空间数据
   - 照片

2. **文字报告**
   - 对山洪灾害风险隐患调查与影响分析成果报告进行录入，提供在线查看审阅

3. **成果报表**
   - 重点关注对象详查名录表
   - 防治对象-监测设备关系表
   - 山洪灾害防治对象名录
   - 跨沟道路、桥涵、塘（堰）坝调查成果表
   - 沟滩占地情况调查成果表
   - 干流顶托城集镇及村落调查分析成果表

**代码库实现**：
- **断面数据模型**：`src/main/java/com/gunshi/project/hsz/model/AttResDetail.java` - 防治部位详细数据模型
- **文件关联**：`src/main/java/com/gunshi/project/hsz/model/FileAssociations.java` - 文件关联模型
- **空间数据处理**：通过JTS空间数据库处理地理空间数据

### 5.1.4 数据治理入库和应用集成

防治对象调查评价成果、风险隐患调查与影响分析成果都需要经过数据治理，得到符合规范的主题数据后再集成。

数据治理需要经过数据提取、数据清洗、数据整合、数据转换、数据解耦和重组、数据入库六个步骤。

**代码库实现**：
- **数据清洗**：`src/main/java/com/gunshi/project/hsz/timetask/DataTaskHsz.java` - 数据同步和清洗
- **批量处理**：`DataTaskHsz.java:122-237` - 批量数据保存和处理
- **事务管理**：所有服务类使用`@Transactional`注解确保数据一致性

### 5.1.5 小流域治理单元建档立卡

以1309小流域治理单元为基础单元，运用地理信息系统（GIS）技术，通过关联汇聚小流域治理单元范围内的各类基础和监测数据，形成小流域治理单元基本信息。

主要包括：
- **流域基础信息**：梳理全省1309个小流域治理单元基础信息
- **各类雨量（水位）站点信息**：关联汇聚范围内各类站点信息
- **降雨预报成果数据**：形成小流域降雨预报网格化数据成果
- **调查评价成果数据**：构建小流域治理单元的调查评价成果数据库
- **流域关系**：通过地图数据识别并划定流域内的各级河流，运用空间分析算法，生成小流域上下游关系拓扑图

**代码库实现**：
- **小流域管理**：`src/main/java/com/gunshi/project/hsz/service/WatershedService.java` - 小流域管理服务
- **空间处理**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java:263-314` - 空间数据处理算法
- **站点关联**：`src/main/java/com/gunshi/project/hsz/service/StStbprpBService.java` - 测站基础信息管理

## 5.2 算法模型建设方案

针对本次项目涉及的107个小流域治理单元，开发建设小流域分布式水文模型和简化淹没范围与水深分析模型。

### 5.2.1 模型建模范围确定

#### 5.2.1.1 小流域设计暴雨计算
根据《湖北省暴雨统计参数等值线图集》（2008年）中湖北省年最大10min、1h、6h和24h标准历时点雨量均值等值线图及相应历时暴雨参数值等值线图，查算4种标准历时的设计暴雨均值。

#### 5.2.1.2 小流域设计洪水计算
包括净雨计算和设计洪水计算方法：
- **瞬时单位线**：地表径流计算、地下径流计算、设计洪水过程
- **经验公式法**：根据小流域所在水文分区和面积，不同标准的洪峰流量按照经验公式法参数查算表选取

#### 5.2.1.3 50、100、300年一遇洪水淹没范围分析
采用HEC-RAS二维水动力学模型进行计算，可进行一维恒定流、一维或二维非恒定流水力计算。

**代码库实现**：
- **洪水算法库**：`pom.xml:137-154` - 引入 `flood_algorithm` 依赖
- **模型接口**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java` - 预报服务集成算法库
- **空间计算**：`ForecastService.java:76-106` - 网格降雨量计算算法

### 5.2.2 小流域分布式水文模型精细建模

#### 5.2.2.1 小流域计算单元划分及属性提取
每个小流域划分计算单元不一样，提取的属性也不一样。湖北省小流域划分及基础属性提取，包括基础数据收集整理、小流域划分及基础属性提取、小流域统一编码、空间拓扑关系建立、逐级合并大流域、小流域标准化单位线提取等过程。

#### 5.2.2.2 面雨量权重值计算
基于雨量站分布情况，计算小流域面雨量的权重值：
- **泰森多边形**：根据离散分布的气象站的降雨量来计算平均降雨量
- **反距离加权**：一种简便、常用的空间插值方法
- **克里金插值**：根据实测数据对研究点的取值进行线性无偏最优估计

**代码库实现**：
- **面雨量计算**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java:76-106` - 网格降雨量计算算法
- **插值算法**：通过JTS空间库实现空间插值
- **权重计算**：`ForecastService.java:263-314` - 区域面降雨量计算算法

#### 5.2.2.3 蒸散发量计算
通过收集各类气象观测要素信息，按照蒸散发模型的公式，计算蒸散发量：
- **FAO Penman-Monteith**：计算可能蒸散发量的最新方法
- **新安江三层蒸发**：将土层分为三层，用以概化蒸散发计算

#### 5.2.2.4 产流模型参数确定
分析确定产流模型参数，每个小流域选用的模型参数都不同：
- **新安江三水源产流**：按照三层蒸散发模式计算流域蒸散发，按蓄满产流概念计算降雨产生的总径流量
- **垂向混合产流**：将超渗产流和蓄满产流在垂向上进行组合

#### 5.2.2.5 单位线提取
提取10min、30min、1小时每个小流域计算单元的单位线：
- **标准化单位线**：利用流域的时间~面积关系分析单位线
- **Nash瞬时单位线**：将河道汇流系统简化为n个串联的线性水库
- **综合单位线**：选用集水面积为2.30~950平方公里的50个水文站共639场雨洪对应资料分析综合

#### 5.2.2.6 河道演进模型参数确定
对每个小流域内的河段，逐河段进行断面概化，初步确定河道演进模型中的两个关键参数k和x：
- **马斯京根流量演算法**：通过槽蓄方程反映流量和水面比降对槽蓄量的影响
- **考虑洪水漫滩的流量修正方法**：结合高精度遥感影像数据，估算漫滩水量平均长度

**代码库实现**：
- **模型参数管理**：通过算法库的配置管理模型参数
- **河道演进**：`flood_algorithm` 库中的水动力模型实现
- **参数优化**：通过历史数据反演优化模型参数

### 5.2.3 模块化水文模型集成
本项目拟采用基于标准封装器的可交互集成方法实现水文模块的动态集成。

### 5.2.4 模型精度评估
收集有小流域历史雨洪资料，对小流域分布式水文模型进行精度评估。评估指标主要包括径流深相对误差、洪峰流量相对误差、峰现时间误差和纳什效率系数等。

### 5.2.5 模型参数率定
结合收集的小流域历史雨洪资料，采用参数自动优化和人工优化相结合，对小流域分布式水文模型进行参数优化。

### 5.2.6 107条小流域分布式水文模型概化图
[详细图表内容]

## 5.3 简化淹没范围与水深分析模型

简化淹没范围与水深分析模型是在河道断面测量基础上，采用曼宁公式等方法推求河道断面水位-流量关系，结合分布式水文模型计算的河道流量，推求不同断面的水位，并勾绘形成区域淹没范围。

### 5.3.1 所需数据收集与整编

#### 5.3.1.1 基础地理信息数据
1. 107个小流域范围最新时相遥感影像（DOM）数据，分辨率优于2m
2. 107个小流域范围内重要城集镇、规模较大的沿河村落所在区域DEM数据（分辨率优于30m）
3. 河道纵断面和横断面测量数据

#### 5.3.1.2 山洪灾害调查评价成果
1. 设计暴雨：10min、1h、6h、24h等时段，5年、10年、20年、50年、100年等重现期下的雨量及时程分配
2. 设计洪水：重现期与设计暴雨一致，河段的精细程度应与重要城集镇和规模较大沿河村落的范围相适应
3. 居民住户资料：包括居民点位置、户主信息、住户数量、联系方式

#### 5.3.1.3 风险隐患调查成果
按照《山洪灾害补充调查评价技术要求（风险隐患调查与影响分析）（试行）》要求，汇集跨沟道路、桥涵和塘堰坝的调查数据等。

**代码库实现**：
- **GRIB2数据处理**：`src/main/java/com/gunshi/project/hsz/grb/RainGrib2Layer.java` - GRIB2网格数据模型
- **空间数据管理**：通过JTS空间库管理地理空间数据
- **文件存储**：`src/main/java/com/gunshi/project/hsz/service/FileAssociationsService.java` - 文件关联和管理

### 5.3.2 资料质量评估

#### 5.3.2.1 数据完整性分析
根据需求确定建模范围，分析收集流域及防灾对象基础数据和调查数据等直接数据和河道形状、底床材料等分析计算所需的间接信息。

#### 5.3.2.2 断面数据评估
根据简化洪水淹没分析模型需要，对隐患调查工作中断面测量提出需求，根据分析对象附近的河道情况，按照从上游到下游的顺序，沿河道进行断面划分。

#### 5.3.2.3 DEM数据修正
将各实测断面数据断面基点与相应位置DEM高程值进行对比，确保断面测量高程系与DEM数据高程系的一致性，并以实测数据高程为基准，修正DEM数据高程。

**代码库实现**：
- **数据验证**：通过JSR-303验证注解和业务逻辑验证确保数据完整性
- **数据清洗**：`src/main/java/com/gunshi/project/hsz/timetask/DataTaskHsz.java` - 数据同步和清洗逻辑
- **高程修正**：通过空间算法进行DEM数据修正

### 5.3.3 断面类型划分
根据分析对象所在横纵断面形态及分析对象位置，结合最新时相高分辨率遥感影像，将断面划分为3种类型：
1. **河道洪水型断面**：分析对象控制断面、上游及下游断面均为相对规整的抛物线型或矩形等
2. **滞留洪水型断面**：分析对象控制断面、上游及下游断面均为复合型断面，主河道过水面积明显小于两侧滩地
3. **封阻洪水型断面**：分析对象下游附近沟道缩窄或下游断面附近有路堤、桥梁、堰坝等明显的阻水建筑物

### 5.3.4 构建断面水位流量关系
对已测量的河道断面的区域，需进行水位流量关系计算，水位流量关系的确定方法可根据实际河道特征选用采用曼宁公式、急滩公式或堰流公式。

### 5.3.5 建模过程
按照不同断面类型，采用不同的方法将小流域洪水分析模型计算的洪峰流量转化为相应水位，获得保护对象的洪水淹没情况。

### 5.3.6 简化淹没范围与水深分析模型构建
利用外业河道断面测量成果，构建简化淹没范围与水深分析模型。

**代码库实现**：
- **断面数据模型**：`src/main/java/com/gunshi/project/hsz/model/AttResDetail.java` - 防治部位详细数据模型
- **水位流量计算**：通过洪水算法库实现水位流量关系计算
- **淹没分析**：集成HEC-RAS模型进行淹没范围计算

### 5.3.7 与分布式水文模型耦合
将处理好后的GeoJSON文件与流量文件放于工程内，流量文件里面需要断面名称和流量值。

### 5.3.8 建立水文关联关系表
需要用到简化模型范围图层、河流图层、小流域面图层及小流域节点图层。

**代码库实现**：
- **水文关联**：`src/main/java/com/gunshi/project/hsz/service/StRiverRService.java` - 河流数据管理
- **拓扑关系**：通过JTS空间库建立水文拓扑关系
- **数据关联**：`src/main/java/com/gunshi/project/hsz/service/FileAssociationsService.java` - 数据关联管理

### 5.3.9 重点区域淹没范围图绘制
针对本项目中107个小流域治理单元，使用24小时不同频率下（5年、10年、20年、50年、100年、300年一遇）的设计暴雨值作为参数传到精细化小流域分布式水文模型中经过计算得到的河道流量数据，把河道流量数据输入到简化淹没范围与水深分析模型中，得到不同频率下的淹没范围。

**代码库实现**：
- **频率分析**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java:198-213` - 不同频率降雨处理
- **淹没计算**：通过洪水算法库实现淹没范围计算
- **可视化**：通过GIS组件实现淹没范围可视化

### 5.3.10 模型接口开发与省级平台集成

#### 5.3.10.1 精细化分布式水文模型
输入雨量站的实测降雨数据、短临网格降雨数据或者短临网格+实测降雨数据通过webservice接口的方式传入精细化分布式水文模型进行计算，将计算得到的河段流量通过webService接口的方式传输其他方使用。

#### 5.3.10.2 简化淹没范围与水深分析模型
简化淹没范围与水深分析模型将精细化分布式水文模型计算的河段流量结果数据和简化模型文件通过WebService接口的方式传输到简化淹没范围与水深分析模型中计算得到淹没范围再通过WebService接口的方式传输到其他使用方。

**代码库实现**：
- **WebService接口**：通过Spring Boot REST API提供模型服务接口
- **数据传输**：使用JSON格式传输模型计算结果
- **服务集成**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java` - 预报服务集成

### 5.3.11 算法模型应用

#### 5.3.11.1 风险隐患分析范围计算
根据24小时50年、100年、300年一遇设计暴雨计算设计洪水，再根据HEC-RAS软件计算50年、100年、300年一遇典型暴雨洪水计算的淹没范围，根据遥感影像，结合淹没范围，确定本次风险隐患调查工作开展范围。

#### 5.3.11.2 小流域预报预警
小流域预报预警通过雷达临近预报雨量、逐河段流量数据、临界雨量、设计暴雨指标、设计洪水指标、村庄与河段等多要素关联关系，最终输出村庄预警等级与预警时间、河段风险等级和风险时间。

#### 5.3.11.3 小流域重点区域预演
输入实时降雨数据，经过简化淹没范围与水深分析模型计算后得到小流域范围内重点区域的淹没范围，可以实现小流域范围内重点区域进行实时模拟。

**代码库实现**：
- **预报预警**：`src/main/java/com/gunshi/project/hsz/service/MessageCenterService.java:75-115` - 水位预警预报
- **阈值判断**：`MessageCenterService.java:88-111` - 多级水位阈值判断
- **预警发布**：`MessageCenterService.java:117-139` - 预警信息发布机制

## 5.4 县级用户创建

### 5.4.1 设计思路
湖北省山洪灾害监测预报预警平台目前已完成了1个省级用户、13个市级用户和31个县级用户的创建，参照水利部"一级部署、多级应用"的技术架构原则，需对剩下的山洪灾害防治县进行全面覆盖。

### 5.4.2 县级用户创建
参照已建设的31个县级用户功能，集成预报、预警、预演、预案服务，实现34个县级用户的创建。

创建完成的县级用户功能应包含：首页、山洪预警、山洪预演、数据维护、综合展示、平台监管、山洪简报、动态预警等。

**代码库实现**：
- **考核任务管理**：`src/main/java/com/gunshi/project/hsz/model/AssessTask.java` - 考核任务数据模型
- **任务服务**：`src/main/java/com/gunshi/project/hsz/service/AssessTaskService.java` - 考核任务业务逻辑
- **任务流程**：`AssessTaskService.java:114-164` - 任务启动、执行、审核流程
- **结果统计**：`AssessTaskService.java:224-252` - 考核结果统计和导出

### 5.4.3 湖北省2025年度山洪灾害防治项目省本级涉及用户创建的34个县名录
[详细县名录表格]

## 5.5 县级数据整理与应用

### 5.5.1 县级数据整理
各项目县完成用户创建完成以后，各县基础数据、监测数据、地理空间数据、预案数据、责任人数据等数据录入湖北省山洪灾害监测预报预警平台。

**代码库实现**：
- **行政区划管理**：`src/main/java/com/gunshi/project/hsz/service/StAddvcdDService.java` - 行政区划数据管理
- **数据同步**：`src/main/java/com/gunshi/project/hsz/timetask/DataTaskHsz.java` - 数据同步机制
- **文件管理**：`src/main/java/com/gunshi/project/hsz/service/FileAssociationsService.java` - 文件关联和管理

### 5.5.2 西塞山区

#### 5.5.2.1 自然情况
西塞山区位于黄荆山东北麓，地处东经115°12′～115°06′，北纬30°08′～30°12′。东起河口镇牯牛洲，与阳新县韦源口镇交界；西止白塔岩，与下陆区和团城山开发区为邻；南依黄荆山，与开铁区汪仁镇相连；北与黄冈市的浠水县、蕲春县隔江相望；西北与黄石港接壤。

#### 5.5.2.2 监测数据
监测数据主要包括雨量、水位、图像等站点监测数据。西塞山区已有河道水位站3个、雨量站6个、图像站2个。

**代码库实现**：
- **雨量监测**：`src/main/java/com/gunshi/project/hsz/model/StPptnR.java` - 降雨监测站数据模型
- **水位监测**：`src/main/java/com/gunshi/project/hsz/model/StRsvrR.java` - 水库水位数据模型
- **实时数据**：`src/main/java/com/gunshi/project/hsz/model/StPptnRReal.java` - 实时监测数据模型

#### 5.5.2.3 地理空间数据
根据西塞山区shp图层信息，在GIS地图上定位防灾对象、危险区、转移路线、站点信息，并进行信息的展示。

#### 5.5.2.4 预案数据
西塞山区根据2025年省水利厅下发的《省水利厅关于修编山洪灾害防御预案的通知》，结合西塞山区调查评价数据，编制了西塞山区、乡（镇）、村山洪灾害防御预案。

**代码库实现**：
- **预案管理**：`src/main/java/com/gunshi/project/hsz/service/ResPlanBService.java` - 预案管理服务
- **预案模型**：`src/main/java/com/gunshi/project/hsz/model/ResPlanB.java` - 预案数据模型

#### 5.5.2.5 责任人数据
西塞山区责任人数据包括县乡村三级责任人和包保责任人。

**代码库实现**：
- **责任人管理**：通过用户权限管理系统实现责任人数据管理
- **权限控制**：基于RuoYi框架的权限管理

### 5.5.3 铁山区
[铁山区相关数据]

### 5.5.4 数据工作清单
针对西塞山区、铁山区、茅箭区、张湾区、郧西县、竹山县、竹溪县、武当山、谷城县、伍家岗区、点军区、猇亭区、夷陵区、秭归县、宜都市、枝江市、当阳市、京山市、屈家岭、大悟县、安陆市、罗田县、英山县、蕲春县、武穴市、黄梅县、咸安区、赤壁市、曾都区、广水市、恩施市、咸丰县、来凤县、鹤峰县共34个区县的数据工作。

### 5.5.5 数据处理应用
2025年数据方面工作主要包含数据迁移、数据比对和数据更新：
1. **数据迁移**：包括雨量监测数据、水位监测数据、图像监测数据、监测预警记录
2. **数据比对**：包括行政区划、调查评价成果结构化数据、调查评价空间数据
3. **数据更新**：包括行政区划、山洪防御责任人、山洪防御预案、调查评价成果结构化数据、调查评价空间数据

#### 5.5.5.1 数据迁移
包括雨量监测数据、水位监测数据、图像监测数据、监测预警记录的迁移流程和实现方式。

**代码库实现**：
- **数据迁移**：`src/main/java/com/gunshi/project/hsz/timetask/DataTaskHsz.java` - 数据同步和迁移
- **批量处理**：`DataTaskHsz.java:122-237` - 批量数据保存和处理
- **历史数据处理**：通过时间戳和数据版本控制实现数据迁移

#### 5.5.5.2 数据比对
包括行政区划、调查评价成果结构化数据、调查评价空间数据的比对流程。

**代码库实现**：
- **数据比对**：通过业务逻辑实现数据差异比对
- **版本控制**：通过时间戳和数据版本实现数据比对
- **冲突解决**：通过业务规则解决数据冲突

#### 5.5.5.3 数据更新
包括行政区划、山洪防御责任人、山洪防御预案、调查评价成果结构化数据、调查评价空间数据的更新流程。

**代码库实现**：
- **数据更新**：`src/main/java/com/gunshi/project/hsz/service/AttResBaseService.java` - 数据更新服务
- **缓存管理**：通过Redis缓存确保数据一致性
- **事务管理**：使用`@Transactional`注解确保数据更新的一致性

### 5.5.6 数据处理清单
[详细数据处理表格]

## 5.6 系统功能完善

参照《省级山洪灾害监测预报预警平台技术要求-2023年修订版》和《水利部办公厅关于印发2025年度山洪灾害防治项目建设工作要求的通知》（办防〔2024〕270号）的技术要求，在已完成的湖北省山洪灾害监测预报预警平台基础上，仍需做进一步完善。

### 5.6.1 智能外推（0-3h）定量降雨临近预报模块
智能外推（0-3h）定量降雨临近预报模块以高精度面雨量为输入，输出高时空分辨率降雨临近预报产品。包括：
- 变分法降雨运动场估计子模块
- 分尺度降雨谱分解子模块
- 二阶自相关降雨外推子模块
- 不同尺度外推降雨场合成算法子模块
- 不同预见期临近预报降雨产品子模块
- 预报精度评估子模块

**代码库实现**：
- **GRIB2处理**：`src/main/java/com/gunshi/project/hsz/grb/RainGrib2Layer.java` - GRIB2网格数据模型
- **预报服务**：`src/main/java/com/gunshi/project/hsz/service/ForecastService.java` - 天气预报处理服务
- **雷达数据处理**：`ForecastService.java:154-178` - 雷达数据短临预报处理
- **网格计算**：`ForecastService.java:76-106` - 网格降雨量计算算法

### 5.6.2 小流域治理单元建档立卡管理与可视化
开发小流域治理单元建档立卡管理与可视化功能，实现小流域治理单元建档立卡成果的可视化展示。

#### 5.6.2.1 流域基本信息
能够查看小流域治理单元的基本信息，并能够通过已开展"四预"能力建设和未开展"四预"能力建设进行查询和统计。

#### 5.6.2.2 流域关系可视化
流域关系包括小流域上下游关系、小流域防治单元与小流域计算单元关联关系。

#### 5.6.2.3 沟道断面可视化
通过GIS线条和颜色编码等方式，清晰地展示深泓线断面、水面线和历史洪痕。

**代码库实现**：
- **小流域管理**：`src/main/java/com/gunshi/project/hsz/service/WatershedService.java` - 小流域管理服务
- **空间可视化**：通过JTS空间库和GIS组件实现空间数据可视化
- **关系展示**：`src/main/java/com/gunshi/project/hsz/service/AttResBaseService.java:44-67` - 树形结构展示

### 5.6.3 优化防灾对象和测站关联关系
优化防灾对象和测站关联关系，每一个防灾对象至少关联2个山洪站点。以小流域治理单元为基础，防灾对象与其所在小流域治理单位上游所有山洪雨量站建立关联关系。

**代码库实现**：
- **关联关系管理**：`src/main/java/com/gunshi/project/hsz/service/FileAssociationsService.java` - 关联关系管理
- **站点关联**：通过数据模型实现防灾对象与测站的关联
- **业务逻辑**：通过服务层实现关联关系的业务逻辑

### 5.6.4 动态预警指标应用

#### 5.6.4.1 动态预警提醒
平台每天早上6时计算全省防灾对象动态预警指标，并结合前期1、3、6小时降雨产生预警，对动态预警指标小于静态指标的预警信息及时发送县级防汛责任人进行提醒。

#### 5.6.4.2 动态预警指标复核
在2023年动态预警指标分析成果基础上，对全省山洪灾害防灾对象静态预警指标和动态预警指标的差异和合理性进行分析，并按照区县为单位进行统计。

**代码库实现**：
- **动态预警规则**：`src/main/java/com/gunshi/project/hsz/model/OsmoticWarnRule.java` - 动态预警规则数据模型
- **规则服务**：`src/main/java/com/gunshi/project/hsz/service/OsmoticWarnRuleService.java` - 动态预警规则管理服务
- **条件判断**：`OsmoticWarnRuleService.java:116-125` - 动态预警条件判断算法
- **定时任务**：`src/main/java/com/gunshi/project/hsz/timetask/DataTaskHsz.java` - 定时任务调度
- **预警发布**：`src/main/java/com/gunshi/project/hsz/service/MessageCenterService.java` - 预警信息发布机制

## 5.7 县级考核管理功能

### 5.7.1 考核任务管理
县级考核管理功能实现了对区县水利部门的山洪灾害防治工作考核，包括任务创建、分配、执行、审核、统计等完整流程。

**代码库实现**：
- **考核任务模型**：`src/main/java/com/gunshi/project/hsz/model/AssessTask.java` - 考核任务数据模型
- **任务管理服务**：`src/main/java/com/gunshi/project/hsz/service/AssessTaskService.java` - 考核任务管理服务
- **任务流程**：`AssessTaskService.java:114-164` - 任务启动、执行、审核流程
- **结果统计**：`AssessTaskService.java:224-252` - 考核结果统计和导出

### 5.7.2 预警配置管理
预警配置管理功能实现了对各类预警指标的配置和管理，支持静态预警指标和动态预警指标的设置和管理。

**代码库实现**：
- **预警配置模型**：`src/main/java/com/gunshi/project/hsz/model/AlarmSet.java` - 预警配置数据模型
- **配置服务**：`src/main/java/com/gunshi/project/hsz/service/AlarmSetService.java` - 预警配置管理服务
- **阈值管理**：`src/main/java/com/gunshi/project/hsz/model/OsmoticWarnRule.java` - 预警阈值管理

### 5.7.3 防治点管理
防治点管理功能实现了对山洪灾害防治点的全面管理，包括防治点信息、防治部位、防治计划等。

**代码库实现**：
- **防治点模型**：`src/main/java/com/gunshi/project/hsz/model/PrePlace.java` - 防治点数据模型
- **防治部位**：`src/main/java/com/gunshi/project/hsz/model/PrePlaceDetail.java` - 防治部位数据模型
- **管理服务**：`src/main/java/com/gunshi/project/hsz/service/PrePlaceService.java` - 防治点管理服务
- **树形结构**：`PrePlaceService.java:44-67` - 防治点树形结构展示

### 5.7.4 维护养护管理
维护养护管理功能实现了对山洪灾害防治设施的维护管理，包括维护计划、维护记录、维护统计等。

**代码库实现**：
- **维护计划模型**：`src/main/java/com/gunshi/project/hsz/model/MentencePlan.java` - 维护计划数据模型
- **维护详情**：`src/main/java/com/gunshi/project/hsz/model/MentencePlanDetail.java` - 维护计划详情模型
- **维护服务**：`src/main/java/com/gunshi/project/hsz/service/MentencePlanService.java` - 维护计划管理服务
- **年度计划**：`MentencePlanService.java:42-77` - 年度维护计划创建