Update SproutGate

sproutgate-backend/internal/handlers/public_profile.go

@@ -13,7 +13,13 @@ import (
 	"sproutgate-backend/internal/storage"
 )
 
-// ListPublicUsers 公开用户目录（未封禁用户，默认按注册时间从早到晚）。
+// ListPublicUsers
+// @Summary 公开用户目录
+// @Tags public
+// @Produce json
+// @Success 200 {object} map[string]interface{} "total、users"
+// @Failure 500 {object} map[string]interface{}
+// @Router /api/public/users [get]
 func (h *Handler) ListPublicUsers(c *gin.Context) {
 	users, err := h.store.ListUsers()
 	if err != nil {
@@ -33,6 +39,18 @@ func (h *Handler) ListPublicUsers(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"total": len(out), "users": out})
 }
 
+// GetPublicUser
+// @Summary 公开用户主页
+// @Description 可选 Authorization：登录用户可看到点赞状态等扩展字段。
+// @Tags public
+// @Produce json
+// @Param account path string true "账号"
+// @Param Authorization header string false "Bearer（可选）"
+// @Success 200 {object} map[string]interface{} "user、profileLikeCount 等"
+// @Failure 400 {object} map[string]interface{}
+// @Failure 404 {object} map[string]interface{}
+// @Failure 500 {object} map[string]interface{}
+// @Router /api/public/users/{account} [get]
 func (h *Handler) GetPublicUser(c *gin.Context) {
 	account := strings.TrimSpace(c.Param("account"))
 	if account == "" {
@@ -83,6 +101,19 @@ func (h *Handler) GetPublicUser(c *gin.Context) {
 	c.JSON(http.StatusNotFound, gin.H{"error": "user not found"})
 }
 
+// PostPublicProfileLike
+// @Summary 主页点赞
+// @Tags public
+// @Accept json
+// @Produce json
+// @Security BearerAuth
+// @Param account path string true "被点赞用户账号"
+// @Success 200 {object} map[string]interface{}
+// @Failure 400 {object} map[string]interface{}
+// @Failure 401 {object} map[string]interface{}
+// @Failure 404 {object} map[string]interface{}
+// @Failure 500 {object} map[string]interface{}
+// @Router /api/public/users/{account}/like [post]
 func (h *Handler) PostPublicProfileLike(c *gin.Context) {
 	likedParam := strings.TrimSpace(c.Param("account"))
 	if likedParam == "" {
@@ -130,9 +161,9 @@ func (h *Handler) PostPublicProfileLike(c *gin.Context) {
 		case errors.Is(err, storage.ErrDailyLikeLimitReached):
 			rem, _ := h.store.ProfileLikeRemainingToday(likerUser.Account)
 			c.JSON(http.StatusBadRequest, gin.H{
-				"error":                      err.Error(),
+				"error":                     err.Error(),
 				"viewerLikesRemainingToday": rem,
-				"profileLikeDailyMax":        storage.MaxProfileLikesPerDay,
+				"profileLikeDailyMax":       storage.MaxProfileLikesPerDay,
 			})
 			return
 		case errors.Is(err, storage.ErrProfileLikeLiker):
@@ -146,9 +177,9 @@ func (h *Handler) PostPublicProfileLike(c *gin.Context) {
 
 	rem, _ := h.store.ProfileLikeRemainingToday(likerUser.Account)
 	c.JSON(http.StatusOK, gin.H{
-		"profileLikeCount":           newCount,
-		"viewerHasLikedToday":        true,
+		"profileLikeCount":          newCount,
+		"viewerHasLikedToday":       true,
 		"viewerLikesRemainingToday": rem,
-		"profileLikeDailyMax":        storage.MaxProfileLikesPerDay,
+		"profileLikeDailyMax":       storage.MaxProfileLikesPerDay,
 	})
 }