# ai-library-management-system-monkeycode

**Repository Path**: superjamison/ai-library-management-system-monkeycode

## Basic Information

- **Project Name**: ai-library-management-system-monkeycode
- **Description**: 图书管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 图书管理系统

基于 Spring Boot + Vue3 + Element Plus 开发的智能化图书管理系统。

## 项目简介

本系统提供完整的图书管理、借阅管理、用户管理功能，支持图书荐购、预约、续借等核心业务场景，适用于各类图书馆或阅读空间的信息化管理需求。

## 技术栈

### 后端技术
- **Spring Boot 2.7.x** - 核心框架
- **MyBatis Plus** - ORM 持久层框架
- **Sa-Token** - 轻量级权限认证框架
- **MySQL** - 关系型数据库

### 前端技术
- **Vue 3** - 渐进式前端框架
- **Element Plus** - Vue3 组件库
- **Vite** - 构建工具
- **Pinia** - 状态管理
- **Vue Router** - 路由管理

## 功能模块

### 认证管理
- 用户登录/注册/登出
- Token 令牌管理
- 权限验证与角色控制

### 图书管理
- 图书新增、编辑、删除
- 图书分类管理
- 图书上下架控制
- 热门图书推荐
- 图书荐购申请

### 借阅管理
- 图书借阅与归还
- 续借操作
- 逾期罚款计算
- 图书预约与取消
- 借阅记录查询

### 系统管理
- 用户管理（CRUD、状态控制、角色分配）
- 角色与权限管理
- 操作日志记录
- 系统参数配置
- 数据看板（统计图表）

## 项目结构

```
ai-library-management-system/
├── server/                 # 后端服务
│   ├── src/main/java/com/library/
│   │   ├── common/         # 公共组件（异常、结果封装）
│   │   ├── config/         # 配置类（CORS、拦截器、AOP日志）
│   │   ├── module/         # 业务模块
│   │   │   ├── auth/       # 认证模块
│   │   │   ├── book/       # 图书模块
│   │   │   ├── borrow/     # 借阅模块
│   │   │   └── system/     # 系统模块
│   │   └── security/       # 安全认证实现
│   └── src/main/resources/
│       ├── application.yml
│       └── logback-spring.xml
├── web/                    # 前端应用
│   ├── src/
│   │   ├── api/            # API 接口
│   │   ├── views/          # 页面组件
│   │   ├── store/          # 状态管理
│   │   ├── router/         # 路由配置
│   │   └── styles/         # 全局样式
│   └── package.json
└── sql/
    └── init.sql            # 数据库初始化脚本
```

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- MySQL 5.7+
- Node.js 14+
- npm 或 yarn

### 后端部署

1. 创建数据库并导入初始化脚本：
```bash
mysql -u root -p < sql/init.sql
```

2. 修改数据库配置 `server/src/main/resources/application.yml`

3. 编译运行：
```bash
cd server
mvn clean install
java -jar target/library-*.jar
```

服务默认运行在 `http://localhost:8080`

### 前端部署

1. 安装依赖：
```bash
cd web
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

3. 构建生产版本：
```bash
npm run build
```

## 默认账号

系统初始化后，可使用以下默认账号登录：

- **管理员**：admin / admin123
- **普通用户**：user / user123

## API 文档

系统提供 RESTful API 接口，主要端点如下：

| 模块 | 路径 | 说明 |
|------|------|------|
| 认证 | `/auth/login` | 用户登录 |
| 认证 | `/auth/register` | 用户注册 |
| 图书 | `/book/page` | 图书分页查询 |
| 图书 | `/book/recommend` | 图书荐购 |
| 借阅 | `/borrow/{bookId}` | 借书 |
| 借阅 | `/borrow/return/{recordId}` | 还书 |
| 借阅 | `/borrow/reserve/{bookId}` | 预约 |
| 系统 | `/system/user/page` | 用户管理 |
| 看板 | `/dashboard` | 统计数据 |

## 功能权限

系统采用 RBAC 权限模型，主要权限标识：

| 权限标识 | 说明 |
|---------|------|
| `book:view` | 查看图书 |
| `book:add` | 新增图书 |
| `book:edit` | 编辑图书 |
| `book:delete` | 删除图书 |
| `borrow:create` | 借书 |
| `borrow:return` | 还书 |
| `borrow:renew` | 续借 |
| `recommend:create` | 荐购申请 |
| `recommend:audit` | 荐购审核 |
| `dashboard:view` | 查看看板 |
| `user:manage` | 用户管理 |
| `role:manage` | 角色管理 |
| `log:view` | 日志查看 |
| `config:manage` | 参数管理 |

## 许可证

本项目仅供学习交流使用。