# 规则引擎实施计划 — 任务清单

> **版本**: 1.0
> **日期**: 2026-06-04
> **基准**: `doc/设计文档/规则引擎实现方案_v1.0.md`
> **分支**: gateway-dev
> **原则**: 分阶段分步骤执行，每步骤编译复查后提交，不合并主分支

---

## 当前状态

| 前置条件 | 状态 |
|------|:--:|
| RealtimePollJob（10s 采集 MC4 IoT 值） | ✅ 已实现 |
| warehouse_rule/condition/action 表 + 管理端 CRUD | ✅ 已实现 |
| warehouse_rulelog 表 | ❌ 待建 |
| 网关 B4-batch 批量接口 | ✅ 已实现 (P1-1) |
| 网关 B5（设备控制） | ✅ 已实现 |
| 网关 B10（远程控制） | ✅ 已实现 |
| VolPro GatewayClient（调网关） | ✅ 已实现 |
| warehouse_variable 表 SQL | ✅ 已写入 db_init.sql（待执行） |
| RuleEngineService / RuleEngineJob | ❌ 待实现 |

---

## 阶段 R1: 数据库准备（预计 30min）

### 步骤 R1.1 — 新增 warehouse_rulelog 表

- [ ] 在数据库执行：
  ```sql
  CREATE TABLE warehouse_rulelog (
    LogID         INT IDENTITY PRIMARY KEY,
    RuleID        INT NOT NULL,
    ConditionMet  NVARCHAR(50),
    ActionResult  NVARCHAR(MAX),
    EvaluatedAt   DATETIME DEFAULT GETDATE(),
    Detail        NVARCHAR(MAX) NULL
  );
  ```
- [ ] 在数据库执行 ALTER TABLE 添加字段（若未执行）：
  - `warehouse_rule` 加 `Enable`, `Priority`, `LastEvaluated`, `LastTriggered`, `CooldownSec`
  - `warehouse_ruleaction` 加 `ActionType`, `ExtraJson`
  - `warehouse_rulecondition` 加 `RecoveryThreshold_Numeric`, `RecoveryThreshold_Switch`, `LastTriggered`, `LastTriggerValue`
- [ ] 在 Vol.Pro 代码生成器中选择 `warehouse_rulelog` 生成全套 CRUD
- [ ] `dotnet build` → 0 错误

### 步骤 R1.2 — 执行 warehouse_variable 表建表

- [ ] 在数据库执行 `doc/db_init.sql` 中 warehouse_variable 建表语句
- [ ] Vol.Pro 代码生成器生成 `warehouse_variable` CRUD
- [ ] 管理端字典补充（§5 字典项）

> **R1 提交点**: `RuleEngine-R1: 数据库表+字典就绪`

---

## 阶段 R2: RuleEngineService 实现（预计 3h）

### 步骤 R2.1 — 创建 RuleEngineService.cs

- [ ] 创建 `api_sqlsugar/Warehouse/Services/RuleEngineService.cs`
- [ ] 注入 `Iwarehouse_ruleRepository`, `Ibase_deviceRepository`, `Iiot_devicedataRepository`, `Iiot_alarmRepository`, `GatewayClient`, `IHubContext<HomePageMessageHub>`
- [ ] 实现 `EvaluateAllAsync()` — 主流程：
  1. `LoadEnabledRulesAsync()` — 从 DB 加载启用规则 + 条件 + 动作
  2. `BuildDeviceMappingAsync()` — DeviceId → (AdapterCode, SourceId, BaseUrl)
  3. `BatchFetchRealtimeAsync()` — 调网关 B4-batch 批量取实时值
  4. `EvaluateRuleAsync(rule, data)` — 逐规则比对
  5. `ExecuteActionsAsync(rule)` — 触发动作

### 步骤 R2.2 — 实现条件评估

- [ ] `EvaluateConditionAsync(cond, realtimeData)`：
  - 从 realtimeData 中找到对应设备+点位的实际值
  - 按 CompareOperator 比对（大于/小于/等于/大于等于/小于等于/不等于）
  - 支持滞后窗（P2-2）：已触发过则用 RecoveryThreshold 判断恢复
  - 支持条件级冷却（P2-3）：未过冷却期则跳过

### 步骤 R2.3 — 实现动作执行

