🚛 FreightIQ - AI-Powered Logistics Platform

India's premier AI-powered transport management system. Built for modern fleets to optimize routes, track shipments in real-time, generate automated invoices, and manage drivers effortlessly.

---

📑 Table of Contents

• Features
• Tech Stack
• Architecture
• Getting Started
  • Prerequisites
  • Local Development
  • Docker Deployment
• Default Credentials
• License

---

🚀 Features

• Live GPS Tracking: Monitor every truck in real-time on interactive Mapbox maps.
• Driver Portal: Dedicated mobile-first web app for drivers to update trip statuses and upload PODs.
• AI Analytics: Intelligent business insights on top routes, driver performance, and revenue growth.
• Digital LR & ePOD: Create lorry receipts and collect delivery proof digitally.
• Automated Invoicing: Generate GST-compliant PDF invoices instantly.
• Fleet Management: Track truck utilization, maintenance status, and driver allocations.

💻 Tech Stack

Frontend

• Framework: Next.js 15 (App Router)
• Styling: Tailwind CSS, Framer Motion
• Data Visualization: Recharts, Mapbox GL JS
• Icons: Lucide React

Backend

• Framework: NestJS
• Database: MongoDB (via Mongoose)
• Real-time: Socket.IO
• Authentication: JWT Auth
• Utilities: PDFKit for automated invoice generation

DevOps

• Containerization: Docker, Docker Compose

🏗 Architecture

+-------------------+       REST API       +-------------------+
|                   | <------------------> |                   |
|   Next.js (App)   |    WebSockets (Live) |   NestJS (API)    |
|   Tailwind UI     | <==================> |   Socket.IO       |
|                   |                      |                   |
+--------+----------+                      +--------+----------+
         |                                          |
         v                                          v
+-------------------+                      +-------------------+
|  Mapbox API       |                      |  MongoDB Database |
| (Routing & Maps)  |                      | (Mongoose Schema) |
+-------------------+                      +-------------------+

🛠️ Getting Started

Prerequisites

• Node.js (v18+)
• MongoDB (Local or Atlas)
• Docker (optional, for containerized deployment)

Local Development

1. Clone the repository:

   git clone https://github.com/Kiran-Kumbar/Freight-IQ.git
   cd Freight-IQ

2. Install dependencies:

   # Backend
   cd backend
   npm install
   
   # Frontend
   cd ../frontend
   npm install

3. Configure Environment Variables:

   • Create .env in the backend folder based on .env.production.example.
   • Create .env.local in the frontend folder with NEXT_PUBLIC_API_URL and NEXT_PUBLIC_MAPBOX_TOKEN.

4. Start the servers:

   # Backend
   cd backend
   npm run start:dev
   
   # Frontend
   cd ../frontend
   npm run dev

5. Seed the database (Optional but recommended):

   cd backend
   npm run seed

Docker Deployment

To spin up the entire stack using Docker:

docker-compose up --build -d

📚 Default Credentials

After running the seed script, you can log in with:

• Admin: admin@freightiq.com / Admin@123
• Driver: raju@freightiq.com / Admin@123

---

Built with ❤️ for Indian Transport Companies.