backend/internal/handler/profile_handler.go

package handler

import (
	"carrotskin/internal/service"
	"carrotskin/internal/types"
	"carrotskin/pkg/database"
	"carrotskin/pkg/logger"

	"github.com/gin-gonic/gin"
	"go.uber.org/zap"
)

// CreateProfile 创建档案
// @Summary 创建Minecraft档案
// @Description 创建新的Minecraft角色档案，UUID由后端自动生成
// @Tags profile
// @Accept json
// @Produce json
// @Security BearerAuth
// @Param request body types.CreateProfileRequest true "档案信息（仅需提供角色名）"
// @Success 200 {object} model.Response{data=types.ProfileInfo} "创建成功，返回完整档案信息（含自动生成的UUID）"
// @Failure 400 {object} model.ErrorResponse "请求参数错误或已达档案数量上限"
// @Failure 401 {object} model.ErrorResponse "未授权"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile [post]
func CreateProfile(c *gin.Context) {
	userID, ok := GetUserIDFromContext(c)
	if !ok {
		return
	}

	var req types.CreateProfileRequest
	if err := c.ShouldBindJSON(&req); err != nil {
		RespondBadRequest(c, "请求参数错误: "+err.Error(), nil)
		return
	}

	maxProfiles := service.GetMaxProfilesPerUser()
	db := database.MustGetDB()

	if err := service.CheckProfileLimit(db, userID, maxProfiles); err != nil {
		RespondBadRequest(c, err.Error(), nil)
		return
	}

	profile, err := service.CreateProfile(db, userID, req.Name)
	if err != nil {
		logger.MustGetLogger().Error("创建档案失败",
			zap.Int64("user_id", userID),
			zap.String("name", req.Name),
			zap.Error(err),
		)
		RespondServerError(c, err.Error(), nil)
		return
	}

	RespondSuccess(c, ProfileToProfileInfo(profile))
}

// GetProfiles 获取档案列表
// @Summary 获取档案列表
// @Description 获取当前用户的所有档案
// @Tags profile
// @Accept json
// @Produce json
// @Security BearerAuth
// @Success 200 {object} model.Response "获取成功"
// @Failure 401 {object} model.ErrorResponse "未授权"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile [get]
func GetProfiles(c *gin.Context) {
	userID, ok := GetUserIDFromContext(c)
	if !ok {
		return
	}

	profiles, err := service.GetUserProfiles(database.MustGetDB(), userID)
	if err != nil {
		logger.MustGetLogger().Error("获取档案列表失败",
			zap.Int64("user_id", userID),
			zap.Error(err),
		)
		RespondServerError(c, err.Error(), nil)
		return
	}

	RespondSuccess(c, ProfilesToProfileInfos(profiles))
}

// GetProfile 获取档案详情
// @Summary 获取档案详情
// @Description 根据UUID获取档案详细信息
// @Tags profile
// @Accept json
// @Produce json
// @Param uuid path string true "档案UUID"
// @Success 200 {object} model.Response "获取成功"
// @Failure 404 {object} model.ErrorResponse "档案不存在"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile/{uuid} [get]
func GetProfile(c *gin.Context) {
	uuid := c.Param("uuid")

	profile, err := service.GetProfileByUUID(database.MustGetDB(), uuid)
	if err != nil {
		logger.MustGetLogger().Error("获取档案失败",
			zap.String("uuid", uuid),
			zap.Error(err),
		)
		RespondNotFound(c, err.Error())
		return
	}

	RespondSuccess(c, ProfileToProfileInfo(profile))
}

// UpdateProfile 更新档案
// @Summary 更新档案
// @Description 更新档案信息
// @Tags profile
// @Accept json
// @Produce json
// @Security BearerAuth
// @Param uuid path string true "档案UUID"
// @Param request body types.UpdateProfileRequest true "更新信息"
// @Success 200 {object} model.Response "更新成功"
// @Failure 400 {object} model.ErrorResponse "请求参数错误"
// @Failure 401 {object} model.ErrorResponse "未授权"
// @Failure 403 {object} model.ErrorResponse "无权操作"
// @Failure 404 {object} model.ErrorResponse "档案不存在"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile/{uuid} [put]
func UpdateProfile(c *gin.Context) {
	userID, ok := GetUserIDFromContext(c)
	if !ok {
		return
	}

	uuid := c.Param("uuid")

	var req types.UpdateProfileRequest
	if err := c.ShouldBindJSON(&req); err != nil {
		RespondBadRequest(c, "请求参数错误: "+err.Error(), nil)
		return
	}

	var namePtr *string
	if req.Name != "" {
		namePtr = &req.Name
	}

	profile, err := service.UpdateProfile(database.MustGetDB(), uuid, userID, namePtr, req.SkinID, req.CapeID)
	if err != nil {
		logger.MustGetLogger().Error("更新档案失败",
			zap.String("uuid", uuid),
			zap.Int64("user_id", userID),
			zap.Error(err),
		)
		RespondWithError(c, err)
		return
	}

	RespondSuccess(c, ProfileToProfileInfo(profile))
}

// DeleteProfile 删除档案
// @Summary 删除档案
// @Description 删除指定的Minecraft档案
// @Tags profile
// @Accept json
// @Produce json
// @Security BearerAuth
// @Param uuid path string true "档案UUID"
// @Success 200 {object} model.Response "删除成功"
// @Failure 401 {object} model.ErrorResponse "未授权"
// @Failure 403 {object} model.ErrorResponse "无权操作"
// @Failure 404 {object} model.ErrorResponse "档案不存在"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile/{uuid} [delete]
func DeleteProfile(c *gin.Context) {
	userID, ok := GetUserIDFromContext(c)
	if !ok {
		return
	}

	uuid := c.Param("uuid")

	err := service.DeleteProfile(database.MustGetDB(), uuid, userID)
	if err != nil {
		logger.MustGetLogger().Error("删除档案失败",
			zap.String("uuid", uuid),
			zap.Int64("user_id", userID),
			zap.Error(err),
		)
		RespondWithError(c, err)
		return
	}

	RespondSuccess(c, gin.H{"message": "删除成功"})
}

// SetActiveProfile 设置活跃档案
// @Summary 设置活跃档案
// @Description 将指定档案设置为活跃状态
// @Tags profile
// @Accept json
// @Produce json
// @Security BearerAuth
// @Param uuid path string true "档案UUID"
// @Success 200 {object} model.Response "设置成功"
// @Failure 401 {object} model.ErrorResponse "未授权"
// @Failure 403 {object} model.ErrorResponse "无权操作"
// @Failure 404 {object} model.ErrorResponse "档案不存在"
// @Failure 500 {object} model.ErrorResponse "服务器错误"
// @Router /api/v1/profile/{uuid}/activate [post]
func SetActiveProfile(c *gin.Context) {
	userID, ok := GetUserIDFromContext(c)
	if !ok {
		return
	}

	uuid := c.Param("uuid")

	err := service.SetActiveProfile(database.MustGetDB(), uuid, userID)
	if err != nil {
		logger.MustGetLogger().Error("设置活跃档案失败",
			zap.String("uuid", uuid),
			zap.Int64("user_id", userID),
			zap.Error(err),
		)
		RespondWithError(c, err)
		return
	}

	RespondSuccess(c, gin.H{"message": "设置成功"})
}