All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 35m45s
ID 来自路径参数,请求体里没有;去掉请求体校验里的 ID 必填,路径 ID 由 handler 校验
469 lines
37 KiB
Go
469 lines
37 KiB
Go
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"`
|
||
}
|
||
|
||
// 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
|
||
}
|