package dto // CreatePackageRequest 创建套餐请求 type CreatePackageRequest struct { PackageCode string `json:"package_code" validate:"required,min=1,max=100" required:"true" minLength:"1" maxLength:"100" description:"套餐编码"` PackageName string `json:"package_name" validate:"required,min=1,max=255" required:"true" minLength:"1" maxLength:"255" description:"套餐名称"` SeriesID *uint `json:"series_id" validate:"omitempty" description:"套餐系列ID"` PackageType string `json:"package_type" validate:"required,oneof=formal addon" required:"true" description:"套餐类型 (formal:正式套餐, addon:附加套餐)"` DurationMonths int `json:"duration_months" validate:"required,min=1,max=120" required:"true" minimum:"1" maximum:"120" description:"套餐时长(月数)"` RealDataMB *int64 `json:"real_data_mb" validate:"omitempty,min=0" minimum:"0" description:"真流量额度(MB)"` VirtualDataMB *int64 `json:"virtual_data_mb" validate:"omitempty,min=0" minimum:"0" description:"虚流量额度(MB)"` EnableVirtualData bool `json:"enable_virtual_data" description:"是否启用虚流量"` SuggestedRetailPrice *int64 `json:"suggested_retail_price" validate:"omitempty,min=0" minimum:"0" description:"建议售价(分)"` CostPrice int64 `json:"cost_price" validate:"required,min=0" required:"true" minimum:"0" description:"成本价(分)"` CalendarType *string `json:"calendar_type" validate:"omitempty,oneof=natural_month by_day" description:"套餐周期类型 (natural_month:自然月, by_day:按天)"` DurationDays *int `json:"duration_days" validate:"omitempty,min=1,max=3650" minimum:"1" maximum:"3650" description:"套餐天数(calendar_type=by_day时必填)"` DataResetCycle *string `json:"data_reset_cycle" validate:"omitempty,oneof=daily monthly yearly none" description:"流量重置周期 (daily:每日, monthly:每月, yearly:每年, none:不重置)"` EnableRealnameActivation *bool `json:"enable_realname_activation" description:"是否启用实名激活 (true:需实名后激活, false:立即激活)"` } // UpdatePackageRequest 更新套餐请求 type UpdatePackageRequest struct { PackageName *string `json:"package_name" validate:"omitempty,min=1,max=255" minLength:"1" maxLength:"255" description:"套餐名称"` SeriesID *uint `json:"series_id" validate:"omitempty" description:"套餐系列ID"` PackageType *string `json:"package_type" validate:"omitempty,oneof=formal addon" description:"套餐类型 (formal:正式套餐, addon:附加套餐)"` DurationMonths *int `json:"duration_months" validate:"omitempty,min=1,max=120" minimum:"1" maximum:"120" description:"套餐时长(月数)"` RealDataMB *int64 `json:"real_data_mb" validate:"omitempty,min=0" minimum:"0" description:"真流量额度(MB)"` VirtualDataMB *int64 `json:"virtual_data_mb" validate:"omitempty,min=0" minimum:"0" description:"虚流量额度(MB)"` EnableVirtualData *bool `json:"enable_virtual_data" description:"是否启用虚流量"` SuggestedRetailPrice *int64 `json:"suggested_retail_price" validate:"omitempty,min=0" minimum:"0" description:"建议售价(分)"` CostPrice *int64 `json:"cost_price" validate:"omitempty,min=0" minimum:"0" description:"成本价(分)"` CalendarType *string `json:"calendar_type" validate:"omitempty,oneof=natural_month by_day" description:"套餐周期类型 (natural_month:自然月, by_day:按天)"` DurationDays *int `json:"duration_days" validate:"omitempty,min=1,max=3650" minimum:"1" maximum:"3650" description:"套餐天数(calendar_type=by_day时必填)"` DataResetCycle *string `json:"data_reset_cycle" validate:"omitempty,oneof=daily monthly yearly none" description:"流量重置周期 (daily:每日, monthly:每月, yearly:每年, none:不重置)"` EnableRealnameActivation *bool `json:"enable_realname_activation" description:"是否启用实名激活 (true:需实名后激活, false:立即激活)"` } // PackageListRequest 套餐列表请求 type PackageListRequest 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:"每页数量"` PackageName *string `json:"package_name" query:"package_name" validate:"omitempty,max=255" maxLength:"255" description:"套餐名称(模糊搜索)"` SeriesID *uint `json:"series_id" query:"series_id" validate:"omitempty" description:"套餐系列ID"` Status *int `json:"status" query:"status" validate:"omitempty,oneof=1 2" description:"状态 (1:启用, 2:禁用)"` ShelfStatus *int `json:"shelf_status" query:"shelf_status" validate:"omitempty,oneof=1 2" description:"上架状态 (1:上架, 2:下架)"` PackageType *string `json:"package_type" query:"package_type" validate:"omitempty,oneof=formal addon" description:"套餐类型 (formal:正式套餐, addon:附加套餐)"` } // UpdatePackageStatusRequest 更新套餐状态请求 type UpdatePackageStatusRequest struct { Status int `json:"status" validate:"required,oneof=1 2" required:"true" description:"状态 (1:启用, 2:禁用)"` } // UpdatePackageShelfStatusRequest 更新套餐上架状态请求 type UpdatePackageShelfStatusRequest struct { ShelfStatus int `json:"shelf_status" validate:"required,oneof=1 2" required:"true" description:"上架状态 (1:上架, 2:下架)"` } // CommissionTierInfo 返佣梯度信息 type CommissionTierInfo struct { CurrentRate string `json:"current_rate" description:"当前返佣比例"` NextThreshold *int64 `json:"next_threshold,omitempty" description:"下一档位阈值"` NextRate string `json:"next_rate,omitempty" description:"下一档位返佣比例"` } // PackageResponse 套餐响应 type PackageResponse struct { ID uint `json:"id" description:"套餐ID"` PackageCode string `json:"package_code" description:"套餐编码"` PackageName string `json:"package_name" description:"套餐名称"` SeriesID *uint `json:"series_id" description:"套餐系列ID"` SeriesName *string `json:"series_name" description:"套餐系列名称"` PackageType string `json:"package_type" description:"套餐类型 (formal:正式套餐, addon:附加套餐)"` DurationMonths int `json:"duration_months" description:"套餐时长(月数)"` RealDataMB int64 `json:"real_data_mb" description:"真流量额度(MB)"` VirtualDataMB int64 `json:"virtual_data_mb" description:"虚流量额度(MB)"` EnableVirtualData bool `json:"enable_virtual_data" description:"是否启用虚流量"` VirtualRatio float64 `json:"virtual_ratio" description:"虚流量比例(real_data_mb/virtual_data_mb),启用虚流量时计算,否则为1.0"` SuggestedRetailPrice int64 `json:"suggested_retail_price" description:"建议售价(分)"` CostPrice int64 `json:"cost_price" description:"成本价(分)"` OneTimeCommissionAmount *int64 `json:"one_time_commission_amount,omitempty" description:"一次性佣金金额(分,代理视角)"` Status int `json:"status" description:"状态 (1:启用, 2:禁用)"` ShelfStatus int `json:"shelf_status" description:"上架状态 (1:上架, 2:下架)"` CreatedAt string `json:"created_at" description:"创建时间"` UpdatedAt string `json:"updated_at" description:"更新时间"` ProfitMargin *int64 `json:"profit_margin,omitempty" description:"利润空间(分,仅代理用户可见)"` CurrentCommissionRate string `json:"current_commission_rate,omitempty" description:"当前返佣比例(仅代理用户可见)"` TierInfo *CommissionTierInfo `json:"tier_info,omitempty" description:"梯度返佣信息(仅代理用户可见)"` CalendarType string `json:"calendar_type" description:"套餐周期类型 (natural_month:自然月, by_day:按天)"` DurationDays *int `json:"duration_days,omitempty" description:"套餐天数(calendar_type=by_day时有值)"` DataResetCycle string `json:"data_reset_cycle" description:"流量重置周期 (daily:每日, monthly:每月, yearly:每年, none:不重置)"` EnableRealnameActivation bool `json:"enable_realname_activation" description:"是否启用实名激活 (true:需实名后激活, false:立即激活)"` } // UpdatePackageParams 更新套餐聚合参数 type UpdatePackageParams struct { IDReq UpdatePackageRequest } // UpdatePackageStatusParams 更新套餐状态聚合参数 type UpdatePackageStatusParams struct { IDReq UpdatePackageStatusRequest } // UpdatePackageShelfStatusParams 更新套餐上架状态聚合参数 type UpdatePackageShelfStatusParams struct { IDReq UpdatePackageShelfStatusRequest } // PackagePageResult 套餐分页结果 type PackagePageResult struct { List []*PackageResponse `json:"list" description:"套餐列表"` Total int64 `json:"total" description:"总数"` Page int `json:"page" description:"当前页"` PageSize int `json:"page_size" description:"每页数量"` TotalPages int `json:"total_pages" description:"总页数"` } // PackageUsageItemResponse 套餐使用项响应(客户视图) type PackageUsageItemResponse struct { PackageUsageID uint `json:"package_usage_id" description:"套餐使用记录ID"` PackageID uint `json:"package_id" description:"套餐ID"` PackageName string `json:"package_name" description:"套餐名称"` UsedMB int64 `json:"used_mb" description:"已使用流量(MB)"` TotalMB int64 `json:"total_mb" description:"总流量(MB)"` Status int `json:"status" description:"状态 (0:待生效, 1:生效中, 2:已用完, 3:已过期, 4:已失效)"` StatusText string `json:"status_text" description:"状态文本"` ExpiresAt string `json:"expires_at" description:"过期时间"` ActivatedAt string `json:"activated_at" description:"激活时间"` Priority int `json:"priority" description:"优先级(数字越小优先级越高)"` } // PackageUsageTotalInfo 套餐流量总计信息 type PackageUsageTotalInfo struct { UsedMB int64 `json:"used_mb" description:"总已使用流量(MB)"` TotalMB int64 `json:"total_mb" description:"总流量(MB)"` } // PackageUsageCustomerViewResponse 客户视图流量查询响应 type PackageUsageCustomerViewResponse struct { MainPackage *PackageUsageItemResponse `json:"main_package" description:"主套餐信息"` AddonPackages []PackageUsageItemResponse `json:"addon_packages" description:"加油包列表(按priority排序)"` Total PackageUsageTotalInfo `json:"total" description:"总计流量信息"` } // PackageUsageDailyRecordResponse 套餐流量日记录响应 type PackageUsageDailyRecordResponse struct { Date string `json:"date" description:"日期"` DailyUsageMB int `json:"daily_usage_mb" description:"当日流量使用量(MB)"` CumulativeUsageMB int64 `json:"cumulative_usage_mb" description:"截止当日的累计流量(MB)"` } // PackageUsageDetailResponse 套餐流量详单响应 type PackageUsageDetailResponse struct { PackageUsageID uint `json:"package_usage_id" description:"套餐使用记录ID"` PackageName string `json:"package_name" description:"套餐名称"` Records []PackageUsageDailyRecordResponse `json:"records" description:"流量日记录列表"` TotalUsageMB int64 `json:"total_usage_mb" description:"总使用流量(MB)"` }