新增上游的停机原因

2026-05-12 11:13:04 +08:00
parent 95fc0b0a1b
commit 8f3a68a673
22 changed files with 83 additions and 3 deletions
--- a/internal/model/dto/agent_open_api_dto.go
+++ b/internal/model/dto/agent_open_api_dto.go
@@ -39,6 +39,7 @@ type AgentOpenAPICardStatusResponse struct {
 	CardNo         string `json:"card_no" description:"卡标识"`
 	CardStatus     string `json:"card_status" description:"卡状态 (normal:正常, stopped:停机)"`
 	CardStatusName string `json:"card_status_name" description:"卡状态名称（中文）"`
+	GatewayExtend  string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 	StopReason     string `json:"stop_reason" description:"停机原因"`
 	StopReasonName string `json:"stop_reason_name" description:"停机原因名称（中文）"`
 }
--- a/internal/model/dto/asset_dto.go
+++ b/internal/model/dto/asset_dto.go
@@ -65,6 +65,7 @@ type AssetResolveResponse struct {
 	ActivationStatus int    `json:"activation_status,omitempty" description:"激活状态"`
 	EnablePolling    bool   `json:"enable_polling" description:"是否参与轮询"`
 	NetworkStatus    int    `json:"network_status" description:"网络状态：0停机 1开机（asset_type=card时有效）"`
+	GatewayExtend    string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 }

 // BoundCardInfo 设备绑定的卡信息
