🚴 BikeRide - Ride Booking System

A backend ride booking system built using Java, Spring Boot, Spring Security, JWT, Spring Data JPA, MySQL, Docker, and Apache Kafka.

BikeRide was developed as a personal project to gain hands-on experience with enterprise Java backend development. The project covers everything from Core Java concepts to modern backend technologies, following RESTful API design principles and industry best practices.

---

🌐 Project Links

GitHub Repository

https://github.com/Luffy992/BikeRide

---

✨ Features

👤 User Management

• User Registration
• User Login
• JWT Authentication
• Secure Password Encryption (BCrypt)
• Role-Based Authorization
• Profile Management

🏍 Ride Booking

• Book a Ride
• Cancel Ride
• View Ride History
• Ride Status Management
• Bike Availability Check

🚲 Bike Management

• Add Bike
• Update Bike
• Delete Bike
• View Available Bikes
• Bike Availability Management

👨‍💼 Admin Features

• Manage Users
• Manage Bikes
• Manage Bookings
• Monitor Ride Information

🔐 Security

• Spring Security
• JWT Authentication
• Role-Based Access Control
• Password Encryption
• Protected REST APIs

⚡ Backend Features

• RESTful API Design
• DTO Pattern
• Validation
• Global Exception Handling
• Layered Architecture
• Clean Code Practices

🐳 DevOps

• Docker Support
• Docker Compose
• Kafka Integration
• Maven Build System

---

🏗 System Architecture

                Client
                   │
                   ▼
            REST API Requests
                   │
                   ▼
          Spring Security Filter
                   │
                   ▼
              Controllers
                   │
                   ▼
               Services
                   │
                   ▼
            Spring Data JPA
                   │
                   ▼
                MySQL Database

          Kafka (Event Messaging)

---

📂 Project Structure

BikeRide
│
├── src
│   ├── main
│   │   ├── java
│   │   │   ├── config
│   │   │   ├── controller
│   │   │   ├── dto
│   │   │   ├── entity
│   │   │   ├── exception
│   │   │   ├── repository
│   │   │   ├── security
│   │   │   ├── service
│   │   │   └── util
│   │   │
│   │   └── resources
│   │       ├── application.properties
│   │       └── application.yml
│   │
│   └── test
│
├── Dockerfile
├── docker-compose.yml
├── docker-compose-kafka.yml
├── pom.xml
└── README.md

---

🛠 Technology Stack

Backend

• Java 21
• Spring Boot
• Spring MVC
• Spring Security
• Spring Data JPA
• Hibernate

Database

• MySQL

Authentication

• JWT
• BCrypt Password Encoder

Messaging

• Apache Kafka

DevOps

• Docker
• Docker Compose

Build Tool

• Maven

Version Control

• Git
• GitHub

---

🔐 Authentication

BikeRide uses JWT (JSON Web Token) for secure authentication.

Workflow:

1. User logs in.
2. Server validates credentials.
3. JWT Token is generated.
4. Client stores the token.
5. Token is sent with every protected request.
6. Spring Security validates the token before granting access.

---

📡 REST APIs

Authentication APIs

• Register User
• Login User

User APIs

• View Profile
• Update Profile

Bike APIs

• Add Bike
• Update Bike
• Delete Bike
• Get Available Bikes

Ride APIs

• Book Ride
• Cancel Ride
• Ride History
• Ride Details

Admin APIs

• Manage Users
• Manage Bikes
• Manage Bookings

---

🗄 Database

The application uses MySQL as the primary database.

Main Entities:

• User
• Role
• Bike
• Booking

Relationships are managed using Spring Data JPA and Hibernate.

---

🐳 Docker Support

Docker is used to containerize the application.

Run the application using Docker:

docker-compose up --build

Run Kafka services:

docker-compose -f docker-compose-kafka.yml up

---

⚙ Installation

Clone Repository

git clone https://github.com/Luffy992/BikeRide.git

---

Navigate

cd BikeRide

---

Configure Database

Update:

application.properties

with your MySQL credentials.

---

Build

mvn clean install

---

Run

mvn spring-boot:run

---

📦 Environment Variables

Configure:

spring.datasource.url=
spring.datasource.username=
spring.datasource.password=

jwt.secret=

spring.kafka.bootstrap-servers=

---

📈 Future Improvements

Planned enhancements:

• Payment Gateway Integration
• Email Notifications
• SMS Notifications
• Live Ride Tracking
• Redis Caching
• API Gateway
• Microservices Architecture
• Kubernetes Deployment
• CI/CD Pipeline
• Monitoring with Prometheus & Grafana

---

📚 Learning Outcomes

This project helped strengthen practical knowledge of:

• Core Java
• Object-Oriented Programming
• Spring Boot
• Spring MVC
• Spring Security
• JWT Authentication
• Spring Data JPA
• Hibernate
• REST API Design
• Validation
• Exception Handling
• MySQL
• Docker
• Kafka
• Git & GitHub

---

🚀 Future Scope

The project can be extended into a production-ready ride booking platform by adding:

• Payment Gateway
• Driver Management
• Real-Time Tracking
• Notifications
• Ratings & Reviews
• Ride Scheduling
• Surge Pricing
• Analytics Dashboard
• Mobile Application
• Cloud Deployment

---

👨‍💻 Author

M Luffy

GitHub: https://github.com/Luffy992

LinkedIn: www.linkedin.com/in/somesh-ramola

---

📄 License

This project is developed for learning purposes and personal portfolio.

Feel free to fork, explore, and enhance it.

---

⭐ If you found this project useful, consider giving it a star!