LogiTrack — Smart Supply Chain & Delivery Management Platform

🚀 Project Overview

LogiTrack is a full-stack logistics and delivery management platform designed for small businesses to manage:

• 📦 Products & Inventory
• 🧾 Orders
• 🚚 Deliveries & Delivery Agents
• 📊 Business Analytics
• 👥 Multi-role Authentication
• 🛒 Customer Ordering System

The platform provides real-time operational visibility with modern dashboards, scalable backend APIs, and responsive UI experiences.

---

🌟 Features

👨‍💼 Business Owner Dashboard

📦 Product Management

• Add/Edit/Delete products
• Product image support
• SKU management
• Stock quantity management
• Category filtering

📊 Inventory Management

• Low stock alerts
• Inventory overview
• Dynamic stock updates
• Real-time inventory tracking

🧾 Order Management

• Incoming customer orders
• Payment status tracking
• Order lifecycle management
• Customer details

🚚 Delivery Management

• Assign delivery agents
• Delivery tracking
• Delivery status updates
• Route overview

📈 Analytics Dashboard

• Revenue tracking
• Total orders
• Sales growth
• Low stock analytics
• Delivery statistics

---

🚚 Delivery Agent Module

• Assigned delivery list
• Delivery status updates
• Delivery tracking
• Mobile responsive UI
• Earnings simulation

---

🛒 Customer Module

• Browse products
• Place orders
• Order tracking
• Checkout flow
• Delivery status monitoring

---

🧠 AI Features (Planned / Simulated)

• Demand Forecasting
• Smart Auto-Assign
• Customer Churn Prediction

---

🛠 Tech Stack

Frontend

• Next.js (App Router)
• TypeScript
• Tailwind CSS
• Recharts
• Lucide React

Backend

• Node.js
• Express.js
• MongoDB Atlas
• Mongoose

Database

• MongoDB Atlas

---

📁 Project Structure

LogiTrack/
│
├── frontend/
│   ├── app/
│   ├── components/
│   ├── lib/
│   └── public/
│
├── backend/
│   ├── src/
│   │   ├── config/
│   │   ├── controllers/
│   │   ├── middleware/
│   │   ├── models/
│   │   ├── routes/
│   │   └── server.js
│   │
│   ├── .env
│   └── package.json
│
└── README.md

---

⚙️ Installation & Setup

1️⃣ Clone Repository

git clone <your-repo-url>
cd LogiTrack

---

🔥 Backend Setup

Install Dependencies

cd backend
npm install

Create .env

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key

Start Backend Server

npm run dev

Backend runs on:

http://localhost:5000

---

🎨 Frontend Setup

Install Dependencies

cd frontend
npm install

Start Frontend

npm run dev

Frontend runs on:

http://localhost:3000

---

📡 Backend API Endpoints

📦 Products

GET    /api/products
POST   /api/products
PUT    /api/products/:id
DELETE /api/products/:id

---

🧾 Orders

GET    /api/orders
POST   /api/orders
PUT    /api/orders/:id/status
DELETE /api/orders/:id

---

📊 Inventory

GET    /api/inventory
GET    /api/inventory/low-stock
PUT    /api/inventory/:productId

---

🚚 Deliveries

GET    /api/deliveries
POST   /api/deliveries
PUT    /api/deliveries/:id
DELETE /api/deliveries/:id

---

📈 Analytics

GET /api/analytics

---

📈 Current Status

• ✅ Backend APIs completed
• ✅ MongoDB integration completed
• ✅ Frontend-backend integration completed
• ✅ Dynamic dashboards implemented
• ✅ Inventory management completed
• ✅ Order management completed
• ✅ Delivery management completed

---

🚀 Future Improvements

• Real-time WebSockets
• AI-powered forecasting
• Razorpay/Stripe payments
• Route optimization with Leaflet.js
• JWT Authentication
• Role-based authorization
• Notification system

---

📄 License

This project is developed for DevFusion Hackathon 2.0.