# WBMS-Server

**Repository Path**: wisterialee/wbms-server

## Basic Information

- **Project Name**: WBMS-Server
- **Description**: 基于 RuoYi-Vue 开发的图书借阅管理后端系统，SpringBoot 多模块架构，完整实现图书、借阅、轮播图业务，自带权限、日志、代码生成等后台通用能力，适合 Java 后端学习参考。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, SpringBoot, MyBatis, MySQL, Spring-MVC

## README

<div align="center">
  <img src="assets/logo.png" alt="WBMS Logo" width="160" />
</div>

<h1 align="center">WBMS-Server</h1>

<p align="center">
  WBMS (Wisteria Book Manage System) · Backend (Spring Boot)
</p>

<p align="center">
  <a href="./README.md">中文</a> · <a href="./README_EN.md">English</a>
</p>

## About

- This repository is a student JavaWeb course project. After graduation, I tidied it up and published it. It runs, but
  there may be quite a few bugs, and some design choices may not be fully “production-grade”. Please be kind.
- The project is based on the RuoYi (RuoYi-Vue, v3.8.9) front-back separation framework, with customizations for book
  management modules.
- This folder contains the backend project (multi-module Maven project).

<table>
  <tr>
    <td>Name</td>
    <td>Gitee</td>
    <td>Github</td>
  </tr>
  <tr>  
    <td>WBMS-Server</td>
    <td>https://gitee.com/wisterialee/wbms-server</td>
    <td>https://github.com/Wisteria0712/WBMS-Server</td>
  </tr>
  <tr>
    <td>WBMS-Front</td>
    <td>https://gitee.com/wisterialee/wbms-front</td>
    <td>https://github.com/Wisteria0712/WBMS-Front</td>
  </tr>
</table>

## Features

### WBMS Business Modules (Book Management)

- Login / Register / Captcha: authentication and captcha validation.
- Home support: provides data APIs for homepage carousel, etc.
- Book Category:
    - Admin: create/edit/delete, batch delete, export to Excel.
    - Normal user: query/search, view category details (including books under the category).
- Book:
    - Admin: create/edit/delete, batch delete, export to Excel.
    - Normal user: query/search, view details, borrow books (borrow status changes with inventory).
- Borrow Records:
    - Admin: view all records, export.
    - Normal user: view only own records and perform actions such as returning.
- Carousel Management: admin maintains homepage carousel (create/edit/delete).

### Built-in RuoYi Modules

- Permission system: users/roles/menus/button permissions, data scope, etc.
- System management: departments, posts, dictionaries, configs, notices, etc.
- Monitoring: online users, login logs, operation logs, server info, cache monitor, Druid monitor, etc.
- Tools: code generator, scheduled tasks (Quartz), Swagger docs, etc.

## Project Modules (Maven)

- `wbms-admin`: web entry + controllers (main class: `com.wisteria.WbmsApplication`)
- `wbms-book`: book domain (book/category/borrow records)
- `wbms-banner`: carousel domain
- `wbms-system`: system domain (user/role/menu/dict/config, etc.)
- `wbms-framework` / `wbms-common`: framework configs and common utilities
- `wbms-quartz`: scheduled tasks
- `wbms-generator`: code generator

## Tech Stack

- Java 8, Maven
- Spring Boot 2.5.15
- Spring Security, JWT (Token)
- MyBatis + PageHelper, MySQL
- Druid (with monitor page)
- Redis
- Quartz
- Springfox Swagger (OpenAPI 3.0)

## Run Locally

- Database
    - Create database `wbms`, import init script: [wbms.sql](file:///d:/Project/WBMS/work/WBMS-Server/sql/wbms.sql)
    - Update datasource config: `wbms-admin/src/main/resources/application-druid.yml` (use your own DB
      host/user/password)
- Storage path (uploads)
    - `ruoyi.profile` in `application.yml` points to a local directory by default; change it to your own path.
- Redis
    - Default `localhost:6379`, start Redis before starting backend.

- Start (choose one)

```bash
# Option 1: Run in IDE (recommended)
# Main class: wbms-admin/src/main/java/com/wisteria/RuoYiApplication.java

# Option 2: Build via Maven (run from WBMS-Server)
mvn clean package -DskipTests
```

- Default endpoints
    - Backend: `http://127.0.0.1:8080`
    - Swagger UI (if swagger.enabled=true): `http://127.0.0.1:8080/swagger-ui/index.html`

## Notes

- Default account: admin / admin123

## Screenshots

<div align="center">
  <table style="margin: 0 auto; width: 96%; max-width: 1100px;">
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片1.jpg" alt="Image 1" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片2.jpg" alt="Image 2" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片3.jpg" alt="Image 3" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片4.jpg" alt="Image 4" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片5.jpg" alt="Image 5" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片6.jpg" alt="Image 6" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片7.jpg" alt="Image 7" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片8.jpg" alt="Image 8" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片9.jpg" alt="Image 9" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片10.jpg" alt="Image 10" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片11.jpg" alt="Image 11" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片12.jpg" alt="Image 12" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
    <tr>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片13.jpg" alt="Image 13" style="width: 100%; border-radius: 6px;" />
      </td>
      <td style="width: 50%; padding: 6px;">
        <img src="assets/图片14.jpg" alt="Image 14" style="width: 100%; border-radius: 6px;" />
      </td>
    </tr>
  </table>
</div>

## Disclaimer

- This project is for learning and communication. The primary goal is “make it run”, not best practices in
  engineering/security.
- Issues and PRs are welcome.