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": "设置成功"}) }