广告素材增加排序字段

advitise_info 增加 sort 字段,列表默认按 sort 从小到大排序。
info/list 增加 orderBy 参数: sortAsc(默认) / sortDesc / newest,
三种排序末尾都追加 _id 作为最后一级,避免同值文档在分页时重复或漏数据。

启动时回填历史数据缺失的 sort 字段: 缺字段的文档在升序里会排在 0 之前,
且按 sort=0 精确查询查不到。用 UpdateMMany 避免刷新全表 updatedAt。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

models/advitiseInfoMod/advitise.go

@@ -20,10 +20,31 @@ func Init(ctx context.Context) {
 			{Key: FN.AdvitiseInfo.Status, Value: 1},
 		}},
 		{Keys: bson.D{{Key: FN.AdvitiseInfo.CreatedAt, Value: -1}}},
+		{Keys: bson.D{
+			{Key: FN.AdvitiseInfo.Sort, Value: 1},
+			{Key: FN.AdvitiseInfo.CreatedAt, Value: -1},
+		}},
 	}
 	if _, err := db.CreateIndex(ctx, indexes); err != nil {
 		panic(fmt.Sprintf("(advitiseInfoMod:Init) CreateIndex failed: %+v", err))
 	}
+	backfillSort(ctx)
+}
+
+// backfillSort 给历史数据补 sort 字段。缺字段的文档在升序排序里会排在 0 之前,
+// 且按 sort=0 精确查询查不到,所以启动时统一补 0。幂等,补完后不再命中。
+func backfillSort(ctx context.Context) {
+	ret, err := db.UpdateMMany(ctx,
+		bson.M{FN.AdvitiseInfo.Sort: bson.M{"$exists": false}},
+		bson.M{"$set": bson.M{FN.AdvitiseInfo.Sort: int64(0)}},
+	)
+	if err != nil {
+		log.Warn("advitiseInfoMod backfill sort failed", log.E(err))
+		return
+	}
+	if ret != nil && ret.ModifiedCount > 0 {
+		log.Info("advitiseInfoMod backfill sort done", log.Any("modified", ret.ModifiedCount))
+	}
 }
 
 func InsertOneAdvitiseInfo(ctx context.Context, doc *AdvitiseInfo) error {
@@ -76,4 +97,3 @@ func FindManyAdvitiseInfos(ctx context.Context, filter bson.M, opts ...*options.
 	}
 	return list, nil
 }
-

models/advitiseInfoMod/tag.go

@@ -15,6 +15,7 @@ type TagAdvitiseInfo struct {
 	RandomNames      string
 	Link             string
 	Status           string
+	Sort             string
 	StartTime        string
 	EndTime          string
 	Remark           string
@@ -46,6 +47,7 @@ func init() {
 	FN.AdvitiseInfo.RandomNames = "randomNames"
 	FN.AdvitiseInfo.Link = "link"
 	FN.AdvitiseInfo.Status = "status"
+	FN.AdvitiseInfo.Sort = "sort"
 	FN.AdvitiseInfo.StartTime = "startTime"
 	FN.AdvitiseInfo.EndTime = "endTime"
 	FN.AdvitiseInfo.Remark = "remark"

models/advitiseInfoMod/type.go

@@ -24,6 +24,7 @@ type AdvitiseInfo struct {
 	RandomNames      []string  `json:"randomNames" bson:"randomNames"`           // 随机名称
 	Link             string    `json:"link" bson:"link"`                         // 跳转链接
 	Status           bool      `json:"status" bson:"status"`                     // 是否激活
+	Sort             int64     `json:"sort" bson:"sort"`                         // 排序值,从小到大
 	StartTime        time.Time `json:"startTime" bson:"startTime"`               // 开始时间
 	EndTime          time.Time `json:"endTime" bson:"endTime"`                   // 结束时间
 	Remark           string    `json:"remark" bson:"remark"`                     // 备注