Update mengyastore

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

@@ -35,6 +35,14 @@ func (h *ChatHandler) requireChatUser(c *gin.Context) (account, name string, ok
 }
 
 // GetMyMessages 返回当前登录用户的全部聊天消息。
+// @Summary 我的聊天消息
+// @Tags 聊天（用户）
+// @Produce json
+// @Security BearerAuth
+// @Success 200 {object} SwaggerMessagesWrap
+// @Failure 401 {object} SwaggerErrorBody
+// @Failure 500 {object} SwaggerErrorBody
+// @Router /api/chat/messages [get]
 func (h *ChatHandler) GetMyMessages(c *gin.Context) {
 	account, _, ok := h.requireChatUser(c)
 	if !ok {
@@ -48,17 +56,30 @@ func (h *ChatHandler) GetMyMessages(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"data": gin.H{"messages": msgs}})
 }
 
-type chatMessagePayload struct {
+// ChatMessagePayload 用户发送消息请求体。
+type ChatMessagePayload struct {
 	Content string `json:"content"`
 }
 
 // SendMyMessage 向管理员发送一条用户消息。
+// @Summary 发送用户消息
+// @Tags 聊天（用户）
+// @Accept json
+// @Produce json
+// @Security BearerAuth
+// @Param body body ChatMessagePayload true "消息正文"
+// @Success 200 {object} SwaggerOneChatMsgWrap
+// @Failure 400 {object} SwaggerErrorBody
+// @Failure 401 {object} SwaggerErrorBody
+// @Failure 429 {object} SwaggerErrorBody
+// @Failure 500 {object} SwaggerErrorBody
+// @Router /api/chat/messages [post]
 func (h *ChatHandler) SendMyMessage(c *gin.Context) {
 	account, name, ok := h.requireChatUser(c)
 	if !ok {
 		return
 	}
-	var payload chatMessagePayload
+	var payload ChatMessagePayload
 	if err := c.ShouldBindJSON(&payload); err != nil {
 		c.JSON(http.StatusBadRequest, gin.H{"error": "请求参数有误"})
 		return