add购买记录功能

internal/domains/finance/repositories/purchase_order_repository_interface.go

@@ -0,0 +1,63 @@
+package repositories
+
+import (
+	"context"
+	"time"
+
+	finance_entities "tyapi-server/internal/domains/finance/entities"
+	"tyapi-server/internal/shared/interfaces"
+)
+
+// PurchaseOrderRepository 购买订单仓储接口
+type PurchaseOrderRepository interface {
+	// 创建订单
+	Create(ctx context.Context, order *finance_entities.PurchaseOrder) (*finance_entities.PurchaseOrder, error)
+
+	// 更新订单
+	Update(ctx context.Context, order *finance_entities.PurchaseOrder) error
+
+	// 根据ID获取订单
+	GetByID(ctx context.Context, id string) (*finance_entities.PurchaseOrder, error)
+
+	// 根据订单号获取订单
+	GetByOrderNo(ctx context.Context, orderNo string) (*finance_entities.PurchaseOrder, error)
+
+	// 根据用户ID获取订单列表
+	GetByUserID(ctx context.Context, userID string, limit, offset int) ([]*finance_entities.PurchaseOrder, int64, error)
+
+	// 根据产品ID和用户ID获取订单
+	GetByUserIDAndProductID(ctx context.Context, userID, productID string) (*finance_entities.PurchaseOrder, error)
+
+	// 根据支付类型和第三方交易号获取订单
+	GetByPaymentTypeAndTransactionID(ctx context.Context, paymentType, transactionID string) (*finance_entities.PurchaseOrder, error)
+
+	// 根据交易号获取订单
+	GetByTradeNo(ctx context.Context, tradeNo string) (*finance_entities.PurchaseOrder, error)
+
+	// 更新支付状态
+	UpdatePaymentStatus(ctx context.Context, orderID string, status finance_entities.PurchaseOrderStatus, tradeNo *string, payAmount, receiptAmount *string, paymentTime *time.Time) error
+
+	// 获取用户已购买的产品编号列表
+	GetUserPurchasedProductCodes(ctx context.Context, userID string) ([]string, error)
+
+	// 检查用户是否已购买指定产品
+	HasUserPurchased(ctx context.Context, userID string, productCode string) (bool, error)
+
+	// 获取即将过期的订单（用于清理）
+	GetExpiringOrders(ctx context.Context, before time.Time, limit int) ([]*finance_entities.PurchaseOrder, error)
+
+	// 获取已过期订单（用于清理）
+	GetExpiredOrders(ctx context.Context, limit int) ([]*finance_entities.PurchaseOrder, error)
+
+	// 获取用户已支付的产品ID列表
+	GetUserPaidProductIDs(ctx context.Context, userID string) ([]string, error)
+
+	// 根据状态获取订单列表
+	GetByStatus(ctx context.Context, status finance_entities.PurchaseOrderStatus, limit, offset int) ([]*finance_entities.PurchaseOrder, int64, error)
+
+	// 根据筛选条件获取订单列表
+	GetByFilters(ctx context.Context, filters map[string]interface{}, options interfaces.ListOptions) ([]*finance_entities.PurchaseOrder, error)
+
+	// 根据筛选条件统计订单数量
+	CountByFilters(ctx context.Context, filters map[string]interface{}) (int64, error)
+}