f

internal/infrastructure/http/routes/certification_routes.go

@@ -0,0 +1,129 @@
+package routes
+
+import (
+	"go.uber.org/zap"
+
+	"hyapi-server/internal/infrastructure/http/handlers"
+	"hyapi-server/internal/shared/http"
+	"hyapi-server/internal/shared/middleware"
+)
+
+// CertificationRoutes 认证路由
+type CertificationRoutes struct {
+	handler        *handlers.CertificationHandler
+	router         *http.GinRouter
+	logger         *zap.Logger
+	auth           *middleware.JWTAuthMiddleware
+	admin          *middleware.AdminAuthMiddleware
+	optional       *middleware.OptionalAuthMiddleware
+	dailyRateLimit *middleware.DailyRateLimitMiddleware
+}
+
+// NewCertificationRoutes 创建认证路由
+func NewCertificationRoutes(
+	handler *handlers.CertificationHandler,
+	router *http.GinRouter,
+	logger *zap.Logger,
+	auth *middleware.JWTAuthMiddleware,
+	admin *middleware.AdminAuthMiddleware,
+	optional *middleware.OptionalAuthMiddleware,
+	dailyRateLimit *middleware.DailyRateLimitMiddleware,
+) *CertificationRoutes {
+	return &CertificationRoutes{
+		handler:        handler,
+		router:         router,
+		logger:         logger,
+		auth:           auth,
+		admin:          admin,
+		optional:       optional,
+		dailyRateLimit: dailyRateLimit,
+	}
+}
+
+// Register 注册认证路由
+func (r *CertificationRoutes) Register(router *http.GinRouter) {
+	// 认证管理路由组
+	certificationGroup := router.GetEngine().Group("/api/v1/certifications")
+	{
+		// 需要认证的路由
+		authGroup := certificationGroup.Group("")
+		authGroup.Use(r.auth.Handle())
+		{
+			authGroup.GET("", r.handler.ListCertifications) // 查询认证列表（管理员）
+
+			// 1. 获取认证详情
+			authGroup.GET("/details", r.handler.GetCertification)
+
+			// 2. 提交企业信息（应用每日限流）
+			authGroup.POST("/enterprise-info", r.dailyRateLimit.Handle(), r.handler.SubmitEnterpriseInfo)
+
+			// OCR营业执照识别接口
+			authGroup.POST("/ocr/business-license", r.handler.RecognizeBusinessLicense)
+
+			// 认证图片上传（七牛云，用于企业信息中的各类图片）
+			authGroup.POST("/upload", r.handler.UploadCertificationFile)
+
+			// 3. 申请合同签署
+			authGroup.POST("/apply-contract", r.handler.ApplyContract)
+
+			// 前端确认是否完成认证
+			authGroup.POST("/confirm-auth", r.handler.ConfirmAuth)
+
+			// 前端确认是否完成签署
+			authGroup.POST("/confirm-sign", r.handler.ConfirmSign)
+
+			// 管理员代用户完成认证（暂不关联合同）
+			authGroup.POST("/admin/complete-without-contract", r.handler.AdminCompleteCertificationWithoutContract)
+
+		}
+
+		// 管理端企业审核（需管理员权限，以状态机状态为准）
+		adminGroup := certificationGroup.Group("/admin")
+		adminGroup.Use(r.auth.Handle())
+		adminGroup.Use(r.admin.Handle())
+		{
+			adminGroup.POST("/transition-status", r.handler.AdminTransitionCertificationStatus)
+		}
+		adminCertGroup := adminGroup.Group("/submit-records")
+		{
+			adminCertGroup.GET("", r.handler.AdminListSubmitRecords)
+			adminCertGroup.GET("/:id", r.handler.AdminGetSubmitRecordByID)
+			adminCertGroup.POST("/:id/approve", r.handler.AdminApproveSubmitRecord)
+			adminCertGroup.POST("/:id/reject", r.handler.AdminRejectSubmitRecord)
+		}
+
+		// 回调路由（不需要认证，但需要验证签名）
+		callbackGroup := certificationGroup.Group("/callbacks")
+		{
+			callbackGroup.POST("/esign", r.handler.HandleEsignCallback) // e签宝回调（统一处理企业认证和合同签署回调）
+		}
+	}
+
+	r.logger.Info("认证路由注册完成")
+}
+
+// GetRoutes 获取路由信息（用于调试）
+func (r *CertificationRoutes) GetRoutes() []RouteInfo {
+	return []RouteInfo{
+		{Method: "POST", Path: "/api/v1/certifications", Handler: "CreateCertification", Auth: true},
+		{Method: "GET", Path: "/api/v1/certifications/:id", Handler: "GetCertification", Auth: true},
+		{Method: "GET", Path: "/api/v1/certifications/user", Handler: "GetUserCertifications", Auth: true},
+		{Method: "GET", Path: "/api/v1/certifications", Handler: "ListCertifications", Auth: true},
+		{Method: "GET", Path: "/api/v1/certifications/statistics", Handler: "GetCertificationStatistics", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/:id/enterprise-info", Handler: "SubmitEnterpriseInfo", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/ocr/business-license", Handler: "RecognizeBusinessLicense", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/apply-contract", Handler: "ApplyContract", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/retry", Handler: "RetryOperation", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/force-transition", Handler: "ForceTransitionStatus", Auth: true},
+		{Method: "GET", Path: "/api/v1/certifications/monitoring", Handler: "GetSystemMonitoring", Auth: true},
+		{Method: "POST", Path: "/api/v1/certifications/callbacks/esign", Handler: "HandleEsignCallback", Auth: false},
+	}
+}
+
+// RouteInfo 路由信息
+type RouteInfo struct {
+	Method  string
+	Path    string
+	Handler string
+	Auth    bool
+}