# fysb_models **Repository Path**: 4u4e/fysb_models ## Basic Information - **Project Name**: fysb_models - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-08 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 自然灾害动态风险评估系统 (Natural Hazards Dynamic Risk Assessment System) 基于统一四要素风险框架 `R = H × E × V / (1 + C)` 的 Java / Spring Boot 项目。系统注册并**全部上线**五个单灾种模块 + 一个上层**行政区域综合风险**模块:**山洪**(动态临界雨量法)、**地质灾害**(易发性 S × 触发危险度 T + 有效降水临界雨量曲线)、**森林火灾**(本底易燃性 B × 火险气象危险度 F)、**流域洪涝**(致洪危险度 Q × 承泄不足度 S + 动态临界面雨量与汇流滞后)、**城市内涝**(致涝危险度 Q × 排水不足度 D + 短历时雨强超设计重现期与快涨快退)。五个单灾种共享同一套计算内核、四级分级、配置中心与数据管理后台;综合风险模块消费五个单灾种结果,两级聚合到县 / 乡镇 / 村三级行政区,输出多灾种综合风险指数 CRI。 五个灾种除输出整场过程的**总体风险 R** 外,还统一输出**逐时间节点风险 R(t)** 曲线(过去实况 + 未来预报全时次),结果既内联在评估响应中,也自动落库到批次表 / 逐时次明细表 / 既有结果主表,可按批次、单元、灾种回溯查询;曲线在风险分布面板之外作为独立单点信息面板常显,与「卡片列表 / 地图 / 风险矩阵」三态切换互不干扰;分布面板内另有「逐时刻全点位风险回放」工具条(综合风险页为「逐时刻全行政区域回放」),拖动或播放时间轴即可横向查看同一时刻所有点位 / 行政区域的风险等级;轨道采用一格一时刻的「时刻格子」,每格直接标注 HH:mm,顶部色条显示该时刻全场最高风险等级颜色,角标显示达到该等级的点位数;轨道宽度贴合页面,超出部分用 ‹ › 左右翻页查看,不会产生页面级横向滚动条。详见「逐时间节点风险评估结果」与「逐时刻全点位风险分布回放」两章,综合页适配见「逐时刻全行政区域风险回放」。 页面入口:`index.html`(山洪)、`geo-hazard.html`(地质灾害)、`forest-fire.html`(森林火灾)、`river-flood.html`(流域洪涝)、`urban-waterlogging.html`(城市内涝)、`comprehensive-risk.html`(行政区域综合风险)、`admin.html`(共享数据管理后台)、`module-placeholder.html`(模块导航异常时的兜底占位页)。顶部模块导航由 `js/module-nav.js` 统一渲染,模块元数据来自 `GET /api/system/modules`(`moduleCount=6` / `readyCount=6`)。 ## 模块清单(五个单灾种 + 行政区域综合风险) | 模块 | 灾种枚举 | 模型 | 状态 | 入口 | |---|---|---|---|---| | 流域洪涝 | `RIVER_FLOOD` | Q × S + 动态临界面雨量与汇流滞后 | 已上线 | `river-flood.html` | | 山洪 | `FLASH_FLOOD` | 动态临界雨量法 | 已上线 | `index.html` | | 地质灾害 | `GEO_HAZARD` | S × T + 有效降水临界曲线 | 已上线 | `geo-hazard.html` | | 森林火灾 | `FOREST_FIRE` | B × F + 连续干燥度累积(FWI) | 已上线 | `forest-fire.html` | | 城市内涝 | `URBAN_WATERLOGGING` | Q × D + 短历时雨强超设计重现期与快涨快退 | 已上线 | `urban-waterlogging.html` | | **综合风险** | `COMPREHENSIVE` | 两级聚合:单元风险 → 区域单灾种风险 R(a,h) → 多灾种综合指数 CRI(分级 / 排序 / 下钻) | 已上线 | `comprehensive-risk.html` | 新增**单灾种**只需实现 `IHazardPlugin` 并注册参数包,统一内核 `RiskComputeEngine`、四级分级 `RiskLevel`、配置中心 `sys_risk_config`、通用 CRUD 管理端与空间地图视图均可直接复用。综合风险是上层模块,不实现 `IHazardPlugin`、不重算致灾因子,只消费单灾种结果(详见「行政区域综合风险动态评估模型」一章)。 ## 核心模型 统一风险公式(四要素归一化到 [0, 1]): ``` R = H × E × V / (1 + C) ``` | 符号 | 含义 | 说明 | |------|------|------| | H | 危险性 Hazard | 由致灾因子(降雨等)驱动,动态计算 | | E | 承灾体暴露度 Exposure | 人口、资产、设施总量 | | V | 脆弱性 Vulnerability | 承灾体的易损程度 | | C | 防灾减灾能力 Capacity | 预警、应急、防护工程,能力越强风险越低 | ### 风险等级(四级) | 等级 | 颜色 | 阈值 | |------|------|------| | 1 - 低风险 | 蓝 | R < 0.25 | | 2 - 中风险 | 黄 | 0.25 ≤ R < 0.5 | | 3 - 高风险 | 橙 | 0.5 ≤ R < 0.75 | | 4 - 极高风险 | 红 | R ≥ 0.75 | ## 山洪风险评估算法(动态临界雨量法) ### 计算流程 ``` 气象数据(NOW/OBS/FCST) → 多历时累积雨量 P_1h/3h/6h → 前期影响雨量 API ↓ 动态临界雨量 CR_t = Pt_t × α(API) ↓ 超阈比 ratio = max(P_t / CR_t) ↓ 分段归一化 → H ∈ [0,1] ↓ R = H × E × V / (1 + C) → 分级 ``` ### 关键公式 **前期影响雨量 API**(土壤饱和度代理): ``` API = Σ(Pᵢ · k^i), i=1..n k = 0.85(衰减系数), n = 15天 ``` **动态调整系数 α**(临界雨量随土壤湿度变化): ``` α(API) = clip(1 - β · (API - API₀)/API_max, α_min, 1) β = 0.5, α_min = 0.4 ``` **危险性 H 分段归一化**: ``` H = 0 ratio < 0.6 H = 线性拉伸到 [0,1] 0.6 ≤ ratio < 1.2 H = 1 ratio ≥ 1.2 ``` ## 地质灾害动态风险评估模型(技术方案 V1.0) 模型依据 `地质灾害动态风险评估模型技术方案.md` 实现,复用山洪的四要素内核,但按地灾机理把危险性拆成**静态本底 × 动态触发**: | 维度 | 山洪 | 地质灾害 | |---|---|---| | 危险性结构 | `H ≈ f(降雨, 临界阈值)` | `H = 易发性 S × 触发危险度 T` | | 主导因素 | 短历时雨强(1h / 3h) | 地质易发性本底,降水为触发 | | 前期降水 | API(k=0.85,n=15 天) | 有效降水 `R_eff`(K=0.80~0.84,n=15~30 天),衰减更慢 | | 阈值形态 | 单一临界雨量 × α(API) | 当日雨量—前期有效雨量曲线,预警线 / 危险线两级 | | 雨停之后 | 快速退水 | 滞后关注期内按衰减曲线延续,风险不立即归零 | | 评估单元 | 小流域 | 隐患点 / 斜坡单元 / 泥石流沟域 | ### 核心公式 ``` R_eff = R₀ + Σ(Rᵢ × Kⁱ) i = 1..n,K=0.80~0.84,n=15~30 天 saturation = min(1, R_eff / 参考有效降水) 预警线 = max(下限, 预警线基准 × (1 - γ × saturation)) # 前期越湿,触发所需当日降水越低 危险线 = max(下限 × 1.4, 危险线基准 × (1 - γ × saturation)) d = R₀ / 预警线 T = 0 d < 0.6 T ∈ [0, 0.6] 0.6 ≤ d < 1 (接近预警) T ∈ [0.6, 1.0] 1 ≤ d < 危险线/预警线(预警区) T = 1 d ≥ 危险线/预警线 (极可能触发) H = S × T R = H × E × V / (1 + C) ``` 短历时强降水(泥石流沟域)另按 1h 最大雨强独立触发,与累积型曲线取最不利;在册隐患点命中预警区时启用风险下限,避免「有险无灾」误降级漏警。 ### 动态机制 - **阈值动态**:前期有效降水越高,临界雨量曲线整体下移(已内含于当日雨量—前期有效雨量曲线)。 - **滞后延续**:雨停后 `T_lag = T_prev × lagDecay^小时数`,与当前 T 取较大者,并输出滞后关注期剩余时长。 - **数据质量**:必要降水缺失返回 `MET_MISSING`(区别于低风险,不输出风险等级);历史日降水序列不足 `geo_partial_days_min` 天返回 `PARTIAL`,仍输出可用结果。 - **气象输入**:过去 24h 逐小时实况、2h 短临(5min)、未来 72h 逐小时预报、15~30 天历史日降水序列。 ### 输出字段 `unitId / village / lon / lat / elevation`、`validTime`、`S`、`T`、`H/E/V/C`、`R / riskLevel / color`、`factors`(当日降水 R₀、短期/长期有效降水、预警线/危险线临界值、曲线位置比 d)、`triggerType`(短期强降水型 / 长期累积型 / 无触发)、`leadTimeMin`、`lagWindowMin`、`lagApplied`、`metQuality`、`hazardKind`、`siteType`、`status`。 ### 数据表(共享数据管理后台维护) | 表 | 用途 | |---|---| | `geo_hazard_site` | 隐患点 / 斜坡单元台账:易发性 S、E/V/C、曲线分区、`POINT SRID 4326` 空间点位 | | `geo_hazard_curve` | 分区临界雨量曲线:预警线 / 危险线基准、下移斜率 γ、K、n、滞后时长、风险下限 | | `geo_hazard_daily_rainfall` | 15~30 天历史日降水序列,用于 `R_eff` | | `sys_risk_config` | `hazard_type='GEO_HAZARD'` 的 16 项全局可率定参数(与山洪共用同一张表) | 初始化脚本:`src/main/resources/db/init_geo_hazard.sql`。三张表均已注册到 `AdminTableRegistry`,管理端可按灾种筛选,地图视图新增「地灾隐患点」图层。 ### 预设验证场景 `GET /api/risk/geo-hazard/scenarios` 返回 6 个场景:晴朗干燥、小雨、短时强降水、长期累积降雨、久雨初晴(滞后)、气象数据缺测。`target/dbinit/verify_geo_hazard.py` 端到端验证 73 项,短时强降水场景下 6 个隐患点覆盖蓝/黄/橙/红四级(`low:2 / medium:2 / high:1 / extremelyHigh:1`),并验证 S 主导、有险无灾、公式一致性、曲线动态下移、滞后延续与缺测阻断。 ## 森林火灾动态风险评估模型(技术方案 V1.0) 模型依据 `森林火灾动态风险评估模型技术方案.md` 实现,复用统一四要素内核,但致灾驱动由「降水」改为「降水缺失 + 高温低湿大风」: ``` D = 自上一次有效降水以来的连续无有效降水日数(久旱慢升、一雨快降) FWI = wT·f(T) + wRH·f(RH) + wW·f(W) + wD·f(D) (风速非线性放大) F = FWI × 当日降水抑制 B = 可燃物—地形静态本底易燃性(台账预计算,缺值时由类型/负荷/坡度/坡向/连续性合成) H = B × F R = H × E × V / (1 + C) ``` | 维度 | 说明 | |---|---| | 输入 | 过去 24h 逐小时气温 / 湿度 / 风速 / 降水实况 + 未来 72h 逐小时预报 + 历史日降水序列 | | 动态机制 | 连续干燥度单调累积抬升火险;一场有效降水清零 D 并快速回落(慢升快降非对称) | | 气象等级 | F 映射国标火险气象等级一至五级;与综合风险等级 R 是两个不同概念 | | 产品字段 | B / F / FWI / H / E / V / C / R、met_grade、dominant_factor、peak_hours、spread_dir、过去 24h 与未来 72h 逐小时 FWI 序列 | | 状态 | `OK` / `PARTIAL`(历史日序列不足)/ `MET_MISSING`(关键气象缺测,不输出风险) | | 保护 | 重点防护对象(景区 / 重大设施 / 林缘聚落)在 F 达高位时启用风险下限,避免降级漏警 | | 表 | 用途 | |---|---| | `forest_fire_stand` | 网格 / 林班台账:可燃物类型与负荷、坡向、本底 B、E/V/C、火险分区、`POINT SRID 4326` 点位 | | `forest_fire_zone` | 分区 FWI 权重、归一化节点、有效降水阈值、五级火险等级节点与风险下限 | | `forest_fire_daily_met` | 30 天历史日气象序列,连续干燥日数统计来源;可在前端切换为自动统计 | | `sys_risk_config` | `hazard_type='FOREST_FIRE'` 的 29 项全局可率定参数(与山洪 / 地灾共用同一张表) | 初始化脚本:`src/main/resources/db/init_forest_fire.sql`。三张表均已注册到 `AdminTableRegistry`,管理端可按灾种筛选,地图视图新增「森火单元」图层。后端分层与山洪 / 地灾一致:`ForestFireRiskModel`(纯算法内核)→ `ForestFirePlugin` → `RiskComputeEngine` → `ForestFireAssessmentService` → `ForestFireRiskController`。 接口:`GET /api/risk/forest-fire/stands|zones|params|scenarios`、`GET|POST /api/risk/forest-fire/assess/...`、`POST /api/risk/forest-fire/assess/custom/all`。全量评估只提交火险气象场景输入,B/E/V/C 按各单元台账读取,保留单元间差异。 ### 预设验证场景 `GET /api/risk/forest-fire/scenarios` 返回 8 个场景:雨后湿润、常规防火期、连旱高温、久旱大风、一雨解旱、稀疏可燃物、历史序列不足、气象数据缺测。`target/dbinit/verify_forest_fire.py` 端到端验证 64 项,`target/dbinit/test_forest_fire_runtime.js` 验证前端初始化、场景切换、参数作用域与图表降级。 ## 中小河流域洪涝动态风险评估模型(Q × S) 依据《中小河流域洪涝动态风险评估模型技术方案 V1.0》,以县域 / 河段控制单元为评估尺度,把「上游集水区产流致洪」与「河道承泄不足」拆成动态量 Q 与静态量 S: ``` API = Σ(Pᵢ × kⁱ) 前期影响雨量(流域湿润程度) C_r = max(C_min, C₀ × (1 − γ × API_norm)) 动态临界面雨量(越湿越易致洪) φ = φ₀ + φ₁ × API_norm 产流系数(越湿产流越多) ratio = P_acc × φ / C_r 来水相对致洪阈值的位置 Q = 分段归一化(ratio) + 上游演进来水 动态致洪危险度(含汇流滞后) S = 河道承泄不足度(静态本底,预计算缓存) H = Q × S R = H × E × V / (1 + C) ``` | 维度 | 说明 | |---|---| | 输入 | 5min 降水实况、0~2h 短临、过去 24h 逐小时面雨量实况、未来 72h 逐小时预报、历史日面雨量序列 | | 动态机制 | API 下调临界面雨量并抬升产流系数;上游 Q_local 按汇流时间滞后演进;雨停后按 exp(−Δt/τ) 退水延续,风险不立即清零 | | 防汛语义 | Q 映射「低于警戒水位 → 接近 / 超警戒 → 超保证水位 / 漫堤风险」,与四级综合风险等级并行输出 | | 产品字段 | Q / Q_local / S / H / E / V / C / R、P_acc、maxRain 3/6/12h、API、C_r、φ、估算来水、waterLevelRef、triggerType、peakTime、leadTimeMin、recessionWindowMin、upstreamContrib、过去 24h 与未来 72h Q 序列 | | 状态 | `OK` / `PARTIAL`(历史日面雨量不足)/ `MET_MISSING`(上游集水区面雨量缺测,不输出风险) | | 保护 | 穿城镇 / 重大保护对象河段 Q 高位时启用风险下限;无人区且 E 极低时折减,区分「有洪无灾」 | | 表 | 用途 | |---|---| | `river_flood_reach` | 河段控制单元台账:河流 / 河段 / 上下游拓扑 `upstream_ids`、汇流与传播时间、过流能力、堤防标准、承泄不足度 S、E/V/C、`POINT SRID 4326` 点位 | | `river_flood_zone` | 水系分区参数:API 消退、动态临界面雨量、Q 分段节点、退水时间常数、上游演进衰减、风险下限 | | `river_flood_daily_rain` | 30 天历史日面雨量序列(API 来源) | | `sys_risk_config` | `hazard_type='RIVER_FLOOD'` 的 30 项全局可率定参数(与其余灾种共用同一张表) | 初始化脚本:`src/main/resources/db/init_river_flood.sql`。三张表均已注册到 `AdminTableRegistry`,管理端可按灾种筛选,地图视图新增「洪涝河段」图层。后端分层与其余灾种一致:`RiverFloodRiskModel`(纯算法内核)→ `RiverFloodPlugin` → `RiskComputeEngine` → `RiverFloodAssessmentService` → `RiverFloodRiskController`;沿有向河网自上而下递归计算上游 `Q_local`,按 `travelTimeH + confluenceTimeH × 0.3` 形成汇流滞后。 接口:`GET /api/risk/river-flood/reaches|reaches/{id}|zones|params|scenarios`、`GET|POST /api/risk/river-flood/assess/...`、`POST /api/risk/river-flood/assess/custom/all`。全量评估只提交面雨量场景输入,S/E/V/C、临界雨量与河网拓扑按各河段台账读取,保留河段间差异(`RiverFloodAssessRequest.copyForReach()`)。 ### 洪涝预设验证场景 `GET /api/risk/river-flood/scenarios` 返回 9 个场景:枯水无雨、常规汛期、短历时强降水、长历时累积、前期湿润、上游暴雨下泄、雨停退水延续、历史序列不足、面雨量缺测。`target/dbinit/verify_river_flood.py` 端到端验证模型机理与管理端接入,`target/dbinit/test_river_flood_runtime.js` 验证前端初始化、场景切换、参数作用域与图表降级。 ## 城市内涝动态风险评估模型(Q × D) 依据《城市内涝动态风险评估模型技术方案》,以县域城区 / 排水分区 / 易涝点为评估尺度,把「短历时强降水超管网设计标准」与「排水能力不足」拆成动态量 Q 与静态量 D。与流域洪涝不同,内涝不用面雨量—API—临界面雨量,而用**就地短历时雨强与重现期超出度**判别,且提前量最短(默认 ≤ 120min): ``` I_10 / I_30 / I_1h = 5min 实况 + 0~2h 短临拼接后的多历时滑动最大雨强 (mm/h) ratio = max(I_t / I_design,t) 相对各历时管网设计雨强的超出度 Q = 分段归一化(ratio × exp(−Δt/τ)) 动态致涝危险度(低于设计标准 Q=0) τ = τ₀ + τ₁ × D 排水越差,雨停后退水越慢(快涨快退) D = 排水能力不足度(台账预计算;为空时按设计重现期 / 低洼 / 硬化 / 淤堵 / 历史积水加权合成) H = Q × D 雨再大若排水强则不涝,排水再弱若无强降雨也不积水 R = H × E × V / (1 + C) ``` | 维度 | 说明 | |---|---| | 输入 | 近 60min 逐 5min 降水实况、未来 0~2h 逐 10min 短临预报、过去 24h 逐小时实况、未来 72h 逐小时预报 | | 动态机制 | 短临与实况峰值按权重融合(默认 0.65 / 0.35)并保留实况峰值下限;0~2h 短临是提前量的唯一来源;雨停后按 `exp(−Δt/τ)` 消退而非立即清零 | | 主导历时 | 10min 突发型 / 30min 过渡型 / 1h 持续型,与综合风险等级并行输出 | | 防汛语义 | 积水深度语义由实际致涝危险性 `H = Q × D` 分级:无明显积水 → 轻微积水影响通行 → 较深积水车辆受困 → 深积水地下空间倒灌;估算积水深度 (m) 同样由 H 与低洼深度推算,避免「雨大但排水能力强」的高标准分区误报深积水 | | 产品字段 | Q / D / H / E / V / C / R、I_10 / I_30 / I_1h、峰值雨强、超出度、实际/设计重现期、主导历时、waterDepthRef、pondingDepthEstimateM、peakTime、leadTimeMin、recessionWindowMin、`observedQ` / `nowcastQ` 演变序列 | | 状态 | `OK` / `PARTIAL`(短临时次 < 6 或逐小时实况 < 12h)/ `MET_MISSING`(5min 实况或 0~2h 短临缺测,不输出风险) | | 保护 | 下穿隧道、地下空间、医院学校、变配电等要害对象采用更严格 Q 阈值与风险下限 `minRiskKeyObject`,避免降级漏警 | | 表 | 用途 | |---|---| | `urban_waterlogging_site` | 易涝点 / 排水分区台账:对象类别、街道、低洼深度、硬化率、设计重现期与 10min/30min/1h 设计雨强、泵站能力、淤堵顶托、历史积水、排水不足度 D、E/V/C、要害标记、`POINT SRID 4326` 点位 | | `urban_waterlogging_zone` | 排水分区参数:Q 分段节点、重现期换算指数、退水时间常数(τ 随 D 增大)、提前量上限、要害对象下限、D 合成权重与积水深度语义节点 | | `urban_waterlogging_ponding_record` | 历史积水事件(最大积水深度 / 历时 / 过程峰值雨强),校正台账 D 合成的积水本底 | | `sys_risk_config` | `hazard_type='URBAN_WATERLOGGING'` 的 27 项全局可率定参数(与其余灾种共用同一张表) | 初始化脚本:`src/main/resources/db/init_urban_waterlogging.sql`。三张表均已注册到 `AdminTableRegistry`,管理端可按灾种筛选,地图视图新增「城市易涝点」图层。后端分层与其余灾种一致:`UrbanWaterloggingRiskModel`(纯算法内核)→ `UrbanWaterloggingPlugin` → `RiskComputeEngine` → `UrbanWaterloggingAssessmentService` → `UrbanWaterloggingRiskController`。参数优先级:前端调试覆盖 > `urban_waterlogging_zone` 分区参数 > `sys_risk_config` 全局配置 > 内置默认值;全量评估只提交短历时降水场景输入,D/E/V/C 与设计雨强按各点位台账读取(`UrbanWaterloggingAssessRequest.copyForSite()`),保证同一降雨过程下各易涝点风险互不相同。 接口:`GET /api/risk/urban-waterlogging/sites|sites/{id}|zones|params|scenarios|records/{siteId}`、`GET|POST /api/risk/urban-waterlogging/assess/...`、`POST /api/risk/urban-waterlogging/assess/custom/all`。 ### 内涝预设验证场景 `GET /api/risk/urban-waterlogging/scenarios` 返回 10 个场景:无雨晴好、小雨低于设计、接近设计标准、10min 突发暴雨、1h 持续强降水、特大暴雨超设计、要害对象优先叫应(自动定位 `UW_002`)、雨停退水延续、短临序列不足(`PARTIAL`)、短临降水缺测(`MET_MISSING`)。场景雨强按 `UW_002`(1 年一遇,1h 设计雨强 18 mm/h)标定,使 Q 依次落在「低于设计 Q=0 / 接近设计 0~0.6 / 超设计 0.6~1.0 / 远超设计 Q=1」各分段,避免所有降雨场景一律饱和而看不出梯度。`target/dbinit/verify_urban_waterlogging.py` 端到端验证模型机理与管理端接入,`target/dbinit/test_urban_waterlogging_runtime.js` 验证前端初始化、场景切换、参数作用域与图表降级。 ## 行政区域综合风险动态评估模型(两级聚合 · CRI) > 参考 `自然灾害综合风险动态评估技术方案.md`。本模块位于五个单灾种模块**之上**:评估对象由「小流域 / 斜坡 / 林班 / 河段 / 易涝点」升级为**行政区域**(县 `COUNTY` → 乡镇/街道 `TOWNSHIP` → 村/社区 `VILLAGE`),输入是「多灾种联动场景 + 合成口径」,不直接接收气象致灾因子。 ### 计算链路 ``` POST /api/risk/comprehensive/assess/custom/all │ {scenario, method, adminLevel, horizon, includeHazards, paramOverrides} ▼ ComprehensiveScenarios ── 展开成 5 个单灾种场景输入 │ ├─ FlashFloodAssessmentService.assessAll(...) ├─ GeoHazardAssessmentService.assessAll(...) ├─ ForestFireAssessmentService.assessAll(...) ├─ RiverFloodAssessmentService.assessAll(...) └─ UrbanWaterloggingAssessmentService.assessAll(...) ▼ RiskAssessmentResult(单元级 R + timeline)→ ComprehensiveUnitRisk ▼ ① 行政区域—单元静态映射(跨界按 ratio 面积占比拆分) 村级 R(a,h) ──► ② 乡镇级 R(a,h) ──► ③ 县级 R(a,h)(逐级汇总,口径自洽) ▼ 第二级合成 CRI / 等级 / 排序 / 主导灾种 / 贡献度 / 并发灾种 / CRI(t) / 态势简报 ▼ ComprehensiveResultStore(结果快照落库 + 内存最近 N 轮历史) ``` ### 第一级:单元风险 → 行政区域单灾种风险 ``` R(a,h) = w_max · R_max + w_cov · R_cov + w_ρ · ρ ``` | 分量 | 含义 | 默认权重 | |------|------|---------| | `R_max` | 强度分量:辖区内该灾种单元风险峰值(宁高勿平) | `w_max = 0.55` | | `R_cov` | 广度分量:按单元暴露人口加权的风险均值 | `w_cov = 0.30` | | `ρ` | 高危单元占比(单元风险 ≥ `cr_high_threshold`) | `w_ρ = 0.15` | 三权重由 `ComprehensiveModelParams.normalizeAggregation()` 归一到和为 1。辖区内无该灾种评估单元,或该灾种 `MET_MISSING`,记为**缺项**(`present=false`),不按零风险计入。 ### 第二级:区域单灾种风险 → 多灾种综合指数 | 方法 | 公式 | 说明 | |------|------|------| | `WEIGHTED` | `CRI = Σ_h [λ_h · R(a,h)]` | 加权综合,各灾种线性可偿 | | `MAX_WEIGHTED`(默认) | `CRI = α·max_h R(a,h) + (1−α)·Σ_h[λ_h·R(a,h)]` | 取大加权混合,突出主导灾种,`α=0.45` | | `PROBABILISTIC` | `CRI = 1 − Π_h (1 − λ_h·R(a,h))` | 概率型合成,多灾并发时非线性放大 | `λ_h` 来自**区域灾种权重模板**,按行政区孕灾环境选择,参与灾种间重新归一:`BALANCED` / `MOUNTAIN` / `URBAN` / `FOREST` / `RIVER_VALLEY`,另有 `admin_code` 级微调行。 并发叠加与一致性校验: ``` CRI_final = CRI · (1 + γ·(n_high − 1)) γ = 0.08,截断到 [0,1] 综合等级 ≥ 主导灾种等级 − consistency_gap 默认 gap = 1(只上调等级,不改 CRI 数值) ``` `n_high` 为该区域达到 Ⅲ/Ⅳ 级的灾种数;主导灾种取 `contrib_h = λ_h·R(a,h) / Σ` 最大者,贡献度只在**参与合成**的灾种间计算,缺项灾种不进入集合。 ### 分级、排序与缺项 - 绝对四级:`<0.25` Ⅰ 低 / `[0.25,0.50)` Ⅱ 较高 / `[0.50,0.75)` Ⅲ 高 / `≥0.75` Ⅳ 极高,阈值 `cr_level_1/2/3` 可率定。 - 相对分级:同级行政区按 CRI 降序给出 `rank / rankTotal / percentile / relativeLevel`,支持跨区域横向比较。 - 状态:`OK`(五灾种齐备)/ `PARTIAL`(有缺项)/ `MET_MISSING`(全部缺测)。缺项灾种在研判卡、灾种构成条与时间轴明细中显式标注「不参与合成」。 ### 多时效对齐 CRI(t) 各单灾种时间轴粒度不同(内涝 5/10min、洪涝/森火 1h、山洪/地灾逐小时面雨量),综合层统一重采样为 **4h 时间桶**,`−24h ~ +72h` 共 **25 个节点**,同桶取最不利值,缺测节点丢弃不冒充零风险。每个节点输出 `CRI(t)`、等级、并发灾种数 `nHigh`、各灾种 `R(a,h,t)` 与 `missingHazards`;峰值节点 CRI 与总体 CRI 一致。 ### 数据表(`db/init_comprehensive.sql`,幂等) | 表 | 用途 | 初始化行数 | |----|------|-----------| | `comprehensive_admin_region` | 行政区台账:三级本底、人口 / 资产 / 重点防护对象 / 历史灾情 / 应急资源评分、权重模板、示意边界 WKT、`POINT SRID 4326` 中心点 | 26(1 县 + 6 乡镇 + 19 村) | | `comprehensive_region_unit` | 行政区—单灾种评估单元静态映射(跨界 `ratio` 拆分 + 暴露人口) | 34 | | `comprehensive_region_hazard_weight` | 区域灾种权重模板 λ_h(`template` 默认行 + `admin_code` 微调行) | 25 | | `comprehensive_risk_result` | 综合风险结果快照(`batch_id + admin_code` 唯一键,管理端只读,按批次保留最近 N 轮) | 由评估流程写入 | `sys_risk_config(hazard_type='COMPREHENSIVE')` 另插入 **16 条 `cr_*`** 可率定参数。运行时优先级:`paramOverrides` > `sys_risk_config` > 内置默认值;台账 / 映射 / 权重由 `ComprehensiveRepositoryImpl` 读 MySQL,数据库不可达时回退内置演示数据(5s 短缓存 + 60s 失败熔断,避免逐次远程往返)。`boundary_wkt` 为演示用规则多边形,生产应替换为真实行政区划边界。 ### 预设场景(8 个多灾种联动) | key | 场景 | 预期主导灾种 / 特征 | |-----|------|-------------------| | `normal` | 常态汛期 | 流域洪涝,县域 CRI ≈ 0.043 | | `dry_calm` | 晴朗无雨 | 全域低风险,CRI ≈ 0.009 | | `mountain_rainstorm` | 山区局地暴雨 | 山洪 / 地灾抬升 | | `urban_cloudburst` | 城区短历时强降水 | 城市内涝主导 | | `basin_flood` | 流域性持续降水 | 洪涝主导,CRI ≈ 0.626 | | `forest_drought` | 林区连旱大风 | 森林火险主导 | | `multi_hazard` | 多灾并发极端过程 | 并发修正生效,CRI ≈ 0.627 | | `data_gap` | 森林火险气象缺测 | `FOREST_FIRE` 缺项、`status=PARTIAL`、参与 4 类并重新归一 | ### 前端展示(`comprehensive-risk.html`) - **综合风险一张图**:`js/comprehensive-region-map.js` 用高德官方 SDK 把 `boundary_wkt` 转 GCJ-02 后分级着色,支持县→乡镇→村下钻、等级过滤、点击联动研判卡;未配 Key / SDK 失败时降级为「空间数据清单」,不影响评估。 - **分布视图**:卡片列表 / 一张图 / 风险矩阵三态互斥;CRI(t) 时间轴是分布面板**之外**的独立常显面板(与五灾种页面一致)。 - **应用组件**:行政区域清单、同级排行榜、区域综合研判卡、各灾种 R(a,h) 与贡献度双条、综合态势简报、主导灾种分布、跨轮次风险演变;「⏱ 风险时间轴」快捷入口与 `?view=timeline` 只滚动定位。 - **调试台**:合成方法、排行榜层级、时效窗、参与灾种开关、第一级三权重、α/γ/阈值及四个规则开关;`collectOverrides()` 只提交偏离 HTML 默认值的键,重置恢复默认。 - 所有图表用本地 `echarts.min.js`,缺失时降级为文本 / 明细表;全站静态资源版本 `?v=20261116c`。场景选项卡的 `tag` 是「山洪+地灾」这类中文短标签而非图标,字体样式由 `comprehensive.css` 中 `#cr-scenarios` 作用域单独定义(10px 徽标 + 12px/600 主名称),**不要**套用山洪页 `.scenario-icon` 的 22px 大图标样式。 ### 逐时刻全行政区域风险回放 综合风险页复用通用组件 `js/risk-timeline-scrubber.js`(`window.RiskTimelineScrubber`),在「综合风险一张图」分布面板内、卡片网格之前提供 ▶ 播放 / ⏸ 暂停 / 滑块拖动 / ↩ 总体 四类控制,用于横向查看**同一时刻多个行政区域**的 CRI 与等级。轨道与五灾种页共用同一套「时刻格子」:每格标注 HH:mm、跨天补 MM-dd,顶部色条为该时刻全场最高 CRI 等级颜色,角标为达到该等级的行政区域数(全部缺测为灰条且不显示角标)。25 个时间桶按容器宽度分页显示,‹ › 翻页查看其余时刻,轨道不会撑出页面横向滚动条。 - **统一时间桶**:后端每个行政区域的 `CRI(t)` 只覆盖实际有单灾种数据的桶(长度可能是 1 / 2 / 13 / 25,且 `slotIndex` 是压缩序号而非桶号)。页面按 `hourOffset` 把每个区域重采样成 `−24h ~ +72h` 的稠密 25 桶,缺桶标 `NO_TIMELINE`;**绝不按数组下标对齐**,否则会把 A 区的 −24h 和 B 区的 0h 放进同一帧。县级与乡镇级(默认展示层)均为完整 25 桶。 - **字段适配**:`cri / level / levelName / color` 映射成组件约定的 `riskValue / riskLevel`;帧行再归一回综合字段,并按该时刻 `hazardRisks` 重算灾种构成条、主导灾种与并发 / 缺项清单。 - **联动范围**:卡片列表、行政区域清单、同级排行榜、四级统计、区域研判卡、灾种构成条、「一张图」分级着色全部随帧刷新;回放时按该时刻 CRI 重排并给出帧内位次,卡片标注「逐时刻」与该时刻。 - **与单点曲线互补**:下方独立 CRI(t) 面板仍是「当前选中区域的整场过程曲线」,回放期间不逐帧重绘(避免图表闪烁),只在头部提示当前帧与该区域 CRI;曲线始终取后端原始节点,不因补桶画出「假零风险」谷值。 - **文案可配置**:通用组件新增 `title / hint / unitLabel / emptyText / modeOverall` 选项,默认值仍是「全部点位 / 个点位 / 总体风险」,五个单灾种页不传即保持原样;综合页传「全部行政区域 / 个行政区域 / 总体综合风险」。 - **零额外请求**:帧数据全部来自 `POST /assess/custom/all` 响应内联的 `results[i].timeline`;结果刷新时 `update()` 重建帧序列并保留正在播放的帧索引。 ### 主要接口 | 方法 | 路径 | 说明 | |------|------|------| | GET | `/api/risk/comprehensive/regions`、`/regions/{code}` | 行政区台账(三级、含边界 WKT) | | GET | `/api/risk/comprehensive/units` | 行政区—单灾种单元映射 | | GET | `/api/risk/comprehensive/params`、`/weights`、`/scenarios` | 生效参数 / 权重模板 / 8 个联动场景 | | **POST** | `/api/risk/comprehensive/assess/custom/all` | **前端主数据源**:全县三级 26 条结果 + 排行榜 + 简报 + 版本戳 | | POST | `/api/risk/comprehensive/assess/custom` | 单行政区域研判卡 | | GET | `/api/risk/comprehensive/assess/all`、`/assess/{code}` | 默认场景快速评估 | | GET | `/api/risk/comprehensive/ranking`、`/summary`、`/history` | 最近一轮排行榜 / 态势简报 / 跨轮次历史 | 响应类型刻意使用独立的 `ComprehensiveAssessmentResponse`(不复用 `AssessmentResponse` / `RiskAssessmentResult`),避免被 `RiskTimelinePersistenceAdvice` 按单灾种口径误落库;快照由 `ComprehensiveResultStore` 用单条多值 `INSERT ... ON DUPLICATE KEY UPDATE` 自行落库,失败只告警并降级为内存历史。 ### 验证 - 后端:`target/dbinit/verify_comprehensive.py`(58 项:台账 / 8 场景 / 三级汇总 / 三种合成方法 / 并发与一致性 / 缺项 / CRI(t) 25 桶 / 单区域 / 榜单 / 简报 / 历史 / 管理端四表) - 前端:`target/dbinit/test_comprehensive_runtime.js`(DOM mock:初始化 / 六个面板 / 时间轴降级 / 三态切换 / 地图降级 / 三级下钻 / 层级过滤 / 参数作用域 / 场景联动 / 缺项展示) - 逐时刻回放:`target/dbinit/verify_comprehensive_scrubber.py`(31 项:页面结构 / 适配层 / 通用组件向后兼容 / 后端 CRI(t) 桶覆盖与多区域差异 / 版本一致)、`test_comprehensive_scrubber.js`(28 项 DOM mock:25 帧构造 / 稀疏区域补桶 / 帧内排序与横向对比 / 播放暂停拖动重置 / 单点曲线不补零) - 纯算法单测:`src/test/java/com/fysb/risk/engine/ComprehensiveRiskModelTest.java`(11 例:三分量聚合 / 缺项标记 / 4h 时间桶对齐 / 三种 CRI 合成 / 并发放大 / 一致性校验 / 贡献度归一 / 分位数排序 / 权重归一);`mvn -o test` 全量 30 例通过、0 失败。 - 原有模块回归:`verify_timeline_scrubber.py` 226 项 / `verify_result_views.py` 194 项 / `verify_risk_timeline.py` 275 项,均 0 失败。 ## 逐时间节点风险评估结果(R(t)) ### 背景 此前五个灾种都把整段时间序列压缩成一个最终总体风险 R;已有的 `hourlyQ` / `forecastQ` / `observedQ` / `nowcastQ` / `hourlyFwi` / `forecastFwi` 只是**致灾驱动量 Q / FWI**,不是风险 R;`risk_assessment_result` 表虽存在但全项目没有写库代码,一直是空表。本章的能力解决了三件事:**每个时间节点都算出完整 H/E/V/C/R 与等级**、**响应直出**、**自动落库可回溯**。 ### 计算方式 统一内核 `RiskComputeEngine` 仍只负责整场过程聚合后的单值结果;时间维度由纯算法类 `RiskTimeline` 展开,用**同一个**四要素公式,不重复实现灾种机理: ``` H(t) = H_final × driver(t) / max(driver) R(t) = clamp01( H(t) × E × V / (1 + C) ) ``` - `driver(t)` 是该时间节点的致灾驱动量,峰值节点的 `H(t)` 等于最终总体危险性 `H`,保证过程曲线与总体结果自洽,不会出现「过程峰值高于总体风险」。 - `E` / `V` / `C` 在短时段内属评估单元固有属性,逐点保持不变。 - 最终结果若额外叠加「在册隐患点 / 要害对象风险下限」保护,最终 R 会略高于时间轴峰值 R,属预期行为。 各灾种自适应时间轴(优先复用内核已算出的逐时次序列,山洪 / 地灾回放 `MetData` 逐小时面雨量实况与预报): | 灾种 | 时间轴 | 粒度 | 驱动量 | |---|---|---|---| | 城市内涝 | 近 60min 实况 + 未来 0~2h 短临 | 5min / 10min | `observedQ` / `nowcastQ` | | 流域洪涝 | 过去 24h 涨水段 + 未来 0~72h 演进(含退水延续) | 1h | `hourlyQ` / `forecastQ` | | 森林火灾 | 过去 24h 实况 + 未来 0~72h 预报 | 1h | `hourlyFwi` / `forecastFwi` | | 山洪 / 地质灾害 | `MetData` 逐小时面雨量实况 + 预报 | 1h | 逐小时面雨量 (mm) | 每个节点带 `phase`(`OBSERVED` / `NOWCAST` / `FORECAST` / `CURRENT`)、`driverName`、`driverValue`、完整四要素、R、四级等级、颜色、`status` 与归属 `unitId` / `hazardType`。`MET_MISSING` / `PARAM_ERROR` / `COMPUTE_ERROR` 时**仍输出节点留痕**,但 R=0、等级为 null、状态明确标注,绝不冒充低风险;`PARTIAL` 正常绘制但标注置信度降低。 ### 数据表与落库策略 `src/main/resources/db/init_risk_timeseries.sql` 幂等新增两张表,并复用既有 `risk_assessment_result`: | 表 | 用途 | 关键字段 / 索引 | |---|---|---| | `risk_assessment_batch` | 一次评估 = 一个批次,含各单元最终总体风险快照 JSON | 主键 `batch_id`;`(hazard_type, assessment_time)` | | `risk_assessment_timeseries` | 每个单元每个时间节点一行,含完整 H/E/V/C/R 与等级 | 唯一键 `(batch_id, unit_id, slot_index)`;`(hazard_type, unit_id, slot_time)` | | `risk_assessment_result` | 既有主表,补写各单元最终总体风险快照 | 用 `met_version = 'batch:<批次UUID>'` 关联批次,不改表结构,随批次清理 | `ResultPersistenceService` 由 `RiskTimelinePersistenceAdvice`(`ResponseBodyAdvice`)在评估响应写出前统一调用,因此五个灾种共 20 余个单点 / 全量 / 自定义端点**无需逐个改 Controller**;响应对象同时回填 `batchId`,前端一次请求即可同时拿到结果与批次号。持久化异常只记 warn,绝不阻断评估响应;mock 模式或数据库不可达时自动降级为内存存储,查询接口仍可用。 - **节流**:同一灾种在 `risk.timeline.min-interval-seconds`(默认 30s)内复用同一 `batch_id`,明细按唯一键 UPSERT,避免「实时评估」滑杆刷爆数据库。 - **保留**:每个灾种只保留最近 `risk.timeline.keep-batches`(默认 20)个批次,写入后清理更早批次及其明细 / 主表快照,数据量有界。 - **性能**:明细与主表快照均为**单条多值 `INSERT ... ON DUPLICATE KEY UPDATE`**(参数全部绑定,只拼接 `(?,?,…)` 占位符),把逐行网络往返压成一次。远程 MySQL 下逐行写入曾让全量评估劣化到 7.7~27.2s;改造后实测五灾种全量评估 0.30~3.83s,A/B 对照(禁用持久化)测得落库净开销仅 **0.33~0.67s**。 配置(`application.yml`): ```yaml risk: timeline: enabled: true # 关闭后仍返回内联 timeline,但不落库 keep-batches: 20 min-interval-seconds: 30 ``` ### 查询接口 | 方法 | 路径 | 说明 | |---|---|---| | GET | `/api/risk/timeline/summary` | 存储状态:是否启用、存储后端(MYSQL / MEMORY)、保留批次、节流窗口 | | GET | `/api/risk/timeline/batches` | 批次列表,可带 `hazardType`,按时间倒序 | | GET | `/api/risk/timeline/latest` | 最近一次评估的时间节点,可带 `hazardType` / `unitId` / `limit` | | GET | `/api/risk/timeline/points` | 通用明细查询:`batchId` / `hazardType` / `unitId` 任意组合 | | GET | `/api/risk/timeline/batch/{batchId}` | 指定批次全部时间节点,可带 `unitId` | ### 前端 R(t) 曲线(风险分布面板外的独立单点信息面板) `js/risk-timeline-chart.js` 暴露 `window.RiskTimelineChart`,五个评估页面共用,脚本顺序固定为「组件早于页面主逻辑」。**时间轴是「风险分布面板」之外的独立单点信息面板**:位于分布面板下方、与四要素剖面 / 致灾因子明细等单点面板并列常显,容器 id 为 `index-timeline-view` / `geo-timeline-view` / `ff-timeline-view` / `rf-timeline-view` / `uw-timeline-view`,带 `data-timeline-panel="1"`,**不设 `hidden`、不参与视图切换**。分布面板工具栏提供「卡片列表 / 地图 / 风险矩阵」三态;每次评估结果刷新或切换选中单元,页面调用 `renderRiskTimelineFromResults()` 重绘当前单元的 R(t) 并重算画布尺寸,容器始终可见,不存在隐藏容器里初始化导致画布宽度为 0 的问题。 **入口与直达链接**:顶部 `.top-stats` 工具栏的「⏱ 风险时间轴」按钮由 `js/risk-timeline-quick.js`(`window.RiskTimelineQuick`)统一联动,点击后**滚动定位**到下方独立面板并重算曲线尺寸,不改变「卡片列表 / 地图」视图;`<页面>.html?view=timeline`(如 `index.html?view=timeline`)直达链接同样定位到该面板,便于演示与分享。五个页面 `
` 另有 no-cache meta,所有本地 JS/CSS 引用带 `?v=` 版本号,避免预览面板或浏览器复用旧页面。 主系列为风险 R(t),可叠加 H(t) / E / V / C,标注 0.25 / 0.50 / 0.75 四级阈值与峰值,按相位用浅色背景划分实况 / 短临 / 预报段;下方同时输出「逐时间节点明细表」(时刻 / 相位 / 驱动量 / H/E/V/C / R(t) / 等级 / 状态)。只依赖本地 ECharts 副本,图表库缺失时降级为明细表,绝不阻断评估流程。每页提供「查看已落库批次」按钮,调用 `/api/risk/timeline/latest` 回放历史结果。 验证:`target/dbinit/verify_risk_timeline.py`(覆盖五灾种响应内联 timeline、公式一致性、时间升序与相位、峰值、缺测语义、批次与三表落库、查询接口、节流、管理端注册、五页独立时间轴面板与三态切换)与 `target/dbinit/test_risk_timeline_runtime.js`(覆盖曲线配置、明细表、缺测断点、ECharts 缺失降级、历史批次查询)。 ## 项目结构 ``` dynamic-risk-assessment-agent/ ├── src/main/java/com/fysb/risk/ │ ├── RiskAssessmentApplication.java # Spring Boot 启动类 │ ├── controller/ # REST API 控制层 │ │ ├── FlashFloodRiskController.java │ │ ├── GeoHazardRiskController.java # 地质灾害评估接口 │ │ ├── ForestFireRiskController.java # 森林火灾评估接口 │ │ ├── RiverFloodRiskController.java # 流域洪涝评估接口 │ │ ├── UrbanWaterloggingRiskController.java # 城市内涝评估接口 │ │ ├── RiskTimelineController.java # 逐时间节点风险结果查询接口 │ │ ├── RiskTimelinePersistenceAdvice.java # 评估响应写出前统一落库切面 │ │ ├── ComprehensiveRiskController.java # 行政区域综合风险评估接口 │ │ ├── SystemController.java # 系统信息 / 六模块注册表 │ │ ├── RiskConfigController.java # 配置管理接口 │ │ └── AdminController.java # 管理端通用 CRUD 接口 │ ├── admin/ # 管理端白名单元数据 + 通用数据服务 │ │ ├── AdminTableMeta.java │ │ ├── AdminTableRegistry.java # 29 张可维护表注册(含山洪气象 / 综合风险 / 时间轴) │ │ └── AdminDataService.java │ ├── service/ # 业务服务层 │ │ ├── RiskAssessmentService.java # 服务接口 │ │ ├── RiskConfigService.java # 配置加载/同步/刷新 │ │ ├── GeoHazardConfigService.java # 地灾分区曲线参数 │ │ ├── ForestFireConfigService.java # 森火全局 + 分区参数解析 │ │ ├── RiverFloodConfigService.java # 洪涝全局 + 水系分区参数解析 │ │ ├── UrbanWaterloggingConfigService.java # 内涝全局 + 排水分区参数解析 │ │ ├── GeoHazardAssessmentService.java │ │ ├── ForestFireAssessmentService.java │ │ ├── RiverFloodAssessmentService.java # 河网级联与洪水演进 │ │ ├── UrbanWaterloggingAssessmentService.java # 5min 实况 / 0~2h 短临拼接与演变时序 │ │ ├── ResultPersistenceService.java # 逐时间节点风险结果落库(批次 / 明细 / 主表快照) │ │ ├── ComprehensiveConfigService.java # cr_* 参数解析(覆盖 > 数据库 > 内置默认) │ │ ├── ComprehensiveAssessmentService.java # 单灾种编排 + 两级聚合 + 排序 / 简报 │ │ └── ComprehensiveResultStore.java # 综合风险快照落库 + 跨轮次内存历史 │ │ └── impl/ │ │ └── FlashFloodAssessmentService.java │ ├── engine/ # 统一计算引擎 │ │ ├── RiskComputeEngine.java # R = H×E×V/(1+C) 核心 │ │ ├── RiskTimeline.java # 逐时间节点 R(t) 构建器(纯算法) │ │ ├── GeoHazardRiskModel.java # 地灾纯算法内核(S × T) │ │ ├── ForestFireRiskModel.java # 森火纯算法内核(B × F / FWI) │ │ ├── RiverFloodRiskModel.java # 洪涝纯算法内核(Q × S / API / 汇流滞后) │ │ ├── UrbanWaterloggingRiskModel.java # 内涝纯算法内核(Q × D / 短历时雨强 / 快涨快退) │ │ └── ComprehensiveRiskModel.java # 综合风险纯算法:两级聚合 / 三种 CRI / 并发 / 一致性 / 时间桶 / 分级排序 │ ├── plugin/ # 灾种插件 │ │ ├── IHazardPlugin.java # 插件接口契约 │ │ └── impl/ │ │ ├── FlashFloodPlugin.java # 山洪插件(核心算法) │ │ ├── GeoHazardPlugin.java # 地质灾害插件 │ │ ├── ForestFirePlugin.java # 森林火灾插件 │ │ ├── RiverFloodPlugin.java # 流域洪涝插件 │ │ └── UrbanWaterloggingPlugin.java # 城市内涝插件 │ ├── model/ # 数据模型 │ │ ├── enums/ # 枚举 │ │ ├── WatershedUnit.java # 小流域单元 │ │ ├── ComprehensiveAdminRegion / ComprehensiveRegionUnit / ComprehensiveRegionWeight # 行政区 / 映射 / 权重台账 │ │ ├── ComprehensiveUnitRisk / ComprehensiveHazardRisk / ComprehensiveModelParams # 第一级输入输出 / 参数包 │ │ ├── ComprehensiveRiskResult / ComprehensiveTimelinePoint # CRI 结果 / CRI(t) 节点 │ │ ├── RiskAssessmentResult.java # 统一评估结果(含各灾种扩展字段 + timeline / batchId / 峰值) │ │ ├── RiskTimelinePoint.java # 单个时间节点的 H/E/V/C/R 与等级 │ │ ├── HazardFactors.java # 致灾因子 │ │ ├── FlashFloodParams.java # 山洪参数包 │ │ ├── GeoHazardSite / GeoHazardCurve / GeoHazardModel* │ │ ├── ForestFireSite / ForestFireZone / ForestFireModel* # 台账 / 分区 / 输入输出 / 参数 │ │ ├── RiverFloodReach / RiverFloodZone / RiverFloodModel* / UpstreamFlow │ │ ├── UrbanWaterloggingSite / UrbanWaterloggingZone / UrbanWaterloggingModel* │ │ ├── MetData.java # 气象数据 │ │ ├── ExposureData.java # 承灾体 E │ │ ├── VulnerabilityData.java # 脆弱性 V │ │ └── CapacityData.java # 防灾能力 C │ ├── dto/ # 数据传输对象(含五灾种场景请求 / 预设场景) │ ├── repository/ # 数据访问层(接口) │ │ ├── jpa/ # 配置表 JPA Repository │ │ ├── mock/ # Mock 实现 │ │ └── impl/ # 地灾 / 森火 / 洪涝 / 内涝 / 综合风险 MySQL 仓储 + 内置演示数据兜底 │ ├── entity/ # 配置表实体 │ │ ├── RiskConfig.java │ │ └── FlashFloodCriticalRainfall.java │ └── config/ # 配置类 │ ├── FlashFloodRiskConfig.java │ └── JpaConfig.java # 按 risk.datasource.type 条件启用 JPA ├── src/main/resources/ │ ├── application.yml # 应用配置(含风险参数种子值) │ ├── application-mock.yml # 离线 Mock profile │ ├── db/ # 建表与初始化脚本(九份,均幂等) │ │ ├── init_risk_config.sql │ │ ├── init_business_tables.sql │ │ ├── init_geo_hazard.sql │ │ ├── init_forest_fire.sql │ │ ├── init_river_flood.sql │ │ ├── init_urban_waterlogging.sql │ │ ├── init_risk_timeseries.sql # 逐时间节点结果批次表 / 明细表 │ │ ├── init_comprehensive.sql # 综合风险四表 + 16 条 cr_* 配置 │ │ └── schema_postgis_reference.sql # PostGIS 设计稿,勿在 MySQL 执行 │ └── static/ # 前端(原生 HTML/CSS/JS,无需构建) │ ├── index.html / css/style.css / js/app.js # 山洪评估调试验证台 │ ├── geo-hazard.html / js/geo-hazard.js # 地质灾害调试验证台 │ ├── forest-fire.html / js/forest-fire.js # 森林火灾调试验证台 │ ├── river-flood.html / js/river-flood.js # 流域洪涝调试验证台 │ ├── urban-waterlogging.html / js/urban-waterlogging.js # 城市内涝调试验证台 │ ├── comprehensive-risk.html / js/comprehensive-risk.js / css/comprehensive.css # 行政区域综合风险 │ ├── js/comprehensive-region-map.js # 行政区分级着色一张图(WKT 解析 / WGS84→GCJ-02 / 降级清单) │ ├── module-placeholder.html / css/modules.css / js/module-nav.js # 六模块导航与占位页 │ ├── admin.html / admin-config.html / admin-history.html / admin-scenarios.html # 后台四模块 │ ├── css/admin.css / js/admin.js # 三个后台页面共用样式与 CRUD 逻辑(按 data-admin-module 分模块) │ ├── js/amap-config.js / js/amap-settings.js # Key + 统一官方卫星影像底图 / 「地图设置」弹窗(localStorage) │ ├── css/amap-settings.css / js/map-view.js # 设置弹窗样式 / 管理端空间渲染 │ ├── js/risk-map.js # 评估页全流域风险分布地图 │ ├── js/risk-result-map.js # 五灾种通用「评估结果地图」组件 + 三态视图切换器 │ ├── js/risk-matrix.js # 六页通用评估单元 × 时刻风险矩阵(第三结果视图) │ ├── js/risk-timeline-chart.js # 五灾种通用 R(t) 曲线(风险分布面板外独立单点信息面板) │ ├── js/risk-timeline-scrubber.js # 六页通用逐时刻全点位 / 全行政区域回放工具条(卡片 / 地图按帧渲染) │ └── js/vendor/echarts.min.js # 本地 ECharts 5.4.3(离线可用) ├── scripts/DbInitRunner.java # 无 mysql 客户端时的初始化工具 ├── target/dbinit/verify_*.py, test_*_runtime.js # 端到端与前端运行时验证脚本(构建产物目录) ├── src/test/java/com/fysb/risk/engine/ # 纯算法单测:RiskComputeEngine / RiskLevel / ComprehensiveRiskModel(11 例) ├── src/test/java/com/fysb/risk/service/ # FlashFloodAssessmentService 集成测试 └── pom.xml ``` ### 架构说明 - **插件化设计**:所有灾种实现 `IHazardPlugin` 接口,新增灾种只需编写新插件 + 配置参数包 - **数据层抽象**:Repository 接口定义数据访问契约;山洪气象 / 承灾体仍用 Mock,地灾 / 森火 / 洪涝 / 内涝台账已通过 `JdbcTemplate` 读 MySQL(不可达时回退内置演示数据),可无缝替换为真实数据源 - **五灾种同构分层**:`XxxRiskModel`(纯算法)→ `XxxPlugin` → `RiskComputeEngine` → `XxxAssessmentService` → `XxxRiskController`,山洪 / 地灾 / 森火 / 洪涝 / 内涝共用统一内核与四级分级 - **配置持久化**:临界雨量阈值与五灾种模型参数存于 MySQL,由 `RiskConfigService` / `GeoHazardConfigService` / `ForestFireConfigService` / `RiverFloodConfigService` / `UrbanWaterloggingConfigService` 加载,`application.yml` 仅作为初始化种子与兜底默认值 - **集中管理**:管理端 Web 页面 + 通用 CRUD API,可直接维护阈值、模型参数、流域/村落、隐患点、林班台账、河段与易涝点台账及历史序列,改动即时生效 - **空间可视化**:所有地图统一使用高德官方卫星影像 + 官方路网注记图层;管理端渲染流域出口、村落点位、流域边界、地灾隐患点、森火单元、洪涝河段与城市易涝点,五个灾种的风险分布均可用「卡片列表 / 地图 / 风险矩阵」三态切换查看,逐时间节点风险 R(t) 在下方独立单点信息面板常显,未配置 Key 时地图均降级为清单;分布面板内的逐时刻回放滑块可把卡片与地图切到任一时刻的全点位快照 - **合规 Key 管理**:源码只保留显式占位符,用户通过页面「⚙ 地图设置」把 Key 存入本机浏览器 `localStorage`,评估页与管理端共用,绝不写入源码或输出 - **行政区域综合风险上层模块**:`ComprehensiveRiskModel`(纯算法)消费五个单灾种结果,经第一级空间聚合、第二级 CRI 合成、并发修正与一致性校验,输出县 / 乡镇 / 村三级行政区的 CRI / 等级 / 排序 / 主导灾种 / CRI(t);台账、映射、权重与结果快照由四张独立表维护,前端「综合风险一张图」支持三级下钻,详见「行政区域综合风险动态评估模型」一章 - **逐时间节点结果**:`RiskTimeline`(纯算法)在五个 `XxxAssessmentService` 返回前挂载 R(t) 时间轴,`RiskTimelinePersistenceAdvice` 统一拦截评估响应并落库,前端 `js/risk-timeline-chart.js` 五页共用曲线组件并在风险分布面板之外的独立单点信息面板常显;异常降级不影响评估,详见「逐时间节点风险评估结果」一章 - **逐时刻全点位回放**:`js/risk-timeline-scrubber.js`(`window.RiskTimelineScrubber`)把每个点位响应内联的 `timeline` 按时间节点对齐成帧,拖动滑块 / 播放即可在「卡片列表 / 地图 / 风险矩阵」三态里查看该时刻全部点位的风险等级与 R,统计条同步按帧重算;点「↩ 总体」回到原有的「所有点位总风险情况」。组件不发起任何额外请求,与下方单点 R(t) 曲线互补;时间轴采用一格一时刻的时刻格子轨道,每格标注 HH:mm、顶部色条显示该时刻全场最高风险等级颜色、角标显示达到该等级的点位数。综合风险页复用同一组件,按 `hourOffset` 重采样成 25 个 4h 桶后回放全部行政区域的 CRI,卡片 / 排行榜 / 研判卡 / 一张图同步换帧,文案通过 `title / unitLabel / modeOverall` 等选项覆盖为「行政区域」口径。 - **统一计算引擎**:`RiskComputeEngine` 执行 `R = H × E × V / (1 + C)`,与具体灾种无关 ## 环境依赖 | 依赖 | 版本 | 说明 | |------|------|------| | JDK | 1.8+ | 当前适配 JDK 8,可升级到 JDK 17 + Spring Boot 3 | | Spring Boot | 2.7.18 | 适配 JDK 8 的最新稳定版 | | Maven | 3.6+ | 构建工具 | | Lombok | 1.18.x | 简化 POJO 代码 | | Jackson | 2.x | JSON 序列化 | > **数据库**:配置表与业务数据表均已在 MySQL 库 `fysb_riskmodel_db` 建好(共 23 张表,含逐时间节点结果批次表与明细表), > 脚本见 `src/main/resources/db/`,说明见「配置持久化」「数据存储层」两章。 > 当前气象等动态数据仍由 Mock Repository 提供;流域、村落、暴露度、防灾能力等静态数据已落库, > 实现对应 Repository 的 JPA 版本即可切换为库表读取。后续可考虑: > - PostgreSQL + PostGIS(空间数据) > - 时序数据库(气象数据,如 InfluxDB / TDengine) > - Redis(结果缓存) > **第三方组件**(后续扩展需要): > - Kafka(事件总线,气象数据驱动评估) > - 向量数据库(历史灾例 RAG 检索) > - LLM API(研判层、预警文稿生成) ## 配置持久化(数据库) `application.yml` 中 `risk.flash-flood` 下的临界雨量阈值、API 参数、α/β 系数、H 归一化阈值等已全部落库;地质灾害(`geo_*`)、森林火灾(`ff_*`)、流域洪涝(`rf_*`)、城市内涝(`uw_*`)与综合风险(`cr_*`,`hazard_type=COMPREHENSIVE`)的可率定参数同样只写入 `sys_risk_config(hazard_type=...)` 及各自分区 / 权重模板表,yml 里仅保留说明注释。运行期**以数据库为准**,yml 仅作为初始化种子与离线兜底默认值。 ### 数据表 | 表名 | 用途 | 唯一键 | |------|------|--------| | `sys_risk_config` | 全局 / 灾种级 KV 参数:山洪 `api_k`、`beta`、`alpha_min`、H 归一化阈值;地灾 `geo_*`(K、n、曲线、滞后参数);森火 `ff_*`(FWI 权重、归一化与等级节点、连续干燥度系数);洪涝 `rf_*`(API、动态临界面雨量、Q 分段、退水与演进参数);内涝 `uw_*`(短历时雨强 Q 分段、重现期指数、快涨快退时间常数、要害对象下限、D 合成权重);风险等级阈值 | `(config_key, hazard_type)` | | `flash_flood_critical_rainfall` | 各流域 1h/3h/6h 的准备转移雨量 `pw`、立即转移雨量 `pt`,以及流域级 `beta` / `baseline_api` / `alpha_min` 覆盖值 | `(unit_id, duration)` | 初始化数据量:`sys_risk_config` **共 129 条**(8 条 `FLASH_FLOOD` + 3 条 `GLOBAL` + 16 条 `GEO_HAZARD` + 29 条 `FOREST_FIRE` + 30 条 `RIVER_FLOOD` + 27 条 `URBAN_WATERLOGGING` + 16 条 `COMPREHENSIVE`),临界雨量 **12 条**(4 个小流域 × 3 个历时)。地灾 / 森火 / 洪涝 / 内涝的分区级差异另由 `geo_hazard_curve` / `forest_fire_zone` / `river_flood_zone` / `urban_waterlogging_zone` 覆盖全局值。字段与 `entity/` 下的 JPA 实体一一对应;`is_active=0` 可停用某项配置使其回退 yml 默认值。 ### 初始化(首次部署必需) 脚本:`src/main/resources/db/init_risk_config.sql`(配置与临界雨量)、`src/main/resources/db/init_comprehensive.sql`(综合风险四表 + `cr_*` 参数)。完整初始化顺序见 `src/main/resources/db/` 下九份脚本,均可用下面的 `DbInitRunner` 逐个执行。 ```bash # 方式一:有 mysql 客户端 mysql -h