YZWater3/docs/扬杰二厂业务流程梳理.md

扬杰二厂泵站 业务流程梳理

依据：docs/扬杰二厂泵站需求.md、projects/yangjie2.json、AutoControlService.cs 等现有实现 梳理日期：2026-09-06

---

一、项目概况

项	值
工艺场景	扬杰二厂集水池排污泵站（1 个集水池 + 3 台排污泵）
PLC	西门子 S7（S7-200 Smart），地址 I/Q/M/VD
控制方式	中控（上位机）/ 屏控（现场触摸屏）二选一，由 M*.0 位决定
监测量	液位、压力、流量、日流量、3 台泵电流、日台时
前端模板	PumpStation（泵站专用视图）

---

二、核心业务流程

1️⃣ 数据采集流程（每轮询周期，默认 1s）

PlcPollingService 定时轮询
   │
   ├─ 读模拟量 VD62(液位) / VD6600(压力) / VD6604(流量)
   │         VD50/54/58(泵电流) / VD884(日流量) / VD950+VD10(日台时)
   │
   ├─ 读数字量 Q0.1~Q0.3(泵运行) / I0.1~I0.3(变频器故障) / M2.6/M5.6/M8.6(手自动)
   │
   ├─ 读控制参数 VD500/504/508/528/962(液位阈值) / VD6700/6704(压力阈值)
   │
   └─ 发布 DataUpdated 事件 → 触发下游所有业务
        ├─ AlarmService       → 报警检测
        ├─ AutoControlService  → 液位自动启停泵
        ├─ DeviceStateMachineManager → 设备状态机转换
        ├─ DataLoggingService  → 历史数据入库
        └─ UI ViewModel       → 界面刷新

2️⃣ 控制模式判定（每台泵独立）

读 M*.0（中控/屏控选择位）
   ├─ M*.0 = 0 → 中控模式：上位机启停命令【有效】
   └─ M*.0 = 1 → 屏控模式：上位机【只监视】，写命令无效

3️⃣ 液位自动控制（核心业务，AutoControlService）

每个轮询周期:
  读集水池液位 VD62
       │
       ▼
  计算需要泵数 requiredCount:
  ┌─────────────────────────────────────────────┐
  │ 液位 > VD962(保护液位)  → 3台全启（紧急排污）│
  │ 液位 > VD528(停止液位)  → 0台（全部停止）    │
  │ 液位 < VD508(启3台位)   → 3台               │
  │ 液位 < VD504(启2台位)   → 2台               │
  │ 液位 < VD500(启1台位)   → 1台               │
  │ 其余（滞后区间）        → 维持现状           │
  └─────────────────────────────────────────────┘
       │
       ▼
  防抖延迟:
    启泵条件需持续 ≥ 3 秒 (StartDelaySeconds)
    停泵条件需持续 ≥ 5 秒 (StopDelaySeconds)
       │
       ▼
  选泵策略 (SelectPumpsToRun):
    ① 剔除故障泵
    ② 按日台时(累计运行时长)升序 → 优先选运行时间最短的泵
    ③ 时长相同时用轮换索引打破平局（均衡磨损）
       │
       ▼
  执行启停（对每台泵）:
    目标开 & 未运行 & 无故障 & 距上次启动 ≥ 60秒
        → 点动写 M*.3 (置ON 200ms → OFF)
    目标关 & 运行中 & 距上次停止 ≥ 60秒
        → 点动写 M*.4

要点：requiredCount 只在越限时变化，滞后区间防止液位在阈值附近抖动导致频繁启停。

4️⃣ 手动控制流程（操作员在中控执行）

操作员点击 启动/停止 按钮 (ViewA / ProjectView)
   │
   ▼
权限检查 (AuthService.HasPermission ≥ Operator)
   │
   ▼
写入点动命令位: 启动 M*.3 / 停止 M*.4 (ON 200ms → OFF)
   │  （命令是否生效取决于该泵当前是中控模式 M*.0=0）
   ▼
下一轮询周期读回 Q0.x 验证运行状态 → 界面刷新
   │
   └─ 审计日志记录 (AuditService.Log)

5️⃣ 报警流程

