This page is generated from the following source files:
This project is a full-stack Book Management System built with a separated frontend and backend architecture. The backend is implemented using Java with Spring Boot, MyBatis, and MySQL, while the frontend utilizes Vue.js, Axios, and Element UI. The system is designed to be simple to deploy and suitable for beginners learning full-stack development readme.md:5-13.
The following environment and tools are required to run this project:
| Component | Version | Description |
|---|---|---|
| Java | JDK 1.8.0 | Required for Spring Boot backend |
| IDE | IntelliJ IDEA 2021.2.1+ | Recommended development environment |
| Build Tool | Maven 3.3.9 | Project build and dependency management |
| Web Server | SpringBoot embedded Tomcat | No external server required |
| Database | MySQL 5.7 | Data persistence layer |
These specifications are documented in the project's environment introduction section readme.md:17-26.
Prerequisites Checklist:
JAVA_HOME environment variable configuredClone the backend repository from GitHub:
bash1git clone https://github.com/huanfenz/BookManager2.git 2cd BookManager2
The corresponding frontend program is available at: https://github.com/huanfenz/BookManagerVue readme.md:15.
Create a new MySQL database and import the schema:
sql1CREATE DATABASE book_manager;
Import the SQL file located at the project root:
bash1mysql -u root -p book_manager < book_manager.sql
According to the setup instructions, create a database named book_manager and import the book_manager.sql file readme.md:29-31.
The SQL file contains the complete database schema including core tables such as book_info, book_type, borrow, and user-related tables. The book_info table structure includes fields for book ID, name, author, price, type, description, borrow status, and image URL book_manager.sql:17-36.
Open the configuration file at src/main/resources/application.properties and modify the database and Redis settings according to the local environment readme.md:32-34.
The SQL file header indicates the source database was configured with:
localhost:3306book_managerNote: The exact configuration keys and values in application.properties require confirmation by examining the actual file content, as the source file provided appears to be empty or truncated.
The recommended minimal path to run the project:
bash1# 1. Ensure MySQL is running with book_manager database imported 2# 2. Configure database connection in application.properties 3# 3. Build and run using Maven 4mvn spring-boot:run
Alternatively, if using an IDE like IntelliJ IDEA:
BookManagerApplicationThe project setup is described as straightforward with a simple deployment process readme.md:13.
After completing the configuration, run the project. The specific startup command or IDE run configuration depends on the development environment readme.md:35.
A demo deployment was previously available at:
Note: The demo has been disabled to conserve server resources readme.md:50. For local deployment verification, access the application through the configured local server address (typically http://localhost:8080 or the port configured in application.properties).
The following test accounts are available for verification:
| Role | Username | Password |
|---|---|---|
| Administrator | admin | admin |
| Reader | wangpeng | 123456 |
These credentials are documented in the project readme for testing purposes readme.md:54-56.
The project includes screenshots demonstrating the user interface, which can be used to verify successful deployment. The screenshots show the book management interface with features like book listing, search, and management functions readme.md:37-46.
Symptoms: Application fails to start with database connection errors.
Possible Causes:
application.propertiesbook_manager not created or SQL file not importedSolutions:
mysqladmin -u root -p statusSHOW DATABASES LIKE 'book_manager';Symptoms: Application fails to start with "port already in use" error.
Possible Causes:
Solutions:
jps or ps aux | grep javaapplication.properties:
properties1server.port=8092
Note: The exact configuration key requires confirmation from the actual application.properties file content.
Symptoms: Application fails to start or runtime errors related to Redis.
Possible Causes:
application.propertiesSolutions:
The readme mentions modifying Redis configuration as part of the setup process readme.md:33, indicating Redis is a required dependency.
Symptoms: Build fails with dependency download errors.
Possible Causes:
Solutions:
rm -rf ~/.m2/repository./mvnw spring-boot:runpom.xml is present and validAfter successfully running the project, consider exploring:
Frontend Integration: Clone and set up the frontend project from https://github.com/huanfenz/BookManagerVue to enable the complete user interface readme.md:15.
API Documentation: Examine the controller classes to understand the available REST API endpoints for book management, user authentication, and borrowing operations.
Database Schema: Review the complete database structure in book_manager.sql to understand the data model, including tables for books, book types, users, and borrow records book_manager.sql:17-157.
Feature Customization: The project is described as suitable for beginners with clear code structure, making it ideal for learning and extending with new features readme.md:13.
Deployment: For production deployment, consider configuring proper database connection pooling, security settings, and externalizing configuration for different environments.