Update README.md

luoye6 · web-flow · commit b6bf4622c0c2 · 2023-11-14T20:28:16.000+08:00
diff --git a/README.md b/README.md
@@ -1,3 +1,11 @@
+# 智能图书馆开源文档
+
+>作者：[程序员小白条](https://luoye6.github.io/)
+>
+>[Gitee 主页](https://gitee.com/falle22222n-leaves)
+>
+>[GitHub 主页](https://github.com/luoye6)
+
 ## ☀️新手必读
 
 + 本项目拥有完整的API后台接口文档（文尾)(重点⭐)
@@ -8,6 +16,14 @@
 + [项目后端地址](https://gitee.com/falle22222n-leaves/vue_-book-manage-system_backend)
 + [项目部署视频](https://www.bilibili.com/video/BV1314y1Z7SS/?pop_share=1&vd_source=e40a9464b71684502f289cff3f51514f)
 
+​														[![star](https://gitee.com/falle22222n-leaves/vue_-book-manage-system/badge/star.svg?theme=dark)](https://gitee.com/falle22222n-leaves/vue_-book-manage-system)  [![gitee](https://badgen.net/badge/gitee/falle22222n-leaves/red)](https://gitee.com/falle22222n-leaves)  [![fork](http://xxx.xiaobaitiao.club/project/fork.svg)](https://gitee.com/falle22222n-leaves/vue_-book-manage-system/members)  [![github](https://badgen.net/badge/github/github?icon)](https://github.com/luoye6)
+
+## ☀️个人介绍
+
+![image-20231030110808831](https://pic.yupi.icu/5563/image-20231030110808831.png)
+
+![image-20231030110232309](https://pic.yupi.icu/5563/image-20231030110232309.png)
+
 ## ☀️技术栈介绍
 
 ### ☃️前端主要技术栈
@@ -47,6 +63,10 @@
 | fastjson                           | 阿里巴巴的json对象转化工具                                   | 1.2.83                            |
 | hutool                             | hutool工具包(简化开发工具类)                                 | [文档](https://hutool.cn/docs/#/) |
 
+## ☀️架构
+
+![图书管理系统架构图](https://pic.yupi.icu/5563/202311101959386.png)
+
 ## ☀️项目简介
 
 + 主要使用Vue2和SpringBoot2实现
@@ -73,12 +93,15 @@
 + 数据返回格式使用JSON
 + 后端采用权限拦截器进行权限校验，并检查登录情况
 + 添加全局异常处理机制，捕获异常，增强系统健壮性
-+ 前端用Echarts展示借阅量，文字和图片结合
++ 前端用Echarts可视化库实现了图书借阅的分析图标（折线图、饼图），并通过loading配置提高加载体验。
 + 留言组件采用弹幕形式，贴合用户的喜好。
++ 引入knife4j依赖，使用 Swagger + Knife4j 自动生成 OpenAPI 规范的接口文档，前端可以在此基础上使用插件自动生成接口请求代码，降低前后端协作成本
++ 使用ElementUI组件库进行前端界面搭建，快速实现页面生成，并实现了前后端统一权限管理，多环境切换等能力。
++ 基于MyBatis Plus框架的QueryWrapper实现对MySQL数据库的灵活查询，并配合MyBatisX插件自动生成后端CRUD基础代码，减少重复工作。
 
 ### ⭐用户模块功能介绍
 
-![img](http://xxx.xiaobaitiao.club/project/%E7%94%A8%E6%88%B7%E6%A8%A1%E5%9D%97%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%BB%8D.png)
+![image-20231030110244726](https://pic.yupi.icu/5563/image-20231030110244726.png)
 
 + 图书查询功能：分页构造器缓解数据过大压力，后端可设置请求数防止爬虫请求数过大，服务器负载过大。模糊查询进行字段搜索。表格均可导出PDF和EXCEL。
 + 读者规则功能：查询现有的借阅规则，借阅规则包括：借阅编号，可借阅图书数量，可借阅天数，可借阅图书馆，过期扣费/天。
@@ -92,7 +115,7 @@
 
 ### ⭐图书管理员模块功能介绍
 
-![image-20230311151434774](http://xxx.xiaobaitiao.club/project/%E5%9B%BE%E4%B9%A6%E7%AE%A1%E7%90%86%E5%91%98%E6%A8%A1%E5%9D%97%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%BB%8D%E5%9B%BE.png)
+![image-20231030110256051](https://pic.yupi.icu/5563/image-20231030110256051.png)
 
 + 借阅图书: 图书管理员输入借阅证号(用户)和要借的图书编号和当前的时间，点击借阅。
 + 归还图书: 输入图书编号查看图书是否逾期，并且可以设置违规信息，然后选择是否归还图书
@@ -103,7 +126,7 @@
 
 ### ⭐系统管理员模块功能介绍
 
-![image-20230311151453931](http://xxx.xiaobaitiao.club/project/%E7%B3%BB%E7%BB%9F%E7%AE%A1%E7%90%86%E5%91%98%E6%A8%A1%E5%9D%97%E4%BB%8B%E7%BB%8D%E5%9B%BE.png)
+![image-20231030110303880](https://pic.yupi.icu/5563/image-20231030110303880.png)
 
 + 书籍管理: 可以查询当前的所有图书，显示图书编号，图书昵称，作者，图书馆，分类，位置，状态，描述。可以进行添加，修改，删除图书。利用分页构造器实现批量查询。利用模糊查询实现图书搜索功能。利用插件实现PDF和EXCEL导出。
 + 书籍类型: 显示查询当前的所有图书类型，可以进行添加，修改，删除图书类型，利用分页构造器实现批量查询，缓解数据压力。
@@ -250,75 +273,85 @@
 
 **首页轮播图演示**
 
-![image-20230311151755217](http://xxx.xiaobaitiao.club/project/%E9%A6%96%E9%A1%B5%E8%BD%AE%E6%92%AD%E5%9B%BE%E6%BC%94%E7%A4%BA.png)
+![image-20231030110318881](https://pic.yupi.icu/5563/image-20231030110318881.png)
 
 **图书查询演示**
 
-![image-20230311151815350](http://xxx.xiaobaitiao.club/project/%E5%9B%BE%E4%B9%A6%E6%9F%A5%E8%AF%A2%E6%BC%94%E7%A4%BA.png)
+![image-20231030110329273](https://pic.yupi.icu/5563/image-20231030110329273.png)
 
 **读者规则演示**
 
-![image-20230311151837692](http://xxx.xiaobaitiao.club/project/%E8%AF%BB%E8%80%85%E8%A7%84%E5%88%99%E6%BC%94%E7%A4%BA.png)
+![image-20231030110333842](https://pic.yupi.icu/5563/image-20231030110333842.png)
 
 **查看公告演示**
 
-![image-20230311151858285](http://xxx.xiaobaitiao.club/project/%E6%9F%A5%E7%9C%8B%E5%85%AC%E5%91%8A%E6%BC%94%E7%A4%BA.png)
+![image-20231030110340781](https://pic.yupi.icu/5563/image-20231030110340781.png)
 
 **个人信息演示**
 
-![image-20230311151918353](http://xxx.xiaobaitiao.club/project/%E4%B8%AA%E4%BA%BA%E4%BF%A1%E6%81%AF%E6%BC%94%E7%A4%BA.png)
+![image-20231030110345751](https://pic.yupi.icu/5563/image-20231030110348229.png)
 
 **借阅信息演示**
 
-![image-20230311151939885](http://xxx.xiaobaitiao.club/project/%E5%80%9F%E9%98%85%E4%BF%A1%E6%81%AF%E6%BC%94%E7%A4%BA.png)
+![image-20231030110405947](https://pic.yupi.icu/5563/image-20231030110405947.png)
 
 **违章信息演示**
 
-![image-20230311151958147](http://xxx.xiaobaitiao.club/project/%E8%BF%9D%E7%AB%A0%E4%BF%A1%E6%81%AF%E6%BC%94%E7%A4%BA.png)
+![image-20231030110414231](https://pic.yupi.icu/5563/image-20231030110414231.png)
 
 **读者留言演示**
 
-![image-20230311152043122](http://xxx.xiaobaitiao.club/project/%E8%AF%BB%E8%80%85%E7%95%99%E8%A8%80%E6%BC%94%E7%A4%BA.png)
+![image-20231030110420564](https://pic.yupi.icu/5563/image-20231030110420564.png)
+
+**智能推荐演示**
+
+![image-20231030110529142](https://pic.yupi.icu/5563/image-20231030110529142.png)
 
 ### 图书管理员功能图
 
 **借阅图书演示**
 
-![image-20230311152118721](http://xxx.xiaobaitiao.club/project/%E5%80%9F%E9%98%85%E5%9B%BE%E4%B9%A6%E6%BC%94%E7%A4%BA.png)
+![image-20231030110551512](https://pic.yupi.icu/5563/image-20231030110551512.png)
 
 **归还图书演示**
 
-![image-20230311152136821](http://xxx.xiaobaitiao.club/project/%E5%BD%92%E8%BF%98%E5%9B%BE%E4%B9%A6%E6%BC%94%E7%A4%BA.png)
+![image-20231030110611331](https://pic.yupi.icu/5563/image-20231030110611331.png)
 
 **借书报表演示**
 
-![image-20230311152220983](http://xxx.xiaobaitiao.club/project/%E5%80%9F%E4%B9%A6%E6%8A%A5%E8%A1%A8.png)
+![image-20231030110618748](https://pic.yupi.icu/5563/image-20231030110618748.png)
 
 **还书报表演示**
 
-![image-20230311152251587](http://xxx.xiaobaitiao.club/project/%E8%BF%98%E4%B9%A6%E6%8A%A5%E8%A1%A8.png)
+![image-20231030110626015](https://pic.yupi.icu/5563/image-20231030110626015.png)
 
 **发布公告演示**
 
-![image-20230311152310736](http://xxx.xiaobaitiao.club/project/%E5%8F%91%E5%B8%83%E5%85%AC%E5%91%8A%E6%BC%94%E7%A4%BA.png)
+![image-20231030110634352](https://pic.yupi.icu/5563/image-20231030110634352.png)
 
 ### 系统管理员功能图
 
-+ 由于篇幅受限，系统管理员功能图只展示一个图表的功能。
++ 由于篇幅受限，系统功能展示主要功能。
 
 **系统管理演示**
 
-![image-20230311152338284](http://xxx.xiaobaitiao.club/project/%E7%B3%BB%E7%BB%9F%E7%AE%A1%E7%90%86.png)
+![image-20231030110641741](https://pic.yupi.icu/5563/image-20231030110641741.png)
+
+![image-20231030110649230](https://pic.yupi.icu/5563/image-20231030110649230.png)
+
+**智能分析演示**
+
+![image-20231030110656108](https://pic.yupi.icu/5563/image-20231030110656108.png)
 
 ## 🐼部署项目
 
-![image-20230311152411864](http://xxx.xiaobaitiao.club/project/%E9%83%A8%E7%BD%B2%E9%A1%B9%E7%9B%AE%E6%BC%94%E7%A4%BA1.png)
+![image-20231030110703088](https://pic.yupi.icu/5563/image-20231030110703088.png)
 
 + 可以下载ZIP压缩包或者使用克隆(Git clone)
 + 复制http或者ssh的链接（github建议ssh,gittee都可以)
 + 在D盘新建一个文件夹，点击进入该文件夹，右键Git Bash Here
 
-![image-20230311152442211](http://xxx.xiaobaitiao.club/project/%E9%83%A8%E7%BD%B2%E9%A1%B9%E7%9B%AE%E6%BC%94%E7%A4%BA2.png)
+![image-20231030110713924](https://pic.yupi.icu/5563/image-20231030110713924.png)
 
 + 还没有下载Git或者不会Git的建议先看基础教程（30分钟左右)
 
@@ -353,9 +386,8 @@
 ⭐
 
 + **QQ：909088445**
-
-+ 晚上在线，建议先自己寻找问题，实在实现不了，可以滴我
-+ 需要定制化项目和修改项目的某些的功能也可以加我
++ 一般晚上在线，建议先自己寻找问题！！！
++ 开源免费， 定制化和调试项目付费。
 
 ## 🐼项目API接口文档
 
@@ -395,14 +427,96 @@
 
 ### 2023-5-1
 
-1.添加“系统管理员”权限的系统管理功能，添加借书类型分析统计图（饼图）采用Echarts。
+1.添加“系统管理员”权限的系统管理功能，**添加借书类型分析统计图（饼图）**采用Echarts。
+
+2.优化请求在没有收到数据时的显示卡顿的情况，添加“加载中”状态,**使用v-loading**(ElementUI组件库)，**优化用户人机交互体验**，在服务器调用接口缓慢的情况下，给予**良好的交互**。
+
+3.轮播图优化：**压缩图片体积**，另外使用Swiper的**懒加载**，实现图片加载中状态，然后图片完全加载完成后才显示图片，**优化用户体验过程**。
+
+4.后端**新增自定义错误码枚举类**，可以自定义状态码进行返回，保留原有枚举类。
+
+5.前端优化部分表格内容展示，当纵向内容过长，**设置了表格最大高度**，超出就会显示滑动窗口。优化表格列宽度，**提高表格美观度**。
+
+6.**添加**书籍管理组件的**批量删除图书**功能，优化管理员体验，不用单个删除图书，**提高效率**。
+
+7.Jmeter进行压力测试，服务器接口在**100个用户并发**发送请求的情况下，**QPS达到50**以上。
+
+### 2023-5-20
+
+**后端更新情况**
+
+1.防止前端抓包被获取明文密码，前端输入密码，进行md5加密（混合盐值，防止碰撞),后端直接与数据库加密后的密码比较，相等代表登录成功。提高系统**安全性**。
+
+2.整改Controller层，**将业务代码全部放入Service层**，由Controller调用Service服务，并修改了@Transactional注解位置到业务层，减少耦合度，让Controller减少臃肿。做到对扩展开放，对修改关闭。后续考虑运用**设计模式**进行优化代码和**多线程**知识提高在**高并发**下接口响应的速度。
+
+3.对照阿里巴巴手册进行代码修改，将警告进行减少，代码更加**优雅、规范**。
+
+4.**修复BUG**： 借阅时间为空，造成服务器被击穿。归还日期为空，仍然显示借书成功。（解决方法：时间参数进行校验，判断是否为空)
+
+5.**工具类增加情况**:SQLUtils(防止SQL注入)，NetUtils(网络工具类)
+
+**前端更新情况**
+
+1.将路由加载方式，改为懒加载，利用懒加载可以有效分担首页加载压力，**减少首页加载用时**。
+
+2.添加404页面，当用户访问请求地址不存在的页面，直接跳转到404页面，**提高用户体验度**。
+
+3.添加按钮的加载中状态，**优化人机交互**，提升用户体验度。修改按钮：登录按钮，其他按钮如果有需要可以自定义去修改，增加:loading="loading"即可。
+
+**Bug修复情况**
+
+1.11位图书编号可以借，但却**无法进行逾期检查**，发现方法参数还是Integer,上次把借书和还书的改成Long了，逾期查看还没改成Long,因此出现问题，现在已经修复。
+
+### 2023-6-10
+
+**前端更新情况**
+
+1.在某些页面添加全屏功能按钮，**方便用户放大查看表格数据**。
+
+2.增加了GitHub和Gitee的地址图标，**方便进行项目拉取和克隆**。
+
+3.读者留言组件，留言功能进行强化，防止无意义的数字、字母、空格出现在数据，后续考虑
+
+4.读者留言组件，**利用lodash进行节流**，5秒内只可发送一次网络请求，防止恶意刷无效留言。
+
+**后端更新情况**
+
+1.后端添加利用EasyExcel进行图书的**批量导入功能**，实现与实际生活中利用Excel存储一些图书数据的交互功能，**提高导入效率**，和爬虫功能效果相同，都可以实现大数据量情况下的导入，推荐利用EasyExcel进行批量导入，时间会比爬虫会更快。
+
+**Bug修复情况**
+
+1.修改用户页面的修改密码功能，因为上次更新已经加了盐值，但是后端代码逻辑没有进行更改，本次修复"在修改密码后无法登录的情况"，原因是因为后端没有加盐值，已修复。
+
+2.修复系统管理员修改借阅证的密码然后就登录不上了，原因跟第一条Bug是一样的，因为后端的盐值没有进行添加，已修复。
+
+3.修复系统管理员在书籍管理功能时候，直接点击修改书籍，发现书籍的分类是错误的，因为前端只在添加书籍的对话框发了获取分类的请求，修改对话框的时候忘记添加了获取分类的请求，已修复。
+
+### 2023-9
+
+**前端更新情况**
+
+1.增加**智能推荐页面，**能够与AI进行交流**，用户输入自己喜欢xxx类的书籍，AI能够在现有数据库中进行分析，**然后给用户作出推荐**，调用的是国内AI模型，底层是OpenAI。
+
+2.增加**智能分析页面**，输入分析目标和图标类型和Excel文件，AI生成分析结论和可视化图标，大大提高效率，**减少人力分析成本**。
+
+3.增加系统管理员可以利用在前端**利用Excel文件批量上传图书**的功能（测试中),仅供参考。
+
+**后端更新情况**
+
+1.增加智能分析的接口和获取最近5条聊天记录的接口，利用**线程池**和**Future**进行**超时请求处理**，如果接口调用超过40秒直接返回错误信息。
+
+2.利用Google的Guava中的RateLimiter进行限流控制，**每秒钟只允许一个请求通过**，防止刷量行为。
+
+### 2023-11
+
+**后端更新情况**
 
-2.优化请求在没有收到数据时的显示卡顿的情况，添加“加载中”状态,使用v-loading(ElementUI组件库)，优化用户人机交互体验，在服务器调用接口缓慢的情况下，给予良好的交互。
+1.将用户聊天的AI模型切换为阿里的通义千问Plus模型，并且**支持多轮会话的历史记录**，**不再使用讯飞星火的AI模型**，但仍保留工具类。主要是为了可以更快的得到响应，而且阿里的**文档更加详细**，可以**定制话术**，在用户输入无关图书推荐的内容时候，直接**拒绝回答**。
 
-3.轮播图优化：压缩图片体积，另外使用Swiper的懒加载，实现图片加载中状态，然后图片完全加载完成后才显示图片，优化用户体验过程。
+2.添加一个 IncSyncDeleteAIMessage **定时任务**，每天将会**删除由于系统错误等原因AI回复失败**，导致内容为空的记录，并且会为这些用户**恢复接口的次数**，**后续可能会选择 RabbitMQ**，将失败的消息放入消息队列，然后**确保失败的消息被消费**。
 
-4.后端新增自定义错误码枚举类，可以自定义状态码进行返回，保留原有枚举类。
+**前端更新情况**
 
-5.前端优化部分表格内容展示，当纵向内容过长，设置了表格最大高度，超出就会显示滑动窗口。优化表格列宽度，提高表格美观度。
+1.将三个登录页面的背景图和头像改为存储在 assets 文件夹的 images 中，**主要是为使用项目的人考虑**，很多人不懂图床技术，我这边暂时将登录页面改成静态图。
 
-6.添加书籍管理组件的批量删除图书功能，优化管理员体验，不用单个删除图书，提高效率。
+2.权限切换的提示优化，**在图标上面现在有登录权限切换的文字样式**，提示用户有多个登录页面可以切换。
