Rogee
683965ae39
- Added new structured snapshot types for orders and order items to improve data integrity and clarity. - Updated the Order and OrderItem models to use the new JSONType for snapshots. - Refactored tests to accommodate the new snapshot structure, ensuring compatibility with legacy data. - Enhanced the OrdersSnapshot struct to support multiple snapshot types and maintain backward compatibility. - Introduced new fields for order items and orders to capture detailed snapshot information for auditing and historical display.
99 lines
4.0 KiB
Go
99 lines
4.0 KiB
Go
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"`
|
||
}
|