- [ ] `ExecuteActionsAsync(rule)`：
  - 动作类型 "控制" → `GatewayClient.ControlDeviceAsync`（调网关 B5）
  - 动作类型 "告警" → 写入 `iot_alarm` 表
  - 动作类型 "通知" → SignalR `_hub.SendAsync("RuleTriggered", ...)`
  - 冷却检查：未过 `CooldownSec` 不重复执行
  - 并发执行：`Task.WhenAll` + 5s 超时（P3-1）

### 步骤 R2.4 — 编译验证

- [ ] `dotnet build api_sqlsugar/Warehouse` → 0 错误

> **R2 提交点**: `RuleEngine-R2: RuleEngineService 完整实现`

---

## 阶段 R3: RuleEngineJob + 调度（预计 30min）

### 步骤 R3.1 — 创建 RuleEngineJob.cs

- [ ] 创建 `api_sqlsugar/Warehouse/Services/RuleEngineJob.cs`
- [ ] 实现 `IJob` 接口，`Execute` 中获取 `RuleEngineService` 调 `EvaluateAllAsync()`

### 步骤 R3.2 — 注册 Quartz

- [ ] 管理端 → Quartz 管理 → 新建 Job：
  ```
  JobName:   RuleEngineJob
  Cron:      0/10 * * * * ?
  ClassName: Warehouse.Services.RuleEngineJob
  ```
- [ ] `dotnet build` → 0 错误

> **R3 提交点**: `RuleEngine-R3: RuleEngineJob 就绪`

---

## 阶段 R4: 前端配套（预计 1h）

### 步骤 R4.1 — 规则管理页增强

- [ ] 编辑 `web.vite/src/views/warehouse/warehouse_rule/warehouse_rule/options.js`
- [ ] 条件表格中 "设备" 列绑定 `allDevices` 动态字典
- [ ] "变量" 列绑定 `warehouse_variable` 字典
- [ ] 动作表格加"动作类型"下拉（控制/告警/通知）

### 步骤 R4.2 — 大屏告警接收

- [ ] 编辑 `warehouse/src/view/DataView.vue`
- [ ] SignalR 订阅 `RuleTriggered` 事件：
  ```javascript
  connection.on("RuleTriggered", (data) => {
    ElMessage.warning(`[规则触发] ${data.title}: ${data.alertMessage}`);
  });
  ```

> **R4 提交点**: `RuleEngine-R4: 前端配套完成`

---

## 阶段 R5: 联调验证（预计 2h）

### 步骤 R5.1 — 联调

- [ ] 网关启动 → MC4 在线 → RealtimePollJob 有数据
- [ ] 管理端新建规则："温度 > 28℃ → 告警"
- [ ] 等 10s → iot_alarm 表有告警记录
- [ ] 管理端收到 SignalR 推送
- [ ] 管理端新建规则："温度 > 28℃ → 控制空调"
- [ ] 等 10s → 网关 B5 被调用

> **R5 提交点**: `RuleEngine-R5: 联调通过`

---

## 任务总览

| 阶段 | 步骤 | 内容 | 预计 |
|:---:|:---:|------|:---:|
| R1 | R1.1 | 建表 + 代码生成 | 20min |
| R1 | R1.2 | 变量表 + 字典 | 10min |
| R2 | R2.1 | RuleEngineService 主流程 | 1.5h |
| R2 | R2.2 | 条件评估 + 滞后窗 + 冷却 | 45min |
| R2 | R2.3 | 动作执行（控制/告警/通知） | 30min |
| R2 | R2.4 | 编译验证 | 15min |
| R3 | R3.1 | RuleEngineJob | 15min |
| R3 | R3.2 | Quartz 注册 | 15min |
| R4 | R4.1 | 管理端 UI 增强 | 30min |
| R4 | R4.2 | 大屏告警接收 | 30min |
| R5 | R5.1 | 联调 | 2h |
| **合计** | **11 步骤** | — | **~7h** |

---

> **注**: 原方案 R4（网关 B4-batch）已在 P1-1 修复中完成，R2 的 DeviceId 映射已在方案中设计，此次直接实现。`warehouse_variable` 建表 SQL 已在 `doc/db_init.sql` 中就绪，本次仅需执行。