// Package gateway 定义 Gateway API 的请求和响应数据传输对象（DTO）
package gateway

import (
	"encoding/json"
	"strconv"
	"strings"
)

// FlexBool 灵活布尔类型
// Gateway 部分设备返回 bool 字段时使用字符串（如 "1"/"0"）而非标准 JSON bool，
// 导致 sonic 严格类型检查失败。此类型兼容 bool、string、number 等多种 JSON 值。
type FlexBool bool

// UnmarshalJSON 实现 json.Unmarshaler 接口
// 支持：true/false, "1"/"0", "true"/"false", 1/0, null
func (b *FlexBool) UnmarshalJSON(data []byte) error {
	raw := strings.Trim(string(data), "\"")
	switch raw {
	case "true", "1":
		*b = true
	default:
		*b = false
	}
	return nil
}

// FlexInt 灵活整数类型
// 与 FlexBool 同理，Gateway 部分设备返回 int 字段时使用字符串（如 "30"）而非 JSON number。
type FlexInt int

// UnmarshalJSON 实现 json.Unmarshaler 接口
// 支持：30, "30", null
func (i *FlexInt) UnmarshalJSON(data []byte) error {
	raw := strings.Trim(string(data), "\"")
	if raw == "" || raw == "null" {
		*i = 0
		return nil
	}
	n, err := strconv.Atoi(raw)
	if err != nil {
		*i = 0
		return nil
	}
	*i = FlexInt(n)
	return nil
}

// GatewayResponse 是 Gateway API 的通用响应结构
type GatewayResponse struct {
	Code    int             `json:"code" description:"业务状态码（200 = 成功）"`
	Msg     string          `json:"msg" description:"业务提示信息"`
	Data    json.RawMessage `json:"data" description:"业务数据（原始 JSON）"`
	TraceID string          `json:"trace_id" description:"链路追踪 ID"`
}

// ============ 流量卡相关 DTO ============

// CardStatusReq 是查询流量卡状态的请求
type CardStatusReq struct {
	CardNo string `json:"cardNo" validate:"required" required:"true" description:"流量卡号"`
}

