修正数据

2026-04-27 18:10:08 +08:00
parent bb33232b1b
commit fe4c545308
57 changed files with 4477 additions and 226 deletions
--- a/internal/model/dto/asset_dto.go
+++ b/internal/model/dto/asset_dto.go
@@ -23,9 +23,12 @@ type AssetResolveResponse struct {
 	RealNameAt          *time.Time `json:"real_name_at" description:"最近一次完成实名的时间，未实名时为 null"`
 	RealnamePolicy      string     `json:"realname_policy" description:"实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)"`
 	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换算"`
+	CurrentPackageUsageID *uint    `json:"current_package_usage_id" description:"当前主套餐的套餐使用记录ID，无主套餐时为 null"`
+	RealTotalMB         int64      `json:"real_total_mb" description:"当前主套餐真实总量(MB)"`
+	RealUsedMB          int64      `json:"real_used_mb" description:"当前主套餐真实已用量(MB)"`
+	VirtualTotalMB      int64      `json:"virtual_total_mb" description:"当前主套餐业务停机阈值(MB)"`
+	VirtualUsedMB       float64    `json:"virtual_used_mb" description:"当前主套餐展示已用量(MB)"`
+	ReductionPct        float64    `json:"reduction_pct" description:"展示增幅比例，公式为(real_total_mb / virtual_total_mb) - 1"`
 	DeviceProtectStatus string     `json:"device_protect_status,omitempty" description:"设备保护期状态：none/stop/start（仅asset_type=device时有效）"`
 	// 绑定关系字段
 	ICCID           string          `json:"iccid,omitempty" description:"卡ICCID（asset_type=card时有效）"`
@@ -105,13 +108,11 @@ type AssetPackageResponse struct {
 	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)"`
-	EnableVirtualData bool       `json:"enable_virtual_data" description:"是否启用虚流量"`
+	RealTotalMB       int64      `json:"real_total_mb" description:"套餐真实总量(MB)"`
+	RealUsedMB        int64      `json:"real_used_mb" description:"套餐真实已用量(MB)"`
+	VirtualTotalMB    int64      `json:"virtual_total_mb" description:"套餐业务停机阈值(MB)"`
+	VirtualUsedMB     float64    `json:"virtual_used_mb" description:"套餐展示已用量(MB)"`
+	ReductionPct      float64    `json:"reduction_pct" description:"展示增幅比例，公式为(real_total_mb / virtual_total_mb) - 1"`
 	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（加油包时有值）"`
--- a/internal/model/dto/client_asset_dto.go
+++ b/internal/model/dto/client_asset_dto.go
@@ -33,10 +33,13 @@ type AssetInfoResponse struct {
 	ActivatedAt        *time.Time `json:"activated_at,omitempty" description:"激活时间"`

 	// === 套餐信息（通用） ===
-	CurrentPackage  string  `json:"current_package" description:"当前套餐名称（无套餐时为空）"`
-	PackageTotalMB  int64   `json:"package_total_mb" description:"当前套餐总虚流量(MB)，已按虚流量比例换算"`
-	PackageUsedMB   float64 `json:"package_used_mb" description:"当前已用虚流量(MB)，已按虚流量比例换算"`
-	PackageRemainMB float64 `json:"package_remain_mb" description:"当前剩余虚流量(MB)，已按虚流量比例换算"`
+	CurrentPackage        string  `json:"current_package" description:"当前套餐名称（无套餐时为空）"`
+	CurrentPackageUsageID *uint   `json:"current_package_usage_id" description:"当前主套餐的套餐使用记录ID，无主套餐时为 null"`
+	RealTotalMB           int64   `json:"real_total_mb" description:"当前主套餐真实总量(MB)"`
+	RealUsedMB            int64   `json:"real_used_mb" description:"当前主套餐真实已用量(MB)"`
+	VirtualTotalMB        int64   `json:"virtual_total_mb" description:"当前主套餐业务停机阈值(MB)"`
+	VirtualUsedMB         float64 `json:"virtual_used_mb" description:"当前主套餐展示已用量(MB)"`
+	ReductionPct          float64 `json:"reduction_pct" description:"展示增幅比例，公式为(real_total_mb / virtual_total_mb) - 1"`

 	// === 设备专属字段（asset_type=device 时有效） ===
 	DeviceName          string          `json:"device_name,omitempty" description:"设备名称"`
--- a/internal/model/package.go
+++ b/internal/model/package.go
@@ -36,7 +36,7 @@ type Package struct {
 	PackageType          string `gorm:"column:package_type;type:varchar(50);not null;comment:套餐类型 formal-正式套餐 addon-附加套餐" json:"package_type"`
 	DurationMonths       int    `gorm:"column:duration_months;type:int;not null;comment:套餐时长(月数) 1-月套餐 12-年套餐" json:"duration_months"`
 	RealDataMB           int64  `gorm:"column:real_data_mb;type:bigint;default:0;comment:真流量额度(MB)" json:"real_data_mb"`
-	VirtualDataMB        int64  `gorm:"column:virtual_data_mb;type:bigint;default:0;comment:虚流量额度(MB,用于停机判断)" json:"virtual_data_mb"`
+	VirtualDataMB        int64  `gorm:"column:virtual_data_mb;type:bigint;default:0;comment:虚流量额度(MB，业务停机阈值)" json:"virtual_data_mb"`
 	EnableVirtualData    bool   `gorm:"column:enable_virtual_data;type:boolean;default:false;not null;comment:是否启用虚流量" json:"enable_virtual_data"`
 	Status               int    `gorm:"column:status;type:int;default:1;not null;comment:状态 0=禁用 1=启用" json:"status"`
 	CostPrice            int64  `gorm:"column:cost_price;type:bigint;default:0;comment:成本价(分为单位)" json:"cost_price"`
@@ -47,7 +47,7 @@ type Package struct {
 	DataResetCycle       string `gorm:"column:data_reset_cycle;type:varchar(20);default:'monthly';comment:流量重置周期 daily-每日 monthly-每月 yearly-每年 none-不重置" json:"data_reset_cycle"`
 	// ExpiryBase 到期时间基准：from_activation-实名激活时起算，from_purchase-购买时起算
 	ExpiryBase   string  `gorm:"column:expiry_base;type:varchar(30);not null;default:'from_activation';comment:到期时间基准 from_activation-实名激活时起算 from_purchase-购买时起算" json:"expiry_base"`
-	VirtualRatio float64 `gorm:"column:virtual_ratio;type:decimal(18,6);default:1.0;comment:虚流量比例(real_data_mb/virtual_data_mb)，创建套餐时计算存储" json:"virtual_ratio"`
+	VirtualRatio float64 `gorm:"column:virtual_ratio;type:decimal(18,6);default:1.0;comment:展示倍率(real_data_mb/virtual_data_mb)，创建套餐时计算存储" json:"virtual_ratio"`
 }

 // TableName 指定表名
@@ -68,10 +68,11 @@ type PackageUsage struct {
 	UsageType                 string     `gorm:"column:usage_type;type:varchar(20);not null;comment:使用类型 single_card-单卡套餐 device-设备级套餐" json:"usage_type"`
 	IotCardID                 uint       `gorm:"column:iot_card_id;index;comment:IoT卡ID(单卡套餐时有值)" json:"iot_card_id"`
 	DeviceID                  uint       `gorm:"column:device_id;index;comment:设备ID(设备级套餐时有值)" json:"device_id"`
-	DataLimitMB               int64      `gorm:"column:data_limit_mb;type:bigint;not null;comment:流量限额(MB)" json:"data_limit_mb"`
-	DataUsageMB               int64      `gorm:"column:data_usage_mb;type:bigint;default:0;comment:已使用流量(MB)" json:"data_usage_mb"`
-	RealDataUsageMB           int64      `gorm:"column:real_data_usage_mb;type:bigint;default:0;comment:真流量使用(MB)" json:"real_data_usage_mb"`
-	VirtualDataUsageMB        int64      `gorm:"column:virtual_data_usage_mb;type:bigint;default:0;comment:虚流量使用(MB)" json:"virtual_data_usage_mb"`
+	DataLimitMB               int64      `gorm:"column:data_limit_mb;type:bigint;not null;comment:真总量快照(MB)" json:"data_limit_mb"`
+	DataUsageMB               int64      `gorm:"column:data_usage_mb;type:bigint;default:0;comment:真已用(MB)" json:"data_usage_mb"`
+	VirtualTotalMBSnapshot    int64      `gorm:"column:virtual_total_mb_snapshot;type:bigint;default:0;comment:虚总量快照(MB，业务停机阈值)" json:"virtual_total_mb_snapshot"`
+	DisplayGainRatioSnapshot  float64    `gorm:"column:display_gain_ratio_snapshot;type:decimal(18,6);default:1.0;comment:展示倍率快照(real_total_mb/virtual_total_mb)" json:"display_gain_ratio_snapshot"`
+	EnableVirtualDataSnapshot bool       `gorm:"column:enable_virtual_data_snapshot;type:boolean;default:false;comment:是否启用虚流量快照" json:"enable_virtual_data_snapshot"`
 	ActivatedAt               *time.Time `gorm:"column:activated_at;comment:套餐生效时间" json:"activated_at"`
 	ExpiresAt                 *time.Time `gorm:"column:expires_at;comment:套餐过期时间" json:"expires_at"`
 	Status                    int        `gorm:"column:status;type:int;default:1;not null;comment:状态 0-待生效 1-生效中 2-已用完 3-已过期 4-已失效" json:"status"`
--- a/internal/model/package_traffic_semantics.go
+++ b/internal/model/package_traffic_semantics.go
@@ -0,0 +1,96 @@
+package model
+
+import "math"
+
+const unlimitedRemainingQuotaMB = int64(^uint64(0) >> 1)
+
+// PackageTrafficMetrics 套餐流量统一展示值
+// 统一封装对外使用的真值、虚值和展示比例，避免各层重复实现公式。
+type PackageTrafficMetrics struct {
+	RealTotalMB    int64
+	RealUsedMB     int64
+	VirtualTotalMB int64
+	VirtualUsedMB  float64
+	ReductionPct   float64
+}
+
+// CalculateDisplayGainRatio 计算展示倍率
+// 启用虚流量且虚总量大于 0 时，倍率 = 真总量 / 虚总量；否则退化为 1。
+func CalculateDisplayGainRatio(enableVirtualData bool, realTotalMB, virtualTotalMB int64) float64 {
+	if enableVirtualData && virtualTotalMB > 0 {
+		return float64(realTotalMB) / float64(virtualTotalMB)
+	}
+	return 1.0
+}
+
+// BuildPackageUsageSnapshotValues 计算套餐使用记录应写入的快照值。
+func BuildPackageUsageSnapshotValues(pkg *Package) (virtualTotalMB int64, displayGainRatio float64, enableVirtualData bool) {
+	if pkg == nil {
+		return 0, 1.0, false
+	}
+
+	if pkg.EnableVirtualData && pkg.VirtualDataMB > 0 {
+		return pkg.VirtualDataMB, CalculateDisplayGainRatio(true, pkg.RealDataMB, pkg.VirtualDataMB), true
+	}
+
+	return pkg.RealDataMB, 1.0, false
+}
+
+// EffectiveThresholdMB 返回套餐业务耗尽阈值。
+// 启用虚流量时按虚总量快照判断；否则按真总量判断。
+func (u *PackageUsage) EffectiveThresholdMB() int64 {
+	if u == nil {
+		return 0
+	}
+	if u.EnableVirtualDataSnapshot && u.VirtualTotalMBSnapshot > 0 {
+		return u.VirtualTotalMBSnapshot
+	}
+	return u.DataLimitMB
+}
+
+// RemainingQuotaMB 返回套餐剩余业务额度。
+func (u *PackageUsage) RemainingQuotaMB() int64 {
+	if u == nil {
+		return 0
+	}
+	threshold := u.EffectiveThresholdMB()
+	if threshold <= 0 {
+		return unlimitedRemainingQuotaMB
+	}
+	return threshold - u.DataUsageMB
+}
+
+// IsTrafficDepleted 判断套餐是否达到业务耗尽阈值。
+func (u *PackageUsage) IsTrafficDepleted() bool {
+	if u == nil {
+		return false
+	}
+	threshold := u.EffectiveThresholdMB()
+	if threshold <= 0 {
+		return false
+	}
+	return u.DataUsageMB >= threshold
+}
+
+// BuildTrafficMetrics 组装统一五字段和 reduction_pct。
+func (u *PackageUsage) BuildTrafficMetrics() PackageTrafficMetrics {
+	metrics := PackageTrafficMetrics{}
+	if u == nil {
+		return metrics
+	}
+
+	metrics.RealTotalMB = u.DataLimitMB
+	metrics.RealUsedMB = u.DataUsageMB
+
+	if u.EnableVirtualDataSnapshot && u.VirtualTotalMBSnapshot > 0 {
+		metrics.VirtualTotalMB = u.VirtualTotalMBSnapshot
+		metrics.VirtualUsedMB = math.Min(float64(u.DataUsageMB)*u.DisplayGainRatioSnapshot, float64(u.DataLimitMB))
+		metrics.ReductionPct = u.DisplayGainRatioSnapshot - 1
+		return metrics
+	}
+
+	metrics.VirtualTotalMB = u.DataLimitMB
+	metrics.VirtualUsedMB = float64(u.DataUsageMB)
+	metrics.ReductionPct = 0
+	return metrics
+}