chore: sync local updates

mengyastore-backend-go/internal/handlers/stats.go

@@ -18,7 +18,8 @@ func NewStatsHandler(orderStore *storage.OrderStore, siteStore *storage.SiteStor
 }
 
 // GetStats 订单总数与站点访问总数。
-// @Summary 站点统计
+// @Summary 获取站点聚合统计
+// @Description 返回全站累计订单数与累计访问量（公开读，用于首页展示等）。
 // @Tags 公开
 // @Produce json
 // @Success 200 {object} SwaggerStatsWrap
@@ -44,7 +45,8 @@ func (h *StatsHandler) GetStats(c *gin.Context) {
 }
 
 // RecordVisit 记录一次站点访问并返回累计访问量。
-// @Summary 记录站点访问
+// @Summary 上报一次站点访问
+// @Description 记录访客一次访问并累加全站访问计数；是否计入由服务端指纹等策略决定，响应中含最新总访问量与本次是否计入。
 // @Tags 公开
 // @Produce json
 // @Success 200 {object} SwaggerVisitWrap
@@ -66,7 +68,8 @@ func (h *StatsHandler) RecordVisit(c *gin.Context) {
 }
 
 // GetMaintenance 当前维护模式与原因。
-// @Summary 维护模式状态
+// @Summary 获取维护模式状态
+// @Description 返回当前是否开启全站维护、以及展示给前端的维护原因文案（公开接口，无需管理令牌）。
 // @Tags 公开
 // @Produce json
 // @Success 200 {object} SwaggerMaintenanceWrap