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"` } // 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 }