feat: 实现客户端实例上报功能

- 新增 ClientInstance 模型，记录客户端 IP 与配置项的关联
- 配置拉取接口（fetchAll/fetchChanged）自动记录客户端信息
- 配置列表页面展示每个配置的在线客户端数量
- 点击可查看具体 IP 地址、拉取方式、最后拉取时间
- 超过 5 分钟未拉取的记录自动清理
- 注释掉 /api/ping 接口

server/internal/handler/client.go

@@ -0,0 +1,29 @@
+package handler
+
+import (
+	"kenaito-conf/server/internal/dao"
+	"kenaito-conf/server/internal/model"
+	"net/http"
+	"strconv"
+
+	"github.com/gin-gonic/gin"
+)
+
+type ClientHandler struct{}
+
+func NewClientHandler() *ClientHandler {
+	return &ClientHandler{}
+}
+
+func (h *ClientHandler) ListByConfigId(c *gin.Context) {
+	configId, _ := strconv.Atoi(c.Query("configId"))
+	if configId == 0 {
+		c.JSON(http.StatusBadRequest, model.WrapperResponse{Code: 400, Msg: "参数错误"})
+		return
+	}
+
+	var instances []model.ClientInstance
+	dao.Engine.Where("app_config_id = ?", configId).OrderBy("last_fetch_at DESC").Find(&instances)
+
+	c.JSON(http.StatusOK, model.WrapperResponse{Code: 0, Data: instances})
+}

server/internal/handler/config.go