每周期 AlarmService.CheckAlarms:
  ┌────────────────────────┬──────┬──────────────────────┐
  │ 条件                    │ 级别 │ 动作                  │
  ├────────────────────────┼──────┼──────────────────────┤
  │ 压力 < VD6700(低压设定) │ 警告 │ 日志 + 界面提示       │
  │ 压力 > VD6704(高压设定) │ 警告 │ 日志 + 界面提示       │
  │ 泵变频器故障 I0.1~I0.3  │ 严重 │ 报警记录 + 通知       │
  │ PLC 断连                │ 提示 │ PLC_Connection 报警   │
  └────────────────────────┴──────┴──────────────────────┘
       │
       ├─ 报警延迟 3 秒 + 死区 2.0（防抖）
       ├─ 通过 Channel 异步入库 alarm_records
       ├─ 升级机制: 未确认超 10 分钟 → 升级 + 通知
       └─ 操作员确认 → 更新 IsConfirmed/ConfirmedBy

6️⃣ 设备状态机流程（每台泵）

PLC 信号驱动 Stateless 状态机:
  Q0.x 运行 + I0.x 无故障 → Running
  Q0.x 停止 + 无故障      → Stopped
  I0.x = 1 (变频器故障)   → Fault（触发设备报警）
       │
       └─ 状态每次变化持久化到 equipment_statuses 表

7️⃣ 数据统计与留存

持续: 轮询数据 → analog_records / flow_records（360天保留）
每日: DataRetentionService 清理过期记录（24h 周期）
每日: BackupService 启动备份 + 24h 定时备份（WAL checkpoint + VACUUM INTO）
日台时: 读 VD950+VD10 等（PLC 累计），M19.4 点动清零
日流量: 读 VD884，M19.3 点动复位

---

三、PLC 点位速查

3.1 数字量 I/O

地址	名称	方向
I0.0	预留	读
I0.1	泵1变频器故障	读（1=故障）
I0.2	泵2变频器故障	读（1=故障）
I0.3	泵3变频器故障	读（1=故障）
Q0.1	1#泵启停	写
Q0.2	2#泵启停	写
Q0.3	3#泵启停	写

3.2 模拟量

地址	名称
VD62	即时液位
VD50	泵1电流
VD54	泵2电流
VD58	泵3电流
VD6600	即时压力
VD6604	即时流量
VD884	日流量（累计）

3.3 液位控制参数

地址	名称
VD500	启动1台泵液位
VD504	启动2台泵液位
VD508	启动3台泵液位
VD528	停止液位
VD962	保护液位

3.4 泵控制位

功能	泵1	泵2	泵3
中控/屏控选择	M1.0	M4.0	M7.0
上位手动启动	M1.3	M4.3	M7.3
上位手动停止	M1.4	M4.4	M7.4
上位自动命令	M2.2	M5.4	M8.4
上位手动命令	M2.1	M5.3	M8.3
手自动状态	M2.6 (1=自动)	M5.6 (1=手动)	M8.6 (1=手动)
故障信号	M3.1	M6.1	M9.1

3.5 日台时 / 日流量

功能	泵1	泵2	泵3
日台时-小时	VD950	VD954	VD958
日台时-分钟	VD10	VD18	VD28
日台时清零	M19.4	M19.4	M19.4
日流量复位	M19.3	—	—

---

四、⚠️ 已知风险点（待确认）

#	问题	现状	影响
1	泵1 与泵2/3 的手自动状态位极性相反（M2.6: 1=自动；M5.6/M8.6: 1=手动）	档案照抄点位表，未做极性归一	控制逻辑判断可能出错
2	日台时/日流量清零由谁触发（定时 or 手动）	未实现自动清零	统计数据可能不准
3	保护液位触发后是否需人工复位	未实现复位确认	安全逻辑待确认
4	点动持续时间（当前写死 200ms）	需现场联调确认	需现场验证
5	故障泵是否自动顶替	选泵时自动剔除故障泵 ✅	已覆盖
6	泵1故障信号位（M3.1/M6.1/M9.1）与 I0.1~I0.3 是否重复	需确认 PLC 程序	报警逻辑可能重复

---

五、与当前代码的对应关系

需求	对应代码	状态
PLC 地址重映射	projects/yangjie2.json + PlcConfig	✅ 已完成
液位自动控制	AutoControlService.cs	✅ 已完成
中控/屏控切换	需在写命令前检查 M*.0	⏳ 待实现
压力监测	AlarmService.CheckAlarmsFromProfile	✅ 已完成
泵电流监测	yangjie2.json 中 currentAddress 已配置	✅ 读取已有
3台泵状态	DeviceStateMachineManager	✅ 已完成
日台时统计	读取地址已配置，UI 待展示	⏳ 部分
日流量统计	VD884 读取已配置	✅ 读取已有
报警逻辑	AlarmService	✅ 已完成
设备状态机	DeviceStateMachine（Stateless）	✅ 已完成