最新公众号管理平台后端

joju-module-system/joju-module-system-api/joju-module-system-api.iml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module org.jetbrains.idea.maven.project.MavenProjectsManager.isMavenModule="true" type="JAVA_MODULE" version="4" />

joju-module-system/joju-module-system-api/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>com.jojubanking.boot</groupId>
+        <artifactId>joju-module-system</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>joju-module-system-api</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        system 模块 API，暴露给其它模块调用
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.jojubanking.boot</groupId>
+            <artifactId>joju-common</artifactId>
+        </dependency>
+
+        <!-- 参数校验 -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+    </dependencies>
+
+</project>

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/dept/DeptApi.java

@@ -0,0 +1,54 @@
+package com.jojubanking.boot.module.system.api.dept;
+
+import com.jojubanking.boot.framework.common.util.collection.CollectionUtils;
+import com.jojubanking.boot.module.system.api.dept.dto.DeptRespDTO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * 部门 API 接口
+ *
+ * @author TW
+ */
+public interface DeptApi {
+
+    /**
+     * 获得部门信息
+     *
+     * @param id 部门编号
+     * @return 部门信息
+     */
+    DeptRespDTO getDept(Long id);
+
+    /**
+     * 获得部门信息数组
+     *
+     * @param ids 部门编号数组
+     * @return 部门信息数组
+     */
+    List<DeptRespDTO> getDepts(Collection<Long> ids);
+
+    /**
+     * 校验部门们是否有效。如下情况，视为无效：
+     * 1. 部门编号不存在
+     * 2. 部门被禁用
+     *
+     * @param ids 角色编号数组
+     */
+    void validDepts(Collection<Long> ids);
+
+    /**
+     * 获得指定编号的部门 Map
+     *
+     * @param ids 部门编号数组
+     * @return 部门 Map
+     */
+    default Map<Long, DeptRespDTO> getDeptMap(Set<Long> ids) {
+        List<DeptRespDTO> list = getDepts(ids);
+        return CollectionUtils.convertMap(list, DeptRespDTO::getId);
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/dept/PostApi.java

@@ -0,0 +1,21 @@
+package com.jojubanking.boot.module.system.api.dept;
+
+import java.util.Collection;
+
+/**
+ * 岗位 API 接口
+ *
+ * @author TW
+ */
+public interface PostApi {
+
+    /**
+     * 校验岗位们是否有效。如下情况，视为无效：
+     * 1. 岗位编号不存在
+     * 2. 岗位被禁用
+     *
+     * @param ids 岗位编号数组
+     */
+    void validPosts(Collection<Long> ids);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/dept/dto/DeptRespDTO.java

@@ -0,0 +1,37 @@
+package com.jojubanking.boot.module.system.api.dept.dto;
+
+import com.jojubanking.boot.framework.common.enums.CommonStatusEnum;
+import lombok.Data;
+
+/**
+ * 部门 Response DTO
+ *
+ * @author TW
+ */
+@Data
+public class DeptRespDTO {
+
+    /**
+     * 部门编号
+     */
+    private Long id;
+    /**
+     * 部门名称
+     */
+    private String name;
+    /**
+     * 父部门编号
+     */
+    private Long parentId;
+    /**
+     * 负责人的用户编号
+     */
+    private Long leaderUserId;
+    /**
+     * 部门状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/dict/DictDataApi.java

@@ -0,0 +1,42 @@
+package com.jojubanking.boot.module.system.api.dict;
+
+import com.jojubanking.boot.module.system.api.dict.dto.DictDataRespDTO;
+
+import java.util.Collection;
+
+/**
+ * 字典数据 API 接口
+ *
+ * @author TW
+ */
+public interface DictDataApi {
+
+    /**
+     * 校验字典数据们是否有效。如下情况，视为无效：
+     * 1. 字典数据不存在
+     * 2. 字典数据被禁用
+     *
+     * @param dictType 字典类型
+     * @param values 字典数据值的数组
+     */
+    void validDictDatas(String dictType, Collection<String> values);
+
+    /**
+     * 获得指定的字典数据，从缓存中
+     *
+     * @param type 字典类型
+     * @param value 字典数据值
+     * @return 字典数据
+     */
+    DictDataRespDTO getDictData(String type, String value);
+
+    /**
+     * 解析获得指定的字典数据，从缓存中
+     *
+     * @param type 字典类型
+     * @param label 字典数据标签
+     * @return 字典数据
+     */
+    DictDataRespDTO parseDictData(String type, String label);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/dict/dto/DictDataRespDTO.java

@@ -0,0 +1,33 @@
+package com.jojubanking.boot.module.system.api.dict.dto;
+
+import com.jojubanking.boot.framework.common.enums.CommonStatusEnum;
+import lombok.Data;
+
+/**
+ * 字典数据 Response DTO
+ *
+ * @author TW
+ */
+@Data
+public class DictDataRespDTO {
+
+    /**
+     * 字典标签
+     */
+    private String label;
+    /**
+     * 字典值
+     */
+    private String value;
+    /**
+     * 字典类型
+     */
+    private String dictType;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/errorcode/ErrorCodeApi.java

@@ -0,0 +1,35 @@
+package com.jojubanking.boot.module.system.api.errorcode;
+
+import com.jojubanking.boot.module.system.api.errorcode.dto.ErrorCodeAutoGenerateReqDTO;
+import com.jojubanking.boot.module.system.api.errorcode.dto.ErrorCodeRespDTO;
+
+import javax.validation.Valid;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 错误码 Api 接口
+ *
+ * @author TW
+ */
+public interface ErrorCodeApi {
+
+    /**
+     * 自动创建错误码
+     *
+     * @param autoGenerateDTOs 错误码信息
+     */
+    void autoGenerateErrorCodes(@Valid List<ErrorCodeAutoGenerateReqDTO> autoGenerateDTOs);
+
+    /**
+     * 增量获得错误码数组
+     *
+     * 如果 minUpdateTime 为空时，则获取所有错误码
+     *
+     * @param applicationName 应用名
+     * @param minUpdateTime 最小更新时间
+     * @return 错误码数组
+     */
+    List<ErrorCodeRespDTO> getErrorCodeList(String applicationName, Date minUpdateTime);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/errorcode/dto/ErrorCodeAutoGenerateReqDTO.java

@@ -0,0 +1,34 @@
+package com.jojubanking.boot.module.system.api.errorcode.dto;
+
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 错误码自动生成 DTO
+ *
+ * @author dylan
+ */
+@Data
+@Accessors(chain = true)
+public class ErrorCodeAutoGenerateReqDTO {
+
+    /**
+     * 应用名
+     */
+    @NotNull(message = "应用名不能为空")
+    private String applicationName;
+    /**
+     * 错误码编码
+     */
+    @NotNull(message = "错误码编码不能为空")
+    private Integer code;
+    /**
+     * 错误码错误提示
+     */
+    @NotEmpty(message = "错误码错误提示不能为空")
+    private String message;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/errorcode/dto/ErrorCodeRespDTO.java

@@ -0,0 +1,28 @@
+package com.jojubanking.boot.module.system.api.errorcode.dto;
+
+import lombok.Data;
+
+import java.util.Date;
+
+/**
+ * 错误码的 Response DTO
+ *
+ * @author TW
+ */
+@Data
+public class ErrorCodeRespDTO {
+
+    /**
+     * 错误码编码
+     */
+    private Integer code;
+    /**
+     * 错误码错误提示
+     */
+    private String message;
+    /**
+     * 更新时间
+     */
+    private Date updateTime;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/logger/LoginLogApi.java

@@ -0,0 +1,21 @@
+package com.jojubanking.boot.module.system.api.logger;
+
+import com.jojubanking.boot.module.system.api.logger.dto.LoginLogCreateReqDTO;
+
+import javax.validation.Valid;
+
+/**
+ * 登录日志的 API 接口
+ *
+ * @author TW
+ */
+public interface LoginLogApi {
+
+    /**
+     * 创建登录日志
+     *
+     * @param reqDTO 日志信息
+     */
+    void createLoginLog(@Valid LoginLogCreateReqDTO reqDTO);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/logger/OperateLogApi.java

@@ -0,0 +1,21 @@
+package com.jojubanking.boot.module.system.api.logger;
+
+import com.jojubanking.boot.module.system.api.logger.dto.OperateLogCreateReqDTO;
+
+import javax.validation.Valid;
+
+/**
+ * 操作日志 API 接口
+ *
+ * @author TW
+ */
+public interface OperateLogApi {
+
+    /**
+     * 创建操作日志
+     *
+     * @param createReqDTO 请求
+     */
+    void createOperateLog(@Valid OperateLogCreateReqDTO createReqDTO);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/logger/dto/LoginLogCreateReqDTO.java

@@ -0,0 +1,62 @@
+package com.jojubanking.boot.module.system.api.logger.dto;
+
+import lombok.Data;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import javax.validation.constraints.Size;
+
+/**
+ * 登录日志创建 Request DTO
+ *
+ * @author TW
+ */
+@Data
+public class LoginLogCreateReqDTO {
+
+    /**
+     * 日志类型
+     */
+    @NotNull(message = "日志类型不能为空")
+    private Integer logType;
+    /**
+     * 链路追踪编号
+     */
+    private String traceId;
+
+    /**
+     * 用户编号
+     */
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    @NotNull(message = "用户类型不能为空")
+    private Integer userType;
+    /**
+     * 用户账号
+     */
+    @NotBlank(message = "用户账号不能为空")
+    @Size(max = 30, message = "用户账号长度不能超过30个字符")
+    private String username;
+
+    /**
+     * 登录结果
+     */
+    @NotNull(message = "登录结果不能为空")
+    private Integer result;
+
+    /**
+     * 用户 IP
+     */
+    @NotEmpty(message = "用户 IP 不能为空")
+    private String userIp;
+    /**
+     * 浏览器 UserAgent
+     *
+     * 允许空，原因：Job 过期登出时，是无法传递 UserAgent 的
+     */
+    private String userAgent;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/logger/dto/OperateLogCreateReqDTO.java

@@ -0,0 +1,123 @@
+package com.jojubanking.boot.module.system.api.logger.dto;
+
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import java.util.Date;
+import java.util.Map;
+
+/**
+ * 操作日志创建 Request DTO
+ */
+@Data
+public class OperateLogCreateReqDTO {
+
+    /**
+     * 链路追踪编号
+     */
+    private String traceId;
+
+    /**
+     * 用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    @NotNull(message = "用户类型不能为空")
+    private Integer userType;
+
+    /**
+     * 操作模块
+     */
+    @NotEmpty(message = "操作模块不能为空")
+    private String module;
+
+    /**
+     * 操作名
+     */
+    @NotEmpty(message = "操作名")
+    private String name;
+
+    /**
+     * 操作分类
+     */
+    @NotNull(message = "操作分类不能为空")
+    private Integer type;
+
+    /**
+     * 操作明细
+     */
+    private String content;
+
+    /**
+     * 拓展字段
+     */
+    private Map<String, Object> exts;
+
+    /**
+     * 请求方法名
+     */
+    @NotEmpty(message = "请求方法名不能为空")
+    private String requestMethod;
+
+    /**
+     * 请求地址
+     */
+    @NotEmpty(message = "请求地址不能为空")
+    private String requestUrl;
+
+    /**
+     * 用户 IP
+     */
+    @NotEmpty(message = "用户 IP 不能为空")
+    private String userIp;
+
+    /**
+     * 浏览器 UserAgent
+     */
+    @NotEmpty(message = "浏览器 UserAgent 不能为空")
+    private String userAgent;
+
+    /**
+     * Java 方法名
+     */
+    @NotEmpty(message = "Java 方法名不能为空")
+    private String javaMethod;
+
+    /**
+     * Java 方法的参数
+     */
+    private String javaMethodArgs;
+
+    /**
+     * 开始时间
+     */
+    @NotNull(message = "开始时间不能为空")
+    private Date startTime;
+
+    /**
+     * 执行时长，单位：毫秒
+     */
+    @NotNull(message = "执行时长不能为空")
+    private Integer duration;
+
+    /**
+     * 结果码
+     */
+    @NotNull(message = "结果码不能为空")
+    private Integer resultCode;
+
+    /**
+     * 结果提示
+     */
+    private String resultMsg;
+
+    /**
+     * 结果数据
+     */
+    private String resultData;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/oauth2/OAuth2TokenApi.java

@@ -0,0 +1,49 @@
+package com.jojubanking.boot.module.system.api.oauth2;
+
+import com.jojubanking.boot.module.system.api.oauth2.dto.OAuth2AccessTokenCheckRespDTO;
+import com.jojubanking.boot.module.system.api.oauth2.dto.OAuth2AccessTokenCreateReqDTO;
+import com.jojubanking.boot.module.system.api.oauth2.dto.OAuth2AccessTokenRespDTO;
+
+import javax.validation.Valid;
+
+/**
+ * OAuth2.0 Token API 接口
+ *
+ * @author TW
+ */
+public interface OAuth2TokenApi {
+
+    /**
+     * 创建访问令牌
+     *
+     * @param reqDTO 访问令牌的创建信息
+     * @return 访问令牌的信息
+     */
+    OAuth2AccessTokenRespDTO createAccessToken(@Valid OAuth2AccessTokenCreateReqDTO reqDTO);
+
+    /**
+     * 校验访问令牌
+     *
+     * @param accessToken 访问令牌
+     * @return 访问令牌的信息
+     */
+    OAuth2AccessTokenCheckRespDTO checkAccessToken(String accessToken);
+
+    /**
+     * 移除访问令牌
+     *
+     * @param accessToken 访问令牌
+     * @return 访问令牌的信息
+     */
+    OAuth2AccessTokenRespDTO removeAccessToken(String accessToken);
+
+    /**
+     * 刷新访问令牌
+     *
+     * @param refreshToken 刷新令牌
+     * @param clientId 客户端编号
+     * @return 访问令牌的信息
+     */
+    OAuth2AccessTokenRespDTO refreshAccessToken(String refreshToken, String clientId);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/oauth2/dto/OAuth2AccessTokenCheckRespDTO.java

@@ -0,0 +1,33 @@
+package com.jojubanking.boot.module.system.api.oauth2.dto;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * OAuth2.0 访问令牌的校验 Response DTO
+ *
+ * @author TW
+ */
+@Data
+public class OAuth2AccessTokenCheckRespDTO implements Serializable {
+
+    /**
+     * 用户编号
+     */
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    private Integer userType;
+    /**
+     * 租户编号
+     */
+    private Long tenantId;
+    /**
+     * 授权范围的数组
+     */
+    private List<String> scopes;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/oauth2/dto/OAuth2AccessTokenCreateReqDTO.java

@@ -0,0 +1,40 @@
+package com.jojubanking.boot.module.system.api.oauth2.dto;
+
+import com.jojubanking.boot.framework.common.enums.UserTypeEnum;
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import lombok.Data;
+
+import javax.validation.constraints.NotNull;
+import java.io.Serializable;
+import java.util.List;
+
+/**
+ * OAuth2.0 访问令牌创建 Request DTO
+ *
+ * @author TW
+ */
+@Data
+public class OAuth2AccessTokenCreateReqDTO implements Serializable {
+
+    /**
+     * 用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    @NotNull(message = "用户类型不能为空")
+    @InEnum(value = UserTypeEnum.class, message = "用户类型必须是 {value}")
+    private Integer userType;
+    /**
+     * 客户端编号
+     */
+    @NotNull(message = "客户端编号不能为空")
+    private String clientId;
+    /**
+     * 授权范围
+     */
+    private List<String> scopes;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/oauth2/dto/OAuth2AccessTokenRespDTO.java

@@ -0,0 +1,39 @@
+package com.jojubanking.boot.module.system.api.oauth2.dto;
+
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * OAuth2.0 访问令牌的信息 Response DTO
+ *
+ * @author TW
+ */
+@Data
+@Accessors(chain = true)
+public class OAuth2AccessTokenRespDTO implements Serializable {
+
+    /**
+     * 访问令牌
+     */
+    private String accessToken;
+    /**
+     * 刷新令牌
+     */
+    private String refreshToken;
+    /**
+     * 用户编号
+     */
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    private Integer userType;
+    /**
+     * 过期时间
+     */
+    private Date expiresTime;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * System API 包，定义暴露给其它模块的 API
+ */
+package com.jojubanking.boot.module.system.api;

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/permission/PermissionApi.java

@@ -0,0 +1,49 @@
+package com.jojubanking.boot.module.system.api.permission;
+
+import com.jojubanking.boot.module.system.api.permission.dto.DeptDataPermissionRespDTO;
+
+import java.util.Collection;
+import java.util.Set;
+
+/**
+ * 权限 API 接口
+ *
+ * @author TW
+ */
+public interface PermissionApi {
+
+    /**
+     * 获得拥有多个角色的用户编号集合
+     *
+     * @param roleIds 角色编号集合
+     * @return 用户编号集合
+     */
+    Set<Long> getUserRoleIdListByRoleIds(Collection<Long> roleIds);
+
+    /**
+     * 判断是否有权限，任一一个即可
+     *
+     * @param userId 用户编号
+     * @param permissions 权限
+     * @return 是否
+     */
+    boolean hasAnyPermissions(Long userId, String... permissions);
+
+    /**
+     * 判断是否有角色，任一一个即可
+     *
+     * @param userId 用户编号
+     * @param roles 角色数组
+     * @return 是否
+     */
+    boolean hasAnyRoles(Long userId, String... roles);
+
+    /**
+     * 获得登陆用户的部门数据权限
+     *
+     * @param userId 用户编号
+     * @return 部门数据权限
+     */
+    DeptDataPermissionRespDTO getDeptDataPermission(Long userId);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/permission/RoleApi.java

@@ -0,0 +1,21 @@
+package com.jojubanking.boot.module.system.api.permission;
+
+import java.util.Collection;
+
+/**
+ * 角色 API 接口
+ *
+ * @author TW
+ */
+public interface RoleApi {
+
+    /**
+     * 校验角色们是否有效。如下情况，视为无效：
+     * 1. 角色编号不存在
+     * 2. 角色被禁用
+     *
+     * @param ids 角色编号数组
+     */
+    void validRoles(Collection<Long> ids);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/permission/dto/DeptDataPermissionRespDTO.java

@@ -0,0 +1,37 @@
+package com.jojubanking.boot.module.system.api.permission.dto;
+
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * 部门的数据权限 Response DTO
+ *
+ * @author TW
+ */
+@Data
+@Accessors(chain = true)
+public class DeptDataPermissionRespDTO {
+
+    /**
+     * 是否可查看全部数据
+     */
+    private Boolean all;
+    /**
+     * 是否可查看自己的数据
+     */
+    private Boolean self;
+    /**
+     * 可查看的部门编号数组
+     */
+    private Set<Long> deptIds;
+
+    public DeptDataPermissionRespDTO() {
+        this.all = false;
+        this.self = false;
+        this.deptIds = new HashSet<>();
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sensitiveword/SensitiveWordApi.java

@@ -0,0 +1,30 @@
+package com.jojubanking.boot.module.system.api.sensitiveword;
+
+import java.util.List;
+
+/**
+ * 敏感词 API 接口
+ *
+ * @author 永不言败
+ */
+public interface SensitiveWordApi {
+
+    /**
+     * 获得文本所包含的不合法的敏感词数组
+     *
+     * @param text 文本
+     * @param tags 标签数组
+     * @return 不合法的敏感词数组
+     */
+    List<String> validateText(String text, List<String> tags);
+
+    /**
+     * 判断文本是否包含敏感词
+     *
+     * @param text 文本
+     * @param tags 表述数组
+     * @return 是否包含
+     */
+    boolean isTextValid(String text, List<String> tags);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/SmsCodeApi.java

@@ -0,0 +1,40 @@
+package com.jojubanking.boot.module.system.api.sms;
+
+import com.jojubanking.boot.framework.common.exception.ServiceException;
+import com.jojubanking.boot.module.system.api.sms.dto.code.SmsCodeCheckReqDTO;
+import com.jojubanking.boot.module.system.api.sms.dto.code.SmsCodeSendReqDTO;
+import com.jojubanking.boot.module.system.api.sms.dto.code.SmsCodeUseReqDTO;
+
+import javax.validation.Valid;
+
+/**
+ * 短信验证码 API 接口
+ *
+ * @author TW
+ */
+public interface SmsCodeApi {
+
+    /**
+     * 创建短信验证码，并进行发送
+     *
+     * @param reqDTO 发送请求
+     */
+    void sendSmsCode(@Valid SmsCodeSendReqDTO reqDTO);
+
+    /**
+     * 验证短信验证码，并进行使用
+     * 如果正确，则将验证码标记成已使用
+     * 如果错误，则抛出 {@link ServiceException} 异常
+     *
+     * @param reqDTO 使用请求
+     */
+    void useSmsCode(@Valid SmsCodeUseReqDTO reqDTO);
+
+    /**
+     * 检查验证码是否有效
+     *
+     * @param reqDTO 校验请求
+     */
+    void checkSmsCode(@Valid SmsCodeCheckReqDTO reqDTO);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/SmsSendApi.java

@@ -0,0 +1,34 @@
+package com.jojubanking.boot.module.system.api.sms;
+
+import com.jojubanking.boot.module.system.api.sms.dto.send.SmsSendSingleToUserReqDTO;
+
+import javax.validation.Valid;
+
+/**
+ * 短信发送 API 接口
+ *
+ * @author TW
+ */
+public interface SmsSendApi {
+
+    /**
+     * 发送单条短信给 Admin 用户
+     *
+     * 在 mobile 为空时，使用 userId 加载对应 Admin 的手机号
+     *
+     * @param reqDTO 发送请求
+     * @return 发送日志编号
+     */
+    Long sendSingleSmsToAdmin(@Valid SmsSendSingleToUserReqDTO reqDTO);
+
+    /**
+     * 发送单条短信给 Member 用户
+     *
+     * 在 mobile 为空时，使用 userId 加载对应 Member 的手机号
+     *
+     * @param reqDTO 发送请求
+     * @return 发送日志编号
+     */
+    Long sendSingleSmsToMember(@Valid SmsSendSingleToUserReqDTO reqDTO);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/dto/code/SmsCodeCheckReqDTO.java

@@ -0,0 +1,37 @@
+package com.jojubanking.boot.module.system.api.sms.dto.code;
+
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import com.jojubanking.boot.framework.common.validation.Mobile;
+import com.jojubanking.boot.module.system.enums.sms.SmsSceneEnum;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 短信验证码的校验 Request DTO
+ *
+ * @author TW
+ */
+@Data
+public class SmsCodeCheckReqDTO {
+
+    /**
+     * 手机号
+     */
+    @Mobile
+    @NotEmpty(message = "手机号不能为空")
+    private String mobile;
+    /**
+     * 发送场景
+     */
+    @NotNull(message = "发送场景不能为空")
+    @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+    /**
+     * 验证码
+     */
+    @NotEmpty(message = "验证码")
+    private String code;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/dto/code/SmsCodeSendReqDTO.java

@@ -0,0 +1,39 @@
+package com.jojubanking.boot.module.system.api.sms.dto.code;
+
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import com.jojubanking.boot.framework.common.validation.Mobile;
+import com.jojubanking.boot.module.system.enums.sms.SmsSceneEnum;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 短信验证码的发送 Request DTO
+ *
+ * @author TW
+ */
+@Data
+@Accessors(chain = true)
+public class SmsCodeSendReqDTO {
+
+    /**
+     * 手机号
+     */
+    @Mobile
+    @NotEmpty(message = "手机号不能为空")
+    private String mobile;
+    /**
+     * 发送场景
+     */
+    @NotNull(message = "发送场景不能为空")
+    @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+    /**
+     * 发送 IP
+     */
+    @NotEmpty(message = "发送 IP 不能为空")
+    private String createIp;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/dto/code/SmsCodeUseReqDTO.java

@@ -0,0 +1,42 @@
+package com.jojubanking.boot.module.system.api.sms.dto.code;
+
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import com.jojubanking.boot.framework.common.validation.Mobile;
+import com.jojubanking.boot.module.system.enums.sms.SmsSceneEnum;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 短信验证码的使用 Request DTO
+ *
+ * @author TW
+ */
+@Data
+public class SmsCodeUseReqDTO {
+
+    /**
+     * 手机号
+     */
+    @Mobile
+    @NotEmpty(message = "手机号不能为空")
+    private String mobile;
+    /**
+     * 发送场景
+     */
+    @NotNull(message = "发送场景不能为空")
+    @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+    /**
+     * 验证码
+     */
+    @NotEmpty(message = "验证码")
+    private String code;
+    /**
+     * 使用 IP
+     */
+    @NotEmpty(message = "使用 IP 不能为空")
+    private String usedIp;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/sms/dto/send/SmsSendSingleToUserReqDTO.java

@@ -0,0 +1,36 @@
+package com.jojubanking.boot.module.system.api.sms.dto.send;
+
+import com.jojubanking.boot.framework.common.validation.Mobile;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import java.util.Map;
+
+/**
+ * 短信发送给 Admin 或者 Member 用户
+ *
+ * @author TW
+ */
+@Data
+public class SmsSendSingleToUserReqDTO {
+
+    /**
+     * 用户编号
+     */
+    private Long userId;
+    /**
+     * 手机号
+     */
+    @Mobile
+    private String mobile;
+    /**
+     * 短信模板编号
+     */
+    @NotEmpty(message = "短信模板编号不能为空")
+    private String templateCode;
+    /**
+     * 短信模板参数
+     */
+    private Map<String, Object> templateParams;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/social/SocialUserApi.java

@@ -0,0 +1,53 @@
+package com.jojubanking.boot.module.system.api.social;
+
+import com.jojubanking.boot.framework.common.exception.ServiceException;
+import com.jojubanking.boot.module.system.api.social.dto.SocialUserBindReqDTO;
+import com.jojubanking.boot.module.system.api.social.dto.SocialUserUnbindReqDTO;
+import com.jojubanking.boot.module.system.enums.social.SocialTypeEnum;
+
+import javax.validation.Valid;
+
+/**
+ * 社交用户的 API 接口
+ *
+ * @author TW
+ */
+public interface SocialUserApi {
+
+    /**
+     * 获得社交平台的授权 URL
+     *
+     * @param type 社交平台的类型 {@link SocialTypeEnum}
+     * @param redirectUri 重定向 URL
+     * @return 社交平台的授权 URL
+     */
+    String getAuthorizeUrl(Integer type, String redirectUri);
+
+    /**
+     * 绑定社交用户
+     *
+     * @param reqDTO 绑定信息
+     */
+    void bindSocialUser(@Valid SocialUserBindReqDTO reqDTO);
+
+    /**
+     * 取消绑定社交用户
+     *
+     * @param reqDTO 解绑
+     */
+    void unbindSocialUser(@Valid SocialUserUnbindReqDTO reqDTO);
+
+    /**
+     * 获得社交用户的绑定用户编号
+     * 注意，返回的是 MemberUser 或者 AdminUser 的 id 编号！
+     * 在认证信息不正确的情况下，也会抛出 {@link ServiceException} 业务异常
+     *
+     * @param userType 用户类型
+     * @param type 社交平台的类型
+     * @param code 授权码
+     * @param state state
+     * @return 绑定用户编号
+     */
+    Long getBindUserId(Integer userType, Integer type, String code, String state);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/social/dto/SocialUserBindReqDTO.java

@@ -0,0 +1,54 @@
+package com.jojubanking.boot.module.system.api.social.dto;
+
+import com.jojubanking.boot.framework.common.enums.UserTypeEnum;
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import com.jojubanking.boot.module.system.enums.social.SocialTypeEnum;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 取消绑定社交用户 Request DTO
+ *
+ * @author TW
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Accessors(chain = true)
+public class SocialUserBindReqDTO {
+
+    /**
+     * 用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    @InEnum(UserTypeEnum.class)
+    @NotNull(message = "用户类型不能为空")
+    private Integer userType;
+
+    /**
+     * 社交平台的类型
+     */
+    @InEnum(SocialTypeEnum.class)
+    @NotNull(message = "社交平台的类型不能为空")
+    private Integer type;
+    /**
+     * 授权码
+     */
+    @NotEmpty(message = "授权码不能为空")
+    private String code;
+    /**
+     * state
+     */
+    @NotNull(message = "state 不能为空")
+    private String state;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/social/dto/SocialUserUnbindReqDTO.java

@@ -0,0 +1,44 @@
+package com.jojubanking.boot.module.system.api.social.dto;
+
+import com.jojubanking.boot.framework.common.enums.UserTypeEnum;
+import com.jojubanking.boot.framework.common.validation.InEnum;
+import com.jojubanking.boot.module.system.enums.social.SocialTypeEnum;
+import lombok.Data;
+
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 社交绑定 Request DTO，使用 code 授权码
+ *
+ * @author TW
+ */
+@Data
+public class SocialUserUnbindReqDTO {
+
+    /**
+     * 用户编号
+     */
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+    /**
+     * 用户类型
+     */
+    @InEnum(UserTypeEnum.class)
+    @NotNull(message = "用户类型不能为空")
+    private Integer userType;
+
+    /**
+     * 社交平台的类型
+     */
+    @InEnum(SocialTypeEnum.class)
+    @NotNull(message = "社交平台的类型不能为空")
+    private Integer type;
+
+    /**
+     * 社交平台的 unionId
+     */
+    @NotEmpty(message = "社交平台的 unionId 不能为空")
+    private String unionId;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/tenant/TenantApi.java

@@ -0,0 +1,26 @@
+package com.jojubanking.boot.module.system.api.tenant;
+
+import java.util.List;
+
+/**
+ * 多租户的 API 接口
+ *
+ * @author TW
+ */
+public interface TenantApi {
+
+    /**
+     * 获得所有租户
+     *
+     * @return 租户编号数组
+     */
+    List<Long> getTenantIds();
+
+    /**
+     * 校验租户是否合法
+     *
+     * @param id 租户编号
+     */
+    void validTenant(Long id);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/user/AdminUserApi.java

@@ -0,0 +1,70 @@
+package com.jojubanking.boot.module.system.api.user;
+
+import com.jojubanking.boot.framework.common.util.collection.CollectionUtils;
+import com.jojubanking.boot.module.system.api.user.dto.AdminUserRespDTO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * Admin 用户 API 接口
+ *
+ * @author TW
+ */
+public interface AdminUserApi {
+
+    /**
+     * 通过用户 ID 查询用户
+     *
+     * @param id 用户ID
+     * @return 用户对象信息
+     */
+    AdminUserRespDTO getUser(Long id);
+
+    /**
+     * 通过用户 ID 查询用户们
+     *
+     * @param ids 用户 ID 们
+     * @return 用户对象信息
+     */
+    List<AdminUserRespDTO> getUsers(Collection<Long> ids);
+
+    /**
+     * 获得指定部门的用户数组
+     *
+     * @param deptIds 部门数组
+     * @return 用户数组
+     */
+    List<AdminUserRespDTO> getUsersByDeptIds(Collection<Long> deptIds);
+
+    /**
+     * 获得指定岗位的用户数组
+     *
+     * @param postIds 岗位数组
+     * @return 用户数组
+     */
+    List<AdminUserRespDTO> getUsersByPostIds(Collection<Long> postIds);
+
+    /**
+     * 获得用户 Map
+     *
+     * @param ids 用户编号数组
+     * @return 用户 Map
+     */
+    default Map<Long, AdminUserRespDTO> getUserMap(Collection<Long> ids) {
+        List<AdminUserRespDTO> users = getUsers(ids);
+        return CollectionUtils.convertMap(users, AdminUserRespDTO::getId);
+    }
+
+    /**
+     * 校验用户们是否有效。如下情况，视为无效：
+     * 1. 用户编号不存在
+     * 2. 用户被禁用
+     *
+     * @param ids 用户编号数组
+     */
+    void validUsers(Set<Long> ids);
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/api/user/dto/AdminUserRespDTO.java

@@ -0,0 +1,44 @@
+package com.jojubanking.boot.module.system.api.user.dto;
+
+import com.jojubanking.boot.framework.common.enums.CommonStatusEnum;
+import lombok.Data;
+
+import java.util.Set;
+
+/**
+ * Admin 用户 Response DTO
+ *
+ * @author TW
+ */
+@Data
+public class AdminUserRespDTO {
+
+    /**
+     * 用户ID
+     */
+    private Long id;
+    /**
+     * 用户昵称
+     */
+    private String nickname;
+    /**
+     * 帐号状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+
+    /**
+     * 部门ID
+     */
+    private Long deptId;
+    /**
+     * 岗位编号数组
+     */
+    private Set<Long> postIds;
+    /**
+     * 手机号码
+     */
+    private String mobile;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/DictTypeConstants.java

@@ -0,0 +1,29 @@
+package com.jojubanking.boot.module.system.enums;
+
+/**
+ * System 字典类型的枚举类
+ *
+ * @author TW
+ */
+public interface DictTypeConstants {
+
+    String USER_TYPE = "user_type"; // 用户类型
+    String COMMON_STATUS = "common_status"; // 系统状态
+
+    // ========== SYSTEM 模块 ==========
+
+    String USER_SEX = "system_user_sex"; // 用户性别
+
+    String OPERATE_TYPE = "system_operate_type"; // 操作类型
+
+    String LOGIN_TYPE = "system_login_type"; // 登录日志的类型
+    String LOGIN_RESULT = "system_login_result"; // 登录结果
+
+    String ERROR_CODE_TYPE = "system_error_code_type"; // 错误码的类型枚举
+
+    String SMS_CHANNEL_CODE = "system_sms_channel_code"; // 短信渠道编码
+    String SMS_TEMPLATE_TYPE = "system_sms_template_type"; // 短信模板类型
+    String SMS_SEND_STATUS = "system_sms_send_status"; // 短信发送状态
+    String SMS_RECEIVE_STATUS = "system_sms_receive_status"; // 短信接收状态
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/ErrorCodeConstants.java

@@ -0,0 +1,184 @@
+package com.jojubanking.boot.module.system.enums;
+
+import com.jojubanking.boot.framework.common.exception.ErrorCode;
+
+/**
+ * System 错误码枚举类
+ *
+ * system 系统，使用 1-002-000-000 段
+ */
+public interface ErrorCodeConstants {
+
+    // ========== AUTH 模块 1002000000 ==========
+    ErrorCode AUTH_LOGIN_BAD_CREDENTIALS = new ErrorCode(1002000000, "登录失败，账号密码不正确");
+    ErrorCode AUTH_LOGIN_USER_DISABLED = new ErrorCode(1002000001, "登录失败，账号被禁用");
+    ErrorCode AUTH_LOGIN_CAPTCHA_NOT_FOUND = new ErrorCode(1002000003, "验证码不存在");
+    ErrorCode AUTH_LOGIN_CAPTCHA_CODE_ERROR = new ErrorCode(1002000004, "验证码不正确");
+    ErrorCode AUTH_THIRD_LOGIN_NOT_BIND = new ErrorCode(1002000005, "未绑定账号，需要进行绑定");
+    ErrorCode AUTH_TOKEN_EXPIRED = new ErrorCode(1002000006, "Token 已经过期");
+    ErrorCode AUTH_MOBILE_NOT_EXISTS = new ErrorCode(1002000007, "手机号不存在");
+
+    // ========== 菜单模块 1002001000 ==========
+    ErrorCode MENU_NAME_DUPLICATE = new ErrorCode(1002001000, "已经存在该名字的菜单");
+    ErrorCode MENU_PARENT_NOT_EXISTS = new ErrorCode(1002001001, "父菜单不存在");
+    ErrorCode MENU_PARENT_ERROR = new ErrorCode(1002001002, "不能设置自己为父菜单");
+    ErrorCode MENU_NOT_EXISTS = new ErrorCode(1002001003, "菜单不存在");
+    ErrorCode MENU_EXISTS_CHILDREN = new ErrorCode(1002001004, "存在子菜单，无法删除");
+    ErrorCode MENU_PARENT_NOT_DIR_OR_MENU = new ErrorCode(1002001005, "父菜单的类型必须是目录或者菜单");
+
+    // ========== 角色模块 1002002000 ==========
+    ErrorCode ROLE_NOT_EXISTS = new ErrorCode(1002002000, "角色不存在");
+    ErrorCode ROLE_NAME_DUPLICATE = new ErrorCode(1002002001, "已经存在名为【{}】的角色");
+    ErrorCode ROLE_CODE_DUPLICATE = new ErrorCode(1002002002, "已经存在编码为【{}】的角色");
+    ErrorCode ROLE_CAN_NOT_UPDATE_SYSTEM_TYPE_ROLE = new ErrorCode(1002002003, "不能操作类型为系统内置的角色");
+    ErrorCode ROLE_IS_DISABLE = new ErrorCode(1002002004, "名字为【{}】的角色已被禁用");
+    ErrorCode ROLE_ADMIN_CODE_ERROR = new ErrorCode(1002002005, "编码【{}】不能使用");
+
+    // ========== 用户模块 1002003000 ==========
+    ErrorCode USER_USERNAME_EXISTS = new ErrorCode(1002003000, "用户账号已经存在");
+    ErrorCode USER_MOBILE_EXISTS = new ErrorCode(1002003001, "手机号已经存在");
+    ErrorCode USER_EMAIL_EXISTS = new ErrorCode(1002003002, "邮箱已经存在");
+    ErrorCode USER_NOT_EXISTS = new ErrorCode(1002003003, "用户不存在");
+    ErrorCode USER_IMPORT_LIST_IS_EMPTY = new ErrorCode(1002003004, "导入用户数据不能为空！");
+    ErrorCode USER_PASSWORD_FAILED = new ErrorCode(1002003005, "用户密码校验失败");
+    ErrorCode USER_IS_DISABLE = new ErrorCode(1002003006, "名字为【{}】的用户已被禁用");
+    ErrorCode USER_COUNT_MAX = new ErrorCode(1002003008, "创建用户失败，原因：超过租户最大租户配额({})！");
+
+    // ========== 部门模块 1002004000 ==========
+    ErrorCode DEPT_NAME_DUPLICATE = new ErrorCode(1002004000, "已经存在该名字的部门");
+    ErrorCode DEPT_PARENT_NOT_EXITS = new ErrorCode(1002004001,"父级部门不存在");
+    ErrorCode DEPT_NOT_FOUND = new ErrorCode(1002004002, "当前部门不存在");
+    ErrorCode DEPT_EXITS_CHILDREN = new ErrorCode(1002004003, "存在子部门，无法删除");
+    ErrorCode DEPT_PARENT_ERROR = new ErrorCode(1002004004, "不能设置自己为父部门");
+    ErrorCode DEPT_EXISTS_USER = new ErrorCode(1002004005, "部门中存在员工，无法删除");
+    ErrorCode DEPT_NOT_ENABLE = new ErrorCode(1002004006, "部门不处于开启状态，不允许选择");
+    ErrorCode DEPT_PARENT_IS_CHILD = new ErrorCode(1002004007, "不能设置自己的子部门为父部门");
+
+    // ========== 岗位模块 1002005000 ==========
+    ErrorCode POST_NOT_FOUND = new ErrorCode(1002005000, "当前岗位不存在");
+    ErrorCode POST_NOT_ENABLE = new ErrorCode(1002005001, "岗位({}) 不处于开启状态，不允许选择");
+    ErrorCode POST_NAME_DUPLICATE = new ErrorCode(1002005002, "已经存在该名字的岗位");
+    ErrorCode POST_CODE_DUPLICATE = new ErrorCode(1002005003, "已经存在该标识的岗位");
+
+    // ========== 字典类型 1002006000 ==========
+    ErrorCode DICT_TYPE_NOT_EXISTS = new ErrorCode(1002006001, "当前字典类型不存在");
+    ErrorCode DICT_TYPE_NOT_ENABLE = new ErrorCode(1002006002, "字典类型不处于开启状态，不允许选择");
+    ErrorCode DICT_TYPE_NAME_DUPLICATE = new ErrorCode(1002006003, "已经存在该名字的字典类型");
+    ErrorCode DICT_TYPE_TYPE_DUPLICATE = new ErrorCode(1002006004, "已经存在该类型的字典类型");
+    ErrorCode DICT_TYPE_HAS_CHILDREN = new ErrorCode(1002006005, "无法删除，该字典类型还有字典数据");
+
+    // ========== 字典数据 1002007000 ==========
+    ErrorCode DICT_DATA_NOT_EXISTS = new ErrorCode(1002007001, "当前字典数据不存在");
+    ErrorCode DICT_DATA_NOT_ENABLE = new ErrorCode(1002007002, "字典数据({})不处于开启状态，不允许选择");
+    ErrorCode DICT_DATA_VALUE_DUPLICATE = new ErrorCode(1002007003, "已经存在该值的字典数据");
+
+    // ========== 通知公告 1002008000 ==========
+    ErrorCode NOTICE_NOT_FOUND = new ErrorCode(1002008001, "当前通知公告不存在");
+
+    // ========== 短信渠道 1002011000 ==========
+    ErrorCode SMS_CHANNEL_NOT_EXISTS = new ErrorCode(1002011000, "短信渠道不存在");
+    ErrorCode SMS_CHANNEL_DISABLE = new ErrorCode(1002011001, "短信渠道不处于开启状态，不允许选择");
+    ErrorCode SMS_CHANNEL_HAS_CHILDREN = new ErrorCode(1002011002, "无法删除，该短信渠道还有短信模板");
+
+    // ========== 短信模板 1002012000 ==========
+    ErrorCode SMS_TEMPLATE_NOT_EXISTS = new ErrorCode(1002012000, "短信模板不存在");
+    ErrorCode SMS_TEMPLATE_CODE_DUPLICATE = new ErrorCode(1002012001, "已经存在编码为【{}】的短信模板");
+
+    // ========== 短信发送 1002013000 ==========
+    ErrorCode SMS_SEND_MOBILE_NOT_EXISTS = new ErrorCode(1002013000, "手机号不存在");
+    ErrorCode SMS_SEND_MOBILE_TEMPLATE_PARAM_MISS = new ErrorCode(1002013001, "模板参数({})缺失");
+    ErrorCode SMS_SEND_TEMPLATE_NOT_EXISTS = new ErrorCode(1002013002, "短信模板不存在");
+
+    // ========== 短信验证码 1002014000 ==========
+    ErrorCode SMS_CODE_NOT_FOUND = new ErrorCode(1002014000, "验证码不存在");
+    ErrorCode SMS_CODE_EXPIRED = new ErrorCode(1002014001, "验证码已过期");
+    ErrorCode SMS_CODE_USED = new ErrorCode(1002014002, "验证码已使用");
+    ErrorCode SMS_CODE_NOT_CORRECT = new ErrorCode(1002014003, "验证码不正确");
+    ErrorCode SMS_CODE_EXCEED_SEND_MAXIMUM_QUANTITY_PER_DAY = new ErrorCode(1002014004, "超过每日短信发送数量");
+    ErrorCode SMS_CODE_SEND_TOO_FAST = new ErrorCode(1002014005, "短信发送过于频率");
+    ErrorCode SMS_CODE_IS_EXISTS = new ErrorCode(1002014006, "手机号已被使用");
+    ErrorCode SMS_CODE_IS_UNUSED = new ErrorCode(1002014007, "验证码未被使用");
+
+    // ========== 租户信息 1002015000 ==========
+    ErrorCode TENANT_NOT_EXISTS = new ErrorCode(1002015000, "租户不存在");
+    ErrorCode TENANT_DISABLE = new ErrorCode(1002015001, "名字为【{}】的租户已被禁用");
+    ErrorCode TENANT_EXPIRE = new ErrorCode(1002015002, "名字为【{}】的租户已过期");
+    ErrorCode TENANT_CAN_NOT_UPDATE_SYSTEM = new ErrorCode(1002015003, "系统租户不能进行修改、删除等操作！");
+
+    // ========== 租户套餐 1002016000 ==========
+    ErrorCode TENANT_PACKAGE_NOT_EXISTS = new ErrorCode(1002016000, "租户套餐不存在");
+    ErrorCode TENANT_PACKAGE_USED = new ErrorCode(1002016001, "租户正在使用该套餐，请给租户重新设置套餐后再尝试删除");
+    ErrorCode TENANT_PACKAGE_DISABLE = new ErrorCode(1002016002, "名字为【{}】的租户套餐已被禁用");
+
+    // ========== 错误码模块 1002017000 ==========
+    ErrorCode ERROR_CODE_NOT_EXISTS = new ErrorCode(1002017000, "错误码不存在");
+    ErrorCode ERROR_CODE_DUPLICATE = new ErrorCode(1002017001, "已经存在编码为【{}】的错误码");
+
+    // ========== 社交用户 1002018000 ==========
+    ErrorCode SOCIAL_USER_AUTH_FAILURE = new ErrorCode(1002018000, "社交授权失败，原因是：{}");
+    ErrorCode SOCIAL_USER_UNBIND_NOT_SELF = new ErrorCode(1002018001, "社交解绑失败，非当前用户绑定");
+    ErrorCode SOCIAL_USER_NOT_FOUND = new ErrorCode(1002018002, "社交授权失败，找不到对应的用户");
+
+    // ========== 系统敏感词 1002019000 =========
+    ErrorCode SENSITIVE_WORD_NOT_EXISTS = new ErrorCode(1002019000, "系统敏感词在所有标签中都不存在");
+    ErrorCode SENSITIVE_WORD_EXISTS = new ErrorCode(1002019001, "系统敏感词已在标签中存在");
+
+    // ========== OAuth2 客户端 1002020000 =========
+    ErrorCode OAUTH2_CLIENT_NOT_EXISTS = new ErrorCode(1002020000, "OAuth2 客户端不存在");
+    ErrorCode OAUTH2_CLIENT_EXISTS = new ErrorCode(1002020001, "OAuth2 客户端编号已存在");
+    ErrorCode OAUTH2_CLIENT_DISABLE = new ErrorCode(1002020002, "OAuth2 客户端已禁用");
+    ErrorCode OAUTH2_CLIENT_AUTHORIZED_GRANT_TYPE_NOT_EXISTS = new ErrorCode(1002020003, "不支持该授权类型");
+    ErrorCode OAUTH2_CLIENT_SCOPE_OVER = new ErrorCode(1002020004, "授权范围过大");
+    ErrorCode OAUTH2_CLIENT_REDIRECT_URI_NOT_MATCH = new ErrorCode(1002020005, "无效 redirect_uri: {}");
+    ErrorCode OAUTH2_CLIENT_CLIENT_SECRET_ERROR = new ErrorCode(1002020006, "无效 client_secret: {}");
+
+    // ========== OAuth2 授权 1002021000 =========
+    ErrorCode OAUTH2_GRANT_CLIENT_ID_MISMATCH = new ErrorCode(1002021000, "client_id 不匹配");
+    ErrorCode OAUTH2_GRANT_REDIRECT_URI_MISMATCH = new ErrorCode(1002021001, "redirect_uri 不匹配");
+    ErrorCode OAUTH2_GRANT_STATE_MISMATCH = new ErrorCode(1002021002, "state 不匹配");
+    ErrorCode OAUTH2_GRANT_CODE_NOT_EXISTS = new ErrorCode(1002021003, "code 不存在");
+
+    // ========== OAuth2 授权 1002022000 =========
+    ErrorCode OAUTH2_CODE_NOT_EXISTS = new ErrorCode(1002022000, "code 不存在");
+    ErrorCode OAUTH2_CODE_EXPIRE = new ErrorCode(1002022000, "code 已过期");
+
+    // =========== 公众号 1002023000 ========================
+    ErrorCode USER_INFO_NOT_EXISTS = new ErrorCode(1002023000, "用户信息不存在");
+    ErrorCode CAROUSEL_NOT_EXISTS  = new ErrorCode(1002023001, "轮播图不存在");
+    ErrorCode INFORMATION_NOT_EXISTS = new ErrorCode(1002023002, "指南信息不存在");
+    ErrorCode WQ_NOT_EXISTS = new ErrorCode(1002023003, "问卷调查不存在");
+    ErrorCode WQWT_NOT_EXISTS = new ErrorCode(1002023004, "问卷调查问题不存在");
+    ErrorCode HOSPITAL_NOT_EXISTS = new ErrorCode(1002023005, "医院信息不存在");
+    ErrorCode WQDA_NOT_EXISTS = new ErrorCode(1002023006, "问卷调查答案不存在");
+    ErrorCode KS_TYPE_NOT_EXISTS = new ErrorCode(1002023007, "科室类别不存在");
+    ErrorCode KS_INFO_NOT_EXISTS = new ErrorCode(1002023008, "科室信息不存在");
+    ErrorCode DOCTOR_NOT_EXISTS = new ErrorCode(1002023009, "医生信息不存在");
+    ErrorCode WQDA_VIEW_NOT_EXISTS = new ErrorCode(1002023010, "VIEW不存在");
+    ErrorCode BUILDING_NOT_EXISTS = new ErrorCode(1002023011, "楼层导视不存在");
+    ErrorCode LABEL_NOT_EXISTS = new ErrorCode(1002023012, "导视不存在");
+    ErrorCode LABEL_EXISTS = new ErrorCode(1002023013, "导视已经存在");
+    ErrorCode DZ_QUESTION_NOT_EXISTS = new ErrorCode(1002023014, "导诊管理不存在");
+    ErrorCode DZ_TYPE_NOT_EXISTS = new ErrorCode(1002023015, "导诊类型不存在");
+
+
+    // ========== 部门模块 1002004000 ==========
+    ErrorCode BUILDING_NAME_DUPLICATE = new ErrorCode(1002024000, "已经存在该名字的大楼");
+    ErrorCode BUILDING_PARENT_NOT_EXITS = new ErrorCode(1002024001,"父级大楼不存在");
+    ErrorCode BUILDING_NOT_FOUND = new ErrorCode(1002024002, "当前大楼不存在");
+    ErrorCode BUILDING_EXITS_CHILDREN = new ErrorCode(1002024003, "存在子楼层，无法删除");
+    ErrorCode BUILDING_PARENT_ERROR = new ErrorCode(1002024004, "不能设置自己为父大楼");
+    ErrorCode BUILDING_EXISTS_USER = new ErrorCode(1002024005, "大楼中存在员工，无法删除");
+    ErrorCode BUILDING_NOT_ENABLE = new ErrorCode(1002024006, "大楼不处于开启状态，不允许选择");
+    ErrorCode BUILDING_PARENT_IS_CHILD = new ErrorCode(1002024007, "不能设置自己的子楼层为父大楼");
+    ErrorCode BUILDING_PARENT_MUST_0 = new ErrorCode(1002024008, "不能设置楼层中楼层");
+    ErrorCode USE_COUNT_NOT_EXISTS = new ErrorCode(1002024009, "统计不存在");
+    ErrorCode MZJF_NOT_EXISTS = new ErrorCode(1002024010, "门诊缴费不存在");
+    ErrorCode RESERVE8_NOT_EXISTS = new ErrorCode(1002024011, "预约挂号不存在");
+    ErrorCode NXBALCKLIST_NOT_EXISTS = new ErrorCode(1002024012, "黑名单列不存在");
+
+
+    ErrorCode NXEXPRESS_NOT_EXISTS = new ErrorCode(1002024013, "病案申请不存在");
+    ErrorCode CARD_NOT_EXISTS = new ErrorCode(1002024014, "就诊卡不存在");
+    ErrorCode BLACKLIST_NOT_EXISTS = new ErrorCode(1002024015, "黑名单不存在");
+    ErrorCode INFO_NOT_EXISTS = new ErrorCode(1002024016, "用户信息不存在");
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/ErrorCodeConstants_手动操作.java

@@ -0,0 +1,3 @@
+// TODO 待办：请将下面的错误码复制到 joju-module-system-api 模块的 ErrorCodeConstants 类中。注意，请给“TODO 补充编号”设置一个错误码编号！！！
+// ========== 用户信息 TODO 补充编号 ==========
+// ErrorCode INFO_NOT_EXISTS = new ErrorCode(TODO 补充编号, "用户信息不存在");

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/common/SexEnum.java

@@ -0,0 +1,27 @@
+package com.jojubanking.boot.module.system.enums.common;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 性别的枚举值
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum SexEnum {
+
+    /** 男 */
+    MALE(1),
+    /** 女 */
+    FEMALE(2),
+    /* 未知 */
+    UNKNOWN(3);
+
+    /**
+     * 性别
+     */
+    private final Integer sex;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/dept/DeptIdEnum.java

@@ -0,0 +1,20 @@
+package com.jojubanking.boot.module.system.enums.dept;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 部门编号枚举
+ */
+@Getter
+@AllArgsConstructor
+public enum DeptIdEnum {
+
+    /**
+     * 根节点
+     */
+    ROOT(0L);
+
+    private final Long id;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/errorcode/ErrorCodeTypeEnum.java

@@ -0,0 +1,39 @@
+package com.jojubanking.boot.module.system.enums.errorcode;
+
+import com.jojubanking.boot.framework.common.core.IntArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * 错误码的类型枚举
+ *
+ * @author dylan
+ */
+@AllArgsConstructor
+@Getter
+public enum ErrorCodeTypeEnum implements IntArrayValuable {
+
+    /**
+     * 自动生成
+     */
+    AUTO_GENERATION(1),
+    /**
+     * 手动编辑
+     */
+    MANUAL_OPERATION(2);
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(ErrorCodeTypeEnum::getType).toArray();
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+
+    @Override
+    public int[] array() {
+        return ARRAYS;
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/logger/LoginLogTypeEnum.java

@@ -0,0 +1,27 @@
+package com.jojubanking.boot.module.system.enums.logger;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 登录日志的类型枚举
+ */
+@Getter
+@AllArgsConstructor
+public enum LoginLogTypeEnum {
+
+    LOGIN_USERNAME(100), // 使用账号登录
+    LOGIN_SOCIAL(101), // 使用社交登录
+    LOGIN_MOBILE(103), // 使用手机登陆
+    LOGIN_SMS(104), // 使用短信登陆
+
+    LOGOUT_SELF(200),  // 自己主动登出
+    LOGOUT_DELETE(202), // 强制退出
+    ;
+
+    /**
+     * 日志类型
+     */
+    private final Integer type;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/logger/LoginResultEnum.java

@@ -0,0 +1,26 @@
+package com.jojubanking.boot.module.system.enums.logger;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 登录结果的枚举类
+ */
+@Getter
+@AllArgsConstructor
+public enum LoginResultEnum {
+
+    SUCCESS(0), // 成功
+    BAD_CREDENTIALS(10), // 账号或密码不正确
+    USER_DISABLED(20), // 用户被禁用
+    CAPTCHA_NOT_FOUND(30), // 图片验证码不存在
+    CAPTCHA_CODE_ERROR(31), // 图片验证码不正确
+
+    ;
+
+    /**
+     * 结果
+     */
+    private final Integer result;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/notice/NoticeTypeEnum.java

@@ -0,0 +1,23 @@
+package com.jojubanking.boot.module.system.enums.notice;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 通知类型
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum NoticeTypeEnum {
+
+    NOTICE(1),
+    ANNOUNCEMENT(2);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/oauth2/OAuth2ClientConstants.java

@@ -0,0 +1,12 @@
+package com.jojubanking.boot.module.system.enums.oauth2;
+
+/**
+ * OAuth2.0 客户端的通用枚举
+ *
+ * @author TW
+ */
+public interface OAuth2ClientConstants {
+
+    String CLIENT_ID_DEFAULT = "default";
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/oauth2/OAuth2GrantTypeEnum.java

@@ -0,0 +1,29 @@
+package com.jojubanking.boot.module.system.enums.oauth2;
+
+import cn.hutool.core.util.ArrayUtil;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * OAuth2 授权类型（模式）的枚举
+ *
+ * @author TW
+ */
+@AllArgsConstructor
+@Getter
+public enum OAuth2GrantTypeEnum {
+
+    PASSWORD("password"), // 密码模式
+    AUTHORIZATION_CODE("authorization_code"), // 授权码模式
+    IMPLICIT("implicit"), // 简化模式
+    CLIENT_CREDENTIALS("client_credentials"), // 客户端模式
+    REFRESH_TOKEN("refresh_token"), // 刷新模式
+    ;
+
+    private final String grantType;
+
+    public static OAuth2GrantTypeEnum getByGranType(String grantType) {
+        return ArrayUtil.firstMatch(o -> o.getGrantType().equals(grantType), values());
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/permission/DataScopeEnum.java

@@ -0,0 +1,30 @@
+package com.jojubanking.boot.module.system.enums.permission;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 数据范围枚举类
+ *
+ * 用于实现数据级别的权限
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum DataScopeEnum {
+
+    ALL(1), // 全部数据权限
+
+    DEPT_CUSTOM(2), // 指定部门数据权限
+    DEPT_ONLY(3), // 部门数据权限
+    DEPT_AND_CHILD(4), // 部门及以下数据权限
+
+    SELF(5); // 仅本人数据权限
+
+    /**
+     * 范围
+     */
+    private final Integer scope;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/permission/MenuIdEnum.java

@@ -0,0 +1,20 @@
+package com.jojubanking.boot.module.system.enums.permission;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * Menu 编号枚举
+ */
+@Getter
+@AllArgsConstructor
+public enum MenuIdEnum {
+
+    /**
+     * 根节点
+     */
+    ROOT(0L);
+
+    private final Long id;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/permission/MenuTypeEnum.java

@@ -0,0 +1,25 @@
+package com.jojubanking.boot.module.system.enums.permission;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 菜单类型枚举类
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum MenuTypeEnum {
+
+    DIR(1), // 目录
+    MENU(2), // 菜单
+    BUTTON(3) // 按钮
+    ;
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/permission/RoleCodeEnum.java

@@ -0,0 +1,31 @@
+package com.jojubanking.boot.module.system.enums.permission;
+
+import com.jojubanking.boot.framework.common.util.object.ObjectUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 角色标识枚举
+ */
+@Getter
+@AllArgsConstructor
+public enum RoleCodeEnum {
+
+    SUPER_ADMIN("super_admin", "超级管理员"),
+    TENANT_ADMIN("tenant_admin", "租户管理员"),
+    ;
+
+    /**
+     * 角色编码
+     */
+    private final String code;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    public static boolean isSuperAdmin(String code) {
+        return ObjectUtils.equalsAny(code, SUPER_ADMIN.getCode());
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/permission/RoleTypeEnum.java

@@ -0,0 +1,21 @@
+package com.jojubanking.boot.module.system.enums.permission;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum RoleTypeEnum {
+
+    /**
+     * 内置角色
+     */
+    SYSTEM(1),
+    /**
+     * 自定义角色
+     */
+    CUSTOM(2);
+
+    private final Integer type;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/sms/SmsReceiveStatusEnum.java

@@ -0,0 +1,23 @@
+package com.jojubanking.boot.module.system.enums.sms;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 短信的接收状态枚举
+ *
+ * @author TW
+ * @date 2021/2/1 13:39
+ */
+@Getter
+@AllArgsConstructor
+public enum SmsReceiveStatusEnum {
+
+    INIT(0), // 初始化
+    SUCCESS(10), // 接收成功
+    FAILURE(20), // 接收失败
+    ;
+
+    private final int status;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/sms/SmsSceneEnum.java

@@ -0,0 +1,50 @@
+package com.jojubanking.boot.module.system.enums.sms;
+
+import cn.hutool.core.util.ArrayUtil;
+import com.jojubanking.boot.framework.common.core.IntArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * 用户短信验证码发送场景的枚举
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum SmsSceneEnum implements IntArrayValuable {
+
+    MEMBER_LOGIN(1, "user-sms-login", "会员用户 - 手机号登陆"),
+    MEMBER_UPDATE_MOBILE(2, "user-sms-reset-password", "会员用户 - 修改手机"),
+    MEMBER_FORGET_PASSWORD(3, "user-sms-update-mobile", "会员用户 - 忘记密码"),
+
+    ADMIN_MEMBER_LOGIN(21, "admin-sms-login", "后台用户 - 手机号登录");
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(SmsSceneEnum::getScene).toArray();
+
+    /**
+     * 验证场景的编号
+     */
+    private final Integer scene;
+    /**
+     * 模版编码
+     */
+    private final String templateCode;
+    /**
+     * 描述
+     */
+    private final String description;
+
+    @Override
+    public int[] array() {
+        return ARRAYS;
+    }
+
+    public static SmsSceneEnum getCodeByScene(Integer scene) {
+        return ArrayUtil.firstMatch(sceneEnum -> sceneEnum.getScene().equals(scene),
+                values());
+    }
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/sms/SmsSendStatusEnum.java

@@ -0,0 +1,24 @@
+package com.jojubanking.boot.module.system.enums.sms;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 短信的发送状态枚举
+ *
+ * @author zzf
+ * @date 2021/2/1 13:39
+ */
+@Getter
+@AllArgsConstructor
+public enum SmsSendStatusEnum {
+
+    INIT(0), // 初始化
+    SUCCESS(10), // 发送成功
+    FAILURE(20), // 发送失败
+    IGNORE(30), // 忽略，即不发送
+    ;
+
+    private final int status;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/sms/SmsTemplateTypeEnum.java

@@ -0,0 +1,25 @@
+package com.jojubanking.boot.module.system.enums.sms;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 短信的模板类型枚举
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum SmsTemplateTypeEnum {
+
+    VERIFICATION_CODE(1), // 验证码
+    NOTICE(2), // 通知
+    PROMOTION(3), // 营销
+    ;
+
+    /**
+     * 类型
+     */
+    private final int type;
+
+}

joju-module-system/joju-module-system-api/src/main/java/com/jojubanking/boot/module/system/enums/social/SocialTypeEnum.java

@@ -0,0 +1,72 @@
+package com.jojubanking.boot.module.system.enums.social;
+
+import cn.hutool.core.util.ArrayUtil;
+import com.jojubanking.boot.framework.common.core.IntArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * 社交平台的类型枚举
+ *
+ * @author TW
+ */
+@Getter
+@AllArgsConstructor
+public enum SocialTypeEnum implements IntArrayValuable {
+
+    /**
+     * Gitee
+     * 文档链接：https://gitee.com/api/v5/oauth_doc#/
+     */
+    GITEE(10, "GITEE"),
+    /**
+     * 钉钉
+     * 文档链接：https://developers.dingtalk.com/document/app/obtain-identity-credentials
+     */
+    DINGTALK(20, "DINGTALK"),
+
+    /**
+     * 企业微信
+     * 文档链接：https://xkcoding.com/2019/08/06/use-justauth-integration-wechat-enterprise.html
+     */
+    WECHAT_ENTERPRISE(30, "WECHAT_ENTERPRISE"),
+    /**
+     * 微信公众平台 - 移动端 H5
+     * 文档链接：https://www.cnblogs.com/juewuzhe/p/11905461.html
+     */
+    WECHAT_MP(31, "WECHAT_MP"),
+    /**
+     * 微信开放平台 - 网站应用 PC 端扫码授权登录
+     * 文档链接：https://justauth.wiki/guide/oauth/wechat_open/#_2-申请开发者资质认证
+     */
+    WECHAT_OPEN(32, "WECHAT_OPEN"),
+    /**
+     * 微信小程序
+     * 文档链接：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html
+     */
+    WECHAT_MINI_APP(34, "WECHAT_MINI_APP"),
+    ;
+
+    public static final int[] ARRAYS = Arrays.stream(values()).mapToInt(SocialTypeEnum::getType).toArray();
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 类型的标识
+     */
+    private final String source;
+
+    @Override
+    public int[] array() {
+        return ARRAYS;
+    }
+
+    public static SocialTypeEnum valueOfType(Integer type) {
+        return ArrayUtil.firstMatch(o -> o.getType().equals(type), values());
+    }
+
+}