backend/internal/handler/routes.go

package handler

import (
	"carrotskin/internal/container"
	"carrotskin/internal/middleware"
	"carrotskin/pkg/auth"
	"carrotskin/pkg/config"

	"github.com/gin-gonic/gin"
	swaggerFiles "github.com/swaggo/files"
	ginSwagger "github.com/swaggo/gin-swagger"
)

// Handlers 集中管理所有Handler
type Handlers struct {
	Auth       *AuthHandler
	User       *UserHandler
	Texture    *TextureHandler
	Profile    *ProfileHandler
	Captcha    *CaptchaHandler
	Yggdrasil  *YggdrasilHandler
	CustomSkin *CustomSkinHandler
	Admin      *AdminHandler
}

// NewHandlers 创建所有Handler实例
func NewHandlers(c *container.Container) *Handlers {
	return &Handlers{
		Auth:       NewAuthHandler(c),
		User:       NewUserHandler(c),
		Texture:    NewTextureHandler(c),
		Profile:    NewProfileHandler(c),
		Captcha:    NewCaptchaHandler(c),
		Yggdrasil:  NewYggdrasilHandler(c),
		CustomSkin: NewCustomSkinHandler(c),
		Admin:      NewAdminHandler(c),
	}
}

// RegisterRoutesWithDI 使用依赖注入注册所有路由
func RegisterRoutesWithDI(router *gin.Engine, c *container.Container) {
	// 健康检查路由
	router.GET("/health", HealthCheck)

	// Swagger文档路由
	cfg, _ := config.GetConfig()
	if cfg != nil && cfg.Server.SwaggerEnabled {
		router.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
	}

	// 创建Handler实例
	h := NewHandlers(c)

	// API路由组
	v1 := router.Group("/api/v1")
	{
		// 认证路由（无需JWT）
		registerAuthRoutes(v1, h.Auth)

		// 用户路由（需要JWT认证）
		registerUserRoutes(v1, h.User, c.JWT)

		// 材质路由
		registerTextureRoutes(v1, h.Texture, c.JWT)

		// 档案路由
		registerProfileRoutesWithDI(v1, h.Profile, c.JWT)

		// 验证码路由
		registerCaptchaRoutesWithDI(v1, h.Captcha)

		// Yggdrasil API路由组
		registerYggdrasilRoutesWithDI(v1, h.Yggdrasil)

		// CustomSkinAPI 路由
		registerCustomSkinRoutes(v1, h.CustomSkin)

		// 管理员路由（需要管理员权限）
		registerAdminRoutes(v1, c, h.Admin)
	}
}

// registerAuthRoutes 注册认证路由
func registerAuthRoutes(v1 *gin.RouterGroup, h *AuthHandler) {
	authGroup := v1.Group("/auth")
	{
		authGroup.POST("/register", h.Register)
		authGroup.POST("/login", h.Login)
		authGroup.POST("/send-code", h.SendVerificationCode)
		authGroup.POST("/reset-password", h.ResetPassword)
	}
}

// registerUserRoutes 注册用户路由
func registerUserRoutes(v1 *gin.RouterGroup, h *UserHandler, jwtService *auth.JWTService) {
	userGroup := v1.Group("/user")
	userGroup.Use(middleware.AuthMiddleware(jwtService))
	{
		userGroup.GET("/profile", h.GetProfile)
		userGroup.PUT("/profile", h.UpdateProfile)

		// 头像相关
		userGroup.POST("/avatar/upload", h.UploadAvatar) // 直接上传头像文件
		userGroup.PUT("/avatar", h.UpdateAvatar)         // 更新头像URL（外部URL）

		// 更换邮箱
		userGroup.POST("/change-email", h.ChangeEmail)

		// Yggdrasil密码相关
		userGroup.POST("/yggdrasil-password/reset", h.ResetYggdrasilPassword)
	}
}

// registerTextureRoutes 注册材质路由
func registerTextureRoutes(v1 *gin.RouterGroup, h *TextureHandler, jwtService *auth.JWTService) {
	textureGroup := v1.Group("/texture")
	{
		// 公开路由（无需认证）
		textureGroup.GET("", h.Search)
		textureGroup.GET("/:id", h.Get)

		// 需要认证的路由
		textureAuth := textureGroup.Group("")
		textureAuth.Use(middleware.AuthMiddleware(jwtService))
		{
			textureAuth.POST("/upload", h.Upload) // 直接上传文件
			textureAuth.PUT("/:id", h.Update)
			textureAuth.DELETE("/:id", h.Delete)
			textureAuth.POST("/:id/favorite", h.ToggleFavorite)
			textureAuth.GET("/my", h.GetUserTextures)
			textureAuth.GET("/favorites", h.GetUserFavorites)
		}
	}
}

