# zerobit-auth-systetm

**Repository Path**: zerobit/zerobit-auth-systetm

## Basic Information

- **Project Name**: zerobit-auth-systetm
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-17
- **Last Updated**: 2025-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目下载

- 项目整体克隆/下载

  ```bash
  git clone https://gitee.com/zerobit/zerobit-auth-systetm.git
  ```

- 前端

  ```bash
  git clone https://gitee.com/zerobit/vue3-antd-admin.git
  ```




# 使用插件生成数据表实体类、Service及Mapper

- 数据表生成

  > 使用IDEA插件：MyBatisX

  ![image-20250501125115123](./assets/image-20250501125115123.png)

  ![image-20250618162821948](./assets/image-20250618162821948.png)

  ![image-20250618162858021](./assets/image-20250618162858021.png)

  

# 统一返回结果包装类

- 结果枚举类`ResultEnums`

  ```java
  package top.leonngx.admin.enums;
  
  import lombok.Getter;
  
  @Getter
  public enum ResultEnums {
      /**
       * 除 20000 外，其余都是失败，每个返回码代表具体失败场景
       */
      SUCCESS(20000, "操作成功"),
      ERROR(40000, "操作失败！"),
      USER_NOT_FOUND(40001, "账户不在在"),
      USER_PASSWORD_ERROR(40002, "账户或者密码错误"),
      USER_DISABLED_ERROR(40003, "账户被禁用"),
      USER_LOCKED_ERROR(40004, "账户被锁定"),
      USER_NOT_LOGIN(40005, "用户未登录"),
      USER_NOT_ALLOW_ACCESS(40006, "用户无访问权限"),
      PARAMS_NULL(40007, "参数不能为空！"),
      PARAMS_ERROR(40008, "参数不合法！"),
      MENU_EXISTS(40009, "菜单已存在"),
      USER_EXISTS(40010, "账号已存在"),
      SYSTEM_ERROR(50000, "系统异常"),
      BUSINESS_ERROR(60005, "业务异常");
  
      private final Integer code;
      private final String msg;
  
      /**
       * ResultEnums 构造函数
       *
       * @param code 状态码，用于标识不同的结果或状态
       * @param msg  状态信息，用于描述对应状态码的具体含义
       */
      ResultEnums(Integer code, String msg) {
          this.code = code;
          this.msg = msg;
      }
  }
  
  ```

- 状态枚举类`StateEnums`
  ```java
  package top.leonngx.admin.enums;
  
  import lombok.Getter;
  
  @Getter
  public enum StateEnums {
      /**
       * 逻辑删除状态
       */
      NOT_DELETED(0, "未删除"),
      DELETED(1, "已删除"),
      /**
       * 启用状态
       */
      ENABLED(0, "启用"),
      NOT_ENABLE(1, "停用"),
      /**
       * 用户类型
       */
      USER_TYPE_ADMIN(0, "超级管理员"),
      USER_TYPE_NORMAL(1, "系统用户"),
      /**
       * 性别状态
       */
      SEX_MAN(0, "男"),
      SEX_WOMAN(1, "女"),
      SEX_UN_KNOW(2, "未知"),
      /**
       * 请求访问状态枚举
       */
      REQUEST_SUCCESS(0, "请求正常"),
      REQUEST_ERROR(1, "请求异常"),
      /**
       * 菜单状态枚举
       */
      MENU_M(0, "目录"),
      MENU_C(1, "菜单"),
      MENU_F(2, "权限"),
      /**
       * 登陆状态
       */
      LOGIN_SUCCESS(0, "登陆成功"),
      LOGIN_ERROR(1, "登陆失败"),
      /**
       * 账号状态
       */
      DISABLED(1, "禁用"),
      NOT_DISABLED(0, "未禁用");
  
      private final Integer code;
      private final String msg;
  
      /**
       * 构造方法
       *
       * @param code 状态码，一个Integer类型的值
       * @param msg  与状态码对应的消息，一个String类型的值
       */
      StateEnums(Integer code, String msg) {
          this.code = code;
          this.msg = msg;
      }
  }
  
  ```

- 统一返回结果类`Result`

  ```java
  package top.leonngx.admin.common;
  
  import lombok.Data;
  import top.leonngx.admin.enums.ResultEnums;
  
  @Data
  public class Result<T> {
  
      // 状态码
      private Integer code;
      // 返回消息
      private String msg;
      // 返回数据
      private T data;
  
      public Result() {
          this.code = ResultEnums.SUCCESS.getCode();
          this.msg = ResultEnums.SUCCESS.getMsg();
      }
  
      public Result(Integer code, String msg) {
          this.code = code;
          this.msg = msg;
      }
  
      public Result(Integer code, String msg, T data) {
          this.code = code;
          this.msg = msg;
          this.data = data;
      }
  
      public static <T> Result<T> ok() {
          return new Result<>(ResultEnums.SUCCESS.getCode(), ResultEnums.SUCCESS.getMsg());
      }
  
      public static <T> Result<T> ok(T data) {
          Result<T> result = new Result<>();
          result.setCode(ResultEnums.SUCCESS.getCode());
          result.setMsg(ResultEnums.SUCCESS.getMsg());
          result.setData(data);
          return result;
      }
  
      public static <T> Result<T> error(String msg) {
          return new Result<>(ResultEnums.ERROR.getCode(), msg);
      }
  }
  
  ```