feat(heartbeat): 添加版本号字段并处理亮度值-1为NULL

- 在心跳事件表中新增 version 字段，用于存储版本号信息 - 将 bright_g 字段的 -1 值映射为数据库中的 NULL，避免语义混淆 - 更新相关文档、数据库迁移脚本和测试用例
2026-01-28 17:47:05 +08:00
parent 1644ee80bc
commit ad270bd936
6 changed files with 45 additions and 4 deletions
--- a/docs/db-heartbeat-schema.md
+++ b/docs/db-heartbeat-schema.md
@@ -34,7 +34,8 @@
 | device_count | int2 | 是 | 设备数量/上报设备数量（语义待确认） |
 | comm_seq | int4 | 是 | 通讯序号（语义待确认） |
 | insert_card | int2 | 否 | 是否插卡（整数；可为空；不建索引） |
-| bright_g | int2 | 否 | 全局亮度值（整数；可为空；不建索引） |
+| bright_g | int2 | 否 | 全局亮度值（整数；可为空；若值为 -1 则存 NULL；不建索引） |
+| version | int2 | 否 | 版本号（int2；可为空；不建索引） |
 | elec_address | text[] | 否 | 电力设备地址数组（与 voltage[] 等按下标对齐） |
 | voltage | double precision[] | 否 | 电压数组 |
 | ampere | double precision[] | 否 | 电流数组 |