项目预览

不知道为什么，图床用的使自己的，Gitee就是不显示其它GitHub和Gitea都能显示就Gitee显示不出来

或者把项目clone下来看也可以

线上地址

• 正式线上预览地址：http://111.229.137.235/#/welcome

• 测试预览地址：http://106.15.251.123/#/welcome

  • 服务器到期时间：12月30日

Github地址

• 前端地址
• 后端地址

Gitee地址

• 前端地址
• 后端地址

环境搭建

安装docker内容

如果使用是centos或者是rocky

# 更新yum 和 dnf
yum update -y
dnf update -y

# 安装必要依赖
yum install -y yum-utils device-mapper-persistent-data lvm2

# 设置镜像源
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum list docker-ce --showduplicates | sort -r

# 安装docker
yum -y install docker-ce.x86_64

# 开机启动docker
systemctl enable docker
systemctl start docker

安装Redis

编写配置文件

mkdir /bunny/docker_data/my_redis/ -p
vim /bunny/docker_data/my_redis/redis.conf

添加以下内容

有注释大概率启动不了

# bind 127.0.0.1 #注释掉这部分，使redis可以外部访问
daemonize no #用守护线程的方式启动
requirepass 123456
appendonly yes #redis持久化　　默认是no
tcp-keepalive 300 #防止出现远程主机强迫关闭了一个现有的连接的错误 默认是300

删除注释

daemonize no
requirepass 123456
appendonly yes
tcp-keepalive 300

启动Redis

docker pull redis:7.0.10
docker run -p 6379:6379 --name redis_master \
-v /bunny/docker_data/redis_master/redis.conf:/etc/redis/redis.conf \
-v/bunny/docker_data/redis_master/data:/data \
--restart=always -d redis:7.0.10  --appendonly yes

安装Minio

docker run -d \
  -p 9000:9000 \
  -p 9090:9090 \
  --name minio_master --restart=always \
  -v /bunny/docker/minio/data:/data \
  -e "MINIO_ROOT_USER=bunny" \
  -e "MINIO_ROOT_PASSWORD=02120212" \
  minio/minio server /data --console-address ":9090"

安装MySQL

设置开机启动

执行启动3306：

docker stop master
docker rm master

docker run --name master -p 3306:3306 \
-v /bunny/docker_data/mysql/master/etc/my.cnf:/etc/my.cnf \
-v /bunny/docker_data/mysql/master/data:/var/lib/mysql \
--restart=always --privileged=true \
   -e MYSQL_ROOT_PASSWORD=02120212 \
   -e TZ=Asia/Shanghai \
   mysql:8.0.33 --lower-case-table-names=1

执行启动3304：

其中有创建备份目录

docker stop slave_3304
docker rm slave_3304

docker run --name slave_3304 -p 3304:3306 \
   -v /bunny/docker_data/mysql/slave_3304/etc/my.cnf:/etc/my.cnf \
   -v /bunny/docker_data/mysql/slave_3304/data:/var/lib/mysql \
   -v /bunny/docker_data/mysql/slave_3304/backup:\
   --restart=always --privileged=true \
   -e MYSQL_ROOT_PASSWORD=02120212 \
   -e TZ=Asia/Shanghai \
   mysql:8.0.33 --lower-case-table-names=1

修改密码：

docker exec -it mysql_master /bin/bash
mysql -uroot -p02120212
use mysql
ALTER USER 'root'@'%' IDENTIFIED BY "02120212";
FLUSH PRIVILEGES;

my.cnf 配置

[mysqld]
skip-host-cache
skip-name-resolve
secure-file-priv=/var/lib/mysql-files
user=mysql

# 设置字符集
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

# 设置服务器ID（如果是复制集群，确保每个节点的ID唯一）
server-id=1

# 启用二进制日志
log-bin=mysql-bin

# 设置表名不区分大小写
lower_case_table_names = 1

数据库文件

在后端文件的根目录中

项目特点

按钮权限显示

如果当前用户在这个页面中只有【添加】和【删除】那么页面按钮中只会显示出【添加按钮】和【删除按钮】

去除前后空格

后端配置了自动去除前端传递的空字符串，如果传递的内容前后有空格会自动去除前后的空格

代码内容

@ControllerAdvice
public class ControllerStringParamTrimConfig {

