新增字段

2026-05-12 14:10:48 +08:00
parent 8f3a68a673
commit a5388446d3
13 changed files with 278 additions and 182 deletions
--- a/internal/model/device.go
+++ b/internal/model/device.go
@@ -25,7 +25,7 @@ type Device struct {
 	Manufacturer                       string     `gorm:"column:manufacturer;type:varchar(255);comment:制造商" json:"manufacturer"`
 	BatchNo                            string     `gorm:"column:batch_no;type:varchar(100);comment:批次号" json:"batch_no"`
 	ShopID                             *uint      `gorm:"column:shop_id;index;comment:店铺ID(NULL=平台库存,有值=店铺所有)" json:"shop_id,omitempty"`
-	Status                             int        `gorm:"column:status;type:int;default:1;not null;comment:状态 1-在库 2-已分销 3-已激活 4-已停用" json:"status"`
+	Status                             int        `gorm:"column:status;type:int;default:1;not null;comment:归属状态 1-在库 2-已分销" json:"status"`
 	ActivatedAt                        *time.Time `gorm:"column:activated_at;comment:激活时间" json:"activated_at"`
 	DeviceUsername                     string     `gorm:"column:device_username;type:varchar(100);comment:设备登录用户名" json:"device_username"`
 	DevicePasswordEncrypted            string     `gorm:"column:device_password_encrypted;type:varchar(255);comment:设备登录密码(加密)" json:"device_password_encrypted"`
--- a/internal/model/dto/asset_dto.go
+++ b/internal/model/dto/asset_dto.go
@@ -8,7 +8,7 @@ type AssetResolveResponse struct {
 	AssetID     uint       `json:"asset_id" description:"资产数据库ID"`
 	Identifier  string     `json:"identifier,omitempty" description:"解析时使用的标识符"`
 	VirtualNo   string     `json:"virtual_no" description:"虚拟号"`
-	Status      int        `json:"status" description:"资产状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)"`
+	Status      int        `json:"status" description:"资产归属状态 (1:在库, 2:已分销；卡仍沿用原卡状态枚举)"`
 	StatusName  string     `json:"status_name" description:"资产状态名称（中文）"`
 	BatchNo     string     `json:"batch_no" description:"批次号"`
 	ShopID      *uint      `json:"shop_id,omitempty" description:"所属店铺ID"`
@@ -19,6 +19,8 @@ type AssetResolveResponse struct {
 	CreatedAt   time.Time  `json:"created_at" description:"创建时间"`
 	UpdatedAt   time.Time  `json:"updated_at" description:"更新时间"`
 	// 状态聚合字段
+	ActivationStatus          int        `json:"activation_status" description:"激活状态：0未激活 1已激活；设备需有生效中主套餐且任意绑定卡已实名"`
+	ActivationStatusName      string     `json:"activation_status_name" description:"激活状态名称（中文）"`
 	RealNameStatus            int        `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
 	RealNameAt                *time.Time `json:"real_name_at" description:"最近一次完成实名的时间，未实名时为 null"`
 	RealnamePolicy            string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
@@ -55,17 +57,16 @@ type AssetResolveResponse struct {
 	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" description:"是否参与轮询"`
-	NetworkStatus    int    `json:"network_status" description:"网络状态：0停机 1开机（asset_type=card时有效）"`
-	GatewayExtend    string `json:"gateway_extend" description:"Gateway 卡状态扩展字段，原样返回上游 extend，用于展示运营商侧实际停机原因"`
+	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:"供应商"`
+	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 设备绑定的卡信息
--- a/internal/model/dto/client_asset_dto.go
+++ b/internal/model/dto/client_asset_dto.go
@@ -18,19 +18,21 @@ type AssetInfoResponse struct {
 	BoundPhone string `json:"bound_phone" description:"当前登录用户绑定的手机号"`

 	// === 基础信息（通用） ===
-	AssetType          string     `json:"asset_type" description:"资产类型（card:卡, device:设备）"`
-	AssetID            uint       `json:"asset_id" description:"资产ID"`
-	Identifier         string     `json:"identifier" description:"资产标识符"`
-	VirtualNo          string     `json:"virtual_no" description:"虚拟号"`
-	Status             int        `json:"status" description:"状态（1:在库, 2:已分销, 3:已激活, 4:已停用）"`
-	StatusName         string     `json:"status_name" description:"状态名称（中文）"`
-	RealNameStatus     int        `json:"real_name_status" description:"实名状态（0:未实名, 1:已实名）"`
-	RealNameStatusName string     `json:"real_name_status_name" description:"实名状态名称（中文）"`
-	RealnamePolicy     string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
-	CarrierName        string     `json:"carrier_name" description:"运营商名称"`
-	Generation         string     `json:"generation" description:"世代"`
-	WalletBalance      int64      `json:"wallet_balance" description:"钱包余额（分）"`
-	ActivatedAt        *time.Time `json:"activated_at,omitempty" description:"激活时间"`
+	AssetType            string     `json:"asset_type" description:"资产类型（card:卡, device:设备）"`
+	AssetID              uint       `json:"asset_id" description:"资产ID"`
+	Identifier           string     `json:"identifier" description:"资产标识符"`
+	VirtualNo            string     `json:"virtual_no" description:"虚拟号"`
+	Status               int        `json:"status" description:"资产归属状态（1:在库, 2:已分销；卡仍沿用原卡状态枚举）"`
+	StatusName           string     `json:"status_name" description:"状态名称（中文）"`
+	ActivationStatus     int        `json:"activation_status" description:"激活状态（0:未激活, 1:已激活；设备需有生效中主套餐且任意绑定卡已实名）"`
+	ActivationStatusName string     `json:"activation_status_name" description:"激活状态名称（中文）"`
+	RealNameStatus       int        `json:"real_name_status" description:"实名状态（0:未实名, 1:已实名）"`
+	RealNameStatusName   string     `json:"real_name_status_name" description:"实名状态名称（中文）"`
+	RealnamePolicy       string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
+	CarrierName          string     `json:"carrier_name" description:"运营商名称"`
+	Generation           string     `json:"generation" description:"世代"`
+	WalletBalance        int64      `json:"wallet_balance" description:"钱包余额（分）"`
+	ActivatedAt          *time.Time `json:"activated_at,omitempty" description:"激活时间"`

 	// === 套餐信息（通用） ===
 	CurrentPackage            string     `json:"current_package" description:"当前套餐名称（无套餐时为空）"`
@@ -57,16 +59,14 @@ type AssetInfoResponse struct {
 	DeviceProtectStatus string          `json:"device_protect_status,omitempty" description:"设备保护期状态（none:无, stop:停机保护, start:开机保护）"`

 	// === 卡专属字段（asset_type=card 时有效） ===
-	ICCID                string `json:"iccid,omitempty" description:"卡ICCID"`
-	MSISDN               string `json:"msisdn,omitempty" description:"手机号"`
-	CarrierID            uint   `json:"carrier_id,omitempty" description:"运营商ID"`
-	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:行业卡）"`
+	ICCID             string `json:"iccid,omitempty" description:"卡ICCID"`
+	MSISDN            string `json:"msisdn,omitempty" description:"手机号"`
+	CarrierID         uint   `json:"carrier_id,omitempty" description:"运营商ID"`
+	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，用于展示运营商侧实际停机原因"`
+	CardCategory      string `json:"card_category,omitempty" description:"卡业务类型（normal:普通卡, industry:行业卡）"`

 	// === 卡绑定设备信息（asset_type=card 且绑定了设备时有效） ===
 	BoundDeviceID   *uint  `json:"bound_device_id,omitempty" description:"绑定的设备ID"`
--- a/internal/model/dto/device_dto.go
+++ b/internal/model/dto/device_dto.go
@@ -3,43 +3,46 @@ package dto
 import "time"

 type ListDeviceRequest struct {
-	Page           int        `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
-	PageSize       int        `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
-	VirtualNo      string     `json:"virtual_no" query:"virtual_no" validate:"omitempty,max=100" maxLength:"100" description:"虚拟号(模糊查询)"`
-	DeviceName     string     `json:"device_name" query:"device_name" validate:"omitempty,max=255" maxLength:"255" description:"设备名称(模糊查询)"`
-	Status         *int       `json:"status" query:"status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)"`
-	ShopID         *uint      `json:"shop_id" query:"shop_id" description:"店铺ID（兼容旧参数，单选；NULL表示平台库存）"`
-	ShopIDs        []uint     `json:"shop_ids" query:"shop_ids" validate:"omitempty,dive,min=1" description:"店铺ID列表（多选）"`
-	SeriesID       *uint      `json:"series_id" query:"series_id" description:"套餐系列ID"`
-	BatchNo        string     `json:"batch_no" query:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号"`
-	DeviceType     string     `json:"device_type" query:"device_type" validate:"omitempty,max=50" maxLength:"50" description:"设备类型"`
-	Manufacturer   string     `json:"manufacturer" query:"manufacturer" validate:"omitempty,max=255" maxLength:"255" description:"制造商(模糊查询)"`
-	CreatedAtStart *time.Time `json:"created_at_start" query:"created_at_start" description:"创建时间起始"`
-	CreatedAtEnd   *time.Time `json:"created_at_end" query:"created_at_end" description:"创建时间结束"`
+	Page             int        `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
+	PageSize         int        `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
+	VirtualNo        string     `json:"virtual_no" query:"virtual_no" validate:"omitempty,max=100" maxLength:"100" description:"虚拟号(模糊查询)"`
+	DeviceName       string     `json:"device_name" query:"device_name" validate:"omitempty,max=255" maxLength:"255" description:"设备名称(模糊查询)"`
+	Status           *int       `json:"status" query:"status" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"归属状态 (1:在库, 2:已分销)"`
+	ActivationStatus *int       `json:"activation_status" query:"activation_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"激活状态 (0:未激活, 1:已激活；需有生效中主套餐且任意绑定卡已实名)"`
+	ShopID           *uint      `json:"shop_id" query:"shop_id" description:"店铺ID（兼容旧参数，单选；NULL表示平台库存）"`
+	ShopIDs          []uint     `json:"shop_ids" query:"shop_ids" validate:"omitempty,dive,min=1" description:"店铺ID列表（多选）"`
+	SeriesID         *uint      `json:"series_id" query:"series_id" description:"套餐系列ID"`
+	BatchNo          string     `json:"batch_no" query:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号"`
+	DeviceType       string     `json:"device_type" query:"device_type" validate:"omitempty,max=50" maxLength:"50" description:"设备类型"`
+	Manufacturer     string     `json:"manufacturer" query:"manufacturer" validate:"omitempty,max=255" maxLength:"255" description:"制造商(模糊查询)"`
+	CreatedAtStart   *time.Time `json:"created_at_start" query:"created_at_start" description:"创建时间起始"`
+	CreatedAtEnd     *time.Time `json:"created_at_end" query:"created_at_end" description:"创建时间结束"`
 }

 type DeviceResponse struct {
-	ID             uint       `json:"id" description:"设备ID"`
-	VirtualNo      string     `json:"virtual_no" description:"设备虚拟号/别名"`
-	IMEI           string     `json:"imei" description:"设备IMEI"`
-	SN             string     `json:"sn" description:"设备序列号"`
-	DeviceName     string     `json:"device_name" description:"设备名称"`
-	DeviceModel    string     `json:"device_model" description:"设备型号"`
-	DeviceType     string     `json:"device_type" description:"设备类型"`
-	MaxSimSlots    int        `json:"max_sim_slots" description:"最大插槽数"`
-	Manufacturer   string     `json:"manufacturer" description:"制造商"`
-	BatchNo        string     `json:"batch_no" description:"批次号"`
-	ShopID         *uint      `json:"shop_id" description:"店铺ID"`
-	ShopName       string     `json:"shop_name" description:"店铺名称"`
-	Status         int        `json:"status" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)"`
-	StatusName     string     `json:"status_name" description:"状态名称"`
-	BoundCardCount int        `json:"bound_card_count" description:"已绑定卡数量"`
-	SeriesID       *uint      `json:"series_id" description:"套餐系列ID"`
-	SeriesName     string     `json:"series_name" description:"套餐系列名称"`
-	ActivatedAt    *time.Time `json:"activated_at" description:"激活时间"`
-	RealnamePolicy string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
-	CreatedAt      time.Time  `json:"created_at" description:"创建时间"`
-	UpdatedAt      time.Time  `json:"updated_at" description:"更新时间"`
+	ID                   uint       `json:"id" description:"设备ID"`
+	VirtualNo            string     `json:"virtual_no" description:"设备虚拟号/别名"`
+	IMEI                 string     `json:"imei" description:"设备IMEI"`
+	SN                   string     `json:"sn" description:"设备序列号"`
+	DeviceName           string     `json:"device_name" description:"设备名称"`
+	DeviceModel          string     `json:"device_model" description:"设备型号"`
+	DeviceType           string     `json:"device_type" description:"设备类型"`
+	MaxSimSlots          int        `json:"max_sim_slots" description:"最大插槽数"`
+	Manufacturer         string     `json:"manufacturer" description:"制造商"`
+	BatchNo              string     `json:"batch_no" description:"批次号"`
+	ShopID               *uint      `json:"shop_id" description:"店铺ID"`
+	ShopName             string     `json:"shop_name" description:"店铺名称"`
+	Status               int        `json:"status" description:"归属状态 (1:在库, 2:已分销)"`
+	StatusName           string     `json:"status_name" description:"归属状态名称（中文）"`
+	ActivationStatus     int        `json:"activation_status" description:"激活状态 (0:未激活, 1:已激活；需有生效中主套餐且任意绑定卡已实名)"`
+	ActivationStatusName string     `json:"activation_status_name" description:"激活状态名称（中文）"`
+	BoundCardCount       int        `json:"bound_card_count" description:"已绑定卡数量"`
+	SeriesID             *uint      `json:"series_id" description:"套餐系列ID"`
+	SeriesName           string     `json:"series_name" description:"套餐系列名称"`
+	ActivatedAt          *time.Time `json:"activated_at" description:"激活时间"`
+	RealnamePolicy       string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
+	CreatedAt            time.Time  `json:"created_at" description:"创建时间"`
+	UpdatedAt            time.Time  `json:"updated_at" description:"更新时间"`
 	// 设备实时同步字段（由 sync-info 接口写入）
 	OnlineStatus      int        `json:"online_status" description:"在线状态：0未知 1在线 2离线"`
 	LastOnlineTime    *time.Time `json:"last_online_time" description:"最后在线时间"`
@@ -146,21 +149,22 @@ type RecallDevicesResponse struct {

 // BatchSetDeviceSeriesBindngRequest 批量设置设备的套餐系列绑定请求
 type BatchSetDeviceSeriesBindngRequest struct {
-	SelectionType  string     `json:"selection_type" validate:"omitempty,oneof=list range filter" enum:"list,range,filter" description:"选设备方式 (list:设备ID列表, range:设备虚拟号范围, filter:筛选条件；不传时兼容旧版设备ID列表)"`
-	DeviceIDs      []uint     `json:"device_ids" validate:"omitempty,max=1000,dive,required" maxItems:"1000" description:"设备ID列表（selection_type=list时使用，最多1000个）"`
-	VirtualNoStart string     `json:"virtual_no_start" validate:"omitempty,max=100" maxLength:"100" description:"起始设备虚拟号（selection_type=range时使用）"`
-	VirtualNoEnd   string     `json:"virtual_no_end" validate:"omitempty,max=100" maxLength:"100" description:"结束设备虚拟号（selection_type=range时使用）"`
-	VirtualNo      string     `json:"virtual_no" validate:"omitempty,max=100" maxLength:"100" description:"设备虚拟号模糊查询（selection_type=filter时可选）"`
-	DeviceName     string     `json:"device_name" validate:"omitempty,max=255" maxLength:"255" description:"设备名称模糊查询（selection_type=filter时可选）"`
-	Status         *int       `json:"status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"状态 (1:在库, 2:已分销, 3:已激活, 4:已停用)（selection_type=filter时可选）"`
-	ShopID         *uint      `json:"shop_id" description:"店铺ID（selection_type=filter时可选，兼容旧参数，单选）"`
-	ShopIDs        []uint     `json:"shop_ids" validate:"omitempty,dive,min=1" description:"店铺ID列表（selection_type=filter时可选，多选）"`
-	FilterSeriesID *uint      `json:"filter_series_id" description:"当前绑定套餐系列ID（selection_type=filter时可选；目标套餐系列仍使用series_id）"`
-	BatchNo        string     `json:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号（selection_type=filter时可选）"`
-	DeviceType     string     `json:"device_type" validate:"omitempty,max=50" maxLength:"50" description:"设备类型（selection_type=filter时可选）"`
-	Manufacturer   string     `json:"manufacturer" validate:"omitempty,max=255" maxLength:"255" description:"制造商模糊查询（selection_type=filter时可选）"`
-	CreatedAtStart *time.Time `json:"created_at_start" description:"创建时间起始（selection_type=filter时可选）"`
-	CreatedAtEnd   *time.Time `json:"created_at_end" description:"创建时间结束（selection_type=filter时可选）"`
+	SelectionType    string     `json:"selection_type" validate:"omitempty,oneof=list range filter" enum:"list,range,filter" description:"选设备方式 (list:设备ID列表, range:设备虚拟号范围, filter:筛选条件；不传时兼容旧版设备ID列表)"`
+	DeviceIDs        []uint     `json:"device_ids" validate:"omitempty,max=1000,dive,required" maxItems:"1000" description:"设备ID列表（selection_type=list时使用，最多1000个）"`
+	VirtualNoStart   string     `json:"virtual_no_start" validate:"omitempty,max=100" maxLength:"100" description:"起始设备虚拟号（selection_type=range时使用）"`
+	VirtualNoEnd     string     `json:"virtual_no_end" validate:"omitempty,max=100" maxLength:"100" description:"结束设备虚拟号（selection_type=range时使用）"`
+	VirtualNo        string     `json:"virtual_no" validate:"omitempty,max=100" maxLength:"100" description:"设备虚拟号模糊查询（selection_type=filter时可选）"`
+	DeviceName       string     `json:"device_name" validate:"omitempty,max=255" maxLength:"255" description:"设备名称模糊查询（selection_type=filter时可选）"`
+	Status           *int       `json:"status" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"归属状态 (1:在库, 2:已分销)（selection_type=filter时可选）"`
+	ActivationStatus *int       `json:"activation_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"激活状态 (0:未激活, 1:已激活；selection_type=filter时可选)"`
+	ShopID           *uint      `json:"shop_id" description:"店铺ID（selection_type=filter时可选，兼容旧参数，单选）"`
+	ShopIDs          []uint     `json:"shop_ids" validate:"omitempty,dive,min=1" description:"店铺ID列表（selection_type=filter时可选，多选）"`
+	FilterSeriesID   *uint      `json:"filter_series_id" description:"当前绑定套餐系列ID（selection_type=filter时可选；目标套餐系列仍使用series_id）"`
+	BatchNo          string     `json:"batch_no" validate:"omitempty,max=100" maxLength:"100" description:"批次号（selection_type=filter时可选）"`
+	DeviceType       string     `json:"device_type" validate:"omitempty,max=50" maxLength:"50" description:"设备类型（selection_type=filter时可选）"`
+	Manufacturer     string     `json:"manufacturer" validate:"omitempty,max=255" maxLength:"255" description:"制造商模糊查询（selection_type=filter时可选）"`
+	CreatedAtStart   *time.Time `json:"created_at_start" description:"创建时间起始（selection_type=filter时可选）"`
+	CreatedAtEnd     *time.Time `json:"created_at_end" description:"创建时间结束（selection_type=filter时可选）"`

 	SeriesID uint `json:"series_id" validate:"required,min=0" required:"true" minimum:"0" description:"目标套餐系列ID（0表示清除关联）"`
 }