package fields import ( "encoding/json" "time" "quyun/v2/pkg/consts" ) // OrdersSnapshot 是 orders.snapshot 的统一包裹结构(判别联合)。 // // 设计目标: // - 同一字段支持多种快照结构(按 kind 区分)。 // - 查询/展示时可以先看 kind,再按需解析 data。 // - 兼容历史数据:如果旧数据没有 kind/data,则按 legacy 处理(data = 原始 JSON)。 type OrdersSnapshot struct { // Kind 快照类型:建议与订单类型对齐(例如 content_purchase)。 Kind string `json:"kind"` // Data 具体快照数据(按 Kind 对应不同结构)。 Data json.RawMessage `json:"data"` } type ordersSnapshotWire struct { Kind string `json:"kind"` Data json.RawMessage `json:"data"` } func (snapshot *OrdersSnapshot) UnmarshalJSON(raw []byte) error { var wire ordersSnapshotWire if err := json.Unmarshal(raw, &wire); err == nil && (wire.Kind != "" || wire.Data != nil) { snapshot.Kind = wire.Kind snapshot.Data = wire.Data return nil } // 兼容旧结构:旧 snapshot 通常是一个扁平对象(没有 kind/data)。 snapshot.Kind = "legacy" snapshot.Data = append(snapshot.Data[:0], raw...) return nil } // OrdersContentPurchaseSnapshot 为“内容购买订单”的下单快照(用于历史展示与争议审计)。 type OrdersContentPurchaseSnapshot struct { // ContentID 内容ID。 ContentID int64 `json:"content_id"` // ContentTitle 内容标题(下单时快照,避免事后改名影响历史订单展示)。 ContentTitle string `json:"content_title"` // ContentUserID 内容作者用户ID(用于审计与后续分成扩展)。 ContentUserID int64 `json:"content_user_id"` // ContentVisibility 下单时的可见性快照。 ContentVisibility consts.ContentVisibility `json:"content_visibility"` // PreviewSeconds 下单时的试看秒数快照。 PreviewSeconds int32 `json:"preview_seconds"` // PreviewDownloadable 下单时的试看是否可下载快照(当前固定为 false)。 PreviewDownloadable bool `json:"preview_downloadable"` // Currency 币种:当前固定 CNY(金额单位为分)。 Currency consts.Currency `json:"currency"` // PriceAmount 基础价格(分)。 PriceAmount int64 `json:"price_amount"` // DiscountType 折扣类型(none/percent/amount)。 DiscountType consts.DiscountType `json:"discount_type"` // DiscountValue 折扣值(percent=0-100;amount=分)。 DiscountValue int64 `json:"discount_value"` // DiscountStartAt 折扣开始时间(可选)。 DiscountStartAt *time.Time `json:"discount_start_at,omitempty"` // DiscountEndAt 折扣结束时间(可选)。 DiscountEndAt *time.Time `json:"discount_end_at,omitempty"` // AmountOriginal 原价金额(分)。 AmountOriginal int64 `json:"amount_original"` // AmountDiscount 优惠金额(分)。 AmountDiscount int64 `json:"amount_discount"` // AmountPaid 实付金额(分)。 AmountPaid int64 `json:"amount_paid"` // PurchaseAt 下单时间(逻辑时间)。 PurchaseAt time.Time `json:"purchase_at"` // PurchaseIdempotency 幂等键(可选)。 PurchaseIdempotency string `json:"purchase_idempotency_key,omitempty"` // PurchasePricingNotes 价格计算补充说明(可选,便于排查争议)。 PurchasePricingNotes string `json:"purchase_pricing_notes,omitempty"` } // OrdersWithdrawalSnapshot 为“创作者提现订单”的快照信息(用于打款核对与审计追溯)。 type OrdersWithdrawalSnapshot struct { // Method 提现方式(wallet/external)。 Method string `json:"method"` // AccountID 收款账户ID(来源 payout_accounts)。 AccountID int64 `json:"account_id"` // AccountType 收款账户类型(bank/alipay)。 AccountType string `json:"account_type"` // AccountName 收款账户名称/开户行。 AccountName string `json:"account_name"` // Account 收款账号。 Account string `json:"account"` // AccountRealname 收款人姓名。 AccountRealname string `json:"account_realname"` }