水位区间用于理解日常调节；年度目标用于理解引配水任务；工程规模和报道排量作为参考。三者都不能替代当班水位、雨量、泵闸反馈及现行调度命令。暂无经核验可直接调用的公开实时调度接口。

圣塘闸报道为2扇闸门、每扇最大开度1.5m；缺少上下游水头及率定关系，不能用“开一半＝流量一半”计算实际排水。不同报道存在总排量口径差异，本工具不相加。

湖水量变化＝湖面降雨＋陆域径流＋其他基流＋人工补水－外排－蒸发；水位变化＝湖水量变化÷等效水面。陆域采用线性蓄泄并保留期末未入湖水量，核对全系统水量闭合。初始陆域蓄水设为0，未反演前期降雨，地下水交换与渗漏未单列。

6.5km²为教学等效水面近似，15km²陆域、径流系数、滞后、蒸发等为可调假设。公开汇水面积口径不清，未当成陆域面积直接叠加，避免重复计量。本算例以圣塘闸参考18m³/s约束等效单出口，未叠加其他八口，不代表全湖排洪能力。

目标策略仅限制外排不低于演练目标，不能在补水不足时自动把水位抬到目标。下游水位达到湖位时，本模型暂停正向重力外排；不计算复杂回水、倒灌和闸孔水力。补水暂停由情景条件决定，不作水质浓度判定。

落地需取得统一高程基准的水位、分区雨量、库容曲线、各闸上下游水位与开度—流量率定、泵站实际流量、预处理允许条件及现行调度命令。经现场复核、模型率定和过程回算后，方可讨论调度辅助应用。

station_id、observed_at、water_level_m、vertical_datum、rainfall_mm、rain_period_min、inflow_m3s、outflow_m3s、gate_opening_m、downstream_level_m、quality_flag。source在文件顶层填写数据提供方与采集说明。

雨量为指定时段累计，不当作瞬时强度；流量不等于累计水量。格式示例内的0表示明确零值，null表示缺测，两者在图表和表格中分别保留。