🚚 Logistics Management System

A backend application built using Spring Boot and PostgreSQL to streamline logistics operations, including order processing, shipment tracking, truck allocation, cargo management, and driver administration.

The system provides RESTful APIs that enable efficient transportation and delivery management while maintaining real-time visibility into logistics workflows.

---

📌 Overview

The Logistics Management System is designed to simplify logistics operations by centralizing the management of:

• Orders
• Deliveries
• Shipments
• Trucks
• Cargo
• Drivers

The platform exposes REST APIs that can be integrated with web or mobile applications and was tested using Postman.

---

✨ Features

Order Management

• Create new orders
• View order details
• Update order information
• Manage delivery status

Shipment Tracking

• Track shipments throughout the delivery lifecycle
• Monitor shipment progress
• Retrieve shipment information through APIs

Truck Management

• Register trucks
• Manage truck information
• Assign trucks to deliveries

Cargo Management

• Manage cargo details
• Associate cargo with shipments
• Track cargo movement

Driver Management

• Add and manage drivers
• Assign drivers to deliveries
• Maintain driver records

Email Notifications

• Order confirmation emails
• Shipment status updates
• Delivery notifications

---

🏗 System Architecture

Client / Postman
        |
        ▼
Spring Boot REST APIs
        |
        ▼
PostgreSQL Database

---

🛠 Technology Stack

Backend

• Java
• Spring Boot
• Spring Data JPA
• REST APIs

Database

• PostgreSQL

Testing

• Postman

Build Tool

• Maven

---

📂 Project Structure

src
├── controller
├── service
├── repository
├── entity
├── dto
└── configuration

The project follows a layered architecture to maintain separation of concerns and improve maintainability.

---

🚀 Getting Started

Clone the Repository

git clone https://github.com/KurvaJeevan/Logistics-Backend.git
cd Logistics-Backend

Prerequisites

Ensure the following are installed:

• Java 17+
• Maven
• PostgreSQL

Database Configuration

Update the database configuration in:

src/main/resources/application.properties

Example:

spring.datasource.url=jdbc:postgresql://localhost:5432/logistics_db
spring.datasource.username=your_username
spring.datasource.password=your_password

Run the Application

mvn spring-boot:run

The application will start on:

http://localhost:8080

---

🔌 API Capabilities

The system exposes RESTful APIs for:

• Order Management
• Shipment Tracking
• Truck Management
• Cargo Operations
• Driver Administration
• Delivery Monitoring

All endpoints can be tested using Postman.

---

🎯 Key Highlights

• RESTful API Development
• Layered Spring Boot Architecture
• PostgreSQL Integration
• Logistics Workflow Management
• Shipment Tracking System
• Email Notification Integration
• Postman API Testing

---

🔮 Future Enhancements

• JWT Authentication
• Role-Based Access Control
• Real-Time Delivery Tracking
• Driver Mobile Integration
• Dashboard Analytics
• Docker Containerization
• Cloud Deployment

---

👨‍💻 Author

Kurva Jeevan Kumar

Best Project GitHub: https://github.com/KurvaJeevan/Edutrack-Full-Stack-Microservices-project