jiang
2e4f6cb93b
Add isolated burst and pollution impact evidence, parallel work-order workflows, persisted notifications and graph updates. Checkpoint current code. Known follow-ups remain for large pollution result previews and graceful geometry failure.
63 lines
9.1 KiB
Markdown
63 lines
9.1 KiB
Markdown
---
|
||
name: water-pollution-event
|
||
description: 从水质监测侦测信号调查水污染事件，完成数据核验、候选溯源、隔离与影响分析、处置报告和反馈复核。
|
||
metadata:
|
||
version: "1.1.0"
|
||
---
|
||
|
||
# 水污染侦测事件调查
|
||
|
||
适用于 `workflow=water_pollution`，入口是水质监测规则侦测异常，与供水水质投诉 `water_quality_complaint` 分开。无需投诉或人工上报才能调查，也不需要压力下降、流量增加或爆管综合评分达到门槛。侦测异常、候选污染源和污染确诊分别说明。
|
||
|
||
先读取任务、规则信号、异常设备、发生时刻、已有证据与报告。任务携带 replay_context 时，查询严格遵守 knowledge_cutoff 和 batch_sequence；普通侦测任务使用实际异常时刻。时间统一按 Asia/Shanghai 阅读，查询和 sample_times 保留明确时区，图表标题只写日期、时刻与单位。后续轮次优先处理新事实，复用已有资产、溯源、隔离和展示成果。
|
||
|
||
## 1. 核验侦测与观测
|
||
|
||
调用 query_scada_readings，省略 device_ids，全量读取异常时刻之前三小时的授权 SCADA；核对 devices、readings、coverage、分页完成与缺测。核查水质指标名称、单位、设备状态、清洗质量、模型节点映射以及实际规则上下限和连续命中条件。超出仪表量程、无效值和缺测属于数据质量问题，不能直接当作污染。有效水质读数超出配置业务范围支持异常调查，不自行认定为法定水质超标。
|
||
|
||
对照同一设备前七天同期及实际采样记录，保留真实时间和 null 缺口。压力、流量仅作关联依据，正常压力不能排除污染，爆管得分不用于替代水污染判断。没有适用的限值或采样结果时记录具体缺口，继续候选分析。
|
||
|
||
## 2. 候选溯源与节点展示
|
||
|
||
使用水质设备映射取得异常关联节点，以 get_element_properties、get_node_connections 核对。映射缺失时查询设备坐标附近模型节点，不猜编号。候选必须来自当前项目已查询资产。
|
||
|
||
检查 source_trace_capability，调用 run_contaminant_source_trace：candidate_node_ids 提交已核验的候选节点，start/end 为实际核查窗。读取 located_node、top_candidates、validated_node_ids、missing_node_ids 和 selection_basis。当前接口以稳定规则快速返回确定节点，正式反演算法后续接入，不虚构相似度、确诊概率或污染范围。
|
||
|
||
临时算法和 synthetic 来源只说明结果取得方式，不构成停止调查的条件。取得 located_node 后立即通过 publish_task_presentation 展示候选节点，继续隔离、覆盖、影响和报告。无候选时修正资产映射；确实无可用节点时仅暂停依赖源节点的分支，完成已有监测事实与处置建议。
|
||
|
||
定位到源节点后，立即保存 interim/concluded 阶段报告，注明“候选污染源待现场核验、传播范围计算中”，调用 propose_task_action 提出 kind=create_work_order、work_order_type=general 的现场核查／采样处置草稿，引用节点、地点和定位证据。沿用已有 action_id，不因模拟返回再建同类工单。工单审核、派发与传播模拟、隔离分析并行，不等模拟完成才发起工单；审批权限与动作版本校验沿用 Server 流程。
|
||
|
||
## 3. 处置前的污染传播模拟
|
||
|
||
继续调用 run_contaminant_simulation，source=located_node、include_impact_coverage=true；start_time 使用事件业务时刻，duration 使用明确的情景预测时长，output_node_ids 选择源节点和需展示曲线的监测／重要节点。源浓度 concentration 单位 mg/L，使用有来源的浓度或有明确依据的情景假设，保留依据与不确定性，不能把浊度、余氯下降或感官描述直接换算成污染源浓度。缺少可用依据时记录具体参数缺口，继续工单和隔离分支。
|
||
|
||
impact_threshold_mg_l 仅作模型影响范围的展示条件；默认0表示正浓度，非饮用水安全限值。工具在筛选展示节点前汇总全网节点整个模拟时段，返回累计超阈值节点、首个超阈值报告时刻、峰值和地图覆盖。沿用模型初始水质及反应条件，不能将总模型浓度当作源独立贡献，不能据此宣布范围外安全。
|
||
|
||
queued/running 时继续独立工作，用 get_calculation_job 跟踪并以 get_calculation_result 读取终态，不以回执代替结果。待审批或 waiting_work_order 不阻止继续可执行分析；模拟结果补入同一 task_id 的证据、进度与报告，不覆盖已审核工单或绕过版本校验。模拟失败只记录该分支问题，不撤回已有现场核查工单。存在未完成计算时不能结束调查运行或发布 final，按宿主计算等待机制接续。
|
||
|
||
读取结果后，用 presentation_preview 的 evidence_id 发布“水污染传播预计影响范围（处置前情景）”地图；将源浓度、阈值、预测窗、影响节点数、首达采样时刻和峰值写入报告表格，按真实时刻展示模型浓度曲线，模型曲线不填观测专用 chart.scada。地图和图表进入正式调查展示事件，历史播放读取已保存证据，不重新运行模拟。空范围、缺测、不支持的单位或几何超限按实际结果说明。保留污染传播步骤，再展示隔离范围，不以隔离覆盖替代传播范围。
|
||
|
||
带 replay_context 时同样可运行此情景，起算不得晚于知识截止；使用当前模型且不读取实时 SCADA。知识截止后的模拟时刻是预测，不得当作已观测数据或历史模型重建。
|
||
|
||
## 4. 隔离边界与影响
|
||
|
||
调用 analyze_valve_isolation，accident_element=[located_node]，明确 accident_element_type="node"，避免节点与管段重号。保留 isolatable、must_close_valves、optional_valves、affected_nodes、supply_affected_nodes 及各自计数。已知失效阀门通过 disabled_valves 分析替代边界；不能隔离时记录原因并继续其他处置建议。
|
||
|
||
展示候选节点、必关与可选阀门。用 generate_node_coverage 分组生成直接隔离、新增供水失源覆盖，再通过 publish_task_presentation 发布。空节点组不提交覆盖计算。拓扑隔离、供水失源、污染传播、水力变化和用户影响分别说明，节点覆盖不能当作污染传播边界，无用户资料不虚构户数。
|
||
|
||
输入和权限具备时使用 analyze_valve_closure 评估关阀水力影响，污染传播复用第3节结果。有排放节点、流量和前置条件时用 analyze_flushing 评估冲洗，缺少可选参数不阻止形成隔离、采样和保障建议。回放未开放的其他水力工具按实际权限记录限制，继续已授权分析。
|
||
|
||
## 5. 过程图表与报告
|
||
|
||
水质曲线填写 chart.scada：metric="quality"、真实 unit、role=current/comparison、完整三小时 window_start/window_end；series 绑定 device_id 和 day_offset。不同水质指标或单位分图，不能把浊度、余氯或其他指标混成同一浓度。当前总览覆盖报告与地图列出的全部目标；各设备七天同期图采用 time_comparison，当前三小时为 line，前七天每天末三个实际采样时刻为 scatter，sample_times 与 data 等长且保留真实日期。缺测保留 null，超过槽位上限按时间分图。所有数据引用本轮证据；展示不要求等待浏览器。
|
||
|
||
报告包含“事件概况、侦测与数据核验、候选溯源、隔离方案、影响说明、处置建议、反馈复核与待办”。影响说明列出实际异常指标、单位、时间、测点、直接隔离与失源节点数、水力或传播预测和用户保障。明确临时选点、观测事实、模型假设及待现场确认事项。最终报告引用本轮全量 SCADA 证据及已取得的溯源、隔离和覆盖证据。查询失败或权限拒绝记录为执行异常，不能写成无数据或未见异常。
|
||
|
||
## 6. 处置与反馈接续
|
||
|
||
第2节已提出的 general 工单继续沿用，按新增证据组织污染进入控制、隔离核验、通知保障、清洗冲洗及复测；已有工单确有不足时再提出必要的新动作。标题写“地点＋动作”，写明执行条件、真实节点、时间要求与回执内容；审批、派发和现场执行遵守 Server 权限。没有用户通知适配器时交由人工实施。回放草稿注明异常业务时间及来源，不直接执行设备命令。
|
||
|
||
待审批、waiting_work_order 且无独立工作时，发布本轮 interim/concluded 并引用真实 action_id 后结束本轮，释放租约，不循环查询或重复建单。field_review 时核对各关联工单反馈及实际采样、处置、复测的时间、位置、数值和判定依据，再查询反馈业务时间之后已有水质观测；不要重跑原始调查。缺少关键事实时先完成独立工作，再用 ask_task_user 明确待补内容并结束本轮等待。
|
||
|
||
本轮调查成果完成与现场事件结案分别表述。工单 completed 或压力恢复不证明水质合格，不套用爆管压力恢复的自动结案条件。反馈复核具备依据时发布 final/concluded，引用最新现场反馈证据；仍异常时调整建议或新建必要动作，未来采样、复测和恢复不能写成已完成。
|