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 / topup)。 Kind string `json:"kind"` // Data 具体快照数据(按 Kind 对应不同结构)。 Data json.RawMessage `json:"data"` } type ordersSnapshotWire struct { Kind string `json:"kind"` Data json.RawMessage `json:"data"` } func (s *OrdersSnapshot) UnmarshalJSON(b []byte) error { var w ordersSnapshotWire if err := json.Unmarshal(b, &w); err == nil && (w.Kind != "" || w.Data != nil) { s.Kind = w.Kind s.Data = w.Data return nil } // 兼容旧结构:旧 snapshot 通常是一个扁平对象(没有 kind/data)。 s.Kind = "legacy" s.Data = append(s.Data[:0], b...) 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"` } // OrdersTopupSnapshot 为“后台充值订单”的快照(用于审计与追责)。 type OrdersTopupSnapshot struct { // OperatorUserID 充值操作人用户ID(租户管理员)。 OperatorUserID int64 `json:"operator_user_id"` // TargetUserID 充值目标用户ID(租户成员)。 TargetUserID int64 `json:"target_user_id"` // Amount 充值金额(分)。 Amount int64 `json:"amount"` // Currency 币种:当前固定 CNY(金额单位为分)。 Currency consts.Currency `json:"currency"` // Reason 充值原因(可选,强烈建议填写用于审计)。 Reason string `json:"reason,omitempty"` // IdempotencyKey 幂等键(可选)。 IdempotencyKey string `json:"idempotency_key,omitempty"` // TopupAt 充值时间(逻辑时间)。 TopupAt time.Time `json:"topup_at"` }