feat: 实名即生效套餐沉默期、延期办理与资产出库时间
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8m39s

- 迁移 000259~000265:套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置(总开关默认关闭)、企微审批白名单、卡与设备出库时间及出库记录
- 沉默期设置(订单发放、自动购包、钱包续费)、后台购买时调整(超默认值按政策免审或企微审批)、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描
- 总开关专用接口与打开前 4 项检查;延期政策;延期资格与计费;H5 自助与后台二维码在线支付(商户池路由)、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款;沉默期审批场景与终态处理
- 换货沉默期流水与出库时间;卡/设备列表、详情、导出与出库记录接口;延期订单与即将过期套餐列表及导出;财务流水纳入延期支付
- 沉默期与出库时间回填工具 cmd/silence-backfill;前端接口变更说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
邹进
2026-10-27 16:32:58 +09:00
parent d2b0d2f534
commit 909f4d0ec2
112 changed files with 10473 additions and 82 deletions

View File

@@ -12,6 +12,7 @@ type AssetResolveResponse struct {
Status int `json:"status" description:"资产归属状态 (1:在库, 2:已分销;卡仍沿用原卡状态枚举)"`
StatusName string `json:"status_name" description:"资产状态名称(中文)"`
BatchNo string `json:"batch_no" description:"批次号"`
OutboundAt *time.Time `json:"outbound_at,omitempty" description:"出库时间(当前世代首次购买套餐的支付时间)"`
ShopID *uint `json:"shop_id,omitempty" description:"所属店铺ID"`
ShopName string `json:"shop_name,omitempty" description:"所属店铺名称"`
SeriesID *uint `json:"series_id,omitempty" description:"套餐系列ID"`
@@ -148,31 +149,32 @@ type AssetRealtimeStatusResponse struct {
// AssetPackageResponse 资产套餐信息
type AssetPackageResponse struct {
PackageUsageID uint `json:"package_usage_id" description:"套餐使用记录ID"`
PackageID uint `json:"package_id" description:"套餐ID"`
PackageName string `json:"package_name" description:"套餐名称"`
PackageType string `json:"package_type" description:"套餐类型:formal/addon"`
ExpiryBase string `json:"expiry_base,omitempty" description:"到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)"`
OrderID uint `json:"order_id" description:"关联订单ID(无订单分配时为0)"`
OrderNo string `json:"order_no,omitempty" description:"订单号快照(无订单分配时为空)"`
RefundID *uint `json:"refund_id,omitempty" description:"退款主键ID快照(未退款时为空)"`
RefundNo string `json:"refund_no,omitempty" description:"退款单号快照(未退款时为空)"`
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:"状态名称"`
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"`
EnableVirtualData bool `json:"enable_virtual_data" description:"是否启用虚流量(按套餐使用记录快照返回)"`
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(加油包时有值)"`
Priority int `json:"priority" description:"优先级"`
PaidAmount *int64 `json:"paid_amount,omitempty" description:"购买成本价(分),仅平台账号可见,非平台账号不返回此字段"`
RetailAmount *int64 `json:"retail_amount,omitempty" description:"购买零售价(分),无订单关联时为空"`
CreatedAt time.Time `json:"created_at" description:"创建时间"`
PackageUsageID uint `json:"package_usage_id" description:"套餐使用记录ID"`
PackageID uint `json:"package_id" description:"套餐ID"`
PackageName string `json:"package_name" description:"套餐名称"`
PackageType string `json:"package_type" description:"套餐类型:formal/addon"`
ExpiryBase string `json:"expiry_base,omitempty" description:"到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)"`
OrderID uint `json:"order_id" description:"关联订单ID(无订单分配时为0)"`
OrderNo string `json:"order_no,omitempty" description:"订单号快照(无订单分配时为空)"`
RefundID *uint `json:"refund_id,omitempty" description:"退款主键ID快照(未退款时为空)"`
RefundNo string `json:"refund_no,omitempty" description:"退款单号快照(未退款时为空)"`
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:"状态名称"`
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"`
EnableVirtualData bool `json:"enable_virtual_data" description:"是否启用虚流量(按套餐使用记录快照返回)"`
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(加油包时有值)"`
Priority int `json:"priority" description:"优先级"`
PaidAmount *int64 `json:"paid_amount,omitempty" description:"购买成本价(分),仅平台账号可见,非平台账号不返回此字段"`
RetailAmount *int64 `json:"retail_amount,omitempty" description:"购买零售价(分),无订单关联时为空"`
CreatedAt time.Time `json:"created_at" description:"创建时间"`
Silence *PackageSilenceView `json:"silence,omitempty" description:"沉默期信息(总开关打开且适用沉默期时返回)"`
}
// AssetPackageHistoryNode 后台资产套餐历史层级节点。
@@ -206,6 +208,7 @@ type AssetPackageHistoryNode struct {
ExpandByDefault bool `json:"expand_by_default" description:"是否默认展开关联加油包"`
RelationshipStatus string `json:"relationship_status,omitempty" description:"关系异常状态:master_missing"`
RelationshipStatusName string `json:"relationship_status_name,omitempty" description:"关系异常状态名称"`
Silence *PackageSilenceView `json:"silence,omitempty" description:"沉默期信息(总开关打开且适用沉默期时返回)"`
}
// AssetPackagesResult 后台资产套餐历史分页结果。

View File

@@ -218,6 +218,7 @@ type ClientAssetPackageHistoryNode struct {
ExpandByDefault bool `json:"expand_by_default" description:"是否默认展开关联加油包"`
RelationshipStatus string `json:"relationship_status,omitempty" description:"关系异常状态:master_missing"`
RelationshipStatusName string `json:"relationship_status_name,omitempty" description:"关系异常状态名称"`
Silence *PackageSilenceView `json:"silence,omitempty" description:"沉默期信息(总开关打开且适用沉默期时返回;extendable 为 true 时显示延期入口)"`
}
// AssetPackageHistoryResponse B3 资产套餐历史层级响应。

View File

@@ -24,6 +24,8 @@ type ListDeviceRequest struct {
Keyword string `json:"keyword" query:"keyword" validate:"omitempty,max=100" maxLength:"100" description:"关键字搜索,匹配虚拟号或IMEI(模糊查询,与virtual_no/imei独立)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" query:"authorized_enterprise_id" description:"按有效授权企业ID过滤(只返回当前授权给该企业的设备)"`
IsAuthorizedToEnterprise *bool `json:"is_authorized_to_enterprise" query:"is_authorized_to_enterprise" description:"企业授权状态过滤 (true:已授权给某企业, false:未授权任何企业)"`
OutboundStart string `json:"outbound_start" query:"outbound_start" description:"出库时间起(RFC3339,含)"`
OutboundEnd string `json:"outbound_end" query:"outbound_end" description:"出库时间止(RFC3339,含)"`
}
type DeviceResponse struct {
@@ -60,12 +62,13 @@ type DeviceResponse struct {
LastGatewaySyncAt *time.Time `json:"last_gateway_sync_at" description:"最后 sync-info 同步时间"`
// asset_status=3 表示该资产已换货且尚未执行"旧资产转新",不再流通
// generation>1 表示该资产历史上曾执行过换货后转新,目前仍在使用
AssetStatus int `json:"asset_status" description:"业务状态 (1:在库, 2:已销售, 3:已换货, 4:已停用)"`
AssetStatusName string `json:"asset_status_name" description:"业务状态名称(中文)"`
Generation int `json:"generation" description:"资产世代编号(初始值1,每次换货转新后+1)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" description:"当前有效授权的企业ID,未授权时为 null"`
AuthorizedEnterpriseName string `json:"authorized_enterprise_name" description:"当前有效授权的企业名称,未授权时为空字符串"`
AssociatedPhones []string `json:"associated_phones" description:"当前关联手机号列表(按资产数据范围返回完整手机号,无关联时为空数组)"`
AssetStatus int `json:"asset_status" description:"业务状态 (1:在库, 2:已销售, 3:已换货, 4:已停用)"`
AssetStatusName string `json:"asset_status_name" description:"业务状态名称(中文)"`
Generation int `json:"generation" description:"资产世代编号(初始值1,每次换货转新后+1)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" description:"当前有效授权的企业ID,未授权时为 null"`
AuthorizedEnterpriseName string `json:"authorized_enterprise_name" description:"当前有效授权的企业名称,未授权时为空字符串"`
AssociatedPhones []string `json:"associated_phones" description:"当前关联手机号列表(按资产数据范围返回完整手机号,无关联时为空数组)"`
OutboundAt *time.Time `json:"outbound_at,omitempty" description:"出库时间(当前世代首次购买套餐的支付时间)"`
}
type ListDeviceResponse struct {

View File

@@ -28,6 +28,8 @@ type ListStandaloneIotCardRequest struct {
RealNameStatus *int `json:"real_name_status" query:"real_name_status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"实名状态 (0:未实名, 1:已实名)"`
AuthorizedEnterpriseID *uint `json:"authorized_enterprise_id" query:"authorized_enterprise_id" description:"按有效授权企业ID过滤(只返回当前授权给该企业的卡)"`
IsAuthorizedToEnterprise *bool `json:"is_authorized_to_enterprise" query:"is_authorized_to_enterprise" description:"企业授权状态过滤 (true:已授权给某企业, false:未授权任何企业)"`
OutboundStart string `json:"outbound_start" query:"outbound_start" description:"出库时间起(RFC3339,含)"`
OutboundEnd string `json:"outbound_end" query:"outbound_end" description:"出库时间止(RFC3339,含)"`
}
type StandaloneIotCardResponse struct {
@@ -58,6 +60,7 @@ type StandaloneIotCardResponse struct {
GatewayCardIMEI string `json:"gateway_card_imei" description:"插拔卡业务 IMEI(由 Gateway 卡状态接口同步,非设备自身 IMEI,无业务含义,仅供查看)"`
DataUsageMB int64 `json:"data_usage_mb" description:"累计流量使用(MB)"`
CurrentMonthUsageMB float64 `json:"current_month_usage_mb" description:"系统自然月累计流量(MB,不等于运营商周期口径)"`
OutboundAt *time.Time `json:"outbound_at,omitempty" description:"出库时间(当前世代首次购买套餐的支付时间;绑定在设备上的卡不记录)"`
LastGatewayReadingMB float64 `json:"last_gateway_reading_mb" description:"运营商当前周期累计流量读数(MB,展示运营商口径时使用)"`
CurrentMonthStartDate *time.Time `json:"current_month_start_date" description:"本月开始日期"`
LastMonthTotalMB float64 `json:"last_month_total_mb" description:"上月流量总量(MB)"`

View File

@@ -16,6 +16,8 @@ type CreateAdminOrderRequest struct {
PackageIDs []uint `json:"package_ids" validate:"required,min=1,max=10,dive,min=1" required:"true" minItems:"1" maxItems:"10" description:"套餐ID列表"`
PaymentMethod string `json:"payment_method" validate:"required,oneof=wallet offline" required:"true" description:"支付方式 (wallet:钱包支付, offline:线下支付)"`
PaymentVoucherKey []string `json:"payment_voucher_key" validate:"omitempty,max=5,dive,max=500" maxItems:"5" description:"线下支付凭证对象存储file_key列表(最多5个,通过/storage/upload-url上传图片后获得);线下订单需付款凭证,但实际收款金额大于 0 且由平台账号操作的非赠送线下订单会生成员工代收款账单,该场景凭证由核销申请环节提供,创建订单时可为空"`
SilencePeriodDays *int `json:"silence_period_days" validate:"omitempty,min=1" minimum:"1" description:"本次沉默期(天,可选,需 package_silence:override 权限;不超过套餐默认值直接生效,超过默认值按延期政策直接生效或先按默认值购买并提交企微审批;只对资产未实名时购买的实名即生效主套餐生效)"`
SilenceReason string `json:"silence_reason" validate:"omitempty,max=500" maxLength:"500" description:"调整沉默期原因(设置本次沉默期时必填)"`
}
type OrderListRequest struct {

View File

@@ -2,21 +2,23 @@ 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:附加套餐)"`
IsGift bool `json:"is_gift" description:"是否赠送套餐"`
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:"建议售价原始值(分,普通可售套餐留空表示未配置,赠送套餐必须显式为0)"`
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:不重置)"`
ExpiryBase string `json:"expiry_base" validate:"omitempty,oneof=from_activation from_purchase" description:"到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)" example:"from_activation"`
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:附加套餐)"`
IsGift bool `json:"is_gift" description:"是否赠送套餐"`
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:"建议售价原始值(分,普通可售套餐留空表示未配置,赠送套餐必须显式为0)"`
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:不重置)"`
ExpiryBase string `json:"expiry_base" validate:"omitempty,oneof=from_activation from_purchase" description:"到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)" example:"from_activation"`
SilencePeriodDays *int `json:"silence_period_days" validate:"omitempty,min=1,max=90" minimum:"1" maximum:"90" description:"默认沉默期(天,实名即生效正式套餐必填 1~90,新建预填 30;其他套餐不得填写)"`
SilenceExtensionEnabled *bool `json:"silence_extension_enabled" description:"是否支持付费延期(默认支持;不支持时仍可申请特殊延期)"`
}
// UpdatePackageRequest 更新套餐请求
@@ -36,6 +38,8 @@ type UpdatePackageRequest struct {
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:不重置)"`
ExpiryBase *string `json:"expiry_base" validate:"omitempty,oneof=from_activation from_purchase" description:"到期时间基准 (from_activation:实名激活时起算, from_purchase:购买时起算)"`
SilencePeriodDays *int `json:"silence_period_days" validate:"omitempty,min=1,max=90" minimum:"1" maximum:"90" description:"默认沉默期(天,实名即生效正式套餐必填 1~90;修改只影响之后的新购买)"`
SilenceExtensionEnabled *bool `json:"silence_extension_enabled" description:"是否支持付费延期"`
}
// PackageListRequest 套餐列表请求
@@ -47,6 +51,8 @@ type PackageListRequest struct {
Status *int `json:"status" query:"status" validate:"omitempty,oneof=0 1" description:"状态 (0:禁用, 1:启用)"`
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:附加套餐)"`
// SilenceUnconfigured 为 true 时只返回"未配置默认沉默期的实名即生效正式套餐"(存量补齐清单)
SilenceUnconfigured *bool `json:"silence_unconfigured" query:"silence_unconfigured" description:"只看未配置默认沉默期的实名即生效套餐"`
}
// UpdatePackageStatusRequest 更新套餐状态请求
@@ -112,6 +118,9 @@ type PackageResponse struct {
ExpiryBaseOverrideName string `json:"expiry_base_override_name" description:"分配生效条件覆盖名称(中文)"`
EffectiveExpiryBase string `json:"effective_expiry_base" description:"最终生效条件 (from_activation:实名激活时生效, from_purchase:购买即生效)"`
EffectiveExpiryBaseName string `json:"effective_expiry_base_name" description:"最终生效条件名称(中文)"`
SilencePeriodDays *int `json:"silence_period_days,omitempty" description:"默认沉默期(天),实名即生效正式套餐有值"`
SilenceExtensionEnabled bool `json:"silence_extension_enabled" description:"是否支持付费延期"`
SilenceConfigRequired bool `json:"silence_config_required" description:"是否必须配置默认沉默期(实名即生效正式套餐)"`
}
// UpdatePackageParams 更新套餐聚合参数

View File

@@ -0,0 +1,462 @@
package dto
import "time"
// PackageSilenceView 是一笔套餐记录的沉默期展示信息(add-package-silence-period §12.1)。
// 只在沉默期总开关打开且该套餐适用沉默期时返回;总开关关闭时整个对象不返回。
type PackageSilenceView struct {
SilenceStatus string `json:"silence_status" description:"沉默期状态:waiting-待实名 expired-沉默期已过期 ended-沉默期已结束;待实名但已过截止的按 expired 返回"`
SilenceStatusName string `json:"silence_status_name" description:"沉默期状态名称(待实名 / 延期待实名 / 沉默期已过期 / 沉默期已结束)"`
SilenceStartAt *time.Time `json:"silence_start_at,omitempty" description:"沉默期起算时间(购买支付成功时间)"`
SilencePeriodDays *int `json:"silence_period_days,omitempty" description:"沉默期天数"`
SilenceDeadlineAt *time.Time `json:"silence_deadline_at,omitempty" description:"当前沉默期截止时间(截止日 23:59:59)"`
SilenceExtendedDays int `json:"silence_extended_days" description:"累计已延期天数"`
SilencePaidExtendedDays int `json:"silence_paid_extended_days" description:"其中付费延期累计天数"`
SilenceExtensionCount int `json:"silence_extension_count" description:"累计延期次数"`
SilenceFreeExtensionUsed int `json:"silence_free_extension_used" description:"已使用免费延期次数"`
SilenceExpiredAt *time.Time `json:"silence_expired_at,omitempty" description:"最近一次过期时间"`
SilenceAdjustPending bool `json:"silence_adjust_pending" description:"购买时调整沉默期的审批是否进行中"`
Extendable bool `json:"extendable" description:"是否显示延期入口(沉默期已过期的待生效套餐)"`
}
// SilenceSwitchRequest 切换沉默期总开关请求。
type SilenceSwitchRequest struct {
Enabled *bool `json:"enabled" validate:"required" required:"true" description:"目标状态:true 打开 / false 关闭(应急关闭不做检查)"`
}
// SilenceSwitchPrecheckItem 是打开前检查的一项结果。
type SilenceSwitchPrecheckItem struct {
Code string `json:"code" description:"检查项:unconfigured_packages / unbackfilled_usages / default_policy_missing / approval_scene_missing"`
Name string `json:"name" description:"检查项名称"`
Passed bool `json:"passed" description:"是否满足"`
Count int64 `json:"count" description:"数量(前两项为未满足的数量,后两项为已具备的数量)"`
}
// SilenceSwitchResponse 沉默期总开关状态。
type SilenceSwitchResponse struct {
Enabled bool `json:"enabled" description:"总开关是否打开"`
PrecheckPassed bool `json:"precheck_passed" description:"打开前检查是否全部通过"`
Precheck []SilenceSwitchPrecheckItem `json:"precheck" nullable:"false" description:"打开前检查各项结果"`
}
// SilencePolicyRequest 新增 / 编辑延期政策请求。
type SilencePolicyRequest struct {
Name string `json:"name" validate:"required,min=1,max=100" required:"true" maxLength:"100" description:"政策名称(唯一)"`
ScopeType string `json:"scope_type" validate:"required,oneof=all series package" required:"true" description:"适用范围:all-全部套餐 series-套餐系列 package-指定套餐"`
ScopeIDs []uint `json:"scope_ids" validate:"omitempty,max=500,dive,min=1" description:"系列 ID 或套餐 ID 列表(all 时为空)"`
UnitPrice int64 `json:"unit_price" validate:"min=0,max=1000000" minimum:"0" description:"每月单价(分),1 月 = 30 天"`
FreeExtensionLimit int `json:"free_extension_limit" validate:"min=0,max=100" minimum:"0" description:"每笔套餐免费延期次数"`
PaidMaxMonths int `json:"paid_max_months" validate:"min=0,max=120" minimum:"0" description:"付费延期累计最多月数"`
SingleMaxMonths *int `json:"single_max_months" validate:"omitempty,min=1,max=120" description:"单次付费延期最多月数(为空表示不单独限制)"`
ApprovalExemptTypes []string `json:"approval_exempt_types" validate:"omitempty,dive,oneof=offline_paid free discount complaint_compensation system_compensation special_customer batch purchase_adjust" description:"免审批场景(多选,空表示全部需审批)"`
EffectiveFrom time.Time `json:"effective_from" validate:"required" required:"true" description:"生效时间"`
EffectiveTo *time.Time `json:"effective_to" description:"失效时间(为空表示长期)"`
Status *int `json:"status" validate:"omitempty,oneof=0 1" description:"状态:0-停用 1-启用(新增默认启用)"`
Remark string `json:"remark" validate:"omitempty,max=500" maxLength:"500" description:"备注"`
}
// SilencePolicyStatusRequest 启停延期政策请求。
type SilencePolicyStatusRequest struct {
Status *int `json:"status" validate:"required,oneof=0 1" required:"true" description:"状态:0-停用 1-启用"`
}
// SilencePolicyListRequest 延期政策列表请求。
type SilencePolicyListRequest struct {
Page int `json:"page" query:"page" validate:"omitempty,min=1" description:"页码"`
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" description:"每页数量"`
Name string `json:"name" query:"name" validate:"omitempty,max=100" description:"政策名称(模糊)"`
ScopeType string `json:"scope_type" query:"scope_type" validate:"omitempty,oneof=all series package" description:"适用范围"`
Status *int `json:"status" query:"status" validate:"omitempty,oneof=0 1" description:"状态"`
EffectiveAt string `json:"effective_at" query:"effective_at" description:"在该时间生效(RFC3339)"`
}
// SilencePolicyResponse 延期政策。
type SilencePolicyResponse struct {
ID uint `json:"id" description:"政策 ID"`
Name string `json:"name" description:"政策名称"`
ScopeType string `json:"scope_type" description:"适用范围"`
ScopeTypeName string `json:"scope_type_name" description:"适用范围名称"`
ScopeIDs []uint `json:"scope_ids" nullable:"false" description:"系列或套餐 ID 列表"`
UnitPrice int64 `json:"unit_price" description:"每月单价(分)"`
FreeExtensionLimit int `json:"free_extension_limit" description:"免费延期次数"`
PaidMaxMonths int `json:"paid_max_months" description:"付费延期累计最多月数"`
SingleMaxMonths *int `json:"single_max_months,omitempty" description:"单次付费延期最多月数"`
ApprovalExemptTypes []string `json:"approval_exempt_types" nullable:"false" description:"免审批场景"`
EffectiveFrom time.Time `json:"effective_from" description:"生效时间"`
EffectiveTo *time.Time `json:"effective_to,omitempty" description:"失效时间"`
Status int `json:"status" description:"状态:0-停用 1-启用"`
Remark string `json:"remark" description:"备注"`
Creator uint `json:"creator" description:"创建人"`
Updater uint `json:"updater" description:"更新人"`
CreatedAt time.Time `json:"created_at" description:"创建时间"`
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
}
// SilencePolicyMatchResponse 某套餐当前匹配的延期政策。
type SilencePolicyMatchResponse struct {
PackageID uint `json:"package_id" description:"套餐 ID"`
Matched bool `json:"matched" description:"是否匹配到政策(未匹配时不能付费延期,特殊延期仍可申请)"`
Policy *SilencePolicyResponse `json:"policy,omitempty" description:"匹配到的政策"`
}
// SilenceEligibilityRequest 延期资格查询请求(后台与 H5 同语义)。
type SilenceEligibilityRequest struct {
PackageUsageID uint `json:"package_usage_id" query:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
}
// SilenceExtensionOption 一个月数档位。
type SilenceExtensionOption struct {
Months int `json:"months" description:"计费月数"`
BilledDays int `json:"billed_days" description:"计费 / 延长天数(月数 × 30)"`
Amount int64 `json:"amount" description:"金额(分)"`
NewDeadline string `json:"new_deadline" description:"新截止日期(YYYY-MM-DD,当日 23:59:59 截止)"`
}
// SilenceEligibilityResponse 延期资格(技术方案 §12.2),金额与月数全部由后端计算。
type SilenceEligibilityResponse struct {
PackageUsageID uint `json:"package_usage_id" description:"套餐记录 ID"`
SilenceStatus string `json:"silence_status" description:"沉默期状态(待实名但已到期的先判定为过期)"`
CanExtend bool `json:"can_extend" description:"能否办理付费延期"`
SpecialExtensionAvailable bool `json:"special_extension_available" description:"能否申请特殊延期(只要求套餐已过期)"`
Reason string `json:"reason,omitempty" description:"付费延期不能办理的原因:not_expired/no_silence/extension_disabled/no_policy/exceeds_limit/refunded/order_pending/activated/adjust_pending"`
OriginalDeadline string `json:"original_deadline,omitempty" description:"当前截止日期(YYYY-MM-DD)"`
OverdueDays int `json:"overdue_days" description:"已过期天数"`
MinDays int `json:"min_days" description:"可输入的最少天数(付费与特殊延期都适用)"`
MaxDays int `json:"max_days" description:"本次付费延期可输入的最多天数"`
MinMonths int `json:"min_months" description:"最少延期月数"`
MaxMonths int `json:"max_months" description:"本次付费延期最多月数(特殊延期不受此限)"`
ExtendedDays int `json:"extended_days" description:"已累计延期天数"`
PaidExtendedDays int `json:"paid_extended_days" description:"其中付费延期累计天数"`
FreeExtensionAvailable bool `json:"free_extension_available" description:"是否还能申请免费延期"`
FreeExtensionLimit int `json:"free_extension_limit" description:"免费延期次数上限"`
FreeExtensionUsed int `json:"free_extension_used" description:"已使用免费延期次数"`
UnitPrice int64 `json:"unit_price" description:"每月单价(分),取当前匹配的延期政策"`
PolicyID *uint `json:"policy_id,omitempty" description:"当前匹配的延期政策 ID"`
PolicyName string `json:"policy_name,omitempty" description:"当前匹配的延期政策名称"`
ExtensionEnabled bool `json:"extension_enabled" description:"套餐是否支持付费延期"`
PendingOrderNo string `json:"pending_order_no,omitempty" description:"未结束的延期订单号(有则不能新建,需先完成或关闭)"`
Options []SilenceExtensionOption `json:"options" nullable:"false" description:"min~max 每档计费天数、金额与新截止日期"`
}
// SilenceQuoteRequest 按输入天数试算。
type SilenceQuoteRequest struct {
PackageUsageID uint `json:"package_usage_id" query:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
Days int `json:"days" query:"days" validate:"required,min=1,max=3650" required:"true" description:"输入的延期天数(按每月 30 天向上取整计费)"`
}
// SilenceQuoteResponse 试算结果。
type SilenceQuoteResponse struct {
InputDays int `json:"input_days" description:"输入天数"`
Months int `json:"months" description:"计费月数"`
BilledDays int `json:"billed_days" description:"计费 / 延长天数"`
Amount int64 `json:"amount" description:"金额(分)"`
NewDeadline string `json:"new_deadline" description:"新截止日期"`
Valid bool `json:"valid" description:"是否在可办理范围内"`
}
// SilenceOnlineOrderRequest 在线付费延期下单(H5 自助或后台二维码)。
type SilenceOnlineOrderRequest struct {
PackageUsageID uint `json:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
Days int `json:"days" validate:"required,min=1,max=3650" required:"true" description:"输入的延期天数"`
PaymentMethod string `json:"payment_method" validate:"required,oneof=wechat alipay" required:"true" description:"支付方式:wechat / alipay(经商户池路由)"`
RequestID string `json:"request_id" validate:"required,min=1,max=64" required:"true" description:"下单幂等键"`
EvidenceRefs []string `json:"evidence_refs" validate:"omitempty,max=10,dive,max=500" description:"客户申请记录或截图对象存储 Key(后台创建时填写)"`
}
// SilenceOfflineOrderRequest 登记线下付费延期。
type SilenceOfflineOrderRequest struct {
PackageUsageID uint `json:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
Days int `json:"days" validate:"required,min=1,max=3650" required:"true" description:"输入的延期天数"`
OfflinePaymentMethodID uint `json:"offline_payment_method_id" validate:"required,min=1" required:"true" description:"线下收款方式(字典 ID)"`
OfflineTradeNo string `json:"offline_trade_no" validate:"required,min=1,max=128" required:"true" description:"线下交易单号(同一收款方式下唯一)"`
PaidAmount int64 `json:"paid_amount" validate:"min=0" description:"实收金额(分),必须等于系统计算金额"`
PaidAt time.Time `json:"paid_at" validate:"required" required:"true" description:"付款时间"`
PaymentVoucherKeys []string `json:"payment_voucher_keys" validate:"required,min=1,max=5,dive,max=500" required:"true" description:"收款凭证对象存储 Key(1~5 个)"`
EvidenceRefs []string `json:"evidence_refs" validate:"omitempty,max=10,dive,max=500" description:"客户申请依据"`
RequestID string `json:"request_id" validate:"required,min=1,max=64" required:"true" description:"幂等键"`
}
// SilenceExtensionOrderResponse 延期订单。
type SilenceExtensionOrderResponse struct {
ID uint `json:"id" description:"订单 ID"`
OrderNo string `json:"order_no" description:"订单号"`
BatchNo string `json:"batch_no,omitempty" description:"批次号"`
PackageUsageID uint `json:"package_usage_id" description:"套餐记录 ID"`
PackageID uint `json:"package_id" description:"套餐 ID"`
PackageName string `json:"package_name" description:"套餐名称快照"`
AssetType string `json:"asset_type" description:"资产类型 iot_card / device"`
AssetID uint `json:"asset_id" description:"资产 ID"`
AssetIdentifier string `json:"asset_identifier" description:"资产标识快照"`
ShopID uint `json:"shop_id" description:"下单时资产所属店铺"`
CustomerID *uint `json:"customer_id,omitempty" description:"H5 下单的客户"`
Source string `json:"source" description:"来源:client / admin / offline"`
SourceName string `json:"source_name" description:"来源名称"`
InputDays int `json:"input_days" description:"输入天数"`
Months int `json:"months" description:"计费月数"`
ExtensionDays int `json:"extension_days" description:"计费 / 延长天数"`
UnitPrice int64 `json:"unit_price" description:"单价(分/月)"`
Amount int64 `json:"amount" description:"应付金额(分)"`
PolicyName string `json:"policy_name" description:"政策名称快照"`
BeforeDeadlineAt time.Time `json:"before_deadline_at" description:"下单时截止时间"`
ExpectedDeadlineAt time.Time `json:"expected_deadline_at" description:"预计新截止时间"`
Status string `json:"status" description:"状态:pending_payment/pending_approval/rejected/paid/completed/closed/exception/refunded"`
StatusName string `json:"status_name" description:"状态名称"`
PaymentMethod string `json:"payment_method" description:"支付方式:wechat/alipay/offline"`
PaymentMerchantName string `json:"payment_merchant_name,omitempty" description:"收款商户名称(取已支付或已退款支付单快照)"`
ThirdPartyTradeNo string `json:"third_party_trade_no,omitempty" description:"交易流水号"`
PaymentNo string `json:"payment_no,omitempty" description:"支付单号"`
QRContent string `json:"qr_content,omitempty" description:"支付内容(待支付时返回,前端渲染为二维码或跳转链接)"`
OfflinePaymentMethodName string `json:"offline_payment_method_name,omitempty" description:"线下收款方式"`
OfflineTradeNo string `json:"offline_trade_no,omitempty" description:"线下交易单号"`
PaymentVoucherKeys []string `json:"payment_voucher_keys,omitempty" description:"线下收款凭证"`
EvidenceRefs []string `json:"evidence_refs,omitempty" description:"申请依据"`
ApprovalRequired bool `json:"approval_required" description:"是否需要审批"`
ApprovalInstanceID *uint `json:"approval_instance_id,omitempty" description:"审批实例 ID"`
PaidAmount *int64 `json:"paid_amount,omitempty" description:"实付金额(分)"`
PaidAt *time.Time `json:"paid_at,omitempty" description:"支付时间"`
ExpireAt *time.Time `json:"expire_at,omitempty" description:"支付截止时间"`
CompletedAt *time.Time `json:"completed_at,omitempty" description:"延期生效时间"`
ExceptionCode string `json:"exception_code,omitempty" description:"异常原因码"`
ExceptionSummary string `json:"exception_summary,omitempty" description:"异常说明"`
RefundNo string `json:"refund_no,omitempty" description:"原路退款单号(仅执行异常)"`
RefundAmount *int64 `json:"refund_amount,omitempty" description:"退款金额"`
RefundedAt *time.Time `json:"refunded_at,omitempty" description:"退款时间"`
CreatedBy *uint `json:"created_by,omitempty" description:"后台创建人"`
CreatedAt time.Time `json:"created_at" description:"创建时间"`
}
// SilenceSpecialItem 特殊延期的一条明细。
type SilenceSpecialItem struct {
PackageUsageID uint `json:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
Days int `json:"days" validate:"required,min=1,max=3650" required:"true" description:"延期天数(按 30 天向上取整)"`
}
// SilenceSpecialRequest 提交特殊延期(单个或批量)。
type SilenceSpecialRequest struct {
ExtensionType string `json:"extension_type" validate:"required,oneof=free discount complaint_compensation system_compensation special_customer" required:"true" description:"延期类型:free 免费 / discount 优惠价 / complaint_compensation 客诉补偿 / system_compensation 系统异常补偿 / special_customer 特殊客户政策"`
Items []SilenceSpecialItem `json:"items" validate:"required,min=1,max=1000,dive" required:"true" description:"明细(批量需 package_silence:extend_batch 权限)"`
Reason string `json:"reason" validate:"required,min=1,max=1000" required:"true" description:"原因"`
Basis string `json:"basis" validate:"omitempty,max=1000" description:"免费或优惠依据"`
EvidenceRefs []string `json:"evidence_refs" validate:"omitempty,max=10,dive,max=500" description:"客户申请记录或截图"`
Amount int64 `json:"amount" validate:"min=0" description:"费用(分,免费为 0;优惠价为实收合计)"`
ImportFileKey string `json:"import_file_key" validate:"omitempty,max=500" description:"批量导入的明细文件 Key"`
OfflinePaymentMethodID *uint `json:"offline_payment_method_id" description:"优惠价有收款时:线下收款方式"`
OfflineTradeNo string `json:"offline_trade_no" validate:"omitempty,max=128" description:"优惠价有收款时:交易单号"`
OfflinePaidAt *time.Time `json:"offline_paid_at" description:"优惠价有收款时:付款时间"`
PaymentVoucherKeys []string `json:"payment_voucher_keys" validate:"omitempty,max=5,dive,max=500" description:"优惠价有收款时:收款凭证"`
}
// SilenceBatchResponse 延期批次。
type SilenceBatchResponse struct {
ID uint `json:"id" description:"批次 ID"`
BatchNo string `json:"batch_no" description:"批次号"`
Path string `json:"path" description:"路径:online / offline / special / adjust"`
ExtensionType string `json:"extension_type" description:"延期类型"`
ApprovalRequired bool `json:"approval_required" description:"是否需要审批"`
ApprovalInstanceID *uint `json:"approval_instance_id,omitempty" description:"审批实例 ID"`
ApprovalStatus string `json:"approval_status,omitempty" description:"审批状态"`
Status string `json:"status" description:"批次状态"`
Reason string `json:"reason" description:"原因"`
Basis string `json:"basis,omitempty" description:"依据"`
EvidenceRefs []string `json:"evidence_refs" nullable:"false" description:"附件"`
Amount int64 `json:"amount" description:"费用(分)"`
RequestedBy uint `json:"requested_by" description:"发起人"`
RequestedAt time.Time `json:"requested_at" description:"发起时间"`
RequestedCount int `json:"requested_count" description:"明细数"`
SucceededCount int `json:"succeeded_count" description:"成功数"`
FailedCount int `json:"failed_count" description:"失败数"`
CompletedAt *time.Time `json:"completed_at,omitempty" description:"完成时间"`
Items []SilenceExtensionResponse `json:"items,omitempty" description:"明细"`
}
// SilenceExtensionResponse 延期明细。
type SilenceExtensionResponse struct {
ID uint `json:"id" description:"明细 ID"`
BatchID uint `json:"batch_id" description:"批次 ID"`
RowNo int `json:"row_no" description:"行号"`
PackageUsageID uint `json:"package_usage_id" description:"套餐记录 ID"`
PackageName string `json:"package_name" description:"套餐名称"`
AssetType string `json:"asset_type" description:"资产类型"`
AssetIdentifier string `json:"asset_identifier" description:"资产标识"`
ExtensionType string `json:"extension_type" description:"延期类型"`
InputDays int `json:"input_days" description:"输入天数"`
Months int `json:"months" description:"计费月数"`
ExtensionDays int `json:"extension_days" description:"延长天数"`
Amount int64 `json:"amount" description:"金额(分)"`
ExtensionOrderID *uint `json:"extension_order_id,omitempty" description:"延期订单 ID"`
BeforeDeadlineAt *time.Time `json:"before_deadline_at,omitempty" description:"延期前截止时间"`
AfterDeadlineAt *time.Time `json:"after_deadline_at,omitempty" description:"延期后截止时间"`
Status string `json:"status" description:"明细状态"`
FailureCode string `json:"failure_code,omitempty" description:"失败 / 异常原因码"`
FailureSummary string `json:"failure_summary,omitempty" description:"失败 / 异常说明"`
ExecutedAt *time.Time `json:"executed_at,omitempty" description:"执行时间"`
}
// SilenceExceptionHandleRequest 异常明细处理。
type SilenceExceptionHandleRequest struct {
Action string `json:"action" validate:"required,oneof=retry close" required:"true" description:"处理方式:retry 重试执行 / close 关闭(在线订单关闭时原路退款)"`
Reason string `json:"reason" validate:"required,min=1,max=500" required:"true" description:"处理原因"`
}
// SilenceRecordResponse 沉默期流水。
type SilenceRecordResponse struct {
ID uint `json:"id" description:"流水 ID"`
PackageUsageID uint `json:"package_usage_id" description:"套餐记录 ID"`
EventType string `json:"event_type" description:"事件:set/adjust/expired/ended/extend/exchange/backfill/realname_backfill"`
EventName string `json:"event_name" description:"事件名称"`
TriggerSource string `json:"trigger_source" description:"触发来源"`
AssetType string `json:"asset_type" description:"资产类型"`
AssetID uint `json:"asset_id" description:"资产 ID"`
BeforeStatus *string `json:"before_status,omitempty" description:"变更前状态"`
AfterStatus *string `json:"after_status,omitempty" description:"变更后状态"`
BeforeDeadlineAt *time.Time `json:"before_deadline_at,omitempty" description:"变更前截止时间"`
AfterDeadlineAt *time.Time `json:"after_deadline_at,omitempty" description:"变更后截止时间"`
PeriodDays *int `json:"period_days,omitempty" description:"沉默期天数"`
DefaultDays *int `json:"default_days,omitempty" description:"默认值快照"`
IsAdjusted bool `json:"is_adjusted" description:"是否调整"`
ChangeDays int `json:"change_days" description:"变化天数"`
OperatorID uint `json:"operator_id" description:"操作人"`
OperatorType string `json:"operator_type" description:"操作人类型"`
Reason string `json:"reason" description:"原因"`
ApprovalInstanceID *uint `json:"approval_instance_id,omitempty" description:"审批实例"`
BatchID *uint `json:"batch_id,omitempty" description:"批次"`
ExtensionID *uint `json:"extension_id,omitempty" description:"延期明细"`
ExchangeNo string `json:"exchange_no,omitempty" description:"换货单号"`
CreatedAt time.Time `json:"created_at" description:"时间"`
}
// SilenceOrderListRequest 延期订单列表请求。
type SilenceOrderListRequest struct {
Page int `json:"page" query:"page" validate:"omitempty,min=1" description:"页码"`
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" description:"每页数量"`
PackageUsageID *uint `json:"package_usage_id" query:"package_usage_id" description:"套餐记录 ID"`
PackageID *uint `json:"package_id" query:"package_id" description:"套餐 ID"`
AssetIdentifier string `json:"asset_identifier" query:"asset_identifier" validate:"omitempty,max=100" description:"资产标识(ICCID / 虚拟号 / IMEI)"`
OrderNo string `json:"order_no" query:"order_no" validate:"omitempty,max=40" description:"订单号"`
Status string `json:"status" query:"status" validate:"omitempty,oneof=pending_payment pending_approval rejected paid completed closed exception refunded" description:"状态"`
Source string `json:"source" query:"source" validate:"omitempty,oneof=client admin offline" description:"来源"`
PaymentMethod string `json:"payment_method" query:"payment_method" validate:"omitempty,oneof=wechat alipay offline" description:"支付方式"`
MerchantName string `json:"merchant_name" query:"merchant_name" validate:"omitempty,max=100" description:"收款商户名称(模糊)"`
ThirdPartyTradeNo string `json:"third_party_trade_no" query:"third_party_trade_no" validate:"omitempty,max=100" description:"交易流水号或线下交易单号"`
PaidStart string `json:"paid_start" query:"paid_start" description:"支付时间起(RFC3339)"`
PaidEnd string `json:"paid_end" query:"paid_end" description:"支付时间止(RFC3339)"`
}
// SilenceOrderPageResult 延期订单分页结果。
type SilenceOrderPageResult struct {
Items []*SilenceExtensionOrderResponse `json:"items" nullable:"false" description:"订单列表"`
Total int64 `json:"total" description:"总数"`
Page int `json:"page" description:"页码"`
PageSize int `json:"page_size" description:"每页数量"`
}
// SilenceBatchListRequest 延期批次列表请求。
type SilenceBatchListRequest struct {
Page int `json:"page" query:"page" validate:"omitempty,min=1" description:"页码"`
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" description:"每页数量"`
BatchNo string `json:"batch_no" query:"batch_no" validate:"omitempty,max=40" description:"批次号"`
Path string `json:"path" query:"path" validate:"omitempty,oneof=online offline special adjust" description:"路径"`
ExtensionType string `json:"extension_type" query:"extension_type" validate:"omitempty,max=30" description:"延期类型"`
Status string `json:"status" query:"status" validate:"omitempty,max=30" description:"批次状态"`
HasException *bool `json:"has_exception" query:"has_exception" description:"只看含异常明细的批次"`
}
// SilenceBatchPageResult 延期批次分页结果。
type SilenceBatchPageResult struct {
Items []*SilenceBatchResponse `json:"items" nullable:"false" description:"批次列表"`
Total int64 `json:"total" description:"总数"`
Page int `json:"page" description:"页码"`
PageSize int `json:"page_size" description:"每页数量"`
}
// SilenceUsageListRequest 即将过期 / 已过期套餐列表请求。
type SilenceUsageListRequest struct {
Page int `json:"page" query:"page" validate:"omitempty,min=1" description:"页码"`
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" description:"每页数量"`
View string `json:"view" query:"view" validate:"omitempty,oneof=expiring expired all" description:"视图:expiring 即将过期(默认 7 天内) / expired 已过期 / all 全部待实名与已过期"`
WithinDays int `json:"within_days" query:"within_days" validate:"omitempty,min=1,max=365" description:"即将过期的天数范围(默认 7)"`
AssetIdentifier string `json:"asset_identifier" query:"asset_identifier" validate:"omitempty,max=100" description:"资产标识"`
PackageID *uint `json:"package_id" query:"package_id" description:"套餐 ID"`
ShopID *uint `json:"shop_id" query:"shop_id" description:"资产所属店铺"`
DeadlineStart string `json:"deadline_start" query:"deadline_start" description:"截止时间起(RFC3339)"`
DeadlineEnd string `json:"deadline_end" query:"deadline_end" description:"截止时间止(RFC3339)"`
}
// SilenceUsageItem 即将过期 / 已过期套餐。
type SilenceUsageItem struct {
PackageUsageID uint `json:"package_usage_id" description:"套餐记录 ID"`
OrderNo string `json:"order_no" description:"订单号"`
PackageID uint `json:"package_id" description:"套餐 ID"`
PackageName string `json:"package_name" description:"套餐名称"`
AssetType string `json:"asset_type" description:"资产类型"`
AssetID uint `json:"asset_id" description:"资产 ID"`
AssetIdentifier string `json:"asset_identifier" description:"资产标识"`
ShopID *uint `json:"shop_id,omitempty" description:"资产所属店铺"`
ShopName string `json:"shop_name" description:"店铺名称"`
CreatedAt time.Time `json:"created_at" description:"购买时间"`
Silence *PackageSilenceView `json:"silence" description:"沉默期信息"`
}
// SilenceUsagePageResult 即将过期 / 已过期套餐分页。
type SilenceUsagePageResult struct {
Items []*SilenceUsageItem `json:"items" nullable:"false" description:"列表"`
Total int64 `json:"total" description:"总数"`
Page int `json:"page" description:"页码"`
PageSize int `json:"page_size" description:"每页数量"`
}
// SilenceIDPath 路径 ID。
type SilenceIDPath struct {
ID uint `json:"id" params:"id" path:"id" validate:"required,min=1" required:"true" description:"ID"`
}
// SilenceRecordListRequest 沉默期流水查询请求。
type SilenceRecordListRequest struct {
PackageUsageID uint `json:"package_usage_id" query:"package_usage_id" validate:"required,min=1" required:"true" description:"套餐记录 ID"`
}
// SilencePolicyMatchRequest 查询套餐当前匹配政策。
type SilencePolicyMatchRequest struct {
PackageID uint `json:"package_id" query:"package_id" validate:"required,min=1" required:"true" description:"套餐 ID"`
}
// AssetOutboundRecordRequest 出库记录查询。
type AssetOutboundRecordRequest struct {
AssetType string `json:"asset_type" params:"asset_type" path:"asset_type" validate:"required,oneof=card device iot_card" required:"true" description:"资产类型 card/iot_card/device"`
ID uint `json:"id" params:"id" path:"id" validate:"required,min=1" required:"true" description:"资产 ID"`
}
// AssetOutboundRecordResponse 出库记录。
type AssetOutboundRecordResponse struct {
ID uint `json:"id" description:"记录 ID"`
AssetType string `json:"asset_type" description:"资产类型"`
AssetID uint `json:"asset_id" description:"资产 ID"`
AssetIdentifier string `json:"asset_identifier" description:"资产标识快照"`
Generation int `json:"generation" description:"世代"`
OutboundAt time.Time `json:"outbound_at" description:"出库时间"`
Source string `json:"source" description:"来源:order / exchange / backfill"`
SourceName string `json:"source_name" description:"来源名称"`
OrderNo string `json:"order_no,omitempty" description:"订单号"`
ExchangeNo string `json:"exchange_no,omitempty" description:"换货单号"`
EndedAt *time.Time `json:"ended_at,omitempty" description:"该世代结束时间"`
EndReason string `json:"end_reason,omitempty" description:"结束原因:exchange_return 换货回库"`
CreatedAt time.Time `json:"created_at" description:"记录时间"`
}
// SilencePolicyUpdateParams 编辑延期政策(路径 ID + 请求体,仅用于接口文档)。
type SilencePolicyUpdateParams struct {
ID uint `json:"id" path:"id" required:"true" description:"政策 ID"`
SilencePolicyRequest
}
// SilencePolicyStatusParams 启停延期政策(路径 ID + 请求体,仅用于接口文档)。
type SilencePolicyStatusParams struct {
ID uint `json:"id" path:"id" required:"true" description:"政策 ID"`
SilencePolicyStatusRequest
}
// SilenceExceptionHandleParams 处理异常明细(路径 ID + 请求体,仅用于接口文档)。
type SilenceExceptionHandleParams struct {
ID uint `json:"id" path:"id" required:"true" description:"延期明细 ID"`
SilenceExceptionHandleRequest
}