chore: sync local updates

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

@@ -19,7 +19,8 @@ func NewPublicHandler(store *storage.ProductStore) *PublicHandler {
 }
 
 // ListProducts 上架商品列表（公开字段，不含卡密与管理信息）。
-// @Summary 上架商品列表
+// @Summary 获取上架商品列表
+// @Description 返回当前处于「上架」状态的商品集合，仅包含前台展示所需字段（不含卡密、管理字段等）。无需登录。
 // @Tags 公开
 // @Produce json
 // @Success 200 {object} SwaggerProductListBody
@@ -35,10 +36,11 @@ func (h *PublicHandler) ListProducts(c *gin.Context) {
 }
 
 // RecordProductView 记录商品浏览（去重策略由服务端指纹决定）。
-// @Summary 记录商品浏览
+// @Summary 记录商品浏览次数
+// @Description 对指定商品增加浏览计数；是否计入由服务端对访客指纹去重策略决定，用于热门统计。路径参数为商品 ID。
 // @Tags 公开
 // @Produce json
-// @Param id path string true "商品 ID"
+// @Param id path string true "商品ID（路径）"
 // @Success 200 {object} SwaggerProductViewWrap
 // @Failure 404 {object} SwaggerErrorBody
 // @Router /api/products/{id}/view [post]