feat(verification): add user identity verification system

Implement a complete user identity verification system with support for multiple identity types (student, teacher, staff, alumni). The system includes user-facing verification submission and status checking endpoints, admin endpoints for reviewing verification requests, middleware for protecting verification-required routes, and integration with the user model to track verification status.
2026-04-05 20:27:03 +08:00
parent b640c9a249
commit 6429322217
17 changed files with 977 additions and 75 deletions
--- a/internal/router/router.go
+++ b/internal/router/router.go
@@ -11,36 +11,38 @@ import (

 // Router 路由配置
 type Router struct {
-	engine                *gin.Engine
-	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
-	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
-	reportHandler        *handler.ReportHandler
-	adminReportHandler   *handler.AdminReportHandler
-	wsHandler             *handler.WSHandler
-	logService            *service.LogService
-	jwtService            *service.JWTService
-	casbinService         service.CasbinService
+	engine                   *gin.Engine
+	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
+	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
+	reportHandler            *handler.ReportHandler
+	adminReportHandler       *handler.AdminReportHandler
+	verificationHandler      *handler.VerificationHandler
+	adminVerificationHandler *handler.AdminVerificationHandler
+	wsHandler                *handler.WSHandler
+	logService               *service.LogService
+	jwtService               *service.JWTService
+	casbinService            service.CasbinService
 }

 // New 创建路由
@@ -71,6 +73,8 @@ func New(
 	callHandler *handler.CallHandler,
 	reportHandler *handler.ReportHandler,
 	adminReportHandler *handler.AdminReportHandler,
+	verificationHandler *handler.VerificationHandler,
+	adminVerificationHandler *handler.AdminVerificationHandler,
 	logService *service.LogService,
 	activityService service.UserActivityService,
 	casbinService service.CasbinService,
@@ -82,36 +86,38 @@ func New(
 	userHandler.SetActivityService(activityService)

 	r := &Router{
-		engine:                gin.Default(),
-		userHandler:           userHandler,
-		postHandler:           postHandler,
-		commentHandler:        commentHandler,
-		messageHandler:        messageHandler,
-		notificationHandler:   notificationHandler,
-		uploadHandler:         uploadHandler,
-		pushHandler:           pushHandler,
-		systemMessageHandler:  systemMessageHandler,
-		groupHandler:          groupHandler,
-		stickerHandler:        stickerHandler,
-		voteHandler:           voteHandler,
-		channelHandler:        channelHandler,
-		scheduleHandler:       scheduleHandler,
-		roleHandler:           roleHandler,
-		adminUserHandler:      adminUserHandler,
-		adminPostHandler:      adminPostHandler,
-		adminCommentHandler:   adminCommentHandler,
-		adminGroupHandler:     adminGroupHandler,
-		adminDashboardHandler: adminDashboardHandler,
-		adminLogHandler:       adminLogHandler,
-		qrcodeHandler:         qrcodeHandler,
-		materialHandler:       materialHandler,
-		callHandler:          callHandler,
-		reportHandler:        reportHandler,
-		adminReportHandler:   adminReportHandler,
-		logService:            logService,
-		jwtService:            jwtService,
-		casbinService:         casbinService,
-		wsHandler:             wsHandler,
+		engine:                   gin.Default(),
+		userHandler:              userHandler,
+		postHandler:              postHandler,
+		commentHandler:           commentHandler,
+		messageHandler:           messageHandler,
+		notificationHandler:      notificationHandler,
+		uploadHandler:            uploadHandler,
+		pushHandler:              pushHandler,
+		systemMessageHandler:     systemMessageHandler,
+		groupHandler:             groupHandler,
+		stickerHandler:           stickerHandler,
+		voteHandler:              voteHandler,
+		channelHandler:           channelHandler,
+		scheduleHandler:          scheduleHandler,
+		roleHandler:              roleHandler,
+		adminUserHandler:         adminUserHandler,
+		adminPostHandler:         adminPostHandler,
+		adminCommentHandler:      adminCommentHandler,
+		adminGroupHandler:        adminGroupHandler,
+		adminDashboardHandler:    adminDashboardHandler,
+		adminLogHandler:          adminLogHandler,
+		qrcodeHandler:            qrcodeHandler,
+		materialHandler:          materialHandler,
+		callHandler:              callHandler,
+		reportHandler:            reportHandler,
+		adminReportHandler:       adminReportHandler,
+		verificationHandler:      verificationHandler,
+		adminVerificationHandler: adminVerificationHandler,
+		logService:               logService,
+		jwtService:               jwtService,
+		casbinService:            casbinService,
+		wsHandler:                wsHandler,
 	}

 	r.setupRoutes()
@@ -201,6 +207,17 @@ func (r *Router) setupRoutes() {
 			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")
@@ -580,6 +597,13 @@ func (r *Router) setupRoutes() {
 					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)
+				}
 			}
 		}
 	}