补回是否启用虚流量

docs/admin-openapi.yaml

@@ -979,6 +979,9 @@ components:
                     description: 创建时间
                     format: date-time
                     type: string
+                enable_virtual_data:
+                    description: 是否启用虚流量（按套餐使用记录快照返回）
+                    type: boolean
                 expires_at:
                     description: 到期时间（待生效套餐为空）
                     format: date-time

docs/asset-detail-refactor-api-changes.md

@@ -157,6 +157,7 @@
 | `virtual_total_mb` | int64 | 套餐业务停机阈值 MB |
 | `virtual_used_mb` | float64 | 套餐展示已用量 MB |
 | `reduction_pct` | float64 | 展示增幅比例，公式为 `(real_total_mb / virtual_total_mb) - 1` |
+| `enable_virtual_data` | bool | 是否启用虚流量（按套餐使用记录快照返回） |
 | `activated_at` | time | 激活时间 |
 | `expires_at` | time | 到期时间 |
 | `master_usage_id` | uint | 主套餐 ID（加油包时有值） |

docs/traffic-model-unification/字段替换矩阵.md

@@ -41,6 +41,7 @@
 | `virtual_remain_mb` | `(data_limit_mb - data_usage_mb) / virtual_ratio` | 删除 | 不再返回 |
 | `virtual_ratio` | `tb_package.virtual_ratio` | `reduction_pct` | 只保留外部增幅比例 |
 | 无 | 无 | `package_usage_id` | 保留既有字段 |
+| 无 | `tb_package_usage.enable_virtual_data_snapshot` | `enable_virtual_data` | 返回套餐使用记录快照，供前端区分是否启用虚流量 |
 
 ### 3.3 后台 `GET /api/admin/assets/:identifier/packages`
 
@@ -53,6 +54,7 @@
 | `virtual_remain_mb` | `(data_limit_mb - data_usage_mb) / virtual_ratio` | 删除 | 不再返回 |
 | `virtual_ratio` | `tb_package.virtual_ratio` | `reduction_pct` | 只保留外部比例 |
 | `package_usage_id` | `tb_package_usage.id` | `package_usage_id` | 保留，作为记录主键 |
+| 无 | `tb_package_usage.enable_virtual_data_snapshot` | `enable_virtual_data` | 返回套餐使用记录快照，供前端区分是否启用虚流量 |
 
 ### 3.4 C 端 `GET /api/c/v1/asset/info`
 

docs/traffic-model-unification/接口回放样例.md

@@ -70,7 +70,7 @@ curl -X GET "http://localhost:8080/api/admin/assets/<identifier>/current-package
 
 - 有主套餐时仅返回主套餐记录
 - 无主套餐时返回 `200 + null`
-- 记录字段包含 `package_usage_id + 统一五字段 + reduction_pct`
+- 记录字段包含 `package_usage_id + 统一五字段 + reduction_pct + enable_virtual_data`
 
 ### 3.3 套餐历史
 
@@ -81,7 +81,7 @@ curl -X GET "http://localhost:8080/api/admin/assets/<identifier>/packages?page=1
 
 重点核对：
 
-- 列表每条记录都包含 `package_usage_id + 统一五字段 + reduction_pct`
+- 列表每条记录都包含 `package_usage_id + 统一五字段 + reduction_pct + enable_virtual_data`
 - 不再出现 `virtual_limit_mb` / `virtual_remain_mb` / `virtual_ratio`
 
 ## 4. C 端接口回放