# 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 ![Java](https://img.shields.io/badge/Java-17-orange?style=flat-square&logo=openjdk) ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.2-green?style=flat-square&logo=springboot) ![Vue](https://img.shields.io/badge/Vue-3.4-brightgreen?style=flat-square&logo=vue.js) ![Naive UI](https://img.shields.io/badge/Naive%20UI-2.38-blue?style=flat-square) ![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square) **基于 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 支持一下!**