    /**
     * 创建 String trim 编辑器
     * 构造方法中 boolean 参数含义为如果是空白字符串,是否转换为null
     * 即如果为true,那么 " " 会被转换为 null,否者为 ""
     */
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        StringTrimmerEditor propertyEditor = new StringTrimmerEditor(false);
        // 为 String 类对象注册编辑器
        binder.registerCustomEditor(String.class, propertyEditor);
    }

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
        return jacksonObjectMapperBuilder -> {
            // 为 String 类型自定义反序列化操作
            jacksonObjectMapperBuilder
                    .deserializerByType(String.class, new StdScalarDeserializer<String>(String.class) {
                        @Override
                        public String deserialize(JsonParser jsonParser, DeserializationContext ctx) throws IOException {
                            // 去除全部空格
                            // return StringUtils.trimAllWhitespace(jsonParser.getValueAsString());
                            // 仅去除前后空格
                            return jsonParser.getValueAsString().trim();
                        }
                    });
        };
    }
}

项目接口和页面

接口地址有两个：

1. knife4j
2. swagger

接口地址://localhost:7070/doc.html#/home

swagger接口地址：http://localhost:7070/swagger-ui/index.html

前端接口地址：http://localhost:7000/#/welcome

登录功能

可以选择邮箱登录或者是密码直接登录，两者不互用。

账号登录

业务需求

• 用户输入用户名和密码进行登录

实现思路

• 用户输入账号和密码和数据库中账号密码进行比对，成功后进行页面跳转
• 如果账户禁用会显示账户已封禁

后端实现文件位置

• 拦截请求为/admin/login的请求之后进行登录验证的判断

邮箱登录

业务需求

• 用户输入邮箱账号、密码、邮箱验证码之后进行登录

实现思路

• 需要验证用户输入的邮箱格式是否正确。
• 在未输入验证码的情况下输入密码会提示用户，同时后端也会进行验证。如果输入了邮箱验证码但是Redis中不存在或已过期，会提示：邮箱验证码不存在或已过期。
• 之后对邮箱账号和密码进行判断包括邮箱验证码进行判断
• 判断逻辑如下，文件位置如上图所示。

/**
 * * 自定义验证
 * 判断邮箱验证码是否正确
 */
@Override
public Authentication attemptAuthentication(HttpServletRequest request, HttpServletResponse response) {
    ObjectMapper objectMapper = new ObjectMapper();
    try {
        loginDto = objectMapper.readValue(request.getInputStream(), LoginDto.class);

        // type不能为空
        String type = loginDto.getType();
        if (!StringUtils.hasText(type)) {
            out(response, Result.error(ResultCodeEnum.REQUEST_IS_EMPTY));
            return null;
        }

        String emailCode = loginDto.getEmailCode();
        String username = loginDto.getUsername();
        String password = loginDto.getPassword();

        // 如果有邮箱验证码，表示是邮箱登录
        if (type.equals("email")) {
            emailCode = emailCode.toLowerCase();
            Object redisEmailCode = redisTemplate.opsForValue().get(RedisUserConstant.getAdminUserEmailCodePrefix(username));
            if (redisEmailCode == null) {
                out(response, Result.error(ResultCodeEnum.EMAIL_CODE_EMPTY));
                return null;
            }

            // 判断用户邮箱验证码是否和Redis中发送的验证码
            if (!emailCode.equals(redisEmailCode.toString().toLowerCase())) {
                out(response, Result.error(ResultCodeEnum.EMAIL_CODE_NOT_MATCHING));
                return null;
            }
        }

        Authentication authenticationToken = new UsernamePasswordAuthenticationToken(username, password);
        return getAuthenticationManager().authenticate(authenticationToken);
    } catch (IOException e) {
        out(response, Result.error(ResultCodeEnum.ILLEGAL_DATA_REQUEST));
        return null;
    }
}

首页功能

功能菜单，首页图表展示部分功能已经由这个模板作者设计好，其中需要注意的是，如果要查看历史消息或者是进入消息页面可以双击既可进入消息页面

消息功能

业务需求

1. 消息页面的展示，包含删除、批量删除、选中已读和当前页面所有消息都标为已读
2. 当用户对左侧菜单点击时可以过滤出消息内容，展示不同的消息类型

3. 可以点击已读和全部进行筛选消息

3. 可以根据标题进行搜搜
4. 包含分页

实现思路

1. 显示当前消息类型，用户点击时带参数请求，只带当前消息类型，不默认携带已读状态查询，然后从数据库筛选并返回结果。

2. 点击"已读"选项时，若选择"全部"（之前是设置为undefined，这样就不会携带参数了，但是底下会有警告），现在改为空字符串，后端只需过滤掉空字符串即可。

3. 删除选定数据，若用户选择列表并筛选出所有ID，将数据传递给后端（用户删除为逻辑删除）。

4. 全部标为已读，类似删除操作，筛选出选中数据的ID，然后传递给后端以标记为已读。

5. 将所有数据标记为已读！当前页面前端使用map提取所有ID，整合成ID列表传递给后端，表示页面上所有数据已读。

6. 输入标题后，随输入变化进行搜索。

后端代码位置

用户管理

需求分析

1. 用户操作需要包含CURD的操作
2. 为了方便在用户中需要给出快速禁用当前用户按钮
3. 需要显示用户头像、性别、最后登录的IP地址和归属地
4. 在左侧中需要包含部分查询
5. 可以根据点击的部门查询当前部门下的用户
6. 根据用户可以强制下线、管理员可以修改用户密码、为用户分配角色

实现思路

上传头像

前端需要剪裁图片内容进行上传，后端将前端上传的头像存储到Minio中，在上传头像中可以有几菜单可以看到功能菜单。

右击时可以看到功能菜单，如上传、下载等功能

重置密码

重置密码需要判断当前用户密码是否是符合指定的密码格式，并且会根据当前输入密码计算得分如果当前密码复杂则得分越高那么密码强度越强

重置密码组件在前端的公共组件文件中

分配角色

• 给用户分配了admin角色后，其他路由绑定和权限设置就不再需要了，因为后端会根据admin角色在前端用户信息中设置通用权限码，如*、*::*、*::*::*，表示前端用户可以访问所有权限并查看所有内容。

• 管理员有权对用户进行角色分配，这涉及到许多操作，包括菜单显示和接口访问权限。角色与权限相关联，角色也与菜单相关联。

• 当用户访问菜单时，会根据其角色看到其所属的菜单内容。随后，角色与权限接口相关联，根据用户的权限来决定是否显示操作按钮。后端会根据用户的权限验证其是否可以访问当前接口。

• 用户登录或刷新页面时会重新获取用户信息，用户信息中包含角色和权限信息。利用角色和权限信息与前端传递的路径进行比对判断，如果用户包含菜单角色，则可以访问。如果用户包含前端路由中的权限，则表示该权限可以访问。后端也会进行权限判断，以防止通过接口文档等方式访问。

• 分配好角色后，菜单会根据当前路由角色匹配用户角色，从而根据用户角色显示相应的菜单内容。

角色管理

角色管理包含CURD和权限分配操作

业务需求

用户对角色进行CURD操作，点击权限设置时让用户分配权限

实现思路

1. 在设计的表中，如果存在相同的角色码，系统会提示用户当前角色已经存在。

2. 后端会根据角色的ID分配权限的ID列表。

3. 后端在角色权限表中会根据角色的ID分配权限内容。在角色权限表中，会先删除当前角色所有的权限内容，然后再进行权限内容的重新分配。

public void assignPowersToRole(AssignPowersToRoleDto dto) {
    List<Long> powerIds = dto.getPowerIds();
    Long roleId = dto.getRoleId();

    // 删除这个角色下所有权限
    baseMapper.deleteBatchRoleIdsWithPhysics(List.of(roleId));

    // 保存分配数据
    List<RolePower> rolePowerList = powerIds.stream().map(powerId -> {
        RolePower rolePower = new RolePower();
        rolePower.setRoleId(roleId);
        rolePower.setPowerId(powerId);
        return rolePower;
    }).toList();
    saveBatch(rolePowerList);

    // 找到所有和当前更新角色相同的用户
    List<Long> roleIds = userRoleMapper.selectList(Wrappers.<UserRole>lambdaQuery().eq(UserRole::getRoleId, roleId))
            .stream().map(UserRole::getUserId).toList();

    // 根据Id查找所有用户
    List<AdminUser> adminUsers = userMapper.selectList(Wrappers.<AdminUser>lambdaQuery().in(!roleIds.isEmpty(), AdminUser::getId, roleIds));

    // 用户为空时不更新Redis的key
    if (adminUsers.isEmpty()) return;

    // 更新Redis中用户信息
    List<Long> userIds = adminUsers.stream().map(AdminUser::getId).toList();
    roleFactory.updateUserRedisInfo(userIds);
}

权限管理

在权限配置中，添加/修改权限时的请求地址为后端接口的请求地址，请求地址使用了【正则表达式】判断和【antpath】方式填写

正则表达式

作用和用法：

• 作用：正则表达式用于描述字符串的特征，可以用来匹配、查找、替换等字符串操作。
• 用法：在Java中，可以使用java.util.regex包来支持正则表达式的使用。例如，可以使用Pattern和Matcher类来编译和匹配正则表达式。

示例：

// 匹配邮箱地址的正则表达式示例
String emailRegex = "\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b";
String email = "example@email.com";

Pattern pattern = Pattern.compile(emailRegex);
Matcher matcher = pattern.matcher(email);

if (matcher.find()) {
    System.out.println("Valid email address");
} else {
    System.out.println("Invalid email address");
}

Ant Path

作用和用法：

• 作用：Ant Path是Spring框架中用来匹配URL路径的一种模式匹配方式，类似于Unix系统中的路径匹配规则。
• 用法：在Spring中，Ant Path可以用来匹配URL路径，例如在配置Spring的URL映射时可以使用Ant Path来指定匹配规则。

示例：

// Ant Path示例
String pattern = "/users/*/profile";
String path = "/users/123/profile";

AntPathMatcher matcher = new AntPathMatcher();
if (matcher.match(pattern, path)) {
    System.out.println("Pattern matched!");
} else {
    System.out.println("Pattern not matched!");
}

Ant Path中支持一些通配符，例如*匹配任意字符（除了路径分隔符），**匹配任意字符，包括路径分隔符。Ant Path是一种方便的路径匹配方式，可以用来匹配URL路径、文件路径等。

业务需求

1. 对权限表进行CURD操作
2. 在表格中点击新增时，父级id为当前点击行的id

实现思路

点击当前行父级id为当前的行的id

权限判断实现方式

后端判断方式

判断权限是否可以访问，后端实现判断逻辑

前端判断方式

角色分配方式有下面几种想洗参考：https://pure-admin.github.io/vue-pure-admin/#/permission/button/router，文档页面

1. 使用标签方式

2. 使用函数方式

3. 使用指令方式

在前端utils文件夹下有auth.ts文件里面包含了权限码信息，如果当前菜单属性中包含这个权限码表示可以访问这个权限

菜单管理

菜单路由

在做菜单返回时必须要了解角色和权限表

需求分析

1. 从数据库中返回出所有的菜单，其中需要整合成前端所要的形式，需要包含roles和auths，及其其它参数。

2. 用户需要根据自己的角色访问不同的菜单。

3. 如果当前用户不可以访问某些按钮需要隐藏。

4. 用户通过其它手段访问如：swagger、knife4j、apifox、postman这种工具访问需要做权限验证，如果当前用户不满足访问这些接口后端需要拒绝。

5. 如果已经添加了菜单名称、路由等级、路由路径会提示xxx已存在

6. 在数据库中为部分字段建立了唯一索引

实现思路

1. 角色和权限哪些可以访问的页面交给前端，在模板中已经设计好，如果用户访问了自己看不到的菜单会出现403页面；判断方式是根据后端返回的菜单中如果包含当前用户的角色就表示可以访问当前的菜单，如果用户信息中没有这个角色则表示不可以访问这个页面。
2. 页面是否可以访问只是在操作上，如果用户通过接口访问是阻止不了的，所以这时后端需要在后端中进行判断，当前的访问路径是否是被允许的，也就是这个用户是否有这个权限，权限表设计中包含了请求路径
3. 后端需要判断用户请求这个接口是否有权访问

整合成前端格式返回需要递归，后端根据当前用户访问的菜单需要进行递归菜单数据之后返回前端，并将这些菜单绑定的角色放置在roles中，之后根据角色查询全新啊相关内容，要将权限内容放置在auths中.

如果包含子菜单需要防止在children数组中，后端实现时如果没有子菜单默认是空数组而不是null

大致如下：

{
"menuType": 0,
"title": "admin_user",
"path": "/system/admin-user",
"component": "/system/adminUser/index",
"meta": {
    "icon": "ic:round-manage-accounts",
    "title": "admin_user",
    "rank": 2,
    "roles": [
        "admin",
        "all_page",
        "system",
        "test"
    ],
    "auths": [
        "message::updateMessage",
        "menuIcon::getMenuIconList",
        "admin::messageReceived",
        "config::getWebConfig",
        "admin::config",
        "i18n::getI18n",
        ....
    ],
    "frameSrc": ""
},
"children": [],
"id": "1841803086252548097",
"parentId": "1",
"name": "admin_user",
"rank": 2
}

部门管理

业务需求

1. 包含CURD
2. 在用户管理中可以选择对应的部门

实现思路

1. CURD接口文件如下

2. 管理员为用户分配部门

菜单图标

业务需求

1. 用户在菜单中可以选择存储在数据库中的图标内容
2. 包含CURD内容

实现思路

后端需要返回接口格式实体类如下

public class MenuIconVo extends BaseUserVo {

    @Schema(name = "iconCode", title = "icon类名")
    private String iconCode;

    @Schema(name = "iconName", title = "icon 名称")
    private String iconName;

}

前端封装好的组件

邮箱相关

业务需求

1. 邮件用户配置CURD
2. 邮件模板CURD
3. 邮件用户中只能有一个是默认的，如果当前修改其它项需要将其它已经启用改为不启用
4. 邮件模板需要绑定邮件用户

实现思路

邮件模板中，添加或者修改时前端需要返回所有的邮件模板用户，添加或者修改时将用户ID存储在邮件模板的数据字段中

web配置

系统监控

服务监控

从SpringBoot的Actuator中获取信息，页面采用响应式

系统缓存

当前内容被SpringBoot缓存会显示在这

定时任务

采用Quarter持久化存储，所有的可以使用的定时任务都在这

页面展示

多语言管理

日志管理

消息管理

管理员可以发送消息告诉xxx用户，在主页中会显示

之后点击时会看到消息封面、标题、简介、消息等级、消息等级内容

消息类型

包含CURD，用户编辑消息发送时可以在选择

同时在用户消息栏中也会显示对应内容

前端判断逻辑如下

消息编辑

提供md编辑器和富文本编辑器

消息接受用户，如果不填写表示全部的用户，填写后会根据填写的内容存储在用户接受表中

消息等级是显示消息样式颜色，文字内容为消息简介内容

消息接收管理

根据上面所选的接受用户会出现在下面的用户接受表中，可以对当前用户是否已读进行修改

消息发送管理

之前编辑过的消息都会在这

环境部署

使用Docker进行部署，后端接口地址以/admin开头，但前端默认请求前缀为/api，因此在请求时需要进行替换。详细内容请参考以下【项目部署】说明。

配置相关

docker文件

# 使用官方的 Nginx 镜像作为基础镜像
FROM nginx

# 删除默认的 Nginx 配置文件
RUN rm /etc/nginx/conf.d/default.conf

# 将自定义的 Nginx 配置文件复制到容器中
COPY nginx.conf /etc/nginx/conf.d/default.conf

# 设置时区，构建镜像时执行的命令
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
RUN echo "Asia/Shanghai" > /etc/timezone

# 创建一个目录来存放前端项目文件
WORKDIR /usr/share/nginx/html

# 将前端项目打包文件复制到 Nginx 的默认静态文件目录
COPY dist/ /usr/share/nginx/html
# 复制到nginx目录下
COPY dist/ /etc/nginx/html

# 暴露 Nginx 的默认端口
EXPOSE 80

# 自动启动 Nginx
CMD ["nginx", "-g", "daemon off;"]

NGINX文件

在请求中会使用代理所以会拿不到用户真实的IP地址，素以在要NGINX侠做下面的配置，这样用户在访问时就可以拿到真实的IP了

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

如果需要使用https协议

COPY bunny-web.site.csr /etc/nginx/bunny-web.site.csr
COPY bunny-web.site.key /etc/nginx/bunny-web.site.key
COPY bunny-web.site_bundle.crt /etc/nginx/bunny-web.site_bundle.crt
COPY bunny-web.site_bundle.pem /etc/nginx/bunny-web.site_bundle.pem

NGINX的文件

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen       80;
    listen       [::]:80;
    server_name  localhost;

    location / {
        root   /etc/nginx/html;
        index  index.html index.htm;
        try_files $uri /index.html;
    }

    # 后端跨域请求
    location ~/admin/ {
        proxy_pass http://172.17.0.1:8000;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    error_page  404              404.html;

    location = /50x.html {
        root   html;
    }
}

项目部署

使用WebStorm进行项目部署，项目上线时默认端口为80。因此，Docker默认暴露的IP端口也应为80，NGINX中默认暴露的端口也是80，三者应一一对应。

若无法下载，请先使用pnpm下载。若不需使用pnpm，请删除或修改相应内容。

docker配置

配置环境

设置启动端口号和项目地址机器后端请求地址

配置线上环境

设置项目启动端口号，线上环境默认请求路径为/admin，需在NGINX中将访问请求前缀更改为/admin。

配置开发环境

开发环境默认IP为7000，若与本地项目端口冲突，请修改。后端请求地址为7070。

前端设置的请求前缀为/api，但后端接受的前缀为/admin，因此需在服务中修改此内容。

修改请求路径

部署命令

docker build -f Dockerfile -t bunny_auth_web:1.0.0 . && docker run -p 80:80 --name bunny_auth_web --restart always bunny_auth_web:1.0.0