RideShare Backend – Spring Boot & MongoDB

A complete Ride Sharing Backend API built using Spring Boot, MongoDB, JWT Authentication, Input Validation, and Global Exception Handling.
This project supports user registration, login, ride booking, driver acceptance, and ride completion with role-based access.

---

🛠️ Tech Stack

• Java 17
• Spring Boot 3.2.5
• MongoDB
• Spring Security
• JWT Authentication
• Hibernate Validator
• Maven
• Tomcat Embedded Server

---

Project Folder Structure

src/main/java/com/Sanskriti/Rapido/
 ├── model/
 ├── repository/
 ├── service/
 ├── controller/
 ├── config/
 ├── dto/
 ├── exception/
 └── util/

---

User Roles

• ROLE_USER → Passenger
• ROLE_DRIVER → Driver

---

Features Implemented

🔐 Authentication

• User Registration (BCrypt password encryption)
• User Login with JWT Token
• Role-based access control

🚕 Ride Management

• User can request a ride
• Driver can view all pending rides
• Driver can accept a ride
• User/Driver can complete a ride
• User can view their own rides

🛡 Security

• JWT authentication on every secured API
• Stateless authentication
• Custom JWT filter

🧾 Validation & Exception Handling

• DTO based validation
• Global exception handling
• Meaningful API error responses

---

JWT Flow

Login → Receive JWT Token → Add Token in Header → Access Protected APIs

Header Format:

Authorization: Bearer <your-token>

---

📌 API Endpoints

Public APIs

Method	Endpoint	Description
POST	/api/auth/register	Register user/driver
POST	/api/auth/login	Login and get JWT

---

USER APIs

Method	Endpoint	Description
POST	/api/v1/rides	Request a ride
GET	/api/v1/user/rides	View own rides
POST	/api/v1/rides/{id}/complete	Complete ride

---

DRIVER APIs

Method	Endpoint	Description
GET	/api/v1/driver/rides/requests	View pending rides
POST	/api/v1/driver/rides/{id}/accept	Accept a ride

---

Sample Request Bodies

Register

{
  "username": "john",
  "password": "1234",
  "role": "ROLE_USER"
}

Login

{
  "username": "john",
  "password": "1234"
}

Create Ride

{
  "pickupLocation": "Koramangala",
  "dropLocation": "Indiranagar"
}

---

Sample CURL Commands

Register User

curl -X POST http://localhost:9000/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username":"john","password":"1234","role":"ROLE_USER"}'

Register Driver

curl -X POST http://localhost:9000/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username":"driver1","password":"abcd","role":"ROLE_DRIVER"}'

Login

curl -X POST http://localhost:9000/api/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"john","password":"1234"}'

Create Ride

curl -X POST http://localhost:9000/api/v1/rides \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{"pickupLocation":"A","dropLocation":"B"}'

---

📊 Database Used

• MongoDB (Local)
• Collections:
  • users
  • rides

---

▶️ How to Run the Project

1. Install Java 17
2. Install and start MongoDB
3. Clone the repository
4. Open in IntelliJ IDEA
5. Run:

   mvn spring-boot:run

6. Server runs at:

   http://localhost:9000
   

---

---

API Testing Screenshots

Below are the screenshots of API testing done using Postman / Curl:

🔐 User Registration

User Registered Sucessfully

🔑 User Login

🚕 Create Ride

The token received during login will be used in authorization for creating the ride.

🚗 Driver View Pending Rides

Driver Accept Ride

🏁 Complete Ride

📄 User Ride History

---

Output Status

• User Registration Working
• JWT Login Working
• Ride Request Working
• Driver Accept Working
• Ride Completion Working
• Role Authorization Working

---

📄 Author

Sanskriti
Backend Developer – Spring Boot & MongoDB
GitHub: https://github.com/Sanskriti10247