// registerProfileRoutesWithDI 注册档案路由（依赖注入版本）
func registerProfileRoutesWithDI(v1 *gin.RouterGroup, h *ProfileHandler, jwtService *auth.JWTService) {
	profileGroup := v1.Group("/profile")
	{
		// 公开路由（无需认证）
		profileGroup.GET("/:uuid", h.Get)

		// 需要认证的路由
		profileAuth := profileGroup.Group("")
		profileAuth.Use(middleware.AuthMiddleware(jwtService))
		{
			// 同时支持 /api/v1/profile 和 /api/v1/profile/ 两种形式返回列表与创建
			profileAuth.GET("", h.List)
			profileAuth.POST("", h.Create)
			profileAuth.POST("/", h.Create)
			profileAuth.GET("/", h.List)
			profileAuth.PUT("/:uuid", h.Update)
			profileAuth.DELETE("/:uuid", h.Delete)
		}
	}
}

// registerCaptchaRoutesWithDI 注册验证码路由（依赖注入版本）
func registerCaptchaRoutesWithDI(v1 *gin.RouterGroup, h *CaptchaHandler) {
	captchaGroup := v1.Group("/captcha")
	{
		captchaGroup.GET("/generate", h.Generate)
		captchaGroup.POST("/verify", h.Verify)
	}
}

// registerYggdrasilRoutesWithDI 注册Yggdrasil API路由（依赖注入版本）
func registerYggdrasilRoutesWithDI(v1 *gin.RouterGroup, h *YggdrasilHandler) {
	ygg := v1.Group("/yggdrasil")
	{
		ygg.GET("", h.GetMetaData)
		ygg.POST("/minecraftservices/player/certificates", h.GetPlayerCertificates)
		authserver := ygg.Group("/authserver")
		{
			authserver.POST("/authenticate", h.Authenticate)
			authserver.POST("/validate", h.ValidToken)
			authserver.POST("/refresh", h.RefreshToken)
			authserver.POST("/invalidate", h.InvalidToken)
			authserver.POST("/signout", h.SignOut)
		}
		sessionServer := ygg.Group("/sessionserver")
		{
			sessionServer.GET("/session/minecraft/profile/:uuid", h.GetProfileByUUID)
			sessionServer.POST("/session/minecraft/join", h.JoinServer)
			sessionServer.GET("/session/minecraft/hasJoined", h.HasJoinedServer)
		}
		api := ygg.Group("/api")
		profiles := api.Group("/profiles")
		{
			profiles.POST("/minecraft", h.GetProfilesByName)
		}
	}
}

// registerAdminRoutes 注册管理员路由
func registerAdminRoutes(v1 *gin.RouterGroup, c *container.Container, h *AdminHandler) {
	admin := v1.Group("/admin")
	admin.Use(middleware.AuthMiddleware(c.JWT))
	admin.Use(middleware.RequireAdmin())
	{

		// 用户管理
		admin.GET("/users", h.GetUserList)
		admin.GET("/users/:id", h.GetUserDetail)
		admin.PUT("/users/role", h.SetUserRole)
		admin.PUT("/users/status", h.SetUserStatus)

		// 材质管理（审核）
		admin.GET("/textures", h.GetTextureList)
		admin.DELETE("/textures/:id", h.DeleteTexture)

		// 权限管理
		admin.GET("/permissions", h.GetPermissions)
	}
}

// registerCustomSkinRoutes 注册CustomSkinAPI路由
// CustomSkinAPI 协议要求根地址必须以 / 结尾
// 路由格式：
//   - {ROOT}/{USERNAME}.json - 获取玩家信息
//   - {ROOT}/textures/{hash} - 获取资源文件
//
// 根路径为 /api/v1/csl/
func registerCustomSkinRoutes(v1 *gin.RouterGroup, h *CustomSkinHandler) {
	// CustomSkinAPI 路由组
	csl := v1.Group("/csl")
	{
		// 获取玩家信息: {ROOT}/{USERNAME}.json
		csl.GET("/:username", h.GetPlayerInfo)

		// 获取资源文件: {ROOT}/textures/{hash}
		csl.GET("/textures/:hash", h.GetTexture)
	}
}