Bidding System Application - University Project

A RESTful bidding API built with Spring Boot that provides automated auction management with real-time bid validation and secure JWT authentication.

📋 Table of Contents

• Features
• Technology Stack
• Prerequisites
• Installation
• Application Usage

✨ Features

Core Functionality

• JWT-based user authentication
• Auction management
• Real-time bidding system
• Inventory & items tracking

Business Logic

• Bid validation via minimum increments
• Highest bidder tracker
• Auction expiration & status management
• Reserve price verification for ownership transfer

---

🛠 Technology Stack

Layer	Technology
Framework	Spring Boot 3.5.7
Security	Spring Security + JWT (jjwt 0.13.0)
Database	PostgreSQL
ORM	Spring Data JPA (Hibernate)
API Docs	SpringDoc OpenAPI 2.8.14
Utilities	Lombok
Build Tool	Maven

---

Prerequisites

1. Docker
   • Install Docker.
2. Docker Compose
   • Pre-installed with Docker Desktop (Windows/Mac).
   • Linux Installation Guide.
3. JDK (Java Development Kit)
   • Version 17 or higher is recommended.
4. Maven (Optional)
   • For building without Docker. Download Maven.

Installation

1. Clone the Repository

git clone [https://github.com/extraxo/bidding-system.git](https://github.com/extraxo/bidding-system.git)
cd bidding-system

2. Build and Run with Docker Compose
```bash
# Build Docker images and start containers
docker-compose up --build

3. Run Application Locally (Optional - without Docker)

# Build the applicaiton
mvn clean install

# Run the application
mvn spring-boot:run

Application usage

After Docker containers have started, both the application and the PostgreSQL server should be running on ports 8080 and 5432 respectfully.

For Swagger UI access use the following link: Swagger BiddingSystemApplication