# 图书管理系统

**Repository Path**: jaycehsz/library-management-system

## Basic Information

- **Project Name**: 图书管理系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-26
- **Last Updated**: 2024-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图书管理系统

### 介绍

本项目是一个基于前后端分离的图书管理系统，提供对图书信息的增删查改等基本功能。项目采用 Spring Boot 作为后端框架，前端部分使用 Vue 2 框架，并使用 MySQL 作为数据库来存储数据。

### 软件架构

- **前端**：Vue 2
- **后端**：Spring Boot，Spring Data JPA
- **数据库**：MySQL
- **API 测试工具**：Apifox、Postman
- **构建工具**：Maven

#### 项目结构

```bash
├── front_end/              # 前端项目文件夹，包含了基于 Vue 2 实现的前端代码
├── src/main/               # 后端项目文件夹，包含了基于 Spring Boot 的后端代码
├── .gitignore              # Git 忽略文件，指定需要忽略的文件和文件夹
├── book.openapi.json       # API 文档文件，用于 Apifox 或 Postman 测试 API 接口
├── book_management.sql     # 数据库文件，包含数据库表结构和初始数据
├── pom.xml                 # Maven 构建文件，定义项目的依赖和构建配置

```

#### 详细说明

- **front_end**: 存放前端项目的代码，使用 Vue 2 框架进行开发，包括了页面组件、路由、状态管理等相关内容。
- **src/main**: 存放后端项目的代码，使用 Spring Boot 进行开发，包括了控制器、服务层、实体类、以及与数据库交互的相关逻辑。
- **book.openapi.json**: 提供了项目的 API 接口文档，方便使用 Apifox 或 Postman 进行接口测试。
- **book_management.sql**: 包含了数据库表结构和初始数据，需将其导入到 MySQL 数据库中以初始化项目的数据环境。
- **pom.xml**: 项目的 Maven 配置文件，定义了项目所需的依赖项和构建指令，确保项目可以正确构建和运行。

### 安装教程

1. **安装并配置数据库**
    - 确保已安装 MySQL 数据库，将 `book_management.sql` 文件导入到数据库中，创建必要的表结构和初始数据。
    
    ```
    mysql -u 用户名 -p 数据库名 < book_management.sql
    
    ```
    
2. **配置后端**
    - 确保已安装 JDK 8 或更高版本，并配置好环境变量。
    - 克隆项目到本地，并使用 Maven 构建项目：
        
        ```
        mvn clean install
        
        ```
        
    - 运行 Spring Boot 应用：
        
        ```
        mvn spring-boot:run
        
        ```
        
    - 后端服务将启动在 `http://localhost:8080`。（最好根据个人环境中端口）
3. **配置前端**
    - 进入 `front_end` 目录，确保已安装 Node.js 和 npm。
    - 安装前端依赖：
        
        ```
        npm install
        
        ```
        
    - 启动前端项目：
        
        ```
        npm run serve
        
        ```
        
    - 前端项目将运行在 `http://localhost:8080`（或指定的端口）。

### 使用说明

1. 访问前端页面进行图书信息的增删查改操作。
2. 后端 API 可通过 `/api/books` 进行交互，详细的 API 文档可在 `book.openapi.json` 文件中查看。
3. 使用 Apifox 或 Postman 测试 API 接口，确保各个接口功能正常。

### 参与贡献

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

### 特技

1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md。
2. 参考 Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com/) 获取更多开发技巧。
3. 在 https://gitee.com/explore 了解更多 Gitee 上的优秀开源项目。
4. [GVP](https://gitee.com/gvp) 是 Gitee 最有价值开源项目的全称，是经过综合评定的优秀开源项目。