feat: 实名即生效套餐沉默期、延期办理与资产出库时间
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8m39s
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:
@@ -35,6 +35,7 @@ type Device struct {
|
||||
FirstRechargeTriggeredBySeriesJSON string `gorm:"column:first_recharge_triggered_by_series;type:jsonb;default:'{}';comment:按套餐系列追踪的首充触发状态" json:"-"`
|
||||
AssetStatus int `gorm:"column:asset_status;type:int;not null;default:1;comment:业务状态 1-在库 2-已销售 3-已换货 4-已停用" json:"asset_status"`
|
||||
Generation int `gorm:"column:generation;type:int;not null;default:1;comment:资产世代编号" json:"generation"`
|
||||
OutboundAt *time.Time `gorm:"column:outbound_at;comment:出库时间(当前世代首次购买套餐的支付时间)" json:"outbound_at,omitempty"`
|
||||
// EnablePolling 是否参与轮询,false 时设备下所有卡不加入轮询队列
|
||||
EnablePolling bool `gorm:"column:enable_polling;not null;default:true" json:"enable_polling"`
|
||||
// 以下字段由 Gateway sync-info 接口同步,有离线存储意义
|
||||
|
||||
@@ -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 后台资产套餐历史分页结果。
|
||||
|
||||
@@ -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 资产套餐历史层级响应。
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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)"`
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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 更新套餐聚合参数
|
||||
|
||||
462
internal/model/dto/package_silence_dto.go
Normal file
462
internal/model/dto/package_silence_dto.go
Normal 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
|
||||
}
|
||||
@@ -51,6 +51,7 @@ type IotCard struct {
|
||||
StopReason string `gorm:"column:stop_reason;type:varchar(50);comment:停机原因(traffic_exhausted=流量耗尽,manual=手动停机,arrears=欠费)" json:"stop_reason,omitempty"`
|
||||
AssetStatus int `gorm:"column:asset_status;type:int;not null;default:1;comment:业务状态 1-在库 2-已销售 3-已换货 4-已停用" json:"asset_status"`
|
||||
Generation int `gorm:"column:generation;type:int;not null;default:1;comment:资产世代编号" json:"generation"`
|
||||
OutboundAt *time.Time `gorm:"column:outbound_at;comment:出库时间(当前世代首次购买套餐的支付时间)" json:"outbound_at,omitempty"`
|
||||
IsStandalone bool `gorm:"column:is_standalone;type:boolean;default:true;not null;comment:是否为独立卡(未绑定设备) 由触发器自动维护" json:"is_standalone"`
|
||||
VirtualNo string `gorm:"column:virtual_no;type:varchar(50);uniqueIndex:idx_iot_card_virtual_no,where:deleted_at IS NULL AND virtual_no IS NOT NULL AND virtual_no <> '';comment:虚拟号(可选,非空时全局唯一)" json:"virtual_no,omitempty"`
|
||||
DeviceVirtualNo string `gorm:"column:device_virtual_no;type:varchar(100);not null;default:'';comment:绑定设备的虚拟号快照(未绑定时为空字符串)" json:"device_virtual_no"`
|
||||
|
||||
@@ -50,6 +50,10 @@ type Package struct {
|
||||
// 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"`
|
||||
// SilencePeriodDays 实名即生效套餐的默认沉默期(1~90 天),普通套餐为空;为空时新购买不进入沉默期
|
||||
SilencePeriodDays *int `gorm:"column:silence_period_days;type:int;comment:默认沉默期天数" json:"silence_period_days,omitempty"`
|
||||
// SilenceExtensionEnabled 是否支持付费延期(不支持时仍可申请特殊延期)
|
||||
SilenceExtensionEnabled bool `gorm:"column:silence_extension_enabled;type:boolean;not null;default:true;comment:是否支持付费延期" json:"silence_extension_enabled"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
@@ -96,6 +100,18 @@ type PackageUsage struct {
|
||||
LastResetAt *time.Time `gorm:"column:last_reset_at;comment:最后一次流量重置时间" json:"last_reset_at"`
|
||||
NextResetAt *time.Time `gorm:"column:next_reset_at;index:idx_package_usage_next_reset_at;comment:下次流量重置时间(用于定时任务查询)" json:"next_reset_at"`
|
||||
Generation int `gorm:"column:generation;type:int;not null;default:1;comment:资产世代编号" json:"generation"`
|
||||
|
||||
// 沉默期字段(按每笔套餐计算,见 add-package-silence-period)
|
||||
SilenceStatus *string `gorm:"column:silence_status;type:varchar(16);comment:沉默期状态 waiting/expired/ended" json:"silence_status,omitempty"`
|
||||
SilenceStartAt *time.Time `gorm:"column:silence_start_at;comment:沉默期起算时间" json:"silence_start_at,omitempty"`
|
||||
SilencePeriodDays *int `gorm:"column:silence_period_days;type:int;comment:最终沉默期天数" json:"silence_period_days,omitempty"`
|
||||
SilenceDeadlineAt *time.Time `gorm:"column:silence_deadline_at;comment:当前沉默期截止时间" json:"silence_deadline_at,omitempty"`
|
||||
SilenceExtendedDays int `gorm:"column:silence_extended_days;type:int;not null;default:0;comment:累计已延期天数" json:"silence_extended_days"`
|
||||
SilencePaidExtendedDays int `gorm:"column:silence_paid_extended_days;type:int;not null;default:0;comment:付费延期累计天数" json:"silence_paid_extended_days"`
|
||||
SilenceExtensionCount int `gorm:"column:silence_extension_count;type:int;not null;default:0;comment:累计延期次数" json:"silence_extension_count"`
|
||||
SilenceFreeExtensionUsed int `gorm:"column:silence_free_extension_used;type:int;not null;default:0;comment:已用免费延期次数" json:"silence_free_extension_used"`
|
||||
SilenceExpiredAt *time.Time `gorm:"column:silence_expired_at;comment:最近一次沉默期过期时间" json:"silence_expired_at,omitempty"`
|
||||
SilenceAdjustPending bool `gorm:"column:silence_adjust_pending;type:boolean;not null;default:false;comment:购买时调整审批进行中" json:"silence_adjust_pending"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
|
||||
243
internal/model/package_silence.go
Normal file
243
internal/model/package_silence.go
Normal file
@@ -0,0 +1,243 @@
|
||||
package model
|
||||
|
||||
import (
|
||||
"time"
|
||||
|
||||
"gorm.io/datatypes"
|
||||
"gorm.io/gorm"
|
||||
)
|
||||
|
||||
// PackageSilenceExtensionPolicy 沉默期延期政策。
|
||||
// 匹配优先级:指定套餐 > 套餐系列 > 全部套餐;同一优先级适用范围与生效时间段不得重叠。
|
||||
type PackageSilenceExtensionPolicy struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
Name string `gorm:"column:name;type:varchar(100);not null;comment:政策名称" json:"name"`
|
||||
ScopeType string `gorm:"column:scope_type;type:varchar(20);not null;comment:适用范围 all/series/package" json:"scope_type"`
|
||||
ScopeIDs UintJSONBArray `gorm:"column:scope_ids;type:jsonb;not null;default:'[]';comment:系列或套餐ID列表" json:"scope_ids"`
|
||||
UnitPrice int64 `gorm:"column:unit_price;type:bigint;not null;comment:单价(分/月)" json:"unit_price"`
|
||||
FreeExtensionLimit int `gorm:"column:free_extension_limit;type:int;not null;default:1;comment:免费延期次数" json:"free_extension_limit"`
|
||||
PaidMaxMonths int `gorm:"column:paid_max_months;type:int;not null;default:6;comment:付费延期累计最多月数" json:"paid_max_months"`
|
||||
SingleMaxMonths *int `gorm:"column:single_max_months;type:int;comment:单次付费延期最多月数" json:"single_max_months,omitempty"`
|
||||
ApprovalExemptTypes StringJSONBArray `gorm:"column:approval_exempt_types;type:jsonb;not null;default:'[]';comment:免审批场景" json:"approval_exempt_types"`
|
||||
EffectiveFrom time.Time `gorm:"column:effective_from;not null;comment:生效时间" json:"effective_from"`
|
||||
EffectiveTo *time.Time `gorm:"column:effective_to;comment:失效时间" json:"effective_to,omitempty"`
|
||||
Status int `gorm:"column:status;type:smallint;not null;default:1;comment:状态 0-停用 1-启用" json:"status"`
|
||||
Remark string `gorm:"column:remark;type:varchar(500);not null;default:'';comment:备注" json:"remark"`
|
||||
Creator uint `gorm:"column:creator;not null;default:0" json:"creator"`
|
||||
Updater uint `gorm:"column:updater;not null;default:0" json:"updater"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
UpdatedAt time.Time `gorm:"column:updated_at;not null;default:CURRENT_TIMESTAMP" json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"column:deleted_at;index" json:"-"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (PackageSilenceExtensionPolicy) TableName() string {
|
||||
return "tb_package_silence_extension_policy"
|
||||
}
|
||||
|
||||
// PackageSilenceRecord 套餐沉默期变更流水(只新增不修改)。
|
||||
type PackageSilenceRecord struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
PackageUsageID uint `gorm:"column:package_usage_id;not null" json:"package_usage_id"`
|
||||
EventType string `gorm:"column:event_type;type:varchar(30);not null" json:"event_type"`
|
||||
TriggerSource string `gorm:"column:trigger_source;type:varchar(40);not null;default:''" json:"trigger_source"`
|
||||
AssetType string `gorm:"column:asset_type;type:varchar(20);not null;default:''" json:"asset_type"`
|
||||
AssetID uint `gorm:"column:asset_id;not null;default:0" json:"asset_id"`
|
||||
BeforeStatus *string `gorm:"column:before_status;type:varchar(16)" json:"before_status,omitempty"`
|
||||
AfterStatus *string `gorm:"column:after_status;type:varchar(16)" json:"after_status,omitempty"`
|
||||
BeforeDeadlineAt *time.Time `gorm:"column:before_deadline_at" json:"before_deadline_at,omitempty"`
|
||||
AfterDeadlineAt *time.Time `gorm:"column:after_deadline_at" json:"after_deadline_at,omitempty"`
|
||||
PeriodDays *int `gorm:"column:period_days" json:"period_days,omitempty"`
|
||||
DefaultDaysSnapshot *int `gorm:"column:default_days_snapshot" json:"default_days_snapshot,omitempty"`
|
||||
IsAdjusted bool `gorm:"column:is_adjusted;not null;default:false" json:"is_adjusted"`
|
||||
ChangeDays int `gorm:"column:change_days;not null;default:0" json:"change_days"`
|
||||
OperatorID uint `gorm:"column:operator_id;not null;default:0" json:"operator_id"`
|
||||
OperatorType string `gorm:"column:operator_type;type:varchar(20);not null;default:''" json:"operator_type"`
|
||||
Reason string `gorm:"column:reason;type:varchar(500);not null;default:''" json:"reason"`
|
||||
ApprovalInstanceID *uint `gorm:"column:approval_instance_id" json:"approval_instance_id,omitempty"`
|
||||
BatchID *uint `gorm:"column:batch_id" json:"batch_id,omitempty"`
|
||||
ExtensionID *uint `gorm:"column:extension_id" json:"extension_id,omitempty"`
|
||||
ExchangeOrderID *uint `gorm:"column:exchange_order_id" json:"exchange_order_id,omitempty"`
|
||||
ExchangeNo string `gorm:"column:exchange_no;type:varchar(64);not null;default:''" json:"exchange_no"`
|
||||
RealnameAt *time.Time `gorm:"column:realname_at" json:"realname_at,omitempty"`
|
||||
Extra datatypes.JSON `gorm:"column:extra;type:jsonb;not null;default:'{}'" json:"extra"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (PackageSilenceRecord) TableName() string {
|
||||
return "tb_package_silence_record"
|
||||
}
|
||||
|
||||
// PackageSilenceExtensionBatch 沉默期申请批次:每次延期或购买时调整都建一个批次,企微审批实例关联批次。
|
||||
type PackageSilenceExtensionBatch struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
BatchNo string `gorm:"column:batch_no;type:varchar(40);not null" json:"batch_no"`
|
||||
Path string `gorm:"column:path;type:varchar(20);not null" json:"path"`
|
||||
ExtensionType string `gorm:"column:extension_type;type:varchar(30);not null" json:"extension_type"`
|
||||
ApprovalRequired bool `gorm:"column:approval_required;not null;default:false" json:"approval_required"`
|
||||
Reason string `gorm:"column:reason;type:varchar(1000);not null;default:''" json:"reason"`
|
||||
EvidenceRefs StringJSONBArray `gorm:"column:evidence_refs;type:jsonb;not null;default:'[]'" json:"evidence_refs"`
|
||||
Basis string `gorm:"column:basis;type:varchar(1000);not null;default:''" json:"basis"`
|
||||
ImportFileKey string `gorm:"column:import_file_key;type:varchar(500);not null;default:''" json:"import_file_key"`
|
||||
PolicyID *uint `gorm:"column:policy_id" json:"policy_id,omitempty"`
|
||||
PolicyNameSnapshot string `gorm:"column:policy_name_snapshot;type:varchar(100);not null;default:''" json:"policy_name_snapshot"`
|
||||
UnitPriceSnapshot int64 `gorm:"column:unit_price_snapshot;not null;default:0" json:"unit_price_snapshot"`
|
||||
ApprovalExemptTypesSnapshot StringJSONBArray `gorm:"column:approval_exempt_types_snapshot;type:jsonb;not null;default:'[]'" json:"approval_exempt_types_snapshot"`
|
||||
FreeExtensionLimitSnapshot int `gorm:"column:free_extension_limit_snapshot;not null;default:1" json:"free_extension_limit_snapshot"`
|
||||
PaidMaxMonthsSnapshot int `gorm:"column:paid_max_months_snapshot;not null;default:0" json:"paid_max_months_snapshot"`
|
||||
SingleMaxMonthsSnapshot *int `gorm:"column:single_max_months_snapshot" json:"single_max_months_snapshot,omitempty"`
|
||||
AdjustPackageUsageID *uint `gorm:"column:adjust_package_usage_id" json:"adjust_package_usage_id,omitempty"`
|
||||
AdjustDefaultDays *int `gorm:"column:adjust_default_days" json:"adjust_default_days,omitempty"`
|
||||
AdjustRequestedDays *int `gorm:"column:adjust_requested_days" json:"adjust_requested_days,omitempty"`
|
||||
Amount int64 `gorm:"column:amount;not null;default:0" json:"amount"`
|
||||
OfflinePaymentMethodID *uint `gorm:"column:offline_payment_method_id" json:"offline_payment_method_id,omitempty"`
|
||||
OfflinePaymentMethodCode *string `gorm:"column:offline_payment_method_code;type:varchar(64)" json:"offline_payment_method_code,omitempty"`
|
||||
OfflinePaymentMethodName *string `gorm:"column:offline_payment_method_name;type:varchar(100)" json:"offline_payment_method_name,omitempty"`
|
||||
OfflineTradeNo *string `gorm:"column:offline_trade_no;type:varchar(128)" json:"offline_trade_no,omitempty"`
|
||||
OfflinePaidAmount *int64 `gorm:"column:offline_paid_amount" json:"offline_paid_amount,omitempty"`
|
||||
OfflinePaidAt *time.Time `gorm:"column:offline_paid_at" json:"offline_paid_at,omitempty"`
|
||||
PaymentVoucherKeys StringJSONBArray `gorm:"column:payment_voucher_keys;type:jsonb;not null;default:'[]'" json:"payment_voucher_keys"`
|
||||
RequestedBy uint `gorm:"column:requested_by;not null;default:0" json:"requested_by"`
|
||||
RequestedByType string `gorm:"column:requested_by_type;type:varchar(20);not null;default:''" json:"requested_by_type"`
|
||||
RequestedAt time.Time `gorm:"column:requested_at;not null" json:"requested_at"`
|
||||
ApprovalInstanceID *uint `gorm:"column:approval_instance_id" json:"approval_instance_id,omitempty"`
|
||||
ApprovalStatus string `gorm:"column:approval_status;type:varchar(20);not null;default:''" json:"approval_status"`
|
||||
ApprovalFinishedAt *time.Time `gorm:"column:approval_finished_at" json:"approval_finished_at,omitempty"`
|
||||
Status string `gorm:"column:status;type:varchar(30);not null" json:"status"`
|
||||
RequestedCount int `gorm:"column:requested_count;not null;default:0" json:"requested_count"`
|
||||
SucceededCount int `gorm:"column:succeeded_count;not null;default:0" json:"succeeded_count"`
|
||||
FailedCount int `gorm:"column:failed_count;not null;default:0" json:"failed_count"`
|
||||
CompletedAt *time.Time `gorm:"column:completed_at" json:"completed_at,omitempty"`
|
||||
ShopIDTag uint `gorm:"column:shop_id_tag;not null;default:0" json:"shop_id_tag"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
UpdatedAt time.Time `gorm:"column:updated_at;not null;default:CURRENT_TIMESTAMP" json:"updated_at"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (PackageSilenceExtensionBatch) TableName() string {
|
||||
return "tb_package_silence_extension_batch"
|
||||
}
|
||||
|
||||
// PackageSilenceExtension 沉默期延期明细(延期事实),以明细状态条件更新保证幂等。
|
||||
type PackageSilenceExtension struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
BatchID uint `gorm:"column:batch_id;not null" json:"batch_id"`
|
||||
RowNo int `gorm:"column:row_no;not null;default:1" json:"row_no"`
|
||||
PackageUsageID uint `gorm:"column:package_usage_id;not null" json:"package_usage_id"`
|
||||
PackageID uint `gorm:"column:package_id;not null;default:0" json:"package_id"`
|
||||
PackageNameSnapshot string `gorm:"column:package_name_snapshot;type:varchar(255);not null;default:''" json:"package_name_snapshot"`
|
||||
AssetType string `gorm:"column:asset_type;type:varchar(20);not null;default:''" json:"asset_type"`
|
||||
AssetID uint `gorm:"column:asset_id;not null;default:0" json:"asset_id"`
|
||||
AssetIdentifierSnapshot string `gorm:"column:asset_identifier_snapshot;type:varchar(100);not null;default:''" json:"asset_identifier_snapshot"`
|
||||
ExtensionType string `gorm:"column:extension_type;type:varchar(30);not null" json:"extension_type"`
|
||||
InputDays int `gorm:"column:input_days;not null" json:"input_days"`
|
||||
Months int `gorm:"column:months;not null" json:"months"`
|
||||
ExtensionDays int `gorm:"column:extension_days;not null" json:"extension_days"`
|
||||
UnitPriceSnapshot int64 `gorm:"column:unit_price_snapshot;not null;default:0" json:"unit_price_snapshot"`
|
||||
Amount int64 `gorm:"column:amount;not null;default:0" json:"amount"`
|
||||
ExtensionOrderID *uint `gorm:"column:extension_order_id" json:"extension_order_id,omitempty"`
|
||||
BeforeDeadlineAt *time.Time `gorm:"column:before_deadline_at" json:"before_deadline_at,omitempty"`
|
||||
AfterDeadlineAt *time.Time `gorm:"column:after_deadline_at" json:"after_deadline_at,omitempty"`
|
||||
Status string `gorm:"column:status;type:varchar(20);not null" json:"status"`
|
||||
FailureCode string `gorm:"column:failure_code;type:varchar(64);not null;default:''" json:"failure_code"`
|
||||
FailureSummary string `gorm:"column:failure_summary;type:varchar(500);not null;default:''" json:"failure_summary"`
|
||||
ExecutedAt *time.Time `gorm:"column:executed_at" json:"executed_at,omitempty"`
|
||||
HandledBy uint `gorm:"column:handled_by;not null;default:0" json:"handled_by"`
|
||||
HandledAt *time.Time `gorm:"column:handled_at" json:"handled_at,omitempty"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
UpdatedAt time.Time `gorm:"column:updated_at;not null;default:CURRENT_TIMESTAMP" json:"updated_at"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (PackageSilenceExtension) TableName() string {
|
||||
return "tb_package_silence_extension"
|
||||
}
|
||||
|
||||
// PackageSilenceExtensionOrder 沉默期延期订单(交易记录),在线支付复用 tb_payment(order_type = silence_extension)。
|
||||
type PackageSilenceExtensionOrder struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
OrderNo string `gorm:"column:order_no;type:varchar(40);not null" json:"order_no"`
|
||||
BatchID uint `gorm:"column:batch_id;not null" json:"batch_id"`
|
||||
PackageUsageID uint `gorm:"column:package_usage_id;not null" json:"package_usage_id"`
|
||||
PackageID uint `gorm:"column:package_id;not null" json:"package_id"`
|
||||
PackageNameSnapshot string `gorm:"column:package_name_snapshot;type:varchar(255);not null;default:''" json:"package_name_snapshot"`
|
||||
AssetType string `gorm:"column:asset_type;type:varchar(20);not null" json:"asset_type"`
|
||||
AssetID uint `gorm:"column:asset_id;not null" json:"asset_id"`
|
||||
AssetIdentifierSnapshot string `gorm:"column:asset_identifier_snapshot;type:varchar(100);not null;default:''" json:"asset_identifier_snapshot"`
|
||||
ShopID uint `gorm:"column:shop_id;not null;default:0" json:"shop_id"`
|
||||
CustomerID *uint `gorm:"column:customer_id" json:"customer_id,omitempty"`
|
||||
Source string `gorm:"column:source;type:varchar(20);not null" json:"source"`
|
||||
CreatedBy *uint `gorm:"column:created_by" json:"created_by,omitempty"`
|
||||
EvidenceRefs StringJSONBArray `gorm:"column:evidence_refs;type:jsonb;not null;default:'[]'" json:"evidence_refs"`
|
||||
InputDays int `gorm:"column:input_days;not null" json:"input_days"`
|
||||
Months int `gorm:"column:months;not null" json:"months"`
|
||||
ExtensionDays int `gorm:"column:extension_days;not null" json:"extension_days"`
|
||||
PolicyID *uint `gorm:"column:policy_id" json:"policy_id,omitempty"`
|
||||
PolicyNameSnapshot string `gorm:"column:policy_name_snapshot;type:varchar(100);not null;default:''" json:"policy_name_snapshot"`
|
||||
UnitPrice int64 `gorm:"column:unit_price;not null" json:"unit_price"`
|
||||
ApprovalExemptTypesSnapshot StringJSONBArray `gorm:"column:approval_exempt_types_snapshot;type:jsonb;not null;default:'[]'" json:"approval_exempt_types_snapshot"`
|
||||
FreeExtensionLimitSnapshot int `gorm:"column:free_extension_limit_snapshot;not null;default:1" json:"free_extension_limit_snapshot"`
|
||||
PaidMaxMonthsSnapshot int `gorm:"column:paid_max_months_snapshot;not null;default:0" json:"paid_max_months_snapshot"`
|
||||
SingleMaxMonthsSnapshot *int `gorm:"column:single_max_months_snapshot" json:"single_max_months_snapshot,omitempty"`
|
||||
Amount int64 `gorm:"column:amount;not null" json:"amount"`
|
||||
BeforeDeadlineAt time.Time `gorm:"column:before_deadline_at;not null" json:"before_deadline_at"`
|
||||
ExpectedDeadlineAt time.Time `gorm:"column:expected_deadline_at;not null" json:"expected_deadline_at"`
|
||||
Status string `gorm:"column:status;type:varchar(20);not null" json:"status"`
|
||||
PaymentMethod string `gorm:"column:payment_method;type:varchar(20);not null" json:"payment_method"`
|
||||
OfflinePaymentMethodID *uint `gorm:"column:offline_payment_method_id" json:"offline_payment_method_id,omitempty"`
|
||||
OfflinePaymentMethodCode *string `gorm:"column:offline_payment_method_code;type:varchar(64)" json:"offline_payment_method_code,omitempty"`
|
||||
OfflinePaymentMethodName *string `gorm:"column:offline_payment_method_name;type:varchar(100)" json:"offline_payment_method_name,omitempty"`
|
||||
OfflineTradeNo *string `gorm:"column:offline_trade_no;type:varchar(128)" json:"offline_trade_no,omitempty"`
|
||||
PaymentVoucherKeys StringJSONBArray `gorm:"column:payment_voucher_keys;type:jsonb;not null;default:'[]'" json:"payment_voucher_keys"`
|
||||
ApprovalRequired bool `gorm:"column:approval_required;not null;default:false" json:"approval_required"`
|
||||
ApprovalInstanceID *uint `gorm:"column:approval_instance_id" json:"approval_instance_id,omitempty"`
|
||||
PaidPaymentID *uint `gorm:"column:paid_payment_id" json:"paid_payment_id,omitempty"`
|
||||
PaidAmount *int64 `gorm:"column:paid_amount" json:"paid_amount,omitempty"`
|
||||
PaidAt *time.Time `gorm:"column:paid_at" json:"paid_at,omitempty"`
|
||||
ExpireAt *time.Time `gorm:"column:expire_at" json:"expire_at,omitempty"`
|
||||
ExtensionID *uint `gorm:"column:extension_id" json:"extension_id,omitempty"`
|
||||
CompletedAt *time.Time `gorm:"column:completed_at" json:"completed_at,omitempty"`
|
||||
ClosedAt *time.Time `gorm:"column:closed_at" json:"closed_at,omitempty"`
|
||||
CloseReason string `gorm:"column:close_reason;type:varchar(200);not null;default:''" json:"close_reason"`
|
||||
ExceptionCode string `gorm:"column:exception_code;type:varchar(64);not null;default:''" json:"exception_code"`
|
||||
ExceptionSummary string `gorm:"column:exception_summary;type:varchar(500);not null;default:''" json:"exception_summary"`
|
||||
RefundNo *string `gorm:"column:refund_no;type:varchar(64)" json:"refund_no,omitempty"`
|
||||
RefundAmount *int64 `gorm:"column:refund_amount" json:"refund_amount,omitempty"`
|
||||
RefundedAt *time.Time `gorm:"column:refunded_at" json:"refunded_at,omitempty"`
|
||||
RefundReason *string `gorm:"column:refund_reason;type:varchar(500)" json:"refund_reason,omitempty"`
|
||||
RequestID *string `gorm:"column:request_id;type:varchar(64)" json:"request_id,omitempty"`
|
||||
ShopIDTag uint `gorm:"column:shop_id_tag;not null;default:0" json:"shop_id_tag"`
|
||||
EnterpriseIDTag *uint `gorm:"column:enterprise_id_tag" json:"enterprise_id_tag,omitempty"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
UpdatedAt time.Time `gorm:"column:updated_at;not null;default:CURRENT_TIMESTAMP" json:"updated_at"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (PackageSilenceExtensionOrder) TableName() string {
|
||||
return "tb_package_silence_extension_order"
|
||||
}
|
||||
|
||||
// AssetOutboundRecord 资产出库记录:每个世代一条,只新增与填写结束信息。
|
||||
type AssetOutboundRecord struct {
|
||||
ID uint `gorm:"column:id;primaryKey" json:"id"`
|
||||
AssetType string `gorm:"column:asset_type;type:varchar(20);not null" json:"asset_type"`
|
||||
AssetID uint `gorm:"column:asset_id;not null" json:"asset_id"`
|
||||
AssetIdentifierSnapshot string `gorm:"column:asset_identifier_snapshot;type:varchar(100);not null;default:''" json:"asset_identifier_snapshot"`
|
||||
Generation int `gorm:"column:generation;not null" json:"generation"`
|
||||
OutboundAt time.Time `gorm:"column:outbound_at;not null" json:"outbound_at"`
|
||||
Source string `gorm:"column:source;type:varchar(20);not null" json:"source"`
|
||||
OrderID *uint `gorm:"column:order_id" json:"order_id,omitempty"`
|
||||
OrderNo string `gorm:"column:order_no;type:varchar(40);not null;default:''" json:"order_no"`
|
||||
ExchangeOrderID *uint `gorm:"column:exchange_order_id" json:"exchange_order_id,omitempty"`
|
||||
ExchangeNo string `gorm:"column:exchange_no;type:varchar(64);not null;default:''" json:"exchange_no"`
|
||||
ShopID *uint `gorm:"column:shop_id" json:"shop_id,omitempty"`
|
||||
EndedAt *time.Time `gorm:"column:ended_at" json:"ended_at,omitempty"`
|
||||
EndReason string `gorm:"column:end_reason;type:varchar(40);not null;default:''" json:"end_reason"`
|
||||
CreatedAt time.Time `gorm:"column:created_at;not null;default:CURRENT_TIMESTAMP" json:"created_at"`
|
||||
}
|
||||
|
||||
// TableName 指定表名
|
||||
func (AssetOutboundRecord) TableName() string {
|
||||
return "tb_asset_outbound_record"
|
||||
}
|
||||
Reference in New Issue
Block a user