更新.gitignore文件，移除不必要的soul-api目录，确保版本控制的清晰性与一致性。

soul-api/internal/handler/match_records.go

@@ -0,0 +1,96 @@
+package handler
+
+import (
+	"net/http"
+	"strconv"
+
+	"soul-api/internal/database"
+	"soul-api/internal/model"
+
+	"github.com/gin-gonic/gin"
+)
+
+// DBMatchRecordsList GET /api/db/match-records 管理端-匹配记录列表（分页、按类型筛选）
+func DBMatchRecordsList(c *gin.Context) {
+	db := database.DB()
+	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
+	pageSize, _ := strconv.Atoi(c.DefaultQuery("pageSize", "10"))
+	matchType := c.Query("matchType")
+	if page < 1 {
+		page = 1
+	}
+	if pageSize < 1 || pageSize > 100 {
+		pageSize = 10
+	}
+
+	q := db.Model(&model.MatchRecord{})
+	if matchType != "" {
+		q = q.Where("match_type = ?", matchType)
+	}
+	var total int64
+	q.Count(&total)
+
+	var records []model.MatchRecord
+	if err := q.Order("created_at DESC").Offset((page - 1) * pageSize).Limit(pageSize).Find(&records).Error; err != nil {
+		c.JSON(http.StatusOK, gin.H{"success": false, "error": err.Error(), "records": []interface{}{}})
+		return
+	}
+
+	userIDs := make(map[string]bool)
+	for _, r := range records {
+		userIDs[r.UserID] = true
+		userIDs[r.MatchedUserID] = true
+	}
+	ids := make([]string, 0, len(userIDs))
+	for id := range userIDs {
+		ids = append(ids, id)
+	}
+	var users []model.User
+	if len(ids) > 0 {
+		database.DB().Where("id IN ?", ids).Find(&users)
+	}
+	userMap := make(map[string]*model.User)
+	for i := range users {
+		userMap[users[i].ID] = &users[i]
+	}
+
+	getStr := func(s *string) string {
+		if s == nil {
+			return ""
+		}
+		return *s
+	}
+
+	out := make([]gin.H, 0, len(records))
+	for _, r := range records {
+		u := userMap[r.UserID]
+		mu := userMap[r.MatchedUserID]
+		userAvatar := ""
+		matchedUserAvatar := ""
+		if u != nil && u.Avatar != nil {
+			userAvatar = *u.Avatar
+		}
+		if mu != nil && mu.Avatar != nil {
+			matchedUserAvatar = *mu.Avatar
+		}
+		out = append(out, gin.H{
+			"id": r.ID, "userId": r.UserID, "matchedUserId": r.MatchedUserID,
+			"matchType": r.MatchType, "phone": getStr(r.Phone), "wechatId": getStr(r.WechatID),
+			"userNickname":     getStr(u.Nickname),
+			"matchedNickname":  getStr(mu.Nickname),
+			"userAvatar":       userAvatar,
+			"matchedUserAvatar": matchedUserAvatar,
+			"matchScore":       r.MatchScore,
+			"createdAt":        r.CreatedAt,
+		})
+	}
+
+	totalPages := int(total) / pageSize
+	if int(total)%pageSize > 0 {
+		totalPages++
+	}
+	c.JSON(http.StatusOK, gin.H{
+		"success": true, "records": out,
+		"total": total, "page": page, "pageSize": pageSize, "totalPages": totalPages,
+	})
+}