refactor(server): decouple services and improve architecture
All checks were successful
Build Backend / build (push) Successful in 4m55s
Build Backend / build-docker (push) Successful in 10m34s

- Introduce interfaces for all major services (JWT, PostAI, Comment, Message, Notification, QRCodeLogin, Upload, Vote, etc.) to support dependency inversion.
- Move query parameters from `internal/dto` to a new `internal/query` package to separate request payloads from data transfer objects.
- Refactor `internal/router` to use embedded `RouterDeps` for cleaner dependency management.
- Decouple handlers from repositories by injecting services instead of direct repository access, ensuring proper layering.
- Improve database initialization by moving it from `internal/model` to `internal/database`.
- Optimize message decryption by implementing a more efficient `BatchDecrypt` method in `MessageEncryptor` using a worker pool.
- Enhance error handling and security by implementing fail-fast checks for encryption key length during startup.
- Clean up unused code, including the `avatar` package and several unused DTOs.
This commit is contained in:
2026-06-15 03:41:59 +08:00
parent 9951043034
commit d9aa4b46c3
78 changed files with 2156 additions and 1640 deletions

View File

@@ -1,4 +1,4 @@
package router
package router
import (
"github.com/gin-gonic/gin"
@@ -28,7 +28,7 @@ type RouterDeps struct {
ScheduleHandler *handler.ScheduleHandler
GradeHandler *handler.GradeHandler
ExamHandler *handler.ExamHandler
EmptyClassroomHandler *handler.EmptyClassroomHandler
EmptyClassroomHandler *handler.EmptyClassroomHandler
RoleHandler *handler.RoleHandler
AdminUserHandler *handler.AdminUserHandler
AdminPostHandler *handler.AdminPostHandler
@@ -48,54 +48,19 @@ type RouterDeps struct {
SetupHandler *handler.SetupHandler
TradeHandler *handler.TradeHandler
WSHandler *handler.WSHandler
JWTService *service.JWTService
JWTService service.JWTService
LogService *service.LogService
ActivityService service.UserActivityService
CasbinService service.CasbinService
UserService service.UserService
}
// Router 路由配置
// 通过嵌入 RouterDeps 复用所有依赖字段,消除 RouterDeps 与 Router 之间的字段重复。
// 所有 deps 字段(如 userHandler、jwtService经嵌入提升后仍以 r.UserHandler 形式访问。
type Router struct {
engine *gin.Engine
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
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
reportHandler *handler.ReportHandler
adminReportHandler *handler.AdminReportHandler
verificationHandler *handler.VerificationHandler
adminVerificationHandler *handler.AdminVerificationHandler
adminProfileAuditHandler *handler.AdminProfileAuditHandler
setupHandler *handler.SetupHandler
tradeHandler *handler.TradeHandler
wsHandler *handler.WSHandler
logService *service.LogService
jwtService *service.JWTService
casbinService service.CasbinService
*RouterDeps
engine *gin.Engine
}
// New 创建路由
@@ -104,46 +69,8 @@ func New(deps RouterDeps) *Router {
deps.UserHandler.SetActivityService(deps.ActivityService)
r := &Router{
engine: gin.Default(),
userRepo: deps.UserRepo,
userHandler: deps.UserHandler,
postHandler: deps.PostHandler,
commentHandler: deps.CommentHandler,
messageHandler: deps.MessageHandler,
notificationHandler: deps.NotificationHandler,
uploadHandler: deps.UploadHandler,
pushHandler: deps.PushHandler,
systemMessageHandler: deps.SystemMessageHandler,
groupHandler: deps.GroupHandler,
stickerHandler: deps.StickerHandler,
voteHandler: deps.VoteHandler,
channelHandler: deps.ChannelHandler,
scheduleHandler: deps.ScheduleHandler,
gradeHandler: deps.GradeHandler,
examHandler: deps.ExamHandler,
emptyClassroomHandler: deps.EmptyClassroomHandler,
roleHandler: deps.RoleHandler,
adminUserHandler: deps.AdminUserHandler,
adminPostHandler: deps.AdminPostHandler,
adminCommentHandler: deps.AdminCommentHandler,
adminGroupHandler: deps.AdminGroupHandler,
adminDashboardHandler: deps.AdminDashboardHandler,
adminLogHandler: deps.AdminLogHandler,
qrcodeHandler: deps.QRCodeHandler,
materialHandler: deps.MaterialHandler,
callHandler: deps.CallHandler,
liveKitHandler: deps.LiveKitHandler,
reportHandler: deps.ReportHandler,
adminReportHandler: deps.AdminReportHandler,
verificationHandler: deps.VerificationHandler,
adminVerificationHandler: deps.AdminVerificationHandler,
adminProfileAuditHandler: deps.AdminProfileAuditHandler,
setupHandler: deps.SetupHandler,
tradeHandler: deps.TradeHandler,
logService: deps.LogService,
jwtService: deps.JWTService,
casbinService: deps.CasbinService,
wsHandler: deps.WSHandler,
RouterDeps: &deps,
engine: gin.Default(),
}
r.setupRoutes()
@@ -169,25 +96,25 @@ func (r *Router) setupRoutes() {
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)
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)
if r.SetupHandler != nil {
v1.POST("/admin/setup-super-admin", r.SetupHandler.SetupSuperAdmin)
}
// 需要认证的路由
authMiddleware := middleware.Auth(r.jwtService)
authMiddleware := middleware.Auth(r.JWTService)
// === 访问日志中间件 ===
if r.adminLogHandler != nil && r.logService != nil {
if r.AdminLogHandler != nil && r.LogService != nil {
accessLogConfig := &middleware.AccessLogConfig{
Enable: true,
SkipPaths: []string{"/health", "/api/v1/health"},
@@ -195,211 +122,208 @@ func (r *Router) setupRoutes() {
ServerPort: 8080,
}
r.engine.Use(middleware.AccessLogMiddleware(
r.logService.OperationLog,
r.LogService.OperationLog,
accessLogConfig,
))
}
// Casbin 权限中间件(暂不全局启用,可根据需要在特定路由组上使用)
// casbinMiddleware := middleware.CasbinAuth(r.casbinService)
// 用户路由
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", 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.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)
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)
if r.RoleHandler != nil {
users.GET("/me/roles", authMiddleware, r.RoleHandler.GetMyRoles)
}
// 搜索用户
users.GET("/search", middleware.OptionalAuth(r.jwtService), r.userHandler.Search)
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)
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)
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 {
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)
verification.GET("/status", r.VerificationHandler.GetVerificationStatus)
verification.POST("/submit", r.VerificationHandler.SubmitVerification)
verification.GET("/records", r.VerificationHandler.GetVerificationRecords)
}
}
// 二维码登录(公开)
if r.qrcodeHandler != nil {
if r.QRCodeHandler != nil {
qrcode := v1.Group("/auth/qrcode")
{
qrcode.GET("", r.qrcodeHandler.GetQRCode)
qrcode.GET("/events", r.qrcodeHandler.WSEvents)
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)
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)
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.userRepo), r.postHandler.Create)
posts.PUT("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), r.postHandler.Update)
posts.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), r.postHandler.Delete)
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/view", middleware.OptionalAuth(r.JWTService), r.PostHandler.RecordView)
// 分享计数(可选认证;仅已发布帖子生效)
posts.POST("/:id/share", middleware.OptionalAuth(r.jwtService), r.postHandler.RecordShare)
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.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.userRepo), r.postHandler.Like)
posts.DELETE("/:id/like", authMiddleware, middleware.RequireVerified(r.userRepo), r.postHandler.Unlike)
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.userRepo), r.postHandler.Favorite)
posts.DELETE("/:id/favorite", authMiddleware, middleware.RequireVerified(r.userRepo), r.postHandler.Unfavorite)
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.userRepo), r.voteHandler.CreateVotePost) // 创建投票帖子
posts.GET("/:id/vote", middleware.OptionalAuth(r.jwtService), r.voteHandler.GetVoteResult) // 获取投票结果
posts.POST("/:id/vote", authMiddleware, middleware.RequireVerified(r.userRepo), r.voteHandler.Vote) // 投票
posts.DELETE("/:id/vote", authMiddleware, middleware.RequireVerified(r.userRepo), r.voteHandler.Unvote) // 取消投票
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 {
if r.ChannelHandler != nil {
channels := v1.Group("/channels")
{
channels.GET("", r.channelHandler.ListPublic)
channels.GET("", r.ChannelHandler.ListPublic)
}
}
// 二手交易路由
if r.tradeHandler != nil {
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.userRepo), r.tradeHandler.Create)
trade.PUT("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), r.tradeHandler.Update)
trade.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), r.tradeHandler.Delete)
trade.PUT("/:id/status", authMiddleware, middleware.RequireVerified(r.userRepo), r.tradeHandler.UpdateStatus)
trade.POST("/:id/view", middleware.OptionalAuth(r.jwtService), r.tradeHandler.RecordView)
trade.POST("/:id/favorite", authMiddleware, middleware.RequireVerified(r.userRepo), r.tradeHandler.Favorite)
trade.DELETE("/:id/favorite", authMiddleware, middleware.RequireVerified(r.userRepo), r.tradeHandler.Unfavorite)
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 {
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)
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 {
if r.GradeHandler != nil {
grades := v1.Group("/grades")
grades.Use(authMiddleware)
{
grades.GET("", r.gradeHandler.ListGrades)
grades.POST("/sync", r.gradeHandler.SyncGrades)
grades.GET("", r.GradeHandler.ListGrades)
grades.POST("/sync", r.GradeHandler.SyncGrades)
}
}
// 考试安排路由
if r.examHandler != nil {
if r.ExamHandler != nil {
exams := v1.Group("/exams")
exams.Use(authMiddleware)
{
exams.GET("", r.examHandler.ListExams)
exams.POST("/sync", r.examHandler.SyncExams)
exams.GET("", r.ExamHandler.ListExams)
exams.POST("/sync", r.ExamHandler.SyncExams)
}
}
// 空教室路由
if r.emptyClassroomHandler != nil {
if r.EmptyClassroomHandler != nil {
classrooms := v1.Group("/classrooms")
classrooms.Use(authMiddleware)
{
classrooms.GET("", r.emptyClassroomHandler.ListEmptyClassrooms)
classrooms.POST("/sync", r.emptyClassroomHandler.SyncEmptyClassrooms)
classrooms.GET("", r.EmptyClassroomHandler.ListEmptyClassrooms)
classrooms.POST("/sync", r.EmptyClassroomHandler.SyncEmptyClassrooms)
}
}
// 学习资料路由(公开)
if r.materialHandler != nil {
if r.MaterialHandler != nil {
materials := v1.Group("/materials")
{
// 学科相关
materials.GET("/subjects", r.materialHandler.ListSubjects)
materials.GET("/subjects/:id", r.materialHandler.GetSubject)
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)
materials.GET("", r.MaterialHandler.ListMaterials)
materials.GET("/search", r.MaterialHandler.SearchMaterials)
materials.GET("/:id", r.MaterialHandler.GetMaterial)
materials.GET("/:id/download", r.MaterialHandler.DownloadMaterial)
}
}
@@ -407,24 +331,24 @@ func (r *Router) setupRoutes() {
voteOptions := v1.Group("/vote-options")
voteOptions.Use(authMiddleware)
{
voteOptions.PUT("/:id", r.voteHandler.UpdateVoteOption) // 更新选项
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.userRepo), r.commentHandler.Create)
comments.PUT("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), r.commentHandler.Update)
comments.DELETE("/:id", authMiddleware, middleware.RequireVerified(r.userRepo), 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.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.userRepo), r.commentHandler.Like)
comments.DELETE("/:id/like", authMiddleware, middleware.RequireVerified(r.userRepo), r.commentHandler.Unlike)
comments.POST("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Like)
comments.DELETE("/:id/like", authMiddleware, middleware.RequireVerified(r.UserService), r.CommentHandler.Unlike)
}
// 会话路由
@@ -434,49 +358,49 @@ func (r *Router) setupRoutes() {
// ================================================================
// 新的 RESTful 风格路由(推荐使用)
// ================================================================
conversations.GET("", r.messageHandler.HandleGetConversationList) // 列表
conversations.GET("/cursor", r.messageHandler.GetConversationsByCursor) // 会话列表游标分页
conversations.POST("", middleware.RequireVerified(r.userRepo), 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.userRepo), 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) // 删除会话(仅自己)
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)
realtime.GET("/ws", r.WSHandler.HandleWebSocket)
}
// 通话路由
if r.callHandler != nil {
if r.CallHandler != nil {
calls := v1.Group("/calls")
calls.Use(authMiddleware)
{
calls.GET("/history", r.callHandler.GetCallHistory)
calls.GET("/history", r.CallHandler.GetCallHistory)
}
}
// LiveKit 通话路由
if r.liveKitHandler != nil {
if r.LiveKitHandler != nil {
lk := v1.Group("/calls")
lk.Use(authMiddleware)
{
lk.GET("/token", r.liveKitHandler.GetToken)
lk.GET("/token", r.LiveKitHandler.GetToken)
}
// Webhook 不需要认证LiveKit 服务端调用)
v1.POST("/calls/webhook", r.liveKitHandler.HandleWebhook)
v1.POST("/calls/webhook", r.LiveKitHandler.HandleWebhook)
}
// 消息操作路由
@@ -484,63 +408,63 @@ func (r *Router) setupRoutes() {
messages.Use(authMiddleware)
{
// 撤回/删除消息(统一接口)
messages.POST("/delete_msg", middleware.RequireVerified(r.userRepo), r.messageHandler.HandleDeleteMsg)
messages.POST("/delete_msg", middleware.RequireVerified(r.UserService), r.MessageHandler.HandleDeleteMsg)
}
// 举报路由
if r.reportHandler != nil {
if r.ReportHandler != nil {
reports := v1.Group("/reports")
reports.Use(authMiddleware)
{
reports.POST("", r.reportHandler.Create)
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)
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("/images", authMiddleware, r.UploadHandler.UploadImage)
}
// 推送相关路由
if r.pushHandler != nil {
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)
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 {
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)
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 {
if r.GroupHandler != nil {
groups := v1.Group("/groups")
groups.Use(authMiddleware)
{
@@ -548,179 +472,179 @@ func (r *Router) setupRoutes() {
// 新的 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.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.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.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/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) // 处理加群请求
groups.POST("/:id/join-requests/handle", r.GroupHandler.HandleSetGroupAddRequest) // 处理加群请求
}
}
// 自定义表情路由
if r.stickerHandler != nil {
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)
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 {
if r.RoleHandler != nil {
admin := v1.Group("/admin")
admin.Use(authMiddleware)
admin.Use(middleware.RequireRole(r.casbinService, model.RoleAdmin, model.RoleSuperAdmin))
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)
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)
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)
}
// 帖子管理
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.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.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.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.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.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 {
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)
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 {
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/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)
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.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.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)
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)
}
}
}