@@ -80,9 +80,31 @@ func (h *ConfigHandler) List(c *gin.Context) {
 	total, _ := dao.Engine.Where(whereClause).Count(&model.AppConfig{})
 	dao.Engine.Where(whereClause).Limit(req.PageSize, (req.PageNo-1)*req.PageSize).Find(&configs)
 
-	// build app names
+	// build app names and client counts
+	configIds := make([]int, 0, len(configs))
 	for i := range configs {
 		configs[i].AppNames = h.buildAppNames(&configs[i])
+		configIds = append(configIds, configs[i].Id)
+	}
+	// batch query client counts
+	if len(configIds) > 0 {
+		type countResult struct {
+			AppConfigId int `xorm:"app_config_id"`
+			Cnt         int `xorm:"cnt"`
+		}
+		var results []countResult
+		dao.Engine.Table("client_instance").
+			Select("app_config_id, COUNT(DISTINCT ip) as cnt").
+			In("app_config_id", configIds).
+			GroupBy("app_config_id").
+			Find(&results)
+		countMap := make(map[int]int, len(results))
+		for _, r := range results {
+			countMap[r.AppConfigId] = r.Cnt
+		}
+		for i := range configs {
+			configs[i].ClientCount = countMap[configs[i].Id]
+		}
 	}
 
 	c.JSON(http.StatusOK, model.PageResult{PageNo: req.PageNo, PageSize: req.PageSize, Total: total, Data: configs})

server/internal/handler/config_api.go

@@ -70,6 +70,7 @@ func (h *ConfigApiHandler) FetchAllConfigs(c *gin.Context) {
 	}
 
 	result := make(map[string]interface{})
+	var configIds []int
 
 	// load global configs
 	if !req.IgnoreGlobal && app.GroupId != nil {
@@ -77,6 +78,7 @@ func (h *ConfigApiHandler) FetchAllConfigs(c *gin.Context) {
 		dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND group_id = ? AND (app_id is null OR app_id = 0)",
 			req.Env, version, *app.GroupId).Find(&globalConfigs)
 		for _, cfg := range globalConfigs {
+			configIds = append(configIds, cfg.Id)
 			kvMap := h.parseService.ParseConfigToKVMap(&cfg)
 			for k, v := range kvMap {
 				result[k] = v
@@ -90,6 +92,7 @@ func (h *ConfigApiHandler) FetchAllConfigs(c *gin.Context) {
 		dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND app_id = ?",
 			req.Env, version, *app.ParentId).Find(&parentConfigs)
 		for _, cfg := range parentConfigs {
+			configIds = append(configIds, cfg.Id)
 			kvMap := h.parseService.ParseConfigToKVMap(&cfg)
 			for k, v := range kvMap {
 				result[k] = v
@@ -102,6 +105,7 @@ func (h *ConfigApiHandler) FetchAllConfigs(c *gin.Context) {
 	dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND app_id = ?",
 		req.Env, version, app.Id).Find(&appConfigs)
 	for _, cfg := range appConfigs {
+		configIds = append(configIds, cfg.Id)
 		kvMap := h.parseService.ParseConfigToKVMap(&cfg)
 		for k, v := range kvMap {
 			result[k] = v
@@ -115,6 +119,9 @@ func (h *ConfigApiHandler) FetchAllConfigs(c *gin.Context) {
 
 	result["latest.fetch.timestamp"] = strconv.FormatInt(time.Now().UnixMilli(), 10)
 
+	// record client instances asynchronously
+	go h.recordClientInstances(c.ClientIP(), configIds, req.AppName, req.Env, "fetchAll")
+
 	c.JSON(http.StatusOK, result)
 }
 
@@ -156,6 +163,7 @@ func (h *ConfigApiHandler) FetchChangedConfigs(c *gin.Context) {
 	lastUpdateTime := time.UnixMilli(req.LastTime)
 
 	result := make(map[string]string)
+	var configIds []int
 
 	// load global changed configs
 	if !req.IgnoreGlobal && app.GroupId != nil {
@@ -163,6 +171,7 @@ func (h *ConfigApiHandler) FetchChangedConfigs(c *gin.Context) {
 		dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND group_id = ? AND (app_id is null OR app_id = 0) AND updated_at > ?",
 			req.Env, version, *app.GroupId, lastUpdateTime).Find(&globalConfigs)
 		for _, cfg := range globalConfigs {
+			configIds = append(configIds, cfg.Id)
 			h.addChangedConfigs(result, &cfg, req.FetchAll)
 		}
 	}
@@ -173,6 +182,7 @@ func (h *ConfigApiHandler) FetchChangedConfigs(c *gin.Context) {
 		dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND app_id = ? AND updated_at > ?",
 			req.Env, version, *app.ParentId, lastUpdateTime).Find(&parentConfigs)
 		for _, cfg := range parentConfigs {
+			configIds = append(configIds, cfg.Id)
 			h.addChangedConfigs(result, &cfg, req.FetchAll)
 		}
 	}
@@ -182,11 +192,15 @@ func (h *ConfigApiHandler) FetchChangedConfigs(c *gin.Context) {
 	dao.Engine.Where("env = ? AND version = ? AND enabled = 1 AND app_id = ? AND updated_at > ?",
 		req.Env, version, app.Id, lastUpdateTime).Find(&appConfigs)
 	for _, cfg := range appConfigs {
+		configIds = append(configIds, cfg.Id)
 		h.addChangedConfigs(result, &cfg, req.FetchAll)
 	}
 
 	result["latest.fetch.timestamp"] = strconv.FormatInt(time.Now().UnixMilli(), 10)
 
+	// record client instances asynchronously
+	go h.recordClientInstances(c.ClientIP(), configIds, req.AppName, req.Env, "fetchChanged")
+
 	c.JSON(http.StatusOK, model.WrapperResponse{Code: 0, Data: result})
 }
 
@@ -197,6 +211,38 @@ func (h *ConfigApiHandler) addChangedConfigs(result map[string]string, config *m
 	}
 }
 
-func (h *ConfigApiHandler) Ping(c *gin.Context) {
-	c.String(http.StatusOK, "200")
+func (h *ConfigApiHandler) recordClientInstances(ip string, configIds []int, appName, env, fetchType string) {
+	if len(configIds) == 0 || ip == "" {
+		return
+	}
+	now := time.Now()
+	for _, configId := range configIds {
+		var existing model.ClientInstance
+		has, _ := dao.Engine.Where("app_config_id = ? AND ip = ?", configId, ip).Get(&existing)
+		if has {
+			existing.LastFetchAt = &now
+			existing.LastFetchType = fetchType
+			existing.UpdatedAt = &now
+			dao.Engine.ID(existing.Id).Cols("last_fetch_at", "last_fetch_type", "updated_at").Update(&existing)
+		} else {
+			instance := model.ClientInstance{
+				AppConfigId:   configId,
+				AppName:       appName,
+				Env:           env,
+				IP:            ip,
+				LastFetchAt:   &now,
+				LastFetchType: fetchType,
+				CreatedAt:     &now,
+				UpdatedAt:     &now,
+			}
+			dao.Engine.Insert(&instance)
+		}
+	}
+	// cleanup records older than 5 minutes
+	fiveMinutesAgo := now.Add(-5 * time.Minute)
+	dao.Engine.Where("last_fetch_at < ?", fiveMinutesAgo).Delete(&model.ClientInstance{})
 }
+
+// func (h *ConfigApiHandler) Ping(c *gin.Context) {
+// 	c.String(http.StatusOK, "200")
+// }