backend/internal/handler/routes.go

package handler

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

	"github.com/gin-gonic/gin"
)

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

// 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),
	}
}

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

	// 创建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)

		// 系统路由
		registerSystemRoutes(v1)

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

// 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-url", h.GenerateAvatarUploadURL)
		userGroup.PUT("/avatar", h.UpdateAvatar)

		// 更换邮箱
		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)
		textureGroup.GET("/:id/render", h.RenderTexture) // type/front/back/full/head/isometric
		textureGroup.GET("/:id/avatar", h.RenderAvatar)  // mode=2d/3d
		textureGroup.GET("/:id/cape", h.RenderCape)
		textureGroup.GET("/:id/preview", h.RenderPreview) // 自动根据类型预览

		// 需要认证的路由
		textureAuth := textureGroup.Group("")
		textureAuth.Use(middleware.AuthMiddleware(jwtService))
		{
			textureAuth.POST("/upload", h.Upload)                // 直接上传文件
			textureAuth.POST("/upload-url", h.GenerateUploadURL) // 生成预签名URL（保留兼容性）
			textureAuth.POST("", h.Create)                       // 创建材质记录（配合预签名URL使用）
			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)
			profileAuth.POST("/:uuid/activate", h.SetActive)
		}
	}
}

// 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)
		}
	}
}

// registerSystemRoutes 注册系统路由
func registerSystemRoutes(v1 *gin.RouterGroup) {
	system := v1.Group("/system")
	{
		system.GET("/config", func(c *gin.Context) {
			// TODO: 实现从数据库读取系统配置
			c.JSON(200, model.NewSuccessResponse(gin.H{
				"site_name":             "CarrotSkin",
				"site_description":      "A Minecraft Skin Station",
				"registration_enabled":  true,
				"max_textures_per_user": 100,
				"max_profiles_per_user": 5,
			}))
		})
	}
}

// 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)
	}
}