@@ -81,6 +82,7 @@ type BoundCardInfo struct {
 	CarrierType    string     `json:"carrier_type,omitempty" description:"运营商类型"`
 	CarrierName    string     `json:"carrier_name,omitempty" description:"运营商名称"`
 	RealnamePolicy string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
+	GatewayExtend  string     `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 }

 // AssetRealtimeStatusResponse 资产实时状态（只读DB/Redis）
@@ -88,6 +90,7 @@ type AssetRealtimeStatusResponse struct {
 	AssetType            string             `json:"asset_type" description:"资产类型：card 或 device"`
 	AssetID              uint               `json:"asset_id" description:"资产ID"`
 	NetworkStatus        int                `json:"network_status" description:"网络状态（asset_type=card时有效）：0停机 1开机"`
+	GatewayExtend        string             `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 	RealNameStatus       int                `json:"real_name_status" description:"实名状态（asset_type=card时有效）：0未实名 1已实名"`
 	RealnamePolicy       string             `json:"realname_policy,omitempty" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
 	CurrentMonthUsageMB  float64            `json:"current_month_usage_mb,omitempty" description:"系统自然月累计流量(MB，asset_type=card时有效，不等于运营商周期口径)"`
--- a/internal/model/dto/client_asset_dto.go
+++ b/internal/model/dto/client_asset_dto.go
@@ -63,6 +63,7 @@ type AssetInfoResponse struct {
 	CarrierType          string `json:"carrier_type,omitempty" description:"运营商类型（CMCC/CUCC/CTCC/CBN）"`
 	NetworkStatus        int    `json:"network_status,omitempty" description:"网络状态（0:停机, 1:开机）"`
 	NetworkStatusName    string `json:"network_status_name,omitempty" description:"网络状态名称（中文）"`
+	GatewayExtend        string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 	ActivationStatus     int    `json:"activation_status,omitempty" description:"激活状态（0:未激活, 1:已激活）"`
 	ActivationStatusName string `json:"activation_status_name,omitempty" description:"激活状态名称（中文）"`
 	CardCategory         string `json:"card_category,omitempty" description:"卡业务类型（normal:普通卡, industry:行业卡）"`
--- a/internal/model/dto/client_realname_device_dto.go
+++ b/internal/model/dto/client_realname_device_dto.go
@@ -42,6 +42,7 @@ type DeviceCardItem struct {
 	CarrierType    string `json:"carrier_type" description:"运营商类型(CMCC/CUCC/CTCC/CBN)"`
 	CarrierName    string `json:"carrier_name" description:"运营商名称"`
 	NetworkStatus  string `json:"network_status" description:"网络状态"`
+	GatewayExtend  string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 	RealNameStatus int    `json:"real_name_status" description:"实名状态 (0:未实名, 1:已实名)"`
 	SlotPosition   int    `json:"slot_position" description:"插槽位置"`
 	IsActive       bool   `json:"is_active" description:"是否当前激活卡"`
--- a/internal/model/dto/device_dto.go
+++ b/internal/model/dto/device_dto.go
@@ -87,6 +87,7 @@ type DeviceCardBindingResponse struct {
 	IsCurrent          bool       `json:"is_current" description:"是否为当前使用的卡"`
 	RealnamePolicy     string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
 	NetworkStatus      int        `json:"network_status" description:"网络状态：0停机 1开机（asset_type=card时有效）"`
+	GatewayExtend      string     `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 }

 type ListDeviceCardsResponse struct {
--- a/internal/model/dto/enterprise_card_authorization_dto.go
+++ b/internal/model/dto/enterprise_card_authorization_dto.go
@@ -87,6 +87,7 @@ type EnterpriseCardItem struct {
 	StatusName        string `json:"status_name" description:"状态名称"`
 	NetworkStatus     int    `json:"network_status" description:"网络状态"`
 	NetworkStatusName string `json:"network_status_name" description:"网络状态名称"`
+	GatewayExtend     string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 }

 type EnterpriseCardPageResult struct {
--- a/internal/model/dto/enterprise_device_authorization_dto.go
+++ b/internal/model/dto/enterprise_device_authorization_dto.go
@@ -85,6 +85,7 @@ type DeviceCardInfo struct {
 	CarrierName       string `json:"carrier_name" description:"运营商名称"`
 	NetworkStatus     int    `json:"network_status" description:"网络状态：0=停机 1=开机"`
 	NetworkStatusName string `json:"network_status_name" description:"网络状态名称"`
+	GatewayExtend     string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 }

 type DeviceDetailReq struct {
--- a/internal/model/dto/iot_card_dto.go
+++ b/internal/model/dto/iot_card_dto.go
@@ -45,6 +45,7 @@ type StandaloneIotCardResponse struct {
 	RealNameStatusName    string     `json:"real_name_status_name" description:"实名状态名称（中文）"`
 	NetworkStatus         int        `json:"network_status" description:"网络状态 (0:停机, 1:开机)"`
 	NetworkStatusName     string     `json:"network_status_name" description:"网络状态名称（中文）"`
+	GatewayExtend         string     `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
 	DataUsageMB           int64      `json:"data_usage_mb" description:"累计流量使用(MB)"`
 	CurrentMonthUsageMB   float64    `json:"current_month_usage_mb" description:"系统自然月累计流量(MB，不等于运营商周期口径)"`
 	LastGatewayReadingMB  float64    `json:"last_gateway_reading_mb" description:"运营商当前周期累计流量读数(MB，展示运营商口径时使用)"`
--- a/internal/model/iot_card.go
+++ b/internal/model/iot_card.go
@@ -54,6 +54,7 @@ type IotCard struct {
 	VirtualNo            string     `gorm:"column:virtual_no;type:varchar(50);uniqueIndex:idx_iot_card_virtual_no,where:deleted_at IS NULL AND virtual_no IS NOT NULL AND virtual_no <> '';comment:虚拟号(可选，非空时全局唯一)" json:"virtual_no,omitempty"`
 	DeviceVirtualNo      string     `gorm:"column:device_virtual_no;type:varchar(100);not null;default:'';comment:绑定设备的虚拟号快照(未绑定时为空字符串)" json:"device_virtual_no"`
 	LastGatewayReadingMB float64    `gorm:"column:last_gateway_reading_mb;type:float;not null;default:0;comment:运营商当前周期累计流量读数(MB，来自网关)" json:"last_gateway_reading_mb"`
+	GatewayExtend        string     `gorm:"column:gateway_extend;type:text;not null;default:'';comment:Gateway 卡状态扩展字段，原样保存上游 extend，用于展示运营商侧实际停机原因" json:"gateway_extend"`
 	RealnamePolicy       string     `gorm:"column:realname_policy;type:varchar(20);default:'after_order';not null;comment:实名认证策略(none=无需实名,before_order=先实名后充值/购买,after_order=先充值/购买后实名)" json:"realname_policy"`

 	// ICCID 双列存储，用于支持 19/20 位 ICCID 精确路由查询