feat: 基础修改

src/main/java/com/webgame/webgamebackend/common/config/PasswordConfig.java

@@ -0,0 +1,17 @@
+package com.webgame.webgamebackend.common.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+
+/**
+ * 密码加密配置
+ */
+@Configuration
+public class PasswordConfig {
+
+    @Bean
+    public BCryptPasswordEncoder passwordEncoder() {
+        return new BCryptPasswordEncoder();
+    }
+}

src/main/java/com/webgame/webgamebackend/common/dto/ApiResponse.java

@@ -0,0 +1,32 @@
+package com.webgame.webgamebackend.common.dto;
+
+/**
+ * 后端统一响应格式
+ *
+ * @param <T> 响应数据类型
+ */
+public record ApiResponse<T>(int code, String message, T data) {
+
+    /**
+     * 成功响应
+     *
+     * @param data 响应数据
+     * @param <T>  数据类型
+     * @return ApiResponse
+     */
+    public static <T> ApiResponse<T> ok(T data) {
+        return new ApiResponse<>(0, "success", data);
+    }
+
+    /**
+     * 失败响应
+     *
+     * @param code    业务状态码
+     * @param message 错误消息
+     * @param <T>     数据类型
+     * @return ApiResponse
+     */
+    public static <T> ApiResponse<T> fail(int code, String message) {
+        return new ApiResponse<>(code, message, null);
+    }
+}

src/main/java/com/webgame/webgamebackend/common/dto/account/LoginRequest.java

@@ -0,0 +1,26 @@
+package com.webgame.webgamebackend.common.dto.account;
+
+import com.webgame.webgamebackend.common.dto.base.BaseVo;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 登录请求
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class LoginRequest extends BaseVo {
+
+    /**
+     * 用户名
+     */
+    @NotBlank(message = "用户名不能为空")
+    private String username;
+
+    /**
+     * 密码
+     */
+    @NotBlank(message = "密码不能为空")
+    private String password;
+}

src/main/java/com/webgame/webgamebackend/common/dto/account/LoginResponse.java

@@ -0,0 +1,6 @@
+package com.webgame.webgamebackend.common.dto.account;
+
+/**
+ * 登录/注册响应
+ */
+public record LoginResponse(String token) {}

src/main/java/com/webgame/webgamebackend/common/dto/account/RegisterRequest.java

@@ -0,0 +1,29 @@
+package com.webgame.webgamebackend.common.dto.account;
+
+import com.webgame.webgamebackend.common.dto.base.BaseVo;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 注册请求
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class RegisterRequest extends BaseVo {
+
+    /**
+     * 用户名
+     */
+    @NotBlank(message = "用户名不能为空")
+    @Size(min = 3, max = 32, message = "用户名长度3-32位")
+    private String username;
+
+    /**
+     * 密码
+     */
+    @NotBlank(message = "密码不能为空")
+    @Size(min = 6, max = 64, message = "密码长度6-64位")
+    private String password;
+}

src/main/java/com/webgame/webgamebackend/common/dto/base/BaseVo.java

@@ -0,0 +1,9 @@
+package com.webgame.webgamebackend.common.dto.base;
+
+import java.io.Serializable;
+
+/**
+ * 请求参数基类，所有入参 VO 均继承此类
+ */
+public abstract class BaseVo implements Serializable {
+}

src/main/java/com/webgame/webgamebackend/common/exception/BusinessException.java

@@ -0,0 +1,28 @@
+package com.webgame.webgamebackend.common.exception;
+
+import lombok.Getter;
+
+/**
+ * 业务异常，Service 层抛出，由全局异常处理器转换为 ApiResponse
+ */
+@Getter
+public class BusinessException extends RuntimeException {
+
+    private final int code;
+
+    /**
+     * 使用 ErrorCode 枚举创建异常，消息使用枚举默认值
+     */
+    public BusinessException(ErrorCode errorCode) {
+        super(errorCode.getDefaultMessage());
+        this.code = errorCode.getCode();
+    }
+
+    /**
+     * 使用 ErrorCode 枚举 + 自定义消息创建异常
+     */
+    public BusinessException(ErrorCode errorCode, String message) {
+        super(message);
+        this.code = errorCode.getCode();
+    }
+}

src/main/java/com/webgame/webgamebackend/common/exception/ErrorCode.java

@@ -0,0 +1,28 @@
+package com.webgame.webgamebackend.common.exception;
+
+import lombok.Getter;
+
+/**
+ * 业务错误码枚举，统一管理所有错误码和默认消息
+ */
+@Getter
+public enum ErrorCode {
+
+    // ========== 通用 ==========
+    SUCCESS(0, "success"),
+    BAD_REQUEST(400, "参数校验失败"),
+    INTERNAL_ERROR(5000, "服务器内部错误"),
+
+    // ========== 账号模块 ==========
+    USERNAME_EXISTS(1001, "用户名已存在"),
+    BAD_CREDENTIALS(1002, "用户名或密码错误"),
+    ;
+
+    private final int code;
+    private final String defaultMessage;
+
+    ErrorCode(int code, String defaultMessage) {
+        this.code = code;
+        this.defaultMessage = defaultMessage;
+    }
+}

src/main/java/com/webgame/webgamebackend/common/handler/GlobalExceptionHandler.java

@@ -0,0 +1,47 @@
+package com.webgame.webgamebackend.common.handler;
+
+import com.webgame.webgamebackend.common.dto.ApiResponse;
+import com.webgame.webgamebackend.common.exception.BusinessException;
+import com.webgame.webgamebackend.common.exception.ErrorCode;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+/**
+ * 全局异常处理，统一返回 ApiResponse 格式
+ */
+@Slf4j
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    /**
+     * 处理业务异常
+     */
+    @ExceptionHandler(BusinessException.class)
+    public ApiResponse<Void> handleBusinessException(BusinessException ex) {
+        log.warn("业务异常: code={}, message={}", ex.getCode(), ex.getMessage());
+        return ApiResponse.fail(ex.getCode(), ex.getMessage());
+    }
+
+    /**
+     * 处理参数校验异常
+     */
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ApiResponse<Void> handleValidation(MethodArgumentNotValidException ex) {
+        String message = ex.getBindingResult().getFieldErrors().stream()
+                .findFirst()
+                .map(e -> e.getDefaultMessage())
+                .orElse(ErrorCode.BAD_REQUEST.getDefaultMessage());
+        return ApiResponse.fail(ErrorCode.BAD_REQUEST.getCode(), message);
+    }
+
+    /**
+     * 处理其他未捕获异常
+     */
+    @ExceptionHandler(Exception.class)
+    public ApiResponse<Void> handleException(Exception ex) {
+        log.error("服务器内部错误", ex);
+        return ApiResponse.fail(ErrorCode.INTERNAL_ERROR.getCode(), ErrorCode.INTERNAL_ERROR.getDefaultMessage());
+    }
+}