LibMan

1. Introduction
2. Features
3. Challenges

Introduction

LibMan is a library management system that helps librarians manage books, members, and borrowing/returning books. The system is built using Java SpringBoot for the backend and React for frontend.

Team Members

Order	Name	Student ID
1	Tran Nguyen Phuc	ITCSIU21097
2	Nguyen Mach Khang Huy	ITCSIU21072
3	Bui Cong Vinh	ITCSIU22165
4	Nguyen Bach Dong Phuong	ITCSIU22118
5	Nguyen Thi Quynh Nga	ITCSIU22094
6	Le Minh Duy	ITCSIU22037
7	Nguyen Minh Viet	ITDSIU21130
8	Tran Quoc Bao	ITITWE20033

How to Run

Option 1: Docker (Recommended)

Only requires Docker installed.

1. Clone the repo

   git clone https://github.com/tnphucccc/LibMan.git
   cd LibMan

2. Start the full stack

   docker compose up --build

3. Open your browser and go to http://localhost:5173/
   • API: http://localhost:8080/api/v1
   • Swagger: http://localhost:8080/swagger-ui.html
   • Credentials: librarian / CHANGE_ME

To stop and reset data:

docker compose down -v

Option 2: Manual Setup

Requires Java 17+, Maven, Node.js 20+, and PostgreSQL 16+.

1. Clone the repo

   git clone https://github.com/tnphucccc/LibMan.git

2. Set up the database

   createdb libman
   psql -d libman -f backend/src/main/resources/schema.sql
   psql -d libman -f backend/src/main/resources/query.sql  # optional seed data

3. Configure the backend

   cp backend/src/main/resources/application.properties.example backend/src/main/resources/application.properties
   # Edit application.properties with your database credentials

4. Run the backend

   cd backend
   ./mvnw spring-boot:run

5. Configure and run the frontend

   cd frontend
   cp .env.example .env
   npm install
   npm run start

6. Open your browser and go to http://localhost:5173/

Features

• ✅ Add, update, delete books
• ✅ Add, update, delete authors
• ✅ Add, update, delete members
• ✅ Borrow, return books
• ✅ View borrowing history
• ✅ Search books

Challenges