Files
junhong_cmp_fiber/internal/model/dto/package_silence_dto.go
邹进 0138a3fb9c
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 25m44s
feat: 延期资格返回套餐名称、资产、订购时间、到期时间与沉默期截止时间
2026-11-07 22:50:37 +09:00

477 lines
38 KiB
Go
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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"`
PackageName string `json:"package_name,omitempty" description:"套餐名称"`
AssetIdentifier string `json:"asset_identifier,omitempty" description:"资产标识"`
PurchasedAt *time.Time `json:"purchased_at,omitempty" description:"套餐订购时间(购买支付成功时间)"`
ActivatedAt *time.Time `json:"activated_at,omitempty" description:"套餐生效时间(未实名激活时为空)"`
ExpiresAt *time.Time `json:"expires_at,omitempty" description:"套餐到期时间(未实名激活时为空)"`
SilenceDeadlineAt *time.Time `json:"silence_deadline_at,omitempty" description:"沉默期截止时间(截止日 23:59:59)"`
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(经商户池路由)"`
AppType string `json:"app_type" validate:"omitempty,oneof=official_account miniapp" description:"H5 微信支付时的应用类型:official_account / miniapp;传入时在微信内直接拉起支付(JSAPI),返回 pay_config"`
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:"支付内容(待支付时返回,前端渲染为二维码或跳转链接)"`
PayConfig *ClientPayConfig `json:"pay_config,omitempty" description:"微信内直接支付(JSAPI)参数,H5 带 app_type 下微信单时返回,前端用它拉起支付"`
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"`
}
// SilenceOrderCancelRequest 作废待支付延期订单请求。
type SilenceOrderCancelRequest struct {
// ID 来自路径参数,由 handler 单独校验;这里不加 validate,否则解析请求体时一律报"必须大于 0"
ID uint `json:"-" params:"id" path:"id" required:"true" description:"延期订单 ID"`
Reason string `json:"reason" validate:"omitempty,max=200" maxLength:"200" description:"作废原因(选填)"`
}
// 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"`
}
// AssetFirstPurchaseRecordRequest 首次购买套餐记录查询。
type AssetFirstPurchaseRecordRequest 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"`
}
// AssetFirstPurchaseRecordResponse 首次购买套餐记录。
type AssetFirstPurchaseRecordResponse 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:"世代"`
FirstPurchaseAt time.Time `json:"first_purchase_at" description:"首次购买套餐时间"`
Source string `json:"source" description:"来源:order 首次购买套餐 / backfill 历史回填"`
SourceName string `json:"source_name" description:"来源名称"`
OrderNo string `json:"order_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
}