huang
00dba42a63
- SyncDeviceInfoResp 新增 Rsrp/Rsrq/Sinr/WifiPassword/IPAddress/WANIP/LANIP/MaxClients/ConnectTime/Status/IMSI/ULStats/DLStats/LimitSpeed/SyncInterval 共 15 个字段 - asset_dto.go 新增 DeviceGatewayInfo B 端实时状态结构体（49 字段，全部含 description tag） - AssetRealtimeStatusResponse 新增 DeviceRealtime *DeviceGatewayInfo 字段 - AssetResolveResponse 新增 5 个设备 DB 缓存字段（online_status/last_online_time/software_version/switch_mode/last_gateway_sync_at）
195 lines
14 KiB
Go
195 lines
14 KiB
Go
package dto
|
||
|
||
import "time"
|
||
|
||
// AssetResolveResponse 统一资产解析响应
|
||
type AssetResolveResponse struct {
|
||
AssetType string `json:"asset_type" description:"资产类型：card 或 device"`
|
||
AssetID uint `json:"asset_id" description:"资产数据库ID"`
|
||
VirtualNo string `json:"virtual_no" description:"虚拟号"`
|
||
Status int `json:"status" description:"资产状态"`
|
||
BatchNo string `json:"batch_no" description:"批次号"`
|
||
ShopID *uint `json:"shop_id,omitempty" description:"所属店铺ID"`
|
||
ShopName string `json:"shop_name,omitempty" description:"所属店铺名称"`
|
||
SeriesID *uint `json:"series_id,omitempty" description:"套餐系列ID"`
|
||
SeriesName string `json:"series_name,omitempty" description:"套餐系列名称"`
|
||
FirstCommissionPaid bool `json:"first_commission_paid" description:"一次性佣金是否已发放"`
|
||
AccumulatedRecharge int64 `json:"accumulated_recharge" description:"累计充值金额(分)"`
|
||
ActivatedAt *time.Time `json:"activated_at,omitempty" description:"激活时间"`
|
||
CreatedAt time.Time `json:"created_at" description:"创建时间"`
|
||
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
|
||
// 状态聚合字段
|
||
RealNameStatus int `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
|
||
CurrentPackage string `json:"current_package" description:"当前套餐名称（无套餐时为空）"`
|
||
PackageTotalMB int64 `json:"package_total_mb" description:"当前套餐总虚流量(MB)，已按virtual_ratio换算"`
|
||
PackageUsedMB float64 `json:"package_used_mb" description:"当前已用虚流量(MB)，已按virtual_ratio换算"`
|
||
PackageRemainMB float64 `json:"package_remain_mb" description:"当前套餐剩余虚流量(MB)，已按virtual_ratio换算"`
|
||
DeviceProtectStatus string `json:"device_protect_status,omitempty" description:"设备保护期状态：none/stop/start（仅asset_type=device时有效）"`
|
||
// 绑定关系字段
|
||
ICCID string `json:"iccid,omitempty" description:"卡ICCID（asset_type=card时有效）"`
|
||
BoundDeviceID *uint `json:"bound_device_id,omitempty" description:"绑定的设备ID（asset_type=card时有效）"`
|
||
BoundDeviceNo string `json:"bound_device_no,omitempty" description:"绑定的设备虚拟号（asset_type=card时有效）"`
|
||
BoundDeviceName string `json:"bound_device_name,omitempty" description:"绑定的设备名称（asset_type=card时有效）"`
|
||
BoundCardCount int `json:"bound_card_count,omitempty" description:"绑定的卡数量（asset_type=device时有效）"`
|
||
Cards []BoundCardInfo `json:"cards,omitempty" description:"绑定的卡列表（asset_type=device时有效）"`
|
||
// 设备专属字段（card类型时为零值）
|
||
DeviceName string `json:"device_name,omitempty" description:"设备名称"`
|
||
IMEI string `json:"imei,omitempty" description:"设备IMEI"`
|
||
SN string `json:"sn,omitempty" description:"设备序列号"`
|
||
DeviceModel string `json:"device_model,omitempty" description:"设备型号"`
|
||
DeviceType string `json:"device_type,omitempty" description:"设备类型"`
|
||
MaxSimSlots int `json:"max_sim_slots,omitempty" description:"最大插槽数"`
|
||
Manufacturer string `json:"manufacturer,omitempty" description:"制造商"`
|
||
// 设备 DB 缓存字段（Phase 3 sync-info 写入，展示上次同步快照）
|
||
OnlineStatus int `json:"online_status,omitempty" description:"在线状态：0未知 1在线 2离线（设备类型时有效）"`
|
||
LastOnlineTime *time.Time `json:"last_online_time,omitempty" description:"最后在线时间（设备类型时有效）"`
|
||
SoftwareVersion string `json:"software_version,omitempty" description:"固件版本号（设备类型时有效）"`
|
||
SwitchMode string `json:"switch_mode,omitempty" description:"切卡模式：0=自动，1=手动（设备类型时有效）"`
|
||
LastGatewaySyncAt *time.Time `json:"last_gateway_sync_at,omitempty" description:"最后 sync-info 同步时间（设备类型时有效）"`
|
||
// 卡专属字段（device类型时为零值）
|
||
CarrierID uint `json:"carrier_id,omitempty" description:"运营商ID"`
|
||
CarrierType string `json:"carrier_type,omitempty" description:"运营商类型"`
|
||
CarrierName string `json:"carrier_name,omitempty" description:"运营商名称"`
|
||
MSISDN string `json:"msisdn,omitempty" description:"手机号"`
|
||
IMSI string `json:"imsi,omitempty" description:"IMSI"`
|
||
CardCategory string `json:"card_category,omitempty" description:"卡业务类型"`
|
||
Supplier string `json:"supplier,omitempty" description:"供应商"`
|
||
ActivationStatus int `json:"activation_status,omitempty" description:"激活状态"`
|
||
EnablePolling bool `json:"enable_polling,omitempty" description:"是否参与轮询"`
|
||
NetworkStatus int `json:"network_status,omitempty" description:"网络状态：0停机 1开机（asset_type=card时有效）"`
|
||
}
|
||
|
||
// BoundCardInfo 设备绑定的卡信息
|
||
type BoundCardInfo struct {
|
||
CardID uint `json:"card_id" description:"卡ID"`
|
||
ICCID string `json:"iccid" description:"ICCID"`
|
||
MSISDN string `json:"msisdn,omitempty" description:"手机号"`
|
||
NetworkStatus int `json:"network_status" description:"网络状态：0停机 1开机"`
|
||
RealNameStatus int `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
|
||
SlotPosition int `json:"slot_position,omitempty" description:"插槽位置"`
|
||
IsCurrent bool `json:"is_current" description:"是否为当前使用的卡"`
|
||
}
|
||
|
||
// AssetRealtimeStatusResponse 资产实时状态（只读DB/Redis）
|
||
type AssetRealtimeStatusResponse struct {
|
||
AssetType string `json:"asset_type" description:"资产类型：card 或 device"`
|
||
AssetID uint `json:"asset_id" description:"资产ID"`
|
||
NetworkStatus int `json:"network_status,omitempty" description:"网络状态（asset_type=card时有效）：0停机 1开机"`
|
||
RealNameStatus int `json:"real_name_status,omitempty" description:"实名状态（asset_type=card时有效）：0未实名 1已实名"`
|
||
CurrentMonthUsageMB float64 `json:"current_month_usage_mb,omitempty" description:"本月已用流量MB（asset_type=card时有效）"`
|
||
LastSyncTime *time.Time `json:"last_sync_time,omitempty" description:"最后同步时间（asset_type=card时有效）"`
|
||
DeviceProtectStatus string `json:"device_protect_status,omitempty" description:"保护期状态（asset_type=device时有效）：none/stop/start"`
|
||
Cards []BoundCardInfo `json:"cards,omitempty" description:"绑定卡状态列表（asset_type=device时有效）"`
|
||
DeviceRealtime *DeviceGatewayInfo `json:"device_realtime,omitempty" description:"设备实时状态（来自 Gateway sync-info，Gateway 失败时为 null）"`
|
||
}
|
||
|
||
// AssetPackageResponse 资产套餐信息
|
||
type AssetPackageResponse struct {
|
||
PackageUsageID uint `json:"package_usage_id" description:"套餐使用记录ID"`
|
||
PackageID uint `json:"package_id" description:"套餐ID"`
|
||
PackageName string `json:"package_name" description:"套餐名称"`
|
||
PackageType string `json:"package_type" description:"套餐类型：formal/addon"`
|
||
UsageType string `json:"usage_type" description:"使用类型：single_card/device"`
|
||
Status int `json:"status" description:"状态：0待生效 1生效中 2已用完 3已过期 4已失效"`
|
||
StatusName string `json:"status_name" description:"状态名称"`
|
||
DataLimitMB int64 `json:"data_limit_mb" description:"套餐真流量总量(MB)"`
|
||
VirtualLimitMB int64 `json:"virtual_limit_mb" description:"套餐虚流量总量(MB)，按virtual_ratio换算"`
|
||
DataUsageMB int64 `json:"data_usage_mb" description:"已用真流量(MB)"`
|
||
VirtualUsedMB float64 `json:"virtual_used_mb" description:"已用虚流量(MB)，按virtual_ratio换算"`
|
||
VirtualRemainMB float64 `json:"virtual_remain_mb" description:"剩余虚流量(MB)，按virtual_ratio换算"`
|
||
VirtualRatio float64 `json:"virtual_ratio" description:"虚流量比例(real/virtual)"`
|
||
ActivatedAt *time.Time `json:"activated_at,omitempty" description:"激活时间（待生效套餐为空）"`
|
||
ExpiresAt *time.Time `json:"expires_at,omitempty" description:"到期时间（待生效套餐为空）"`
|
||
MasterUsageID *uint `json:"master_usage_id,omitempty" description:"主套餐ID（加油包时有值）"`
|
||
Priority int `json:"priority" description:"优先级"`
|
||
CreatedAt time.Time `json:"created_at" description:"创建时间"`
|
||
}
|
||
|
||
// AssetPackagesResult 套餐列表分页结果
|
||
type AssetPackagesResult struct {
|
||
Total int64 `json:"total" description:"总条数"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"page_size" description:"每页条数"`
|
||
Items []*AssetPackageResponse `json:"items" description:"套餐列表"`
|
||
}
|
||
|
||
// AssetResolveRequest 资产解析请求（路径参数）
|
||
type AssetResolveRequest struct {
|
||
Identifier string `path:"identifier" description:"资产标识符（虚拟号/ICCID/IMEI/SN/MSISDN）" required:"true"`
|
||
}
|
||
|
||
// AssetTypeIDRequest 资产类型+ID请求（路径参数）
|
||
type AssetTypeIDRequest struct {
|
||
AssetType string `path:"asset_type" description:"资产类型：card 或 device" required:"true"`
|
||
ID uint `path:"id" description:"资产ID" required:"true"`
|
||
}
|
||
|
||
// AssetPackagesRequest 资产套餐列表请求（路径参数 + 分页）
|
||
type AssetPackagesRequest struct {
|
||
AssetType string `path:"asset_type" description:"资产类型：card 或 device" required:"true"`
|
||
ID uint `path:"id" description:"资产ID" required:"true"`
|
||
Page int `query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码（默认1）"`
|
||
PageSize int `query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页条数（默认50，最大100）"`
|
||
}
|
||
|
||
// DeviceIDRequest 设备ID请求（路径参数）
|
||
type DeviceIDRequest struct {
|
||
DeviceID uint `path:"device_id" description:"设备ID" required:"true"`
|
||
}
|
||
|
||
// CardICCIDRequest 卡ICCID请求（路径参数）
|
||
type CardICCIDRequest struct {
|
||
ICCID string `path:"iccid" description:"卡ICCID" required:"true"`
|
||
}
|
||
|
||
// DeviceGatewayInfo B端设备实时状态信息（来自 Gateway sync-info）
|
||
// 与 C 端 DeviceRealtimeInfo 独立，未来可展示更多技术字段
|
||
// 所有字段均为可选，Gateway 调用失败时整体为 null
|
||
type DeviceGatewayInfo struct {
|
||
// 设备状态
|
||
OnlineStatus *int `json:"online_status,omitempty" description:"在线状态：1=在线，2=离线"`
|
||
BatteryLevel *int `json:"battery_level,omitempty" description:"电池电量百分比（无电池时为null）"`
|
||
Status *int `json:"status,omitempty" description:"设备状态：1=正常，0=禁用"`
|
||
RunTime *string `json:"run_time,omitempty" description:"本次开机运行时间(秒)"`
|
||
ConnectTime *string `json:"connect_time,omitempty" description:"本次联网时间(秒)"`
|
||
LastOnlineTime *string `json:"last_online_time,omitempty" description:"设备最后在线时间"`
|
||
LastUpdateTime *string `json:"last_update_time,omitempty" description:"设备信息最后更新时间"`
|
||
|
||
// 信号相关
|
||
Rsrp *int `json:"rsrp,omitempty" description:"参考信号接收功率(dBm)"`
|
||
Rsrq *int `json:"rsrq,omitempty" description:"参考信号接收质量(dB)"`
|
||
Rssi *string `json:"rssi,omitempty" description:"接收信号强度"`
|
||
Sinr *int `json:"sinr,omitempty" description:"信噪比(dB)"`
|
||
|
||
// WiFi 相关
|
||
SSID *string `json:"ssid,omitempty" description:"WiFi热点名称"`
|
||
WifiEnabled *bool `json:"wifi_enabled,omitempty" description:"WiFi开关状态"`
|
||
WifiPassword *string `json:"wifi_password,omitempty" description:"WiFi密码"`
|
||
|
||
// 网络相关
|
||
IPAddress *string `json:"ip_address,omitempty" description:"IP地址"`
|
||
WANIP *string `json:"wan_ip,omitempty" description:"基站分配IPv4地址"`
|
||
LANIP *string `json:"lan_ip,omitempty" description:"局域网网关IP地址"`
|
||
MACAddress *string `json:"mac_address,omitempty" description:"MAC地址"`
|
||
|
||
// 流量与速率
|
||
DailyUsage *string `json:"daily_usage,omitempty" description:"日使用流量(字节)"`
|
||
DLStats *string `json:"dl_stats,omitempty" description:"本次开机下载流量(字节)"`
|
||
ULStats *string `json:"ul_stats,omitempty" description:"本次开机上传流量(字节)"`
|
||
LimitSpeed *int `json:"limit_speed,omitempty" description:"限速速率(KB/s)"`
|
||
|
||
// 设备属性
|
||
CurrentIccid *string `json:"current_iccid,omitempty" description:"当前使用的ICCID"`
|
||
MaxClients *int `json:"max_clients,omitempty" description:"最大连接客户端数"`
|
||
SoftwareVersion *string `json:"software_version,omitempty" description:"软件版本号"`
|
||
SwitchMode *string `json:"switch_mode,omitempty" description:"切卡模式：0=自动，1=手动"`
|
||
SyncInterval *int `json:"sync_interval,omitempty" description:"信息上报周期(秒)"`
|
||
|
||
// Gateway 标识字段
|
||
DeviceID *string `json:"device_id,omitempty" description:"Gateway设备ID(IMEI/SN)"`
|
||
DeviceName *string `json:"device_name,omitempty" description:"Gateway返回的设备名称"`
|
||
DeviceType *string `json:"device_type,omitempty" description:"Gateway返回的设备类型"`
|
||
IMEI *string `json:"imei,omitempty" description:"IMEI号"`
|
||
IMSI *string `json:"imsi,omitempty" description:"IMSI用户标识码"`
|
||
}
|