🚀 Spring Boot User Management REST API

Secure User Management REST API using Spring Boot

A production-style REST API built using Spring Boot, Spring Security, JWT Authentication, Redis Caching, MySQL, Flyway Database Migration, and Docker.

---

📌 Project Overview

This project demonstrates how modern backend applications are built using Spring Boot with secure authentication, database persistence, caching, and database version control.

The application follows a clean layered architecture:

• Controller
• Service
• Repository
• Database

The project secures all protected endpoints using JWT Authentication and improves performance using Redis Cache running inside a Docker container.

---

✨ Features

• 🔐 JWT Authentication
• 👤 User Registration
• 🔑 User Login
• 🛡 Spring Security
• 📦 CRUD Operations
• 🗄 MySQL Database
• ⚡ Redis Cache
• 🐳 Dockerized Redis
• 🔄 Flyway Database Migration
• 📑 Request Validation
• ❌ Global Exception Handling
• 🧩 Layered Architecture
• 🚀 Maven Build
• 📬 API Testing using Postman

---

🛠 Tech Stack

Technology	Used
Java 25	✅
Spring Boot	✅
Spring Security	✅
JWT	✅
Spring Data JPA	✅
Hibernate	✅
MySQL	✅
Redis	✅
Docker	✅
Flyway	✅
Maven	✅
IntelliJ IDEA	✅
Postman	✅

---

🏗 Project Architecture

                Client (Postman)

                       │
                       ▼

              Spring Security

                       │
                       ▼

             JWT Authentication

                       │
                       ▼

              User Controller

                       │
                       ▼

               Service Layer

              ↙              ↘

        Redis Cache      JPA Repository

              │               │

           Docker        Hibernate ORM

                              │

                              ▼

                       MySQL Database

---

📂 Project Structure

basic-rest-api
│
├── docs
│   └── screenshots
│
├── src
│   ├── main
│   │
│   ├── java
│   │     └── com.example.basic_rest_api
│   │
│   │          ├── config
│   │          ├── controller
│   │          ├── dto
│   │          ├── exception
│   │          ├── model
│   │          ├── repository
│   │          ├── security
│   │          ├── service
│   │          └── BasicRestApiApplication
│   │
│   └── resources
│        ├── application.properties
│        └── db
│             └── migration
│
├── pom.xml
├── docker-compose.yml
├── README.md
└── .gitignore

---

🔗 REST API Endpoints

Authentication APIs

Method	Endpoint	Description
POST	/auth/register	Register User
POST	/auth/login	Login User

---

User APIs

Method	Endpoint	Description
GET	/users	Get All Users
GET	/users/{id}	Get User by ID
PUT	/users/{id}	Update User
DELETE	/users/{id}	Delete User

🔒 All User APIs require a valid JWT Token.

---

🔐 JWT Authentication Flow

Register User
      │
      ▼
Login
      │
      ▼
JWT Token Generated
      │
      ▼
Authorization Header

Bearer <JWT Token>

      │
      ▼
Spring Security Filter
      │
      ▼
Protected APIs

---

⚡ Redis Cache Flow

Client

   │

GET /users

   │

   ▼

Redis Cache ?

YES ─────────► Return Cached Response

NO

 │

 ▼

MySQL Database

 │

 ▼

Store Data in Redis

 │

 ▼

Return Response

Redis is used to cache frequently requested user data to reduce unnecessary database queries and improve response time.

---

🐳 Docker

Redis runs inside a Docker container.

Run Redis

docker run -d --name redis-server -p 6379:6379 redis

Start Existing Container

docker start redis-server

Verify Running Containers

docker ps

---

🗄 Flyway Database Migration

Database schema is managed automatically using Flyway.

V1__create_users_table.sql

↓

V2__insert_initial_data.sql

↓

Executed Automatically
During Application Startup

---

🚀 Getting Started

Clone Repository

git clone https://github.com/uddishasinghh31/YOUR_REPOSITORY_NAME.git

---

Open Project

Open the project using IntelliJ IDEA.

---

Configure MySQL

Update your application.properties.

spring.datasource.url=jdbc:mysql://localhost:3306/prodigy_task2_db
spring.datasource.username=root
spring.datasource.password=your_password

---

Start Redis

docker start redis-server

---

Run Application

mvn spring-boot:run

or run

BasicRestApiApplication.java

Application starts on:

http://localhost:8080

---

📮 Testing with Postman

1. Register a new user.
2. Login using registered credentials.
3. Copy the generated JWT Token.
4. Add it to the Authorization Header.

Authorization

Bearer your_jwt_token

5. Access all protected APIs.

---

📸 Project Screenshots

📂 Project Structure

---

🎫 Postman Working

---

🎫 JWT Token Generated

---

⚡ Redis Cache

---

🐳 Docker Redis Container

---

🎥 Project Demo

▶️ Click here to watch the demo video

---

🚀 Future Improvements

• 📄 Swagger / OpenAPI Documentation
• 👥 Role-Based Authentication
• 🔄 Refresh Tokens
• 📊 Pagination & Sorting
• 🔍 Search APIs
• 🧪 Unit Testing
• ☁ Cloud Deployment
• ⚙ CI/CD Pipeline
• 📈 Monitoring using Prometheus & Grafana

---

👩‍💻 Developed By

Udisha

Aspiring Java Backend Developer

Skills

• ☕ Java
• 🌱 Spring Boot
• 🔐 Spring Security
• 🎫 JWT Authentication
• 🗄 MySQL
• ⚡ Redis
• 🐳 Docker
• 🚀 REST APIs

Linkedin: https://www.linkedin.com/in/udisha-singh-47170b338

---

# ⭐ Support

If you found this project useful,

⭐ Consider giving this repository a **Star**!

<div align="center">

## Made with ❤️ using Spring Boot

</div>