Files
backend/internal/router/router.go

660 lines
29 KiB
Go
Raw Normal View History

package router
import (
"github.com/gin-gonic/gin"
"with_you/internal/handler"
"with_you/internal/middleware"
"with_you/internal/model"
"with_you/internal/repository"
"with_you/internal/service"
)
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
// RouterDeps 路由依赖
type RouterDeps struct {
UserRepo repository.UserRepository
UserHandler *handler.UserHandler
PostHandler *handler.PostHandler
CommentHandler *handler.CommentHandler
MessageHandler *handler.MessageHandler
NotificationHandler *handler.NotificationHandler
UploadHandler *handler.UploadHandler
PushHandler *handler.PushHandler
SystemMessageHandler *handler.SystemMessageHandler
GroupHandler *handler.GroupHandler
StickerHandler *handler.StickerHandler
VoteHandler *handler.VoteHandler
ChannelHandler *handler.ChannelHandler
ScheduleHandler *handler.ScheduleHandler
GradeHandler *handler.GradeHandler
ExamHandler *handler.ExamHandler
EmptyClassroomHandler *handler.EmptyClassroomHandler
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
RoleHandler *handler.RoleHandler
AdminUserHandler *handler.AdminUserHandler
AdminPostHandler *handler.AdminPostHandler
AdminCommentHandler *handler.AdminCommentHandler
AdminGroupHandler *handler.AdminGroupHandler
AdminDashboardHandler *handler.AdminDashboardHandler
AdminLogHandler *handler.AdminLogHandler
QRCodeHandler *handler.QRCodeHandler
MaterialHandler *handler.MaterialHandler
CallHandler *handler.CallHandler
LiveKitHandler *handler.LiveKitHandler
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
ReportHandler *handler.ReportHandler
AdminReportHandler *handler.AdminReportHandler
VerificationHandler *handler.VerificationHandler
AdminVerificationHandler *handler.AdminVerificationHandler
AdminProfileAuditHandler *handler.AdminProfileAuditHandler
SetupHandler *handler.SetupHandler
TradeHandler *handler.TradeHandler
WSHandler *handler.WSHandler
JWTService service.JWTService
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
LogService *service.LogService
ActivityService service.UserActivityService
CasbinService service.CasbinService
UserService service.UserService
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
}
// Router 路由配置
// 通过嵌入 RouterDeps 复用所有依赖字段,消除 RouterDeps 与 Router 之间的字段重复。
// 所有 deps 字段(如 userHandler、jwtService经嵌入提升后仍以 r.UserHandler 形式访问。
type Router struct {
*RouterDeps
engine *gin.Engine
}
// New 创建路由
refactor: improve system stability, performance, and code structure This commit introduces several architectural improvements and optimizations across the codebase: - **Performance & Reliability**: - Implemented Redis pipelining in `ConversationCache.CacheMessage` to reduce network round-trips. - Added a circuit breaker to the JPush client to prevent cascading failures. - Introduced batch deletion and batch member addition capabilities in repositories. - Added message idempotency support using `client_msg_id` and a Redis-based cache. - Optimized WebSocket handling with connection limits (total and per-user) and improved error logging. - **Code Refactoring**: - Refactored `Router` to use a `RouterDeps` struct, simplifying the constructor and improving maintainability. - Unified model ID generation logic using new `id_helper.go` (supporting UUID and Snowflake). - Standardized JSON serialization/deserialization in models using `json_helper.go`. - Refactored DTO conversion logic, specifically for `UserResponse` (using functional options) and `Report` responses. - Removed redundant/deprecated DTOs like `PostDetailResponse` and `TradeItemDetailResponse`. - **Cache Improvements**: - Enhanced `LayeredCache` with `SetRaw` to avoid double-encoding when promoting values from Redis to local cache. - Added `DeleteBatch` support to the cache interface. - **Other Changes**: - Cleaned up `config.go` by removing redundant default values and explicit environment variable overrides. - Improved WebSocket registration flow to handle connection limits gracefully.
2026-05-04 13:07:03 +08:00
func New(deps RouterDeps) *Router {
deps.UserHandler.SetJWTService(deps.JWTService)
deps.UserHandler.SetActivityService(deps.ActivityService)
r := &Router{
RouterDeps: &deps,
engine: gin.Default(),
}
r.setupRoutes()
return r
}
// setupRoutes 设置路由
func (r *Router) setupRoutes() {
// 中间件
r.engine.Use(middleware.SecurityHeaders())
r.engine.Use(middleware.CORS())
// 健康检查
r.engine.GET("/health", func(c *gin.Context) {
c.JSON(200, gin.H{"status": "ok"})
})
// API v1
v1 := r.engine.Group("/api/v1")
{
// 认证路由(公开,按接口类型设置不同速率限制)
auth := v1.Group("/auth")
auth.Use(middleware.GlobalAuthRateLimit())
auth.Use(middleware.IPBanMiddleware())
{
auth.POST("/register", middleware.RegisterRateLimit(), r.UserHandler.Register)
auth.POST("/register/send-code", middleware.SendCodeRateLimit(), r.UserHandler.SendRegisterCode)
auth.POST("/login", middleware.LoginRateLimit(), r.UserHandler.Login)
auth.POST("/password/send-code", middleware.PasswordResetRateLimit(), r.UserHandler.SendPasswordResetCode)
auth.POST("/password/reset", middleware.PasswordResetRateLimit(), r.UserHandler.ResetPassword)
auth.POST("/logout", r.UserHandler.Logout)
auth.POST("/refresh", r.UserHandler.RefreshToken)
}
// 初始化超级管理员(公开接口,只能使用一次)
if r.SetupHandler != nil {
v1.POST("/admin/setup-super-admin", r.SetupHandler.SetupSuperAdmin)
}
// 需要认证的路由
authMiddleware := middleware.Auth(r.JWTService)
// === 访问日志中间件 ===
if r.AdminLogHandler != nil && r.LogService != nil {
accessLogConfig := &middleware.AccessLogConfig{
Enable: true,
SkipPaths: []string{"/health", "/api/v1/health"},
ServerIP: "0.0.0.0",
ServerPort: 8080,
}
r.engine.Use(middleware.AccessLogMiddleware(
r.LogService.OperationLog,
accessLogConfig,
))
}
// 用户路由
users := v1.Group("/users")
{
// 当前用户
users.GET("/me", authMiddleware, r.UserHandler.GetCurrentUser)
users.PUT("/me", authMiddleware, r.UserHandler.UpdateUser)
users.POST("/me/email/send-code", authMiddleware, r.UserHandler.SendEmailVerifyCode)
users.POST("/me/email/verify", authMiddleware, r.UserHandler.VerifyEmail)
users.POST("/me/avatar", authMiddleware, r.UploadHandler.UploadAvatar)
users.POST("/me/cover", authMiddleware, r.UploadHandler.UploadCover)
users.POST("/change-password/send-code", authMiddleware, r.UserHandler.SendChangePasswordCode)
users.POST("/change-password", authMiddleware, r.UserHandler.ChangePassword)
// 隐私设置
users.GET("/me/privacy", authMiddleware, r.UserHandler.GetPrivacySettings)
users.PUT("/me/privacy", authMiddleware, r.UserHandler.UpdatePrivacySettings)
// 账号注销
users.POST("/me/deactivate", authMiddleware, r.UserHandler.RequestAccountDeletion)
users.DELETE("/me/deactivate", authMiddleware, r.UserHandler.CancelAccountDeletion)
users.GET("/me/deletion-status", authMiddleware, r.UserHandler.GetDeletionStatus)
// 当前用户角色
if r.RoleHandler != nil {
users.GET("/me/roles", authMiddleware, r.RoleHandler.GetMyRoles)
}
// 搜索用户
users.GET("/search", middleware.OptionalAuth(r.JWTService), r.UserHandler.Search)
// 其他用户
users.GET("/:id", middleware.OptionalAuth(r.JWTService), r.UserHandler.GetUserByID)
users.POST("/:id/follow", authMiddleware, r.UserHandler.FollowUser)
users.DELETE("/:id/follow", authMiddleware, r.UserHandler.UnfollowUser)
users.POST("/:id/block", authMiddleware, r.UserHandler.BlockUser)
users.DELETE("/:id/block", authMiddleware, r.UserHandler.UnblockUser)
users.GET("/:id/block-status", authMiddleware, r.UserHandler.GetBlockStatus)
users.GET("/blocks", authMiddleware, r.UserHandler.GetBlockedUsers)
users.GET("/:id/following", authMiddleware, r.UserHandler.GetFollowingList)
users.GET("/:id/followers", authMiddleware, r.UserHandler.GetFollowersList)
// 用户帖子 - 使用 OptionalAuth 获取当前用户点赞/收藏状态
users.GET("/:id/posts", middleware.OptionalAuth(r.JWTService), r.PostHandler.GetUserPosts)
users.GET("/:id/favorites", middleware.OptionalAuth(r.JWTService), r.PostHandler.GetFavorites)
}
// 身份认证路由
if r.VerificationHandler != nil {
verification := v1.Group("/verification")
verification.Use(authMiddleware)
{
verification.GET("/status", r.VerificationHandler.GetVerificationStatus)
verification.POST("/submit", r.VerificationHandler.SubmitVerification)
verification.GET("/records", r.VerificationHandler.GetVerificationRecords)
}
}
// 二维码登录(公开)
if r.QRCodeHandler != nil {
qrcode := v1.Group("/auth/qrcode")
{
qrcode.GET("", r.QRCodeHandler.GetQRCode)
qrcode.GET("/events", r.QRCodeHandler.WSEvents)
}
// 二维码操作(需认证)
qrcodeAuth := v1.Group("/auth/qrcode")
qrcodeAuth.Use(authMiddleware)
{
qrcodeAuth.POST("/scan", r.QRCodeHandler.Scan)
qrcodeAuth.POST("/confirm", r.QRCodeHandler.Confirm)
qrcodeAuth.POST("/cancel", r.QRCodeHandler.Cancel)
}
}
// 认证路由(公开)
authPublic := v1.Group("/auth")
{
authPublic.GET("/check-username", r.UserHandler.CheckUsername)
}
// 帖子路由
posts := v1.Group("/posts")
{
// 使用 OptionalAuth 中间件来获取用户登录状态
posts.GET("", middleware.OptionalAuth(r.JWTService), r.PostHandler.List)
posts.GET("/search", middleware.OptionalAuth(r.JWTService), r.PostHandler.Search)
posts.GET("/suggest", middleware.OptionalAuth(r.JWTService), r.PostHandler.Suggest)
posts.GET("/:id", middleware.OptionalAuth(r.JWTService), r.PostHandler.GetByID)
posts.POST("", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Create)
posts.PUT("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Update)
posts.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Delete)
// 浏览量记录(可选认证,允许游客浏览)
posts.POST("/:id/view", middleware.OptionalAuth(r.JWTService), r.PostHandler.RecordView)
// 分享计数(可选认证;仅已发布帖子生效)
posts.POST("/:id/share", middleware.OptionalAuth(r.JWTService), r.PostHandler.RecordShare)
// 内链相关路由
posts.GET("/:id/related", middleware.OptionalAuth(r.JWTService), r.PostHandler.GetRelatedPosts)
posts.GET("/:id/refs", middleware.OptionalAuth(r.JWTService), r.PostHandler.GetReferencedPosts)
posts.POST("/:id/ref-click", middleware.OptionalAuth(r.JWTService), r.PostHandler.RecordRefClick)
// 点赞
posts.POST("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Like)
posts.DELETE("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Unlike)
// 收藏
posts.POST("/:id/favorite", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Favorite)
posts.DELETE("/:id/favorite", authMiddleware, middleware.RequireVerified(r.UserService), r.PostHandler.Unfavorite)
// 投票相关路由
posts.POST("/vote", authMiddleware, middleware.RequireVerified(r.UserService), r.VoteHandler.CreateVotePost) // 创建投票帖子
posts.GET("/:id/vote", middleware.OptionalAuth(r.JWTService), r.VoteHandler.GetVoteResult) // 获取投票结果
posts.POST("/:id/vote", authMiddleware, middleware.RequireVerified(r.UserService), r.VoteHandler.Vote) // 投票
posts.DELETE("/:id/vote", authMiddleware, middleware.RequireVerified(r.UserService), r.VoteHandler.Unvote) // 取消投票
}
// 频道路由(公开)
if r.ChannelHandler != nil {
channels := v1.Group("/channels")
{
channels.GET("", r.ChannelHandler.ListPublic)
}
}
// 二手交易路由
if r.TradeHandler != nil {
trade := v1.Group("/trade")
{
trade.GET("", middleware.OptionalAuth(r.JWTService), r.TradeHandler.List)
trade.GET("/:id", middleware.OptionalAuth(r.JWTService), r.TradeHandler.GetByID)
trade.POST("", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.Create)
trade.PUT("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.Update)
trade.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.Delete)
trade.PUT("/:id/status", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.UpdateStatus)
trade.POST("/:id/view", middleware.OptionalAuth(r.JWTService), r.TradeHandler.RecordView)
trade.POST("/:id/favorite", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.Favorite)
trade.DELETE("/:id/favorite", authMiddleware, middleware.RequireVerified(r.UserService), r.TradeHandler.Unfavorite)
}
}
// 课表路由
if r.ScheduleHandler != nil {
schedule := v1.Group("/schedule")
schedule.Use(authMiddleware)
{
schedule.GET("/courses", r.ScheduleHandler.ListCourses)
schedule.POST("/courses", r.ScheduleHandler.CreateCourse)
schedule.POST("/sync", r.ScheduleHandler.SyncSchedule) // 同步课表
schedule.PUT("/courses/:id", r.ScheduleHandler.UpdateCourse)
schedule.DELETE("/courses/:id", r.ScheduleHandler.DeleteCourse)
}
}
// 成绩路由
if r.GradeHandler != nil {
grades := v1.Group("/grades")
grades.Use(authMiddleware)
{
grades.GET("", r.GradeHandler.ListGrades)
grades.POST("/sync", r.GradeHandler.SyncGrades)
}
}
// 考试安排路由
if r.ExamHandler != nil {
exams := v1.Group("/exams")
exams.Use(authMiddleware)
{
exams.GET("", r.ExamHandler.ListExams)
exams.POST("/sync", r.ExamHandler.SyncExams)
}
}
// 空教室路由
if r.EmptyClassroomHandler != nil {
classrooms := v1.Group("/classrooms")
classrooms.Use(authMiddleware)
{
classrooms.GET("", r.EmptyClassroomHandler.ListEmptyClassrooms)
classrooms.POST("/sync", r.EmptyClassroomHandler.SyncEmptyClassrooms)
}
}
// 学习资料路由(公开)
if r.MaterialHandler != nil {
materials := v1.Group("/materials")
{
// 学科相关
materials.GET("/subjects", r.MaterialHandler.ListSubjects)
materials.GET("/subjects/:id", r.MaterialHandler.GetSubject)
// 资料相关
materials.GET("", r.MaterialHandler.ListMaterials)
materials.GET("/search", r.MaterialHandler.SearchMaterials)
materials.GET("/:id", r.MaterialHandler.GetMaterial)
materials.GET("/:id/download", r.MaterialHandler.DownloadMaterial)
}
}
// 投票选项路由
voteOptions := v1.Group("/vote-options")
voteOptions.Use(authMiddleware)
{
voteOptions.PUT("/:id", r.VoteHandler.UpdateVoteOption) // 更新选项
}
// 评论路由
comments := v1.Group("/comments")
{
comments.GET("/post/:id", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetByPostID)
comments.GET("/post/:id/cursor", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetByPostIDByCursor) // 帖子评论游标分页
comments.GET("/:id", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetByID)
comments.POST("", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Create)
comments.PUT("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Update)
comments.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Delete)
comments.GET("/:id/replies", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetReplies)
comments.GET("/:id/replies/flat", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetRepliesByRootID) // 扁平化分页获取回复
comments.GET("/:id/replies/cursor", middleware.OptionalAuth(r.JWTService), r.CommentHandler.GetRepliesByRootIDByCursor) // 回复游标分页
// 评论点赞
comments.POST("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Like)
comments.DELETE("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Unlike)
}
// 会话路由
conversations := v1.Group("/conversations")
conversations.Use(authMiddleware)
{
// ================================================================
// 新的 RESTful 风格路由(推荐使用)
// ================================================================
conversations.GET("", r.MessageHandler.HandleGetConversationList) // 列表
conversations.GET("/cursor", r.MessageHandler.GetConversationsByCursor) // 会话列表游标分页
conversations.POST("", middleware.RequireVerified(r.UserService), r.MessageHandler.HandleCreateConversation) // 创建
conversations.GET("/:id", r.MessageHandler.HandleGetConversation) // 详情
conversations.GET("/:id/messages", r.MessageHandler.HandleGetMessages) // 消息列表
conversations.GET("/:id/messages/cursor", r.MessageHandler.GetMessagesByCursor) // 消息列表游标分页
conversations.POST("/:id/messages", middleware.RequireVerified(r.UserService), r.MessageHandler.HandleSendMessage) // 发送消息
conversations.POST("/:id/read", r.MessageHandler.HandleMarkRead) // 标记已读
conversations.POST("/read-all", r.MessageHandler.HandleMarkReadAll) // 批量标记已读
conversations.PUT("/:id/pinned", r.MessageHandler.HandleSetConversationPinned) // 置顶设置
conversations.PUT("/:id/notification_muted", r.MessageHandler.HandleSetConversationNotificationMuted) // 免打扰设置
conversations.GET("/unread/count", r.MessageHandler.GetUnreadCount) // 未读数
conversations.GET("/sync-data", r.MessageHandler.HandleGetSyncData) // 同步元数据
conversations.GET("/sync", r.MessageHandler.HandleGetSyncByVersion) // 增量同步(版本日志)
conversations.POST("/:id/typing", r.MessageHandler.HandleTyping) // 输入状态
conversations.DELETE("/:id/self", r.MessageHandler.HandleDeleteConversationForSelf) // 删除会话(仅自己)
}
realtime := v1.Group("/realtime")
{
// WebSocket端点 - 在中间件之前处理认证通过query参数
realtime.GET("/ws", r.WSHandler.HandleWebSocket)
}
// 通话路由
if r.CallHandler != nil {
calls := v1.Group("/calls")
calls.Use(authMiddleware)
{
calls.GET("/history", r.CallHandler.GetCallHistory)
}
}
// LiveKit 通话路由
if r.LiveKitHandler != nil {
lk := v1.Group("/calls")
lk.Use(authMiddleware)
{
lk.GET("/token", r.LiveKitHandler.GetToken)
}
// Webhook 不需要认证LiveKit 服务端调用)
v1.POST("/calls/webhook", r.LiveKitHandler.HandleWebhook)
}
// 消息操作路由
messages := v1.Group("/messages")
messages.Use(authMiddleware)
{
// 撤回/删除消息(统一接口)
messages.POST("/delete_msg", middleware.RequireVerified(r.UserService), r.MessageHandler.HandleDeleteMsg)
}
// 举报路由
if r.ReportHandler != nil {
reports := v1.Group("/reports")
reports.Use(authMiddleware)
{
reports.POST("", r.ReportHandler.Create)
}
}
// 通知路由
notifications := v1.Group("/notifications")
{
notifications.GET("", authMiddleware, r.NotificationHandler.GetNotifications)
notifications.GET("/cursor", authMiddleware, r.NotificationHandler.GetNotificationsByCursor) // 通知游标分页
notifications.POST("/:id/read", authMiddleware, r.NotificationHandler.MarkAsRead)
notifications.POST("/read-all", authMiddleware, r.NotificationHandler.MarkAllAsRead)
notifications.GET("/unread-count", authMiddleware, r.NotificationHandler.GetUnreadCount)
notifications.DELETE("/:id", authMiddleware, r.NotificationHandler.DeleteNotification)
notifications.DELETE("", authMiddleware, r.NotificationHandler.ClearAllNotifications)
}
// 上传路由
uploads := v1.Group("/uploads")
{
uploads.POST("/images", authMiddleware, r.UploadHandler.UploadImage)
uploads.POST("/files", authMiddleware, r.UploadHandler.UploadFile)
}
// 推送相关路由
if r.PushHandler != nil {
pushGroup := v1.Group("/push")
pushGroup.Use(authMiddleware)
{
pushGroup.POST("/devices", r.PushHandler.RegisterDevice)
pushGroup.GET("/devices", r.PushHandler.GetMyDevices)
pushGroup.DELETE("/devices/:device_id", r.PushHandler.UnregisterDevice)
pushGroup.PUT("/devices/:device_id/token", r.PushHandler.UpdateDeviceToken)
pushGroup.GET("/records", r.PushHandler.GetPushRecords)
}
}
// 系统消息路由
if r.SystemMessageHandler != nil {
msgGroup := v1.Group("/messages")
msgGroup.Use(authMiddleware)
{
msgGroup.GET("/system", r.SystemMessageHandler.GetSystemMessages)
msgGroup.GET("/system/unread-count", r.SystemMessageHandler.GetUnreadCount)
msgGroup.PUT("/system/:id/read", r.SystemMessageHandler.MarkAsRead)
msgGroup.PUT("/system/read-all", r.SystemMessageHandler.MarkAllAsRead)
}
}
// 群组路由
if r.GroupHandler != nil {
groups := v1.Group("/groups")
groups.Use(authMiddleware)
{
// ================================================================
// 新的 RESTful 风格路由(推荐使用)
// ================================================================
// 群组基本操作
groups.GET("", r.GroupHandler.HandleGetUserGroups) // 列表
groups.GET("/cursor", r.GroupHandler.GetGroupsByCursor) // 群组游标分页
groups.POST("", r.GroupHandler.HandleCreateGroup) // 创建
groups.GET("/:id", r.GroupHandler.HandleGetGroupInfo) // 详情
groups.GET("/:id/me", r.GroupHandler.HandleGetMyMemberInfo) // 当前用户成员信息
groups.DELETE("/:id", r.GroupHandler.HandleDissolveGroup) // 解散群组
groups.POST("/:id/transfer", r.GroupHandler.HandleTransferOwner) // 转让群主
// 成员管理
groups.POST("/:id/invitations", r.GroupHandler.HandleInviteMembers) // 邀请成员
groups.POST("/:id/join-requests", r.GroupHandler.HandleJoinGroup) // 申请加群
groups.POST("/:id/join-requests/respond", r.GroupHandler.HandleRespondInvite) // 响应加群邀请/申请
groups.POST("/:id/leave", r.GroupHandler.HandleSetGroupLeave) // 退群
groups.GET("/:id/members", r.GroupHandler.HandleGetGroupMemberList) // 成员列表
groups.GET("/:id/members/cursor", r.GroupHandler.GetMembersByCursor) // 成员游标分页
groups.POST("/:id/members/kick", r.GroupHandler.HandleSetGroupKick) // 踢出成员
groups.PUT("/:id/members/:user_id/admin", r.GroupHandler.HandleSetGroupAdmin) // 设置管理员
groups.PUT("/:id/members/me/nickname", r.GroupHandler.HandleSetNickname) // 设置群昵称
groups.POST("/:id/members/ban", r.GroupHandler.HandleSetGroupBan) // 禁言成员
// 群设置
groups.PUT("/:id/ban", r.GroupHandler.HandleSetGroupWholeBan) // 全员禁言
groups.PUT("/:id/join-type", r.GroupHandler.HandleSetJoinType) // 加群方式
groups.PUT("/:id/name", r.GroupHandler.HandleSetGroupName) // 群名称
groups.PUT("/:id/avatar", r.GroupHandler.HandleSetGroupAvatar) // 群头像
groups.PUT("/:id/description", r.GroupHandler.HandleSetGroupDescription) // 群描述
// 群公告
groups.POST("/:id/announcements", r.GroupHandler.HandleCreateAnnouncement) // 创建公告
groups.GET("/:id/announcements", r.GroupHandler.HandleGetAnnouncements) // 公告列表
groups.GET("/:id/announcements/cursor", r.GroupHandler.GetAnnouncementsByCursor) // 公告游标分页
groups.DELETE("/:id/announcements/:announcement_id", r.GroupHandler.HandleDeleteAnnouncement) // 删除公告
// 加群请求处理
groups.POST("/:id/join-requests/handle", r.GroupHandler.HandleSetGroupAddRequest) // 处理加群请求
}
}
// 自定义表情路由
if r.StickerHandler != nil {
stickers := v1.Group("/stickers")
stickers.Use(authMiddleware)
{
stickers.GET("", r.StickerHandler.GetStickers)
stickers.POST("", r.StickerHandler.AddSticker)
stickers.DELETE("", r.StickerHandler.DeleteSticker)
stickers.POST("/reorder", r.StickerHandler.ReorderStickers)
stickers.GET("/check", r.StickerHandler.CheckStickerExists)
}
}
// 管理路由(需要管理员权限)
if r.RoleHandler != nil {
admin := v1.Group("/admin")
admin.Use(authMiddleware)
admin.Use(middleware.RequireRole(r.CasbinService, model.RoleAdmin, model.RoleSuperAdmin))
{
// 角色管理
admin.GET("/roles", r.RoleHandler.GetAllRoles)
admin.GET("/roles/:name", r.RoleHandler.GetRoleDetail)
admin.GET("/roles/:name/permissions", r.RoleHandler.GetRolePermissions)
admin.PUT("/roles/:name/permissions", r.RoleHandler.UpdateRolePermissions)
admin.GET("/permissions", r.RoleHandler.GetAllPermissions)
admin.GET("/users/:id/roles", r.RoleHandler.GetUserRoles)
admin.POST("/users/:id/roles", r.RoleHandler.AssignRole)
admin.DELETE("/users/:id/roles/:role", r.RoleHandler.RemoveRole)
// 用户管理
if r.AdminUserHandler != nil {
admin.GET("/users", r.AdminUserHandler.GetUserList)
admin.GET("/users/:id", r.AdminUserHandler.GetUserDetail)
admin.PUT("/users/:id/status", r.AdminUserHandler.UpdateUserStatus)
admin.GET("/users/:id/devices", r.AdminUserHandler.GetUserDevices)
}
// 帖子管理
if r.AdminPostHandler != nil {
admin.GET("/posts", r.AdminPostHandler.GetPostList)
admin.GET("/posts/:id", r.AdminPostHandler.GetPostDetail)
admin.DELETE("/posts/:id", r.AdminPostHandler.DeletePost)
admin.PUT("/posts/:id/moderate", r.AdminPostHandler.ModeratePost)
admin.POST("/posts/batch-delete", r.AdminPostHandler.BatchDeletePosts)
admin.POST("/posts/batch-moderate", r.AdminPostHandler.BatchModeratePosts)
admin.PUT("/posts/:id/pin", r.AdminPostHandler.SetPostPin)
admin.PUT("/posts/:id/feature", r.AdminPostHandler.SetPostFeature)
}
// 频道管理
if r.ChannelHandler != nil {
admin.GET("/channels", r.ChannelHandler.AdminList)
admin.POST("/channels", r.ChannelHandler.AdminCreate)
admin.PUT("/channels/:id", r.ChannelHandler.AdminUpdate)
admin.DELETE("/channels/:id", r.ChannelHandler.AdminDelete)
}
// 评论管理
if r.AdminCommentHandler != nil {
admin.GET("/comments", r.AdminCommentHandler.GetCommentList)
admin.GET("/comments/:id", r.AdminCommentHandler.GetCommentDetail)
admin.DELETE("/comments/:id", r.AdminCommentHandler.DeleteComment)
admin.PUT("/comments/:id/moderate", r.AdminCommentHandler.ModerateComment)
admin.POST("/comments/batch-delete", r.AdminCommentHandler.BatchDeleteComments)
admin.POST("/comments/batch-moderate", r.AdminCommentHandler.BatchModerateComments)
admin.GET("/comments/post/:postId", r.AdminCommentHandler.GetPostComments)
}
// 群组管理
if r.AdminGroupHandler != nil {
admin.GET("/groups", r.AdminGroupHandler.GetGroupList)
admin.GET("/groups/:id", r.AdminGroupHandler.GetGroupDetail)
admin.GET("/groups/:id/members", r.AdminGroupHandler.GetGroupMembers)
admin.DELETE("/groups/:id", r.AdminGroupHandler.DeleteGroup)
admin.PUT("/groups/:id/status", r.AdminGroupHandler.UpdateGroupStatus)
admin.DELETE("/groups/:id/members/:userId", r.AdminGroupHandler.RemoveMember)
admin.PUT("/groups/:id/transfer", r.AdminGroupHandler.TransferOwner)
}
// 仪表盘
if r.AdminDashboardHandler != nil {
admin.GET("/dashboard/stats", r.AdminDashboardHandler.GetStats)
admin.GET("/dashboard/user-activity", r.AdminDashboardHandler.GetUserActivityTrend)
admin.GET("/dashboard/content-stats", r.AdminDashboardHandler.GetContentStats)
admin.GET("/dashboard/pending-content", r.AdminDashboardHandler.GetPendingContent)
admin.GET("/dashboard/online-users", r.AdminDashboardHandler.GetOnlineUsers)
}
// 日志管理
if r.AdminLogHandler != nil {
logs := admin.Group("/logs")
{
logs.GET("/operations", r.AdminLogHandler.GetOperationLogs)
logs.GET("/logins", r.AdminLogHandler.GetLoginLogs)
logs.GET("/data-changes", r.AdminLogHandler.GetDataChangeLogs)
logs.GET("/statistics", r.AdminLogHandler.GetLogStatistics)
logs.GET("/export", r.AdminLogHandler.ExportLogs)
}
}
// 学习资料管理
if r.MaterialHandler != nil {
// 学科管理
admin.GET("/materials/subjects", r.MaterialHandler.AdminListSubjects)
admin.POST("/materials/subjects", r.MaterialHandler.AdminCreateSubject)
admin.PUT("/materials/subjects/:id", r.MaterialHandler.AdminUpdateSubject)
admin.DELETE("/materials/subjects/:id", r.MaterialHandler.AdminDeleteSubject)
// 资料管理
admin.GET("/materials", r.MaterialHandler.AdminListMaterials)
admin.GET("/materials/:id", r.MaterialHandler.AdminGetMaterial)
admin.POST("/materials", r.MaterialHandler.AdminCreateMaterial)
admin.PUT("/materials/:id", r.MaterialHandler.AdminUpdateMaterial)
admin.DELETE("/materials/:id", r.MaterialHandler.AdminDeleteMaterial)
}
// 举报管理
if r.AdminReportHandler != nil {
admin.GET("/reports", r.AdminReportHandler.List)
admin.GET("/reports/:id", r.AdminReportHandler.Detail)
admin.PUT("/reports/:id/handle", r.AdminReportHandler.Handle)
admin.POST("/reports/batch-handle", r.AdminReportHandler.BatchHandle)
}
// 身份认证管理
if r.AdminVerificationHandler != nil {
admin.GET("/verifications", r.AdminVerificationHandler.ListVerifications)
admin.GET("/verifications/:id", r.AdminVerificationHandler.GetVerificationDetail)
admin.PUT("/verifications/:id/review", r.AdminVerificationHandler.ReviewVerification)
}
// 用户资料审核管理
if r.AdminProfileAuditHandler != nil {
admin.GET("/profile-audits", r.AdminProfileAuditHandler.GetPendingList)
admin.PUT("/profile-audits/:id/moderate", r.AdminProfileAuditHandler.ModerateAudit)
admin.POST("/profile-audits/batch-moderate", r.AdminProfileAuditHandler.BatchModerate)
}
}
}
}
}
// Engine 获取引擎
func (r *Router) Engine() *gin.Engine {
return r.engine
}