// CardStatusResp 是查询流量卡状态的响应
type CardStatusResp struct {
	ICCID      string `json:"iccid" description:"ICCID"`
	CardStatus string `json:"cardStatus" description:"卡状态（准备、正常、停机）"`
	Extend     string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// FlowQueryReq 是查询流量使用的请求
type FlowQueryReq struct {
	CardNo string `json:"cardNo" validate:"required" required:"true" description:"流量卡号"`
}

// FlowUsageResp 是查询流量使用的响应
type FlowUsageResp struct {
	ICCID string  `json:"iccid" description:"ICCID"`
	Used  float64 `json:"used" description:"当月已用流量（MB）"`
	Unit  string  `json:"unit" description:"流量单位（MB）"`
}

// CardOperationReq 是停机/复机请求
type CardOperationReq struct {
	CardNo string `json:"cardNo" validate:"required" required:"true" description:"流量卡号"`
	Extend string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// RealnameStatusResp 是实名认证状态的响应
type RealnameStatusResp struct {
	ICCID      string `json:"iccid" description:"ICCID"`
	RealStatus bool   `json:"realStatus" description:"实名状态（true=已实名, false=未实名）"`
}

// RealnameLinkResp 是实名认证链接的响应
type RealnameLinkResp struct {
	URL string `json:"url" description:"实名认证跳转链接（HTTPS URL）"`
}

// BatchQueryReq 是批量查询的请求
type BatchQueryReq struct {
	CardNos []string `json:"cardNos" validate:"required,min=1,max=100" required:"true" description:"流量卡号列表（最多100个）"`
}

// BatchQueryResp 是批量查询的响应
type BatchQueryResp struct {
	Results []CardStatusResp `json:"results" description:"查询结果列表"`
}

// ============ 设备相关 DTO ============

// DeviceInfoReq 是查询设备信息的请求
type DeviceInfoReq struct {
	CardNo   string `json:"cardNo,omitempty" description:"流量卡号（与 DeviceID 二选一）"`
	DeviceID string `json:"deviceId,omitempty" description:"设备 ID/IMEI（与 CardNo 二选一）"`
}

// DeviceInfoResp 是查询设备信息的响应
type DeviceInfoResp struct {
	IMEI          string `json:"imei" description:"设备 IMEI"`
	OnlineStatus  int    `json:"onlineStatus" description:"在线状态（0:离线, 1:在线）"`
	SignalLevel   int    `json:"signalLevel" description:"信号强度（0-31）"`
	WiFiSSID      string `json:"wifiSsid,omitempty" description:"WiFi 名称"`
	WiFiEnabled   int    `json:"wifiEnabled" description:"WiFi 启用状态（0:禁用, 1:启用）"`
	UploadSpeed   int    `json:"uploadSpeed" description:"上行速率（KB/s）"`
	DownloadSpeed int    `json:"downloadSpeed" description:"下行速率（KB/s）"`
	Extend        string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// SpeedLimitReq 是设置设备限速的请求
type SpeedLimitReq struct {
	CardNo     string `json:"cardNo,omitempty" description:"流量卡号（与 DeviceID 二选一）"`
	DeviceID   string `json:"deviceId,omitempty" description:"设备 ID/IMEI（与 CardNo 二选一）"`
	SpeedLimit int    `json:"speedLimit" validate:"required,min=1" required:"true" minimum:"1" description:"限速值（KB/s）"`
	Extend     string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// WiFiReq 是设置设备 WiFi 的请求
type WiFiReq struct {
	CardNo   string `json:"cardNo" validate:"required" required:"true" description:"流量卡号（ICCID）"`
	DeviceID string `json:"deviceId,omitempty" description:"设备 ID/IMEI"`
	SSID     string `json:"ssid" validate:"required,min=1,max=32" required:"true" minLength:"1" maxLength:"32" description:"WiFi 名称"`
	Password string `json:"password,omitempty" description:"WiFi 密码"`
	Enabled  bool   `json:"enabled" description:"启用状态"`
	Extend   string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// SwitchCardReq 是设备切换卡的请求
type SwitchCardReq struct {
	CardNo        string `json:"cardNo" validate:"required" required:"true" description:"设备编号（IMEI）"`
	ICCID         string `json:"iccid" validate:"required" required:"true" description:"目标卡 ICCID"`
	OperationType int    `json:"operationType" description:"操作类型（固定值 2）"`
	Extend        string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// DeviceOperationReq 是设备操作（重启、恢复出厂）的请求
type DeviceOperationReq struct {
	DeviceID string `json:"deviceId" validate:"required" required:"true" description:"设备 ID/IMEI"`
	Extend   string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// SlotInfo 是单个卡槽信息
type SlotInfo struct {
	SlotNo     int    `json:"slotNo" description:"卡槽编号"`
	ICCID      string `json:"iccid" description:"卡槽中的 ICCID"`
	CardStatus string `json:"cardStatus" description:"卡状态（准备、正常、停机）"`
	IsActive   int    `json:"isActive" description:"是否为当前使用的卡槽（0:否, 1:是）"`
	Extend     string `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// SlotInfoResp 是查询设备卡槽信息的响应
type SlotInfoResp struct {
	IMEI   string     `json:"imei" description:"设备 IMEI"`
	Slots  []SlotInfo `json:"slots" description:"卡槽信息列表"`
	Extend string     `json:"extend,omitempty" description:"扩展字段（广电国网特殊参数）"`
}

// SyncDeviceInfoReq sync-info 同步查询设备信息请求
// cardNo 规则：>15 位用 ICCID，=15 位用 IMEI，=11 位用 SN
type SyncDeviceInfoReq struct {
	CardNo string `json:"cardNo" description:"设备标识（ICCID/IMEI/SN）"`
}

// SyncDeviceInfoResp sync-info 同步查询设备信息响应（对应 Gateway data 字段）
// 注意：所有字段均可能为 null/零值，表示暂无数据
type SyncDeviceInfoResp struct {
	DeviceID        string   `json:"device_id" description:"设备ID（IMEI/SN）"`
	DeviceName      string   `json:"device_name" description:"设备名称"`
	IMEI            string   `json:"imei" description:"IMEI号"`
	CurrentIccid    string   `json:"current_iccid" description:"当前使用的ICCID"`
	DeviceType      string   `json:"device_type" description:"设备类型：1=诺行，2=玺龙，3=迎势达"`
	SoftwareVersion string   `json:"software_version" description:"软件版本号"`
	MacAddress      string   `json:"mac_address" description:"MAC地址"`
	SSID            string   `json:"ssid" description:"WiFi热点名称"`
	WifiEnabled     FlexBool `json:"wifi_enabled" description:"WiFi开关状态"`
	SwitchMode      string   `json:"switch_mode" description:"切卡模式：0=自动，1=手动"`
	RSSI            string   `json:"rssi" description:"接收信号强度"`
	BatteryLevel    *FlexInt `json:"battery_level" description:"电池电量百分比（无电池时为null）"`
	OnlineStatus    FlexInt  `json:"online_status" description:"在线状态：1=在线，2=离线"`
	LastUpdateTime  string   `json:"last_update_time" description:"设备信息最后更新时间（ISO 8601）"`
	LastOnlineTime  string   `json:"last_online_time" description:"设备最后在线时间（ISO 8601）"`
	RunTime         string   `json:"run_time" description:"本次开机运行时间（秒）"`
	DailyUsage      string   `json:"daily_usage" description:"日使用流量（字节）"`

	// 信号相关（D-10 补全）
	Rsrp FlexInt `json:"rsrp" description:"参考信号接收功率(dBm)"`
	Rsrq FlexInt `json:"rsrq" description:"参考信号接收质量(dB)"`
	Sinr FlexInt `json:"sinr" description:"信噪比(dB)"`

	// WiFi 相关（D-10 补全）
	WifiPassword string `json:"wifi_password" description:"WiFi密码"`

	// 网络相关（D-10 补全）
	IPAddress string `json:"ip_address" description:"IP地址"`
	WANIP     string `json:"wan_ip" description:"基站分配IPv4地址"`
	LANIP     string `json:"lan_ip" description:"局域网网关IP地址"`

	// 连接相关（D-10 补全）
	MaxClients   FlexInt `json:"max_clients" description:"最大连接客户端数"`
	ClientNumber FlexInt `json:"client_number" description:"当前已连接客户端数"`
	ConnectTime  string  `json:"connect_time" description:"设备本次联网时间(秒)"`

	// 设备属性（D-10 补全）
	Status       FlexInt `json:"status" description:"设备状态：1=正常，0=禁用"`
	IMSI         string  `json:"imsi" description:"IMSI用户标识码"`
	ULStats      string  `json:"ul_stats" description:"本次开机上传流量(字节)"`
	DLStats      string  `json:"dl_stats" description:"本次开机下载流量(字节)"`
	LimitSpeed   FlexInt `json:"limit_speed" description:"限速速率(KB/s)"`
	SyncInterval FlexInt `json:"sync_interval" description:"信息上报周期(秒)"`
}