Gitee 主页

前台：https://localhost:8081/#/login 后台：https://localhost:8081/#/loginadmin

Language：English| 中文.

AI 智能图书馆（AI Intelligent Library）是一个利用 AI 模型和数据分析对用户所喜欢的图书进行精准推荐的系统，并且提供了 AIGC 的在线生成借阅量分析的 BI 图表功能，能够起到一个数据分析师的作用。其主要有三大使用者：用户（借阅人）、图书管理员、系统管理员。

Ps：如果你想要简易和新颖，那么这个项目将会是不错的选择~

1）图书查询功能：分页构造器缓解数据过大压力，后端可设置请求数防止爬虫请求数过大，服务器负载过大。模糊查询进行字段搜索。表格均可导出 PDF 和 EXCEL。

2）读者规则功能：查询现有的借阅规则，借阅规则包括：借阅编号，可借阅图书数量，可借阅天数，可借阅图书馆，过期扣费/天。

3）查看公告: 可以查询图书管理员发布的公告列表，文字滑动效果。

4）个人信息: 可以查看个人的借阅证编号，借阅证姓名，规则编号，状态，可以修改个人账户的密码。

5）借阅信息: 可以查看自身借阅过的图书记录和归还情况。

6）违章信息: 可以查询自身归还的图书是否有违章信息。

7）读者留言: 实现留言功能并以弹幕形式显示。

8）智能推荐用户输入自己的偏好，AI 根据数据库书籍列表和用户偏好，给用户推荐书籍。

1）借阅图书: 图书管理员输入借阅证号(用户)和要借的图书编号和当前的时间，点击借阅。

2）归还图书: 输入图书编号查看图书是否逾期，并且可以设置违规信息，然后选择是否归还图书。

3）借书报表: 用于查询已经借阅并归还的书籍列表，同样使用分页构造器和模糊查询字段，显示借阅证编号，图书编号，借阅日期，截止日期，归还日期，违章信息，处理人。

4）还书报表: 用于查询已经借阅但是还未归还的书籍列表，显示借阅证编号，图书编号，借阅日期，截止日期。

5）发布公告: 可以查询当前发布的公告列表，并进行删除，修改，增加功能，分页构造器用于缓解数据量大的情况。

1）书籍管理: 可以查询当前的所有图书，显示图书编号，图书昵称，作者，图书馆，分类，位置，状态，描述。可以进行添加，修改，删除图书。利用分页构造器实现批量查询。利用模糊查询实现图书搜索功能。利用插件实现 PDF 和 EXCEL 导出。

2）书籍类型: 显示查询当前的所有图书类型，可以进行添加，修改，删除图书类型，利用分页构造器实现批量查询，缓解数据压力。

3）借阅证管理: 可以查询当前的所有借阅证列表，也就是用户数量，可以进行添加，修改，删除操作。同样实现分页。

4）借阅信息查询: 可以查询当前已经完成借阅和归还的记录，显示借阅证号，书籍编号，借阅日期，截止日期，归还日期，违章信息，处理人。分页功能，PDF 和 EXCEL 导出。

5）借阅规则管理: 可以查询当前所有的借阅规则，显示限制借阅天数，限制本数，限制图书馆，逾期费用，可以进行添加、删除、修改操作。

6）图书管理员管理: 显示当前的图书管理员列表，显示账号，姓名，邮箱，可以进行添加、删除、修改操作。

7）系统管理: 可以查询一个月内的借阅量，以一周为时间间隔，计算借阅量，用 Echarts 实现各种图表的展示。

8）系统分析：可以上传某个时间段的借阅量和日期，并且输入分析目标和想要生成的图表类型，等待一段时间后，AI 将会给出分析结论和可视化图表。

1）本项目采用前后端分离的模式，前端构建页面，后端作数据接口，前端调用后端数据接口得到数据，重新渲染页面。

2）前端在 Authorization 字段提供 Token 令牌，API 认证使用 Token 认证，使用 HTTP Status Code 表示状态，数据返回格式使用 JSON。

3）后端已开启 CORS 跨域支持，采用权限拦截器进行权限校验，并检查登录情况。

4）添加全局异常处理机制，捕获异常，增强系统健壮性。

5）前端用 Echarts 可视化库实现了图书借阅的分析图标（折线图、饼图），并通过 Loading 配置提高加载体验。

6）留言组件采用弹幕形式，贴合用户的喜好。

7）引入 knife4j 依赖，使用 Swagger + Knife4j 自动生成 OpenAPI 规范的接口文档，前端可以在此基础上使用插件自动生成接口请求代码，降低前后端协作成本

8）使用 ElementUI 组件库进行前端界面搭建，快速实现页面生成，并实现了前后端统一权限管理，多环境切换等能力。

9）基于 MyBatis Plus 框架的 QueryWrapper 实现对 MySQL 数据库的灵活查询，并配合 MyBatisX 插件自动生成后端 CRUD 基础代码，减少重复工作。

10）前端路由懒加载、CDN 静态资源缓存优化、图片懒加载效果。

1）找到 SpringBoot 启动类，点击运行

2）打开 Knife4J 注册用户，或者可以直接找我拿数据库模拟数据（简易）。

3）前端输入表单内容后点击登录即可成功，开始愉快使用功能~

前端

软件：Vscode 或者 Webstorm（推荐）

环境：Node 版本 16 或者 18（推荐） 注：千万别选 18 以上的版本！

后端

软件：Eclipse 或者 IDEA（推荐）

环境：MySQL 5.7 或者 8.0（推荐）Redis（可选）

1）点击克隆/下载项目，会使用 Git 进行版本控制的，推荐 Git Clone，不会的小伙伴可以选择下载一个 Zip 压缩包，然后解压到自己电脑的 D 盘，推荐直接 Star，后续直接向我拿数据库模拟文件和 API 接口文档。

2）利用 Vscode 或者 Webstorm 打开前端页面，配置 Configuration。配置 Node 环境和包管理工具即可，我这边选择的包管理工具是 Npm，其他包管理工具如：Yarn、Cnpm、Pnpm 皆可。 注：注意更改 Npm 的镜像地址为淘宝的新镜像地址，否则会出现 Npm Install 一直卡进度条的情况。

3）直接点击 dev 的运行，或者打开控制台，输入 npm run serve 即可成功启动前端项目。

npm config set registry https://registry.npmmirror.com/

4）将图片链接进行自定义切换，可以切换为你自己的图床的图片链接，比如七牛云、GitHub 等，也可以寻找在线图片，复制百度文库图片链接（多试几次，有些图片有防盗链）。更换背景后，可以看到右下角的权限切换小图标。

1）点击克隆/下载项目，会使用 Git 进行版本控制的，推荐 Git Clone，不会的小伙伴可以选择下载一个 Zip 压缩包，然后解压到自己电脑的 D 盘，推荐直接 Star，后续直接向我拿数据库模拟文件和 API 接口文档。

2）领取数据库模拟文件后，利用 Navicat 或者 SQLYog 等软件导入数据库文件，记得先建立一个名为 bms_boot 的数据库，然后右键点击运行 SQL 文件即可，运行成功，无报错后，重新打开数据库，检查是否有数据，如果有数据，表明导入成功。

3）用 IDEA 打开后端项目，找到 application-dev.yml 文件，修改其中的 MySQL 配置，保证用户名和密码正确，注：密码不能以数字 0 开头。

4）导入 Maven 依赖，注意看自己的 Maven 版本是否正确，建议选择跟我一样的，3.8以上的版本，发现依赖导入很慢，是因为没有配置国内镜像，默认连接的是国外服务器，因此阿里云镜像配置可以看这篇博客。CSDN Maven 配置教程

5）找到 SpringBoot 启动类，我建议用 Debug 模式启动项目，更好排查错误。

6）如果遇到错误，大概率可能是 JDK 版本问题，我项目用的是 JDK 8，建议选择与我相同版本。

7）成功启动项目效果展示如下

1）如果需要修改端口和前缀（比如/api），需要同时修改前端和后端。

1）用户输入自己的图书偏爱信息。

2）前端发送 Axios 请求。

3）后端先判断文本是否违法（为空或者文本字数过长）。

4）查看接口是否存在。

5）查看 AI 接口调用次数是否充足。

6）GuavaRateLimiter 进行单体限流，判断请求次数是否超出正常业务频次。

7）给 AI 模型人工预设，并且查询数据库中的书籍列表进行拼接。

8）查询 AI 模型与该用户最近的五条历史记录，用于上下文关联。

9）FutureTask 同步调用获取 AI 结果，并设置超时时间（超时抛出异常）

10）获取 AI 模型推荐信息后进行持久化，并且减少接口调用次数（判断是否成功）

11）返回处理好的 AI 推荐信息给前端，并设置响应状态码为 200 即可。

1）用户输入分析目标、图标名称、选择图标类型、上传 Excel 文件，点击提交，发送 Axios 请求至后端。

2）校验文件是否为空、名称是否过长、文件大小检验、文件后缀校验

3）获取管理员 ID，从接口信息表查询管理员 ID 拥有的接口，接口判空。

4）判断 AI 接口调用次数是否足够

5）GuavaRateLimiter 进行单体限流，判断请求次数是否超出正常业务频次。

6）构造 AI 模型的提示词和角色

7）构造用户输入，拼接用户输入信息，并用工具类将 Excel 转为 CSV 字符串数据。

8）利用讯飞星火 AI 模型，传入调用者 ID 和输入参数，利用 FutureTask 同步获取，并设置超时时间（超时抛出异常）

9）对 AI 生成结果进行判断，格式错误就返回前端错误信息，并提示重新调用（后续考虑 RabbitMQ 进行重试和补偿机制）

10）将 AI 生成结果持久化到数据库，并更新接口调用次数（判断是否成功），动态给前端返回图标和数据结论。

1）简单地调用 AI 模型（讯飞星火 | 阿里百炼）获取自定义文本内容。

2）简单的 JWT 权限校验 ，利用后端拦截器进行登录校验。

3）上传 Excel 文件，Excel 文件转换为 CSV 数据，AIGC 在线生成可视化图表。

4）Jousp 批量爬取图书列表，可结合 SpringSchedule 定时任务执行。

5）简单的增删改查系统，前后端是如何联调协作的。

6）前端路由懒加载、CDN 静态资源缓存优化、图片懒加载是如何实现的

7）利用 Lodash 进行节流控制，尽量降低无效的恶意刷留言情况。

8）利用自定义线程池和 FutureTask 进行超时请求处理。

9）利用Google 的 GuavaRateLimiter 进行单体限流控制。

10）定时任务结合 Redis 做一个缓存预热，加快查询效率，提高用户体验。

• 主要使用Vue2和SpringBoot2实现

• 项目权限控制分别为：用户借阅，图书管理员，系统管理员

• 开发工具：IDEA2022.1.3(真不推荐用eclipse开发，IDEA项目可以导出为eclipse项目，二者不影响，但需要自己学教程)

• IDEA->Eclipse

• Eclipse->IDEA

• 学校老师硬性要求软件的话，还是按要求来。可以先问一下是否可以选择其他软件开发。

• 用户账号密码： 相思断红肠 123456

• 图书管理员账号密码: admin 123456

• 系统管理员账号密码: root 123456

• 前端样式参考 感谢原作者明月复苏

• 遇到交互功能错误，或者页面无法打开，请用开发者工具F12查看请求和响应状态码情况，当然可能小白不懂，那也没关系，可以加我QQ：909088445。白天上课，晚上有空才能回答，感谢体谅！⭐⭐⭐

• 本项目采用前后端分离的模式，前端构建页面，后端作数据接口，前端调用后端数据接口得到数据，重新渲染页面。
• 后端已开启 CORS 跨域支持
• API 认证使用 Token 认证
• 前端在 Authorization 字段提供 Token 令牌
• 使用 HTTP Status Code 表示状态
• 数据返回格式使用 JSON
• 后端采用权限拦截器进行权限校验，并检查登录情况
• 添加全局异常处理机制，捕获异常，增强系统健壮性
• 前端用 Echarts 可视化库实现了图书借阅的分析图标（折线图、饼图），并通过 Loading 配置提高加载体验。
• 留言组件采用弹幕形式，贴合用户的喜好。
• 引入 knife4j 依赖，使用 Swagger + Knife4j 自动生成 OpenAPI 规范的接口文档，前端可以在此基础上使用插件自动生成接口请求代码，降低前后端协作成本
• 使用 ElementUI 组件库进行前端界面搭建，快速实现页面生成，并实现了前后端统一权限管理，多环境切换等能力。
• 基于 MyBatis Plus 框架的 QueryWrapper 实现对 MySQL 数据库的灵活查询，并配合 MyBatisX 插件自动生成后端 CRUD 基础代码，减少重复工作。
• 前端路由懒加载、CDN 静态资源缓存优化、图片懒加载效果。

• 图书查询功能：分页构造器缓解数据过大压力，后端可设置请求数防止爬虫请求数过大，服务器负载过大。模糊查询进行字段搜索。表格均可导出PDF和EXCEL。
• 读者规则功能：查询现有的借阅规则，借阅规则包括：借阅编号，可借阅图书数量，可借阅天数，可借阅图书馆，过期扣费/天。
• 查看公告: 可以查询图书管理员发布的公告列表，文字滑动效果。
• 个人信息: 可以查看个人的借阅证编号，借阅证姓名，规则编号，状态，可以修改个人账户的密码。
• 借阅信息: 可以查看自身借阅过的图书记录和归还情况。
• 违章信息: 可以查询自身归还的图书是否有违章信息。
• 读者留言: 实现留言功能并以弹幕形式显示。

• 借阅图书: 图书管理员输入借阅证号(用户)和要借的图书编号和当前的时间，点击借阅。

• 归还图书: 输入图书编号查看图书是否逾期，并且可以设置违规信息，然后选择是否归还图书

• 借书报表: 用于查询已经借阅并归还的书籍列表，同样使用分页构造器和模糊查询字段，显示借阅证编号，图书编号，借阅日期，截止日期，归还日期，违章信息，处理人。

• 还书报表: 用于查询已经借阅但是还未归还的书籍列表，显示借阅证编号，图书编号，借阅日期，截止日期。

• 发布公告: 可以查询当前发布的公告列表，并进行删除，修改，增加功能，分页构造器用于缓解数据量大的情况。

• 书籍管理: 可以查询当前的所有图书，显示图书编号，图书昵称，作者，图书馆，分类，位置，状态，描述。可以进行添加，修改，删除图书。利用分页构造器实现批量查询。利用模糊查询实现图书搜索功能。利用插件实现PDF和EXCEL导出。
• 书籍类型: 显示查询当前的所有图书类型，可以进行添加，修改，删除图书类型，利用分页构造器实现批量查询，缓解数据压力。
• 借阅证管理: 可以查询当前的所有借阅证列表，也就是用户数量，可以进行添加，修改，删除操作。同样实现分页。
• 借阅信息查询: 可以查询当前已经完成借阅和归还的记录，显示借阅证号，书籍编号，借阅日期，截止日期，归还日期，违章信息，处理人。分页功能，PDF和EXCEL导出。
• 借阅规则管理: 可以查询当前所有的借阅规则，显示限制借阅天数，限制本数，限制图书馆，逾期费用，可以进行添加、删除、修改操作。
• 图书管理员管理: 显示当前的图书管理员列表，显示账号，姓名，邮箱，可以进行添加、删除、修改操作。
• 系统管理: 可以查询一个月内的借阅量，以一周为时间间隔，计算借阅量，用Echarts实现折线图的展示。

首页轮播图演示

图书查询演示

读者规则演示

查看公告演示

个人信息演示

借阅信息演示

违章信息演示

读者留言演示

智能推荐演示

借阅图书演示

归还图书演示

借书报表演示

还书报表演示

发布公告演示

• 由于篇幅受限，系统功能展示主要功能。

系统管理演示

智能分析演示

• 可以下载ZIP压缩包或者使用克隆(Git clone)
• 复制http或者ssh的链接（github建议ssh,gittee都可以)
• 在D盘新建一个文件夹，点击进入该文件夹，右键Git Bash Here

• 还没有下载Git或者不会Git的建议先看基础教程（30分钟左右)

• 输入git init 初始化git项目 然后出现一个.git文件夹

• 输入git remote add origin xxxxxx(xxx为刚刚复制的http或者ssh链接)

• 输入git pull origin master 从远程代码托管仓库拉取代码

• 成功拉取项目（前端后端都是如此)

• 前端项目注意依赖下载使用npm install 或者 yarn install （Vscode或者Webstorm)

• 后端项目注意maven依赖下载（IDEA(推荐)或者Ecplise)

• 前端npm 镜像源建议淘宝镜像源，后端maven镜像源推荐阿里云镜像源（非必选，但更换后下载快速)

⭐

• 乱码问题 项目采用的UFT-8
• 一般出现乱码就是UTF-8和GBK二者相反
• 请百度IDEA乱码和Eclipse乱码问题(描述清楚即可)

⭐

• 点击交互按钮，没有发生反应。
• 很明显，请求失败，浏览器打开开发者工具，Edge浏览器直接ctrl+shift+i,其他浏览器按F12
• 查看红色的请求和响应状态码问题

⭐

• 先阅读文档再进行问题的查询或者提问
• 提问有技巧，模糊的发言，让高级架构师找BUG也无从下手

• 接口文档篇幅过大
• 本来想完全采用RESTFUL风格，做到一半忘记了
• 看清楚文档的基准地址
• 要API后端接口文档详细内容和数据库结构+内容一起的，将前后端star⭐的截图加我QQ：909088445发我即可领取~感谢支持