update

internal/service/brand_service.go

@@ -2,8 +2,10 @@ package service
 
 import (
 	"context"
+	"sort"
 
 	"fashionapi/internal/dto"
+	"fashionapi/internal/model"
 	"fashionapi/internal/pkg/hashid"
 	"fashionapi/internal/repository"
 )
@@ -11,9 +13,10 @@ import (
 // BrandService 品牌业务接口。
 type BrandService interface {
 	List(ctx context.Context, q dto.BrandQuery) ([]dto.PublicBrand, int64, error)
-	// Popular 首页"热门品牌"区块：按图片数排名的前 limit 个品牌，附带代表走秀封面与标题。
-	// locale 决定品牌名/标题的展示语言（cn/en）。
-	Popular(ctx context.Context, limit int, locale string) ([]dto.PopularBrand, error)
+	// Hot 返回热门品牌（按走秀图片数排名前 limit 个）并附带各品牌档案数。
+	// 供 SSG 构建期（RunwayLooks 侧栏 / 品牌弹窗 HOT 标签）一次性取前 N 个热门品牌；
+	// 复用 List 的 featured 收窄逻辑（FeaturedIDs("images", limit)），与首页精选口径一致。
+	Hot(ctx context.Context, limit int, locale string) ([]dto.PublicBrand, error)
 }
 
 type brandService struct {
@@ -58,34 +61,54 @@ func (s *brandService) List(ctx context.Context, q dto.BrandQuery) ([]dto.Public
 		return nil, 0, internalErr(err.Error())
 	}
 
+	list := s.toPublicBrands(items, counts, q.Locale)
+	return list, total, nil
+}
+
+// Hot 返回热门品牌：按走秀图片总数排名取前 limit 个，结果按热度顺序（而非字母序）排列。
+//
+// 供 SSG 构建期（走秀页侧栏品牌 filter / 品牌弹窗 HOT 标签）一次性取用——
+// 前端不再从全量列表里自行切片，热度排名由后端唯一口径给出。
+func (s *brandService) Hot(ctx context.Context, limit int, locale string) ([]dto.PublicBrand, error) {
+	ids, err := s.brands.FeaturedIDs(ctx, "images", limit)
+	if err != nil {
+		return nil, internalErr(err.Error())
+	}
+	if len(ids) == 0 {
+		return []dto.PublicBrand{}, nil
+	}
+
+	items, err := s.brands.ListByIDs(ctx, ids)
+	if err != nil {
+		return nil, internalErr(err.Error())
+	}
+	counts, err := s.brands.ArticleCountByBrandIDs(ctx, ids)
+	if err != nil {
+		return nil, internalErr(err.Error())
+	}
+
+	// IN 查询不保证顺序，这里重排回 FeaturedIDs 的热度排名顺序。
+	pos := make(map[uint32]int, len(ids))
+	for i, id := range ids {
+		pos[id] = i
+	}
+	sort.Slice(items, func(i, j int) bool { return pos[items[i].ID] < pos[items[j].ID] })
+
+	return s.toPublicBrands(items, counts, locale), nil
+}
+
+// toPublicBrands 把仓储层品牌行映射为对外精简结构（编码 id + 双语名 + 档案数）。
+func (s *brandService) toPublicBrands(items []model.Brand, counts map[uint32]int, locale string) []dto.PublicBrand {
 	list := make([]dto.PublicBrand, 0, len(items))
 	for _, b := range items {
 		list = append(list, dto.PublicBrand{
 			UID:          hashid.Encode(b.ID),
-			Name:         pickLocale(b.NameEn, b.NameCn, q.Locale),
+			Name:         pickLocale(b.NameEn, b.NameCn, locale),
+			NameEn:       b.NameEn,
+			NameCn:       b.NameCn,
 			ShowName:     b.NameCn,
 			ArticleCount: counts[b.ID],
 		})
 	}
-	return list, total, nil
-}
-
-// Popular 热门品牌（首页区块用）：按图片数排名的前 limit 个品牌，附带代表走秀封面与标题。
-// 复用仓储层的 FeaturedIDs 排名逻辑，保持与"代表品牌"一致的"热门"定义。locale 选展示语言。
-func (s *brandService) Popular(ctx context.Context, limit int, locale string) ([]dto.PopularBrand, error) {
-	rows, err := s.brands.PopularWithCover(ctx, limit)
-	if err != nil {
-		return nil, internalErr(err.Error())
-	}
-	out := make([]dto.PopularBrand, 0, len(rows))
-	for _, b := range rows {
-		out = append(out, dto.PopularBrand{
-			UID:        hashid.Encode(b.ID),
-			ArticleUID: hashid.Encode(b.ArticleID),
-			Brand:      pickLocale(b.BrandEn, b.BrandCn, locale),
-			Cover:      b.Cover,
-			Title:      pickLocale(b.TitleEn, b.TitleCn, locale),
-		})
-	}
-	return out, nil
+	return list
 }