# lys-blog

**Repository Path**: lixinDaniel_admin/lys-blog

## Basic Information

- **Project Name**: lys-blog
- **Description**: 简单、易上手的个人博客
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-09
- **Last Updated**: 2024-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue, Java, SpringBoot, MySQL, Redis

## README

<p align="center">
  <img src="images/202402260950444.png" alt="lys" width="200" height="200"/>
</p>

## 💡 简介
lys博客系统，是基于SpringBoot+Mybatis-Plus+SpringSecurity+Redis+MySQL+Vue2.x+Element-UI+axios+echarts+Maven构建的博客系统。

##  ✨ 功能
- 文章采用了比较火的Markdown编辑器。
- 系统集成了邮件发送功能。
- 系统可以自定义友情链接。
- 系统主页推荐文章 / 热门文章(展示最近n天用户访问量最多的10篇文章)。
- 集成了百度IP定位API，记录用户的登陆地址及IP归属地展示。
- 用户发布博客附带文件实现了目录文件结构的树形展示。
- 系统注册新用户实行邮箱绑定制、单个邮箱注册账号不得超过3个。
- 系统实行积分制，下载资源需要扣除相应积分，同样被下载资源的用户会得到一定积分的奖励。
- 用户可以通过每日签到获取免费积分，单日签到次数不超过1次。
- 集成了支付宝支付功能，系统已经实现了支付宝沙箱环境的对接。
- 系统尽可能实现可配置，前台信息管理端可自定义配置。
- 系统实现了对博客的点赞、收藏、评论等功能，也可对自己心仪的博主进行打赏。
- 系统实现了匿名预览功能，匿名账号拥有系统最高查看权限(除DMML操作，该账号止咳查看、无法进行增删改操作、不会对系统造成影响)
- 前后端通过token进行交互，token30分钟内持续操作无感知续时(只要用户在操作，永不过期)

## ✨ 待优化内容
- ❌ 用户注册时会验证邮箱的正确性，个人中心修改邮箱时也可加入邮箱验证。
- ❌ 用户登录时可加入邮箱登陆的方式。
- ❌ 用户在浏览文章时，可加入博主的个人中心页面展示功能。
- ❌ 超级管理员创建新用户的输入框没有自适应
- ❌ 前端AES.js变成从后端获取前后端约定的key，前端AES.js改为从后端获取
- ❌ 定时任务处理使用单独的模块，feign配置
- ❌ 评论模块，评论内容可进行敏感词过滤，敏感词库可自行配置
- ❌ 生产上的jar包，启动脚本
- ✅ SystemInnerConfig换成从库里读取数据
- ❌ PC两侧增加广告位，读取配置
- ❌ 图片上传，阿里云oss存储，服务器本地存储
- ❌ 积分充值接口，积分充值失败

##  ✨ 运行环境
 - 开发工具：Idea、Vscode 
 - 数据库：MySQL5.7+、Redis 
 - 构建工具：Maven3.6.0+
 - 前端运行环境：nodejs14.21.3

## ✨ 技术介绍
 - 服务端采用SpringBoot框架搭建，Mybatis—Plus做为持久层框架，SpringSecurity技术进行认证权限控制
 - 数据库采用MySQL
 - 前端采用了Vue2.x、Element-UI、axios、echarts等技术、管理系统采用vue-element-admin

## ✨ 部署教程
1. 拉取项目（前后端的项目地址，暂时没有拆分）
```
https://gitee.com/lixinDaniel_admin/lys-blog.git
```
2. 进入lys-web-client目录
分别进入两个目录，打开cmd执行如下命令，等待依赖下载完
```
npm install
```

3. 连接数据库
依次执行config目录下的两个SQL文件,在执行lys_currency_sys.sql

4. 在lys-blog-management模块下找到application-dev.yml配置文件，修改以下几处地方 
   - 文件上传位置配置，修改为全路径，`common.file-upload.path:/Users/lix/lys-blog/upload`
   - 修改数据库连接信息，用户名、密码、数据库名
   - 配置redis连接信息，ip、端口、密码
   - 进入百度地图开放平台申请定位AK并配置：[百度地图开放平台](https://lbsyun.baidu.com/index.php)
   - 配置邮件发送，默认使用的qq邮箱，更换为自己邮箱的stmp服务器地址、端口、发件人地址、密码
   - 如需调试付款购买积分，自行配置支付宝沙箱环境，配置app-id、私钥、公钥 
     - 无服务器本地可使用内网穿透技术测试
   - 选配：
     - windows电脑，在你的hosts文件添加一行配置`127.0.0.1  www.blob.com`
     - 生产：
       - 如需部署到服务器：修改`application-prod.yml`配置，修改一下日志的存储位置，可将级别修改为error
       - 修改服务端项目的域名，申请完域名后，修改参数key为：`auth.domain`,value换成自己的域名即可

> 此处域名有如下作用：
> 1. 图片资源为服务端管理，做防盗链控制，小伙伴们可以自行使用Nginx搭建文件服务器调整
> 2. 获取用户token顺序是先从cookie，再从header获取

5. 启动redis服务端
6. 启动服务端项目
7. 启动前端项目

- 进入lys-web-client\lys-blog-sys-pc目录打开cmd，执行如下命令
```shell
npm run serve
```

- 进入lys-web-client\lys-blog-sys-pc目录打开cmd，执行如下命令
```shell
npm run dev
```

8. 本地访问
 - 前台系统访问：http://127.0.0.1:3000/index 或者 http://www.blob.com:3000/index （自行配置）
 - 管理系统访问：http://127.0.0.1:9527/ 或者 http://www.blob.com:9527/ （自行配置）
 
注意：如果想完全不出问题，要使用域名访问，如使用IP访问或者localhost访问 会有图片防盗链问题


## ✨ 提供账号
- 超级管理员：admin/123456
- 用户：user/1234567890!（暂时不生效）
- 可以注册账号，注册账号后，默认为普通用户，可自行配置权限


##  ✨ 成果展示

系统截图简单放几个，全部放太多了

**前台系统**

前台首页

![image-20240226135518861](images/202402261355034.png)

登录页

系统可以匿名访问，包括浏览文章、给博主打赏等，匿名状态下进行下载文件、点赞、评论、收藏等操作时，会自动弹出登录页面，如下图

`注意：服务端做了环境配置，开发环境验证码不做验证，随便输入即可`

![image-20240226140404481](images/202402261404553.png)

文章详情页

用户点击文章列表进入文章详情页，可以进行点赞、收藏、打赏(前提是博主已开通并上传打赏收款二维码)、下载(前提是该文章附带文件资料)

![image-20240226140843921](images/202402261408001.png)

举报文章

用户可对其他用户发布的文章进行举报，为防止恶意举报，单个用户每日上限举报3次

![image-20240226143348182](images/202402261433251.png)

文章发布页

用户登录后可发布文章、如未编写完毕，可暂时保存草稿，下次可直接编辑

发布后由管理员审核并设置资源下载所需积分

`注意：发布成功后会有<5分钟的延迟，首页缓存，影响不大，可以通过搜索获取到文章`

![image-20240226141110887](images/202402261411003.png)

个人中心->个人资料

用户可在此处查看并修改个人的用户信息

![image-20240226141620112](images/202402261416190.png)

个人中心-个性化设置

用户可在此处进行积分余额是否展示、通知、博文打赏的配置(未配置不可被打赏)

![image-20240226141942632](images/202402261419713.png)

管理员登录页

![image-20240226135704099](images/202402261357165.png)

管理员首页

![image-20240226135733020](images/202402261357092.png)

用户管理

- 权限：超级管理员可以设置单个用户的权限、包括用户的文件上传权限、发言评论权限、打赏功能权限、文章发布权限、申请友链权限、用户反馈权限、用户举报权限等
- 授权：超级管理员可对用户进行角色授权
- 禁用：禁止用户登陆系统
- 重置：充值用户登录密码
- 删除：删除用户

![image-20240226142146256](images/202402261421326.png)

![image-20240226142446426](images/202402261424483.png)

定时任务管理

配置项目中用到的一些的定时任务，也可以查看定时任务的执行日志

![image-20240226142534977](images/202402261425038.png)

![image-20240226142636360](images/202402261426427.png)

关于本站

管理员可设置系统的标题、Logo、系统简介等配置项

![image-20240226142846975](images/202402261428078.png)

首页管理

主要配置首页的链接、标签、技术分类、导航链接等配置

![image-20240226143006448](images/202402261430512.png)

博客审核

如果博客带有资料文件，可以设置下载积分，如果没有，则不能设置

![image-20240226143206712](images/202402261432788.png)

举报管理

处理用户的举报，有以下几种惩罚措施

对于博客

1、举报不实、不做处理

2、删除该帖子

3、删除该帖子，禁止该用户发布文章权限

4、禁止用户上传文件权限

禁止权限可设置对应时长，单位分钟，可以设置是否邮件提醒用户

![image-20240226143511693](images/202402261435753.png)

![image-20240226143758558](images/202402261437621.png)

日志管理

查看管理员的操作日志

![image-20240226143857937](images/202402261438005.png)

交易类型管理

配置前台用户通过购买获取积分的配置

![image-20240226143938897](images/202402261439958.png)

其余功能不做演示、可查看演示视频