feat(api): add message segments support for posts and comments

Add rich message segment support enabling structured content (text, images, votes, mentions) in posts and comments. Includes segments field in models, DTOs, handlers, and services. Also adds @mention notification processing and migrates vote data to embedded segments.

internal/dto/dto.go

@@ -1,8 +1,8 @@
-package dto
+package dto
 
 import (
-	"with_you/internal/model"
 	"time"
+	"with_you/internal/model"
 )
 
 // ==================== User DTOs ====================
@@ -143,54 +143,56 @@ type PostImageResponse struct {
 
 // PostResponse 帖子响应（列表用）
 type PostResponse struct {
-	ID              string              `json:"id"`
-	UserID          string              `json:"user_id"`
-	ChannelID       *string             `json:"channel_id,omitempty"`
-	Title           string              `json:"title"`
-	Content         string              `json:"content"`
-	Images          []PostImageResponse `json:"images"`
-	Status          string              `json:"status,omitempty"`
-	LikesCount      int                 `json:"likes_count"`
-	CommentsCount   int                 `json:"comments_count"`
-	FavoritesCount  int                 `json:"favorites_count"`
-	SharesCount     int                 `json:"shares_count"`
-	ViewsCount      int                 `json:"views_count"`
-	IsPinned        bool                `json:"is_pinned"`
-	IsLocked        bool                `json:"is_locked"`
-	IsVote          bool                `json:"is_vote"`
-	CreatedAt       string              `json:"created_at"`
-	UpdatedAt       string              `json:"updated_at"`
-	ContentEditedAt string              `json:"content_edited_at,omitempty"`
-	Author          *UserResponse       `json:"author"`
-	IsLiked         bool                `json:"is_liked"`
-	IsFavorited     bool                `json:"is_favorited"`
-	Channel         *PostChannelBrief   `json:"channel,omitempty"`
+	ID              string                `json:"id"`
+	UserID          string                `json:"user_id"`
+	ChannelID       *string               `json:"channel_id,omitempty"`
+	Title           string                `json:"title"`
+	Content         string                `json:"content"`
+	Segments        model.MessageSegments `json:"segments,omitempty"`
+	Images          []PostImageResponse   `json:"images"`
+	Status          string                `json:"status,omitempty"`
+	LikesCount      int                   `json:"likes_count"`
+	CommentsCount   int                   `json:"comments_count"`
+	FavoritesCount  int                   `json:"favorites_count"`
+	SharesCount     int                   `json:"shares_count"`
+	ViewsCount      int                   `json:"views_count"`
+	IsPinned        bool                  `json:"is_pinned"`
+	IsLocked        bool                  `json:"is_locked"`
+	IsVote          bool                  `json:"is_vote"`
+	CreatedAt       string                `json:"created_at"`
+	UpdatedAt       string                `json:"updated_at"`
+	ContentEditedAt string                `json:"content_edited_at,omitempty"`
+	Author          *UserResponse         `json:"author"`
+	IsLiked         bool                  `json:"is_liked"`
+	IsFavorited     bool                  `json:"is_favorited"`
+	Channel         *PostChannelBrief     `json:"channel,omitempty"`
 }
 
 // PostDetailResponse 帖子详情响应
 type PostDetailResponse struct {
-	ID              string              `json:"id"`
-	UserID          string              `json:"user_id"`
-	ChannelID       *string             `json:"channel_id,omitempty"`
-	Title           string              `json:"title"`
-	Content         string              `json:"content"`
-	Images          []PostImageResponse `json:"images"`
-	Status          string              `json:"status"`
-	LikesCount      int                 `json:"likes_count"`
-	CommentsCount   int                 `json:"comments_count"`
-	FavoritesCount  int                 `json:"favorites_count"`
-	SharesCount     int                 `json:"shares_count"`
-	ViewsCount      int                 `json:"views_count"`
-	IsPinned        bool                `json:"is_pinned"`
-	IsLocked        bool                `json:"is_locked"`
-	IsVote          bool                `json:"is_vote"`
-	CreatedAt       string              `json:"created_at"`
-	UpdatedAt       string              `json:"updated_at"`
-	ContentEditedAt string              `json:"content_edited_at,omitempty"`
-	Author          *UserResponse       `json:"author"`
-	IsLiked         bool                `json:"is_liked"`
-	IsFavorited     bool                `json:"is_favorited"`
-	Channel         *PostChannelBrief   `json:"channel,omitempty"`
+	ID              string                `json:"id"`
+	UserID          string                `json:"user_id"`
+	ChannelID       *string               `json:"channel_id,omitempty"`
+	Title           string                `json:"title"`
+	Content         string                `json:"content"`
+	Segments        model.MessageSegments `json:"segments,omitempty"`
+	Images          []PostImageResponse   `json:"images"`
+	Status          string                `json:"status"`
+	LikesCount      int                   `json:"likes_count"`
+	CommentsCount   int                   `json:"comments_count"`
+	FavoritesCount  int                   `json:"favorites_count"`
+	SharesCount     int                   `json:"shares_count"`
+	ViewsCount      int                   `json:"views_count"`
+	IsPinned        bool                  `json:"is_pinned"`
+	IsLocked        bool                  `json:"is_locked"`
+	IsVote          bool                  `json:"is_vote"`
+	CreatedAt       string                `json:"created_at"`
+	UpdatedAt       string                `json:"updated_at"`
+	ContentEditedAt string                `json:"content_edited_at,omitempty"`
+	Author          *UserResponse         `json:"author"`
+	IsLiked         bool                  `json:"is_liked"`
+	IsFavorited     bool                  `json:"is_favorited"`
+	Channel         *PostChannelBrief     `json:"channel,omitempty"`
 }
 
 // ==================== Comment DTOs ====================
@@ -209,6 +211,7 @@ type CommentResponse struct {
 	ParentID     *string                `json:"parent_id"`
 	RootID       *string                `json:"root_id"`
 	Content      string                 `json:"content"`
+	Segments     model.MessageSegments  `json:"segments,omitempty"`
 	Images       []CommentImageResponse `json:"images"`
 	LikesCount   int                    `json:"likes_count"`
 	RepliesCount int                    `json:"replies_count"`
@@ -248,6 +251,7 @@ const (
 	SegmentTypeReply SegmentType = "reply"
 	SegmentTypeFace  SegmentType = "face"
 	SegmentTypeLink  SegmentType = "link"
+	SegmentTypeVote  SegmentType = "vote"
 )
 
 // TextSegmentData 文本数据
@@ -315,6 +319,19 @@ type LinkSegmentData struct {
 	Image       string `json:"image,omitempty"`
 }
 
+// VoteOptionData 投票选项数据
+type VoteOptionData struct {
+	ID      string `json:"id"`
+	Content string `json:"content"`
+}
+
+// VoteSegmentData 投票Segment数据
+type VoteSegmentData struct {
+	Options       []VoteOptionData `json:"options"`
+	MaxChoices    int              `json:"max_choices,omitempty"`
+	IsMultiChoice bool             `json:"is_multi_choice,omitempty"`
+}
+
 // ==================== Message DTOs ====================
 
 // MessageResponse 消息响应
@@ -887,7 +904,16 @@ type CreateVotePostRequest struct {
 	Content     string   `json:"content" binding:"max=2000"`
 	ChannelID   *string  `json:"channel_id,omitempty"`
 	Images      []string `json:"images"`
-	VoteOptions []string `json:"vote_options" binding:"required,min=2,max=10"` // 投票选项，至少2个最多10个
+	VoteOptions []string `json:"vote_options" binding:"required,min=2,max=10"`
+}
+
+// CreatePostWithSegmentsRequest 创建帖子请求（含 segments）
+type CreatePostWithSegmentsRequest struct {
+	Title     string                `json:"title" binding:"required,max=200"`
+	Content   string                `json:"content"`
+	Segments  model.MessageSegments `json:"segments"`
+	Images    []string              `json:"images"`
+	ChannelID *string               `json:"channel_id,omitempty"`
 }
 
 // VoteOptionDTO 投票选项DTO
@@ -943,29 +969,30 @@ type AdminPostListResponse struct {
 
 // AdminPostDetailResponse 管理端帖子详情响应
 type AdminPostDetailResponse struct {
-	ID              string              `json:"id"`
-	UserID          string              `json:"user_id"`
-	ChannelID       *string             `json:"channel_id,omitempty"`
-	Title           string              `json:"title"`
-	Content         string              `json:"content"`
-	Images          []PostImageResponse `json:"images"`
-	Status          string              `json:"status"`
-	LikesCount      int                 `json:"likes_count,omitzero"`
-	CommentsCount   int                 `json:"comments_count,omitzero"`
-	FavoritesCount  int                 `json:"favorites_count,omitzero"`
-	SharesCount     int                 `json:"shares_count,omitzero"`
-	ViewsCount      int                 `json:"views_count,omitzero"`
-	IsPinned        bool                `json:"is_pinned"`
-	IsFeatured      bool                `json:"is_featured"`
-	IsLocked        bool                `json:"is_locked"`
-	IsVote          bool                `json:"is_vote"`
-	RejectReason    string              `json:"reject_reason,omitempty"`
-	ReviewedAt      string              `json:"reviewed_at,omitempty"`
-	ReviewedBy      string              `json:"reviewed_by,omitempty"`
-	CreatedAt       string              `json:"created_at"`
-	UpdatedAt       string              `json:"updated_at"`
-	ContentEditedAt string              `json:"content_edited_at,omitempty"`
-	Author          *UserResponse       `json:"author"`
+	ID              string                `json:"id"`
+	UserID          string                `json:"user_id"`
+	ChannelID       *string               `json:"channel_id,omitempty"`
+	Title           string                `json:"title"`
+	Content         string                `json:"content"`
+	Segments        model.MessageSegments `json:"segments,omitempty"`
+	Images          []PostImageResponse   `json:"images"`
+	Status          string                `json:"status"`
+	LikesCount      int                   `json:"likes_count,omitzero"`
+	CommentsCount   int                   `json:"comments_count,omitzero"`
+	FavoritesCount  int                   `json:"favorites_count,omitzero"`
+	SharesCount     int                   `json:"shares_count,omitzero"`
+	ViewsCount      int                   `json:"views_count,omitzero"`
+	IsPinned        bool                  `json:"is_pinned"`
+	IsFeatured      bool                  `json:"is_featured"`
+	IsLocked        bool                  `json:"is_locked"`
+	IsVote          bool                  `json:"is_vote"`
+	RejectReason    string                `json:"reject_reason,omitempty"`
+	ReviewedAt      string                `json:"reviewed_at,omitempty"`
+	ReviewedBy      string                `json:"reviewed_by,omitempty"`
+	CreatedAt       string                `json:"created_at"`
+	UpdatedAt       string                `json:"updated_at"`
+	ContentEditedAt string                `json:"content_edited_at,omitempty"`
+	Author          *UserResponse         `json:"author"`
 }
 
 // AdminModeratePostRequest 审核帖子请求

internal/dto/post_converter.go

@@ -1,9 +1,9 @@
-package dto
+package dto
 
 import (
-	"with_you/internal/model"
 	"context"
 	"encoding/json"
+	"with_you/internal/model"
 )
 
 // ==================== Post 转换 ====================
@@ -67,6 +67,20 @@ func PostChannelBriefForPost(post *model.Post, channelByID map[string]*model.Cha
 	return postChannelBrief(post, channelByID)
 }
 
+// SegmentsOrDefault 如果 segments 为空但 content 非空，
+// 返回降级的单 text segment；否则原样返回。
+func SegmentsOrDefault(segments model.MessageSegments, content string) model.MessageSegments {
+	if len(segments) > 0 {
+		return segments
+	}
+	if content != "" {
+		return model.MessageSegments{
+			{Type: string(SegmentTypeText), Data: map[string]any{"text": content}},
+		}
+	}
+	return nil
+}
+
 // ConvertPostToResponse 将Post转换为PostResponse（列表用）；channelByID 可为 nil
 func ConvertPostToResponse(post *model.Post, channelByID map[string]*model.Channel, isLiked, isFavorited bool) *PostResponse {
 	if post == nil {
@@ -89,6 +103,7 @@ func ConvertPostToResponse(post *model.Post, channelByID map[string]*model.Chann
 		ChannelID:       post.ChannelID,
 		Title:           post.Title,
 		Content:         post.Content,
+		Segments:        SegmentsOrDefault(post.Segments, post.Content),
 		Images:          images,
 		Status:          string(post.Status),
 		LikesCount:      post.LikesCount,
@@ -131,6 +146,7 @@ func ConvertPostToDetailResponse(post *model.Post, channelByID map[string]*model
 		ChannelID:       post.ChannelID,
 		Title:           post.Title,
 		Content:         post.Content,
+		Segments:        SegmentsOrDefault(post.Segments, post.Content),
 		Images:          images,
 		Status:          string(post.Status),
 		LikesCount:      post.LikesCount,
@@ -227,6 +243,7 @@ func ConvertCommentToResponse(comment *model.Comment, isLiked bool) *CommentResp
 		ParentID:     comment.ParentID,
 		RootID:       comment.RootID,
 		Content:      comment.Content,
+		Segments:     SegmentsOrDefault(comment.Segments, comment.Content),
 		Images:       images,
 		LikesCount:   comment.LikesCount,
 		RepliesCount: comment.RepliesCount,
@@ -303,6 +320,7 @@ func ConvertCommentToResponseWithUser(comment *model.Comment, userID string, che
 		ParentID:     comment.ParentID,
 		RootID:       comment.RootID,
 		Content:      comment.Content,
+		Segments:     SegmentsOrDefault(comment.Segments, comment.Content),
 		Images:       images,
 		LikesCount:   comment.LikesCount,
 		RepliesCount: comment.RepliesCount,

internal/dto/segment.go

@@ -1,4 +1,4 @@
-package dto
+package dto
 
 import (
 	"encoding/json"
@@ -145,6 +145,29 @@ func NewLinkSegment(url, title, description, image string) model.MessageSegment
 	}
 }
 
+// ExtractVoteSegmentData 从消息链中提取投票Segment数据
+func ExtractVoteSegmentData(segments model.MessageSegments) *VoteSegmentData {
+	for _, segment := range segments {
+		if segment.Type == string(SegmentTypeVote) {
+			dataBytes, err := json.Marshal(segment.Data)
+			if err != nil {
+				continue
+			}
+			var voteData VoteSegmentData
+			if err := json.Unmarshal(dataBytes, &voteData); err != nil {
+				continue
+			}
+			return &voteData
+		}
+	}
+	return nil
+}
+
+// HasVoteSegment 检查消息链中是否包含投票Segment
+func HasVoteSegment(segments model.MessageSegments) bool {
+	return HasSegmentType(segments, SegmentTypeVote)
+}
+
 // ExtractTextContentFromJSON 从JSON格式的segments中提取纯文本内容
 // 用于从数据库读取的 []byte 格式的 segments
 // 已废弃：现在数据库直接存储 model.MessageSegments 类型
@@ -202,6 +225,8 @@ func ExtractTextContentFromModel(segments model.MessageSegments) string {
 			} else {
 				result += "[链接]"
 			}
+		case "vote":
+			result += "[投票]"
 		}
 	}
 	return result