赠送套餐逻辑

docs/admin-openapi.yaml

@@ -2149,7 +2149,7 @@ components:
                     description: 套餐类型 (formal:正式套餐, addon:加油包)
                     type: string
                 retail_price:
-                    description: 零售价（分）
+                    description: 生效零售价（分）
                     type: integer
                 validity_days:
                     description: 有效天数
@@ -2786,6 +2786,9 @@ components:
                     description: 到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)
                     example: from_activation
                     type: string
+                is_gift:
+                    description: 是否赠送套餐
+                    type: boolean
                 package_code:
                     description: 套餐编码
                     maxLength: 100
@@ -2810,7 +2813,7 @@ components:
                     nullable: true
                     type: integer
                 suggested_retail_price:
-                    description: 建议售价(分)
+                    description: 建议售价原始值(分，普通可售套餐留空表示未配置，赠送套餐必须显式为0)
                     minimum: 0
                     nullable: true
                     type: integer
@@ -5580,6 +5583,10 @@ components:
                 duration_months:
                     description: 套餐时长(月数)
                     type: integer
+                effective_retail_price:
+                    description: 生效零售价（分，仅销售链路展示使用）
+                    nullable: true
+                    type: integer
                 enable_virtual_data:
                     description: 是否启用虚流量
                     type: boolean
@@ -5590,6 +5597,9 @@ components:
                     description: 套餐ID
                     minimum: 0
                     type: integer
+                is_gift:
+                    description: 是否赠送套餐
+                    type: boolean
                 one_time_commission_amount:
                     description: 一次性佣金金额（分，代理视角）
                     nullable: true
@@ -5603,6 +5613,12 @@ components:
                 package_type:
                     description: 套餐类型 (formal:正式套餐, addon:附加套餐)
                     type: string
+                price_config_status:
+                    description: 价格配置状态 (0:未配置, 1:赠送0价, 2:已配置非0)
+                    type: integer
+                price_config_status_name:
+                    description: 价格配置状态名称（中文）
+                    type: string
                 profit_margin:
                     description: 利润空间（分，仅代理用户可见）
                     nullable: true
@@ -5611,7 +5627,11 @@ components:
                     description: 真流量额度(MB)
                     type: integer
                 retail_price:
-                    description: 代理零售价（分），仅代理用户可见
+                    description: 代理零售价原始值（分，仅代理用户可见，未配置时为空）
+                    nullable: true
+                    type: integer
+                retail_price_config_status:
+                    description: 代理零售价配置状态 (0:未配置, 1:赠送0价, 2:已配置非0)
                     nullable: true
                     type: integer
                 series_id:
@@ -5636,7 +5656,8 @@ components:
                     description: 状态名称（中文）
                     type: string
                 suggested_retail_price:
-                    description: 建议售价(分)
+                    description: 建议售价原始值(分，未配置时为空)
+                    nullable: true
                     type: integer
                 tier_info:
                     $ref: '#/components/schemas/DtoCommissionTierInfo'
@@ -7704,6 +7725,9 @@ components:
                     description: 套餐周期类型 (natural_month:自然月, by_day:按天)
                     nullable: true
                     type: string
+                clear_suggested_retail_price:
+                    description: 是否清空建议售价并恢复为未配置状态
+                    type: boolean
                 cost_price:
                     description: 成本价(分)
                     minimum: 0
@@ -7733,6 +7757,10 @@ components:
                     description: 到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)
                     nullable: true
                     type: string
+                is_gift:
+                    description: 是否赠送套餐
+                    nullable: true
+                    type: boolean
                 package_name:
                     description: 套餐名称
                     maxLength: 255
@@ -7754,7 +7782,7 @@ components:
                     nullable: true
                     type: integer
                 suggested_retail_price:
-                    description: 建议售价(分)
+                    description: 建议售价原始值(分，普通可售套餐留空表示未配置，赠送套餐必须显式为0)
                     minimum: 0
                     nullable: true
                     type: integer
@@ -7960,7 +7988,7 @@ components:
         DtoUpdateRetailPriceParams:
             properties:
                 retail_price:
-                    description: 零售价（单位：分）
+                    description: 零售价原始值（分，普通可售套餐不允许显式0）
                     minimum: 0
                     type: integer
             required: