tyapi-server/internal/infrastructure/http/routes/certification_routes.go

package routes

import (
	"go.uber.org/zap"

	"tyapi-server/internal/infrastructure/http/handlers"
	"tyapi-server/internal/shared/http"
	"tyapi-server/internal/shared/middleware"
)

// CertificationRoutes 认证路由
type CertificationRoutes struct {
	handler        *handlers.CertificationHandler
	router         *http.GinRouter
	logger         *zap.Logger
	auth           *middleware.JWTAuthMiddleware
	optional       *middleware.OptionalAuthMiddleware
	dailyRateLimit *middleware.DailyRateLimitMiddleware
}

// NewCertificationRoutes 创建认证路由
func NewCertificationRoutes(
	handler *handlers.CertificationHandler,
	router *http.GinRouter,
	logger *zap.Logger,
	auth *middleware.JWTAuthMiddleware,
	optional *middleware.OptionalAuthMiddleware,
	dailyRateLimit *middleware.DailyRateLimitMiddleware,
) *CertificationRoutes {
	return &CertificationRoutes{
		handler:        handler,
		router:         router,
		logger:         logger,
		auth:           auth,
		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)

			// 3. 申请合同签署
			authGroup.POST("/apply-contract", r.handler.ApplyContract)

			// 前端确认是否完成认证
			authGroup.POST("/confirm-auth", r.handler.ConfirmAuth)

			// 前端确认是否完成签署
			authGroup.POST("/confirm-sign", r.handler.ConfirmSign)

		}

		// 回调路由（不需要认证，但需要验证签名）
		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
}