feat: Refactor order snapshot handling and introduce structured snapshot types

- 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.

backend/database/fields/orders.go

@@ -0,0 +1,98 @@
+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"`
+}