feat: 扩展心跳消息支持电力与空调设备数组字段

新增 Kafka 消息中 electricity[] 和 air_conditioner[] 数组字段支持，用于存储电力与空调设备明细数据。数据库表新增对应数组列并创建 GIN 索引优化查询性能，processor 实现数组字段校验与聚合转换逻辑。

主要变更：
- Kafka 消息规范新增 electricity 和 air_conditioner 数组字段定义
- 数据库 heartbeat_events 表新增 14 个数组列并创建 4 个 GIN 索引
- processor 实现数组字段解析、校验及聚合转换逻辑
- 更新相关文档与测试用例，确保端到端功能完整

scripts/db/010_heartbeat_schema.sql

@@ -25,6 +25,21 @@ CREATE TABLE IF NOT EXISTS heartbeat.heartbeat_events (
   device_count int2        NOT NULL,
   comm_seq     int4        NOT NULL,
 
+  elec_address text[],
+  air_address  text[],
+  voltage      double precision[],
+  ampere       double precision[],
+  power        double precision[],
+  phase        text[],
+  energy       double precision[],
+  sum_energy   double precision[],
+  state        int2[],
+  model        int2[],
+  speed        int2[],
+  set_temp     int2[],
+  now_temp     int2[],
+  solenoid_valve int2[],
+
   -- 弹性字段：电参/空调等（后续可结构化拆列；当前先放 extra）
   extra        jsonb,
 
@@ -44,6 +59,21 @@ CREATE TABLE IF NOT EXISTS heartbeat.heartbeat_events (
 )
 PARTITION BY RANGE (ts_ms);
 
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS elec_address text[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS air_address text[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS voltage double precision[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS ampere double precision[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS power double precision[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS phase text[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS energy double precision[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS sum_energy double precision[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS state int2[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS model int2[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS speed int2[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS set_temp int2[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS now_temp int2[];
+ALTER TABLE heartbeat.heartbeat_events ADD COLUMN IF NOT EXISTS solenoid_valve int2[];
+
 -- 指定索引
 CREATE INDEX IF NOT EXISTS idx_heartbeat_events_hotel_id ON heartbeat.heartbeat_events (hotel_id);
 CREATE INDEX IF NOT EXISTS idx_heartbeat_events_power_state ON heartbeat.heartbeat_events (power_state);
@@ -58,4 +88,9 @@ CREATE INDEX IF NOT EXISTS idx_heartbeat_events_service_mask_brin ON heartbeat.h
 -- 若不希望额外索引，可注释掉
 CREATE INDEX IF NOT EXISTS idx_heartbeat_events_hotel_ts ON heartbeat.heartbeat_events (hotel_id, ts_ms);
 
+CREATE INDEX IF NOT EXISTS idx_heartbeat_events_elec_address_gin ON heartbeat.heartbeat_events USING GIN (elec_address);
+CREATE INDEX IF NOT EXISTS idx_heartbeat_events_air_address_gin ON heartbeat.heartbeat_events USING GIN (air_address);
+CREATE INDEX IF NOT EXISTS idx_heartbeat_events_state_gin ON heartbeat.heartbeat_events USING GIN (state);
+CREATE INDEX IF NOT EXISTS idx_heartbeat_events_model_gin ON heartbeat.heartbeat_events USING GIN (model);
+
 COMMIT;

scripts/db/smokeTest.js

@@ -43,8 +43,11 @@ async function main() {
     `INSERT INTO heartbeat.heartbeat_events (
       ts_ms, hotel_id, room_id, device_id, ip,
       power_state, guest_type, cardless_state, service_mask,
-      pms_state, carbon_state, device_count, comm_seq, extra
-    ) VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14)`,
+      pms_state, carbon_state, device_count, comm_seq,
+      elec_address, voltage, ampere, power, phase, energy, sum_energy,
+      air_address, state, model, speed, set_temp, now_temp, solenoid_valve,
+      extra
+    ) VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13,$14,$15,$16,$17,$18,$19,$20,$21,$22,$23,$24,$25,$26,$27,$28)`,
     [
       ts,
       1,
@@ -59,6 +62,20 @@ async function main() {
       0,
       1,
       1,
+      ['add11', 'add12'],
+      [3.2, 3.3],
+      [1.1, 2.2],
+      [704.3, 705.3],
+      ['A', 'B'],
+      [10.5, 11.5],
+      [100.5, 101.5],
+      ['ac1'],
+      [1],
+      [2],
+      [3],
+      [26],
+      [25],
+      [1],
       { source: 'smoke-test' },
     ]
   );