update backend

internal/dto/article.go

@@ -2,7 +2,7 @@ package dto
 
 // ---------- 请求 ----------
 
-// ArticleQuery 走秀列表查询条件（GET /public/runways）。
+// ArticleQuery 走秀列表查询条件（GET /public/runway-looks）。
 //
 // 设计原则：参数尽可能少、不复用。
 //   - 所有筛选均为单值（前端已全改为单选），不再支持多选数组；
@@ -64,7 +64,7 @@ func (q ArticleQuery) Offset() int { return (q.Page - 1) * q.Size }
 
 // PublicArticleImage 对外展示用的图片结构。
 //
-// ID 是图片自身的编码 id（hashid，i=走秀单图 / j=街拍单图），供「单图收藏」定位到具体某一张；
+// ID 是图片自身的编码 id（hashid，类型进密码：i=走秀单图 / j=街拍单图），供「单图收藏」定位到具体某一张；
 // 此前只有 image + name，前端无法稳定标识单张图片，故补充该字段。
 //
 // Image 与 Thumb 的关系：
@@ -99,7 +99,7 @@ type PublicArticle struct {
 	BrandUID   string               `json:"brand_id"` // 编码后的品牌 id（无序串）
 	Title      string               `json:"title"`
 	Cover      string               `json:"cover"`       // 封面相对路径，如 /uploads/xxx.jpg
-	BrandName  string               `json:"brand_name"`  // JOIN brand 得到
+	BrandName  string               `json:"brand_name"`  // JOIN brands 得到
 	ImageCount uint16               `json:"image_count"` // 该走秀图片总数（列表卡片 "N+" 角标用）
 	Images     []PublicArticleImage `json:"images"`      // 列表附带的每篇前 N 张缩略图
 }
@@ -117,7 +117,7 @@ type PublicArticleDetail struct {
 	BrandName   string `json:"brand_name"`
 	// Images 仅含主图（look 图），默认展示；每个主图的细节图挂在它自己的 Detail 子数组下。
 	Images    []PublicArticleImage `json:"images"`
-	Favorited bool                 `json:"favorited,omitempty"` // 已登录时该图集是否被当前用户收藏（gallery 级，r= 前缀）
+	Favorited bool                 `json:"favorited,omitempty"` // 已登录时该图集是否被当前用户收藏（gallery 级）
 }
 
 // AdminRunway 后台管理用的走秀列表项：在 PublicArticle 基础上补回管理字段，
@@ -125,7 +125,7 @@ type PublicArticleDetail struct {
 type AdminRunway struct {
 	UID            string `json:"id"`         // 编码后的文章 id（无序串）
 	BrandUID       string `json:"brand_id"`   // 编码后的品牌 id（无序串）
-	BrandName      string `json:"brand_name"` // JOIN brand 得到（优先 en）
+	BrandName      string `json:"brand_name"` // JOIN brands 得到（优先 en）
 	Title          string `json:"title"`
 	Year           uint16 `json:"year"`            // 年份（如 2024）
 	Season         string `json:"season"`          // spring / fall