🚗 Car Rental System – Full Stack Web Application

Java Spring Boot REST API + React + Tailwind CSS

Live demo: https://carrental-system-app.vercel.app/login

---

📁 Project Structure

carrental-web/
├── backend/                          ← Spring Boot REST API
│   ├── pom.xml
│   └── src/main/java/com/carrental/
│       ├── CarRentalApplication.java  ← Entry point
│       ├── config/
│       │   └── SecurityConfig.java    ← JWT + CORS config
│       ├── controller/
│       │   ├── AuthController.java    ← POST /api/auth/login|register
│       │   ├── CarController.java     ← CRUD /api/cars
│       │   ├── BookingController.java ← CRUD /api/bookings
│       │   └── AdminController.java   ← GET /api/admin/*
│       ├── model/                     ← JPA Entities (from Swing models)
│       │   ├── User.java
│       │   ├── CarCompany.java
│       │   ├── CarVariant.java
│       │   ├── Location.java
│       │   ├── Customer.java
│       │   ├── Car.java
│       │   ├── Booking.java
│       │   └── Payment.java
│       ├── repository/                ← Spring Data JPA (replaces DAOs)
│       │   └── Repositories.java
│       ├── dto/
│       │   └── Dtos.java              ← Request/Response DTOs
│       └── security/
│           ├── JwtUtils.java          ← Token generation/validation
│           └── UserDetailsServiceImpl.java
│
└── frontend/                         ← React + Tailwind CSS
    ├── package.json
    ├── tailwind.config.js
    └── src/
        ├── App.jsx                   ← Routes + Auth guards
        ├── index.css                 ← Tailwind + global styles
        ├── context/
        │   └── AuthContext.jsx       ← Login state management
        ├── services/
        │   └── api.js                ← Axios API client
        ├── layouts/
        │   └── DashboardLayout.jsx   ← Sidebar + responsive layout
        ├── pages/
        │   ├── auth/
        │   │   ├── LoginPage.jsx
        │   │   └── RegisterPage.jsx
        │   ├── admin/
        │   │   ├── AdminDashboard.jsx
        │   │   ├── AdminCars.jsx
        │   │   ├── AdminBookings.jsx
        │   │   └── AdminCustomers.jsx
        │   └── customer/
        │       ├── CustomerDashboard.jsx
        │       ├── BrowseCars.jsx
        │       ├── BookingPage.jsx
        │       └── MyBookings.jsx
        └── components/               ← (add reusable components here)

Note: database_schema.sql lives at the repository root (next to carrental-web/) and contains the full MySQL schema used by the backend.

---

⚙️ Setup Instructions

Prerequisites

• Java JDK 17+
• Node.js 18+
• MySQL 8.0+
• Maven 3.8+

---

Step 1 – Database Setup

The database schema is provided in the root-level database_schema.sql file. You can run the full schema directly, or inspect the file for the exact table definitions used by the app.

-- Sample schema (also in database_schema.sql)
CREATE DATABASE IF NOT EXISTS car_rental_db;
USE car_rental_db;

-- Users table (admin + customers)
CREATE TABLE IF NOT EXISTS users (
    user_id      INT AUTO_INCREMENT PRIMARY KEY,
    username     VARCHAR(50)  NOT NULL UNIQUE,
    password     VARCHAR(255) NOT NULL,
    role         ENUM('ADMIN','CUSTOMER') NOT NULL DEFAULT 'CUSTOMER',
    created_at   TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

To apply the full schema:

mysql -u root -p < database_schema.sql

Spring Boot with ddl-auto=update will auto-create/update tables on first run.

---

Step 2 – Backend Setup

Update DB credentials in backend/src/main/resources/application.properties:

spring.datasource.url=jdbc:mysql://localhost:3306/car_rental_db?...
spring.datasource.username=root
spring.datasource.password=YOUR_PASSWORD

Run the backend:

cd backend
mvn spring-boot:run

Backend starts at: http://localhost:8080

---

Step 3 – Frontend Setup

cd frontend
npm install
npm start

Frontend starts at: http://localhost:3000

The "proxy": "http://localhost:8080" in package.json routes all /api/* calls to Spring Boot.

---

Step 4 – Default Login

Role	Username	Password
Admin	admin	admin123
Customer	Register via UI

---

🌐 API Endpoints

Auth (Public)

POST   /api/auth/login            Body: { username, password, role }
POST   /api/auth/register         Body: { username, password, fullName, email, ... }

Cars

GET    /api/cars/available        Public – list available cars
GET    /api/cars                  Admin – all cars
GET    /api/cars/{id}             Public – car detail
POST   /api/admin/cars            Admin – add car
PUT    /api/admin/cars/{id}       Admin – update car
DELETE /api/admin/cars/{id}       Admin – delete car

Bookings

GET    /api/bookings              Admin – all bookings
GET    /api/bookings/my           Customer – own bookings
POST   /api/bookings              Auth – create booking
PUT    /api/bookings/{id}/status  Admin – update status
DELETE /api/bookings/{id}         Auth – cancel booking

Admin

GET    /api/admin/dashboard       Stats: cars, customers, bookings, revenue
GET    /api/admin/customers       All customers
GET    /api/admin/companies       CRUD car companies
GET    /api/admin/locations       CRUD locations

---

🔐 Authentication Flow

1. User POSTs to /api/auth/login
2. Spring Security validates username + password
3. JwtUtils generates a signed JWT token
4. Frontend stores token in localStorage
5. Every subsequent request includes: Authorization: Bearer <token>
6. JwtAuthFilter validates token on each request
7. Spring Security sets user context for @PreAuthorize checks

---

🏗️ Tech Stack

Layer	Technology
Backend	Java 17, Spring Boot 3.2
Security	Spring Security + JWT (jjwt)
Database	MySQL 8 + Spring Data JPA
Frontend	React 18 + React Router v6
Styling	Tailwind CSS 3
HTTP Client	Axios
Toasts	react-hot-toast
Icons	lucide-react