# Smart Library
**Repository Path**: yangleduo7788/smart-library
## Basic Information
- **Project Name**: Smart Library
- **Description**: Smart Library 是一个现代化的图书管理系统,采用前后端分离架构,提供完整的图书管理、借阅管理、预约管理等功能。系统集成 AI 智能助手,支持多 AI 服务商,可进行智能对话和图书推荐。项目结构清晰、代码规范,适合学习和二次开发。
- **Primary Language**: Unknown
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-05-16
- **Last Updated**: 2026-07-29
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Smart Library





**基于 Spring Boot 3 + Vue 3 的智能图书管理系统,集成 AI 助手**
---
## 项目简介
Smart Library 是一个现代化的图书管理系统,采用前后端分离架构,提供完整的图书管理、借阅管理、预约管理等功能。系统集成 AI 智能助手,支持多 AI 服务商,可进行智能对话和图书推荐。项目结构清晰、代码规范,适合学习和二次开发。
## 功能特性
### 核心功能
- **图书管理** - 图书增删改查、分类管理、库存管理、全文检索
- **借阅管理** - 借阅、归还、续借、逾期罚款计算
- **预约管理** - 图书预约、自动过期处理、预约通知
- **用户管理** - 三级权限体系(管理员 / 馆员 / 读者)
- **通知管理** - 系统通知、借阅提醒、逾期提醒、预约通知
- **数据仪表盘** - ECharts 图表展示借阅趋势、分类统计、热门图书排行
### AI 智能助手
- **实时对话** - 基于 WebSocket 的流式 AI 对话
- **图书推荐** - 根据用户借阅历史智能推荐图书
- **多服务商支持** - OpenAI、Claude、文心一言、通义千问、智谱 AI、自定义接口
- **可视化配置** - 在线配置 API Key、模型参数、系统提示词
### 权限控制
- **RBAC 权限模型** - 基于角色的细粒度权限控制
- **Sa-Token 认证** - JWT 风格的无状态认证,Redis 存储会话
- **菜单权限** - 动态菜单 + 按钮级权限标识
- **三级角色** - 管理员(全部权限)、馆员(图书/借阅管理)、读者(查看/借阅)
## 技术栈
### 后端
| 技术 | 版本 | 说明 |
|------|------|------|
| Spring Boot | 3.2.4 | 基础框架 |
| MyBatis-Plus | 3.5.5 | ORM 框架 |
| Sa-Token | 1.37.0 | 权限认证 |
| Redis | 7.0+ | 缓存 / 会话存储 |
| MySQL | 8.0+ | 数据库 |
| WebSocket | - | 实时通信 |
| Knife4j | 4.4.0 | API 文档 |
| Hutool | 5.8.25 | Java 工具库 |
| Lombok | - | 代码简化 |
### 前端
| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.4 | 前端框架 |
| Vite | 5.1 | 构建工具 |
| Naive UI | 2.38 | UI 组件库 |
| Pinia | 2.1 | 状态管理 |
| Vue Router | 4.3 | 路由管理 |
| Axios | 1.6 | HTTP 客户端 |
| ECharts | 5.5 | 图表库 |
| Sass | 1.71 | CSS 预处理器 |
## 项目结构
```
book-management-system/
├── backend # Spring Boot 后端
│ ├── src/main/java/com/book/
│ │ ├── common # 通用模块(统一响应、异常处理)
│ │ ├── config # 配置类(CORS、Redis、Sa-Token、WebSocket)
│ │ ├── controller # 控制器层
│ │ ├── dto # 数据传输对象
│ │ ├── entity # 实体类
│ │ ├── enums # 枚举定义
│ │ ├── mapper # MyBatis Mapper 接口
│ │ ├── service # 业务逻辑层
│ │ │ └── impl # 服务实现类
│ │ ├── vo # 视图对象
│ │ └── websocket # WebSocket 处理器
│ ├── src/main/resources
│ │ └── application.yml # 应用配置
│ └── pom.xml # Maven 依赖
│
├── frontend # Vue 3 前端
│ ├── src/
│ │ ├── api # API 请求封装
│ │ ├── assets # 静态资源
│ │ ├── components # 公共组件
│ │ ├── layouts # 布局组件
│ │ ├── router # 路由配置
│ │ ├── stores # Pinia 状态管理
│ │ ├── utils # 工具函数
│ │ └── views # 页面视图
│ │ ├── login # 登录页
│ │ ├── dashboard # 数据仪表盘
│ │ ├── book # 图书管理
│ │ ├── category # 分类管理
│ │ ├── borrow # 借阅管理
│ │ ├── reservation # 预约管理
│ │ ├── user # 用户管理
│ │ ├── notification # 通知管理
│ │ ├── profile # 个人中心
│ │ └── ai # AI 助手(聊天 + 配置)
│ └── package.json
│
└── database # 数据库脚本
├── book_management.sql # 主数据库脚本(含初始数据)
├── migration_permission.sql # 权限迁移脚本
└── migration_user_permission.sql
```
## 快速开始
### 环境要求
- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 7.0+
### 数据库初始化
```sql
-- 创建数据库并导入初始数据
mysql -u root -p < database/book_management.sql
```
### 后端启动
```bash
cd backend
# 修改 application.yml 中的数据库和 Redis 配置
# 启动项目
mvn spring-boot:run
```
后端启动后访问 API 文档:http://localhost:8080/api/doc.html
### 前端启动
```bash
cd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev
```
前端访问:http://localhost:5173
### 默认账号
| 账号 | 密码 | 角色 | 说明 |
|------|------|------|------|
| admin | admin123 | 管理员 | 拥有全部权限 |
| librarian | 123456 | 馆员 | 图书和借阅管理 |
| reader1 | 123456 | 读者 | 查看和借阅图书 |
## 数据库设计
系统共包含 14 张数据表:
| 表名 | 说明 |
|------|------|
| sys_user | 用户表 |
| sys_role | 角色表 |
| sys_user_role | 用户角色关联表 |
| sys_menu | 菜单权限表 |
| sys_role_menu | 角色菜单关联表 |
| book_category | 图书分类表 |
| book_info | 图书信息表 |
| borrow_record | 借阅记录表 |
| reservation_record | 预约记录表 |
| sys_config | 系统配置表 |
| sys_notification | 通知消息表 |
| ai_config | AI 配置表 |
| ai_chat_history | AI 对话历史表 |
| sys_operation_log | 操作日志表 |
## 接口文档
启动后端后访问 Knife4j 自动生成的 API 文档:
```
http://localhost:8080/api/doc.html
```
### 主要接口
| 模块 | 接口 | 说明 |
|------|------|------|
| 认证 | `POST /api/auth/login` | 用户登录 |
| 认证 | `POST /api/auth/logout` | 用户登出 |
| 认证 | `GET /api/auth/info` | 获取当前用户信息 |
| 图书 | `GET /api/book/page` | 分页查询图书 |
| 图书 | `POST /api/book` | 新增图书 |
| 图书 | `PUT /api/book` | 更新图书 |
| 图书 | `DELETE /api/book/{id}` | 删除图书 |
| 借阅 | `GET /api/borrow/page` | 分页查询借阅记录 |
| 借阅 | `POST /api/borrow` | 借阅图书 |
| 借阅 | `PUT /api/borrow/{id}/return` | 归还图书 |
| 借阅 | `PUT /api/borrow/{id}/renew` | 续借图书 |
| 预约 | `GET /api/reservation/page` | 分页查询预约 |
| 预约 | `POST /api/reservation` | 预约图书 |
| 预约 | `PUT /api/reservation/{id}/cancel` | 取消预约 |
| AI | `GET /api/ai/config` | 获取 AI 配置 |
| AI | `POST /api/ai/config` | 保存 AI 配置 |
| AI | `POST /api/ai/config/{id}/test` | 测试 AI 连接 |
| AI | `WS /api/ws/ai/chat` | AI 实时对话 |
## 借阅规则
| 规则 | 默认值 | 说明 |
|------|--------|------|
| 最大借阅数量 | 5 本 | 可在系统配置中修改 |
| 借阅天数 | 30 天 | 可在系统配置中修改 |
| 最大续借次数 | 2 次 | 每次续借延长一个借阅周期 |
| 逾期罚款 | 0.5 元/天 | 按日计算 |
| 预约保留时间 | 48 小时 | 超时自动取消 |
## 系统截图
> 欢迎补充项目截图到 `doc/` 目录
## 开发指南
### 添加新功能模块
1. 在 `entity` 包下创建实体类
2. 在 `mapper` 包下创建 Mapper 接口
3. 在 `dto` / `vo` 包下创建传输对象
4. 在 `service` 包下创建 Service 接口和实现
5. 在 `controller` 包下创建 Controller
6. 前端在 `api/` 下添加请求封装,在 `views/` 下创建页面
### 添加新的 AI 服务商
1. 在 `AiServiceImpl.java` 中扩展 `callAiApi` 方法
2. 在前端 `views/ai/config.vue` 中添加服务商选项
### 自定义权限
1. 在 `sys_menu` 表中添加菜单和权限标识
2. 在 `sys_role_menu` 表中配置角色权限
3. 前端路由 `meta` 中添加 `permission` 标识
## 配置说明
### 后端配置 (`application.yml`)
```yaml
server:
port: 8080
servlet:
context-path: /api
spring:
datasource:
url: jdbc:mysql://localhost:3306/book_management
username: root
password: root
data:
redis:
host: localhost
port: 6379
sa-token:
timeout: 86400 # Token 过期时间(秒)
active-timeout: 1800 # 无操作过期时间(秒)
```
### AI 配置
在系统管理 -> AI 配置页面中可视化配置:
- 选择 AI 服务商(OpenAI / Claude / 文心一言 / 通义千问 / 智谱 AI / 自定义)
- 填入 API Key 和 API 地址
- 设置模型名称、温度、最大 Token 等参数
- 配置系统提示词
## 贡献指南
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -m 'feat: add some feature'`)
4. 推送到分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request
## 开源协议
本项目基于 [MIT License](LICENSE) 开源。
---
**如果这个项目对你有帮助,请给一个 Star 支持一下!**