记录信号强度数据

internal/infra/models/sensor_data.go

@@ -0,0 +1,56 @@
+package models
+
+import (
+	"time"
+
+	"gorm.io/datatypes"
+)
+
+// SensorDataType 定义了 SensorData 记录中 Data 字段的整体类型
+type SensorDataType string
+
+const (
+	SensorDataTypeSignalMetrics SensorDataType = "signal_metrics" // 信号强度
+	SensorDataTypeBatteryLevel  SensorDataType = "battery_level"  // 电池电量
+)
+
+// SignalMetrics 存储信号强度数据
+type SignalMetrics struct {
+	RSSI        int     `json:"rssi"`        // 绝对信号强度（dBm），受距离、障碍物影响
+	SNR         float64 `json:"snr"`         // 信号与噪声的相对比率（dB），由 RSSI 减去噪声地板（Noise Floor）
+	Sensitivity int     `json:"sensitivity"` // 网关的最低检测阈值(dBm)
+	Margin      int     `json:"margin"`      // SNR 相对于接收器灵敏度的余量, Margin = SNR - Sensitivity
+}
+
+// BatteryLevel 存储电池电量数据
+type BatteryLevel struct {
+	BatteryLevel            float32 `json:"battery_level"`             // 电量剩余百分比
+	BatteryLevelUnavailable bool    `json:"battery_level_unavailable"` // 电量数据不可用
+	ExternalPower           bool    `json:"external_power"`            // 是否使用外部电源
+}
+
+// SensorData 存储所有类型的传感器数据，对应数据库中的 'sensor_data' 表。
+type SensorData struct {
+	// Time 是数据记录的时间戳，作为复合主键的一部分。
+	// GORM 会将其映射到 'time' TIMESTAMPTZ 列。
+	Time time.Time `gorm:"primaryKey" json:"time"`
+
+	// DeviceID 是传感器的唯一标识符，作为复合主键的另一部分。
+	// GORM 会将其映射到 'device_id' VARCHAR(50) 列。
+	DeviceID uint `gorm:"primaryKey" json:"device_id"`
+
+	// RegionalControllerID 是上报此数据的区域主控的ID。
+	// 我们为其添加了数据库索引以优化按区域查询的性能。
+	RegionalControllerID uint `json:"regional_controller_id"`
+
+	// SensorDataType 是传感数据的类型
+	SensorDataType SensorDataType `gorm:"not null;index" json:"sensor_data_type"`
+
+	// Data 存储一个或多个传感器读数，格式为 JSON。
+	// GORM 会使用 'jsonb' 类型来创建此列。
+	Data datatypes.JSON `gorm:"type:jsonb" json:"data"`
+}
+
+func (SensorData) TableName() string {
+	return "sensor_data"
+}