feat: 接入 CoinGlass 清算热力图隔离链路

internal/usecase/coinglass_query.go

@@ -0,0 +1,27 @@
+package usecase
+
+import (
+	"context"
+	"strings"
+
+	"cryptoHermes/internal/entity"
+)
+
+const defaultCGLiqHeatMapLimit = 288
+
+type CoinglassQueryUsecase struct {
+	liqHeatMapRepo CoinglassLiqHeatMapRepository
+}
+
+func NewCoinglassQueryUsecase(liqHeatMapRepo CoinglassLiqHeatMapRepository) *CoinglassQueryUsecase {
+	return &CoinglassQueryUsecase{liqHeatMapRepo: liqHeatMapRepo}
+}
+
+func (u *CoinglassQueryUsecase) GetLiqHeatMap(ctx context.Context, symbol, interval string, limit int) ([]entity.CGLiqHeatMap, error) {
+	symbol = strings.ToUpper(strings.TrimSpace(symbol))
+	symbol = strings.TrimPrefix(symbol, "BINANCE_")
+	if limit <= 0 {
+		limit = defaultCGLiqHeatMapLimit
+	}
+	return u.liqHeatMapRepo.FindRecent(ctx, symbol, interval, limit)
+}

internal/usecase/ports.go

@@ -25,6 +25,10 @@ type DerivativesProvider interface {
 	GetTakerBuySellVolume(ctx context.Context, symbol, period string, limit int) ([]entity.TakerBuySellVolume, error)
 }
 
+type CoinglassProvider interface {
+	GetLiqHeatMap(ctx context.Context, symbol, interval string, limit int) (*entity.CGLiqHeatMap, error)
+}
+
 type KlineRepository interface {
 	UpsertMany(ctx context.Context, items []entity.Kline) error
 	FindRecent(ctx context.Context, symbol, interval string, limit int) ([]entity.Kline, error)
@@ -50,6 +54,11 @@ type TakerVolumeRepository interface {
 	FindRecent(ctx context.Context, symbol, period string, limit int) ([]entity.TakerBuySellVolume, error)
 }
 
+type CoinglassLiqHeatMapRepository interface {
+	UpsertMany(ctx context.Context, items []entity.CGLiqHeatMap) error
+	FindRecent(ctx context.Context, symbol, interval string, limit int) ([]entity.CGLiqHeatMap, error)
+}
+
 // IndicatorComputer 纯函数式接口：接收已经被上层 fetch 的 slice，
 // 返回填充好的 TechnicalStructure。
 //