# jyu-library-back

**Repository Path**: litinyu/jyu-library-back

## Basic Information

- **Project Name**: jyu-library-back
- **Description**: jyu图书管理系统-后端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 嘉应学院图书借阅系统后端

## 项目介绍
嘉应学院图书借阅系统（JYU Library System）是为嘉应学院图书馆设计的一套现代化图书管理系统，提供图书借阅、归还、预约、查询等核心功能，旨在提升图书馆管理效率和用户体验。

本项目为系统的后端部分，基于Spring Boot框架开发，提供完整的RESTful API接口。

## 技术栈

- **后端框架**: Spring Boot 4.0.1
- **开发语言**: Java 22
- **数据访问**: Spring Data JPA
- **数据库**: MySQL
- **缓存**: Redis
- **规则引擎**: Drools 8.44.0.Final
- **接口文档**: Swagger/OpenAPI 3
- **代码简化**: Lombok
- **构建工具**: Maven
- **邮件服务**: Spring Boot Mail
- **参数校验**: Spring Validation

## 软件架构

项目采用经典的分层架构设计：

1. **Controller层**: 处理HTTP请求，调用Service层进行业务逻辑处理
2. **Service层**: 实现核心业务逻辑，调用Repository层进行数据访问
3. **Repository层**: 数据访问层，使用Spring Data JPA操作数据库
4. **Entity层**: 实体类，映射数据库表结构
5. **Enums层**: 枚举类，定义系统状态和常量
6. **Config层**: 配置类，管理系统配置

## 功能模块

### 1. 图书管理 (Book)
- 图书信息的增删改查
- 图书状态管理（可借、已借、预约等）
- 图书分类和检索

### 2. 读者管理 (Reader)
- 读者信息管理
- 读者权限和状态管理
- 借阅限制和积分管理

### 3. 借阅管理 (Borrow)
- 图书借阅操作
- 图书归还操作
- 逾期计算和罚款管理
- 借阅记录查询

### 4. 预约管理 (Reservation)
- 图书预约功能
- 预约状态管理
- 预约通知

### 5. 规则引擎
- 使用Drools实现借阅规则管理
- 灵活配置借阅期限、罚款规则等

## 安装教程

### 1. 环境要求
- Java 22或以上版本
- Maven 3.8或以上版本
- MySQL 8.0或以上版本
- Redis 6.0或以上版本

### 2. 安装步骤

1. **克隆项目**
   ```bash
   git clone <项目地址>
   cd jyu-library-back
   ```

2. **配置数据库**
   - 创建MySQL数据库：`jyulibrary`
   - 导入数据库脚本：`data/jyulibrary.sql`
   - 修改`src/main/resources/application.properties`中的数据库配置

3. **配置Redis**
   - 确保Redis服务运行
   - 修改`src/main/resources/application.properties`中的Redis配置

4. **构建项目**
   ```bash
   mvn clean install
   ```

5. **运行项目**
   ```bash
   mvn spring-boot:run
   ```

## 使用说明

### 接口文档
项目集成了Swagger/OpenAPI 3，启动项目后可通过以下地址访问接口文档：
```
http://localhost:8082/swagger-ui/index.html
```
Apifox
http://localhost:8082/v3/api-docs
### 主要接口

- **图书管理接口**: `/api/books`
- **读者管理接口**: `/api/readers`
- **借阅管理接口**: `/api/borrows`
- **预约管理接口**: `/api/reservations`

### 核心业务流程

1. **图书借阅流程**:
   - 读者选择图书
   - 系统检查读者权限和图书状态
   - 创建借阅记录，更新图书状态
   - 返回借阅成功信息

2. **图书归还流程**:
   - 读者归还图书
   - 系统检查是否逾期
   - 计算罚款（如有）
   - 更新借阅记录和图书状态
   - 返回归还成功信息

## 项目结构

```
├── src/main/java/com/example/jyulibraryback/
│   ├── config/          # 系统配置类
│   ├── controller/      # 控制器层
│   ├── entity/          # 实体类
│   ├── enums/           # 枚举类
│   ├── repository/      # 数据访问层
│   ├── service/         # 业务逻辑层
│   └── JyuLibraryBackApplication.java  # 项目启动类
├── src/main/resources/
│   ├── rules/           # Drools规则文件
│   └── application.properties  # 系统配置文件
├── data/
│   └── jyulibrary.sql   # 数据库脚本
├── pom.xml              # Maven依赖配置
└── README.md            # 项目说明文档
```

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 联系方式

如有问题或建议，请联系项目维护人员。

## 许可证

MIT License