🚚 FleetFlow - Modular Fleet & Logistics Management System

---

🚀 Setup & Installation

1️⃣ Clone Repository

git clone https://github.com/vishesh-017/fleetflow.git
cd fleetflow
2️⃣ Backend Setup (Flask)
cd backend
pip install -r requirements.txt
python app.py

Backend runs at:
http://localhost:5000

3️⃣ Frontend Setup (React)
cd frontend
npm install
npm start

Frontend runs at:
http://localhost:3000

---

📌 Overview

FleetFlow replaces manual logbooks with a centralized digital fleet command center.

It helps organizations manage:

• 🚘 Vehicles
• 👨‍✈️ Drivers
• 🚚 Trip Dispatch
• 📊 Utilization & Performance Tracking

---

🎯 Key Features

📊 Command Center Dashboard

• Active fleet tracking
• Utilization rate calculation
• Maintenance alerts
• Real-time updates

🚘 Vehicle Management

• Add / Edit / Delete vehicles
• Unique license plate validation
• Capacity tracking (kg)
• Status control:
  • Available
  • In Shop
  • On Trip

👨‍✈️ Driver Registry

• Driver creation
• Assignment validation
• Compliance tracking (future scope)

🚚 Trip Dispatch Logic

Workflow:

1. Select available vehicle
2. Assign driver
3. Enter cargo weight
4. Validate cargo < vehicle capacity
5. Dispatch

Business Rules:

• Vehicles marked “In Shop” cannot be dispatched
• Cargo exceeding capacity is blocked
• Expired driver licenses block assignment (planned)

---

🏗️ Tech Stack

Layer	Technology
Backend	Flask + SQLAlchemy + SQLite
Frontend	React 18 + Material UI
API	RESTful JSON
Database	SQLite (PostgreSQL-ready)

---

📁 Project Structure

fleetflow/
│
├── backend/
│   ├── app.py
│   ├── models.py
│   ├── instance/
│   │   └── fleetflow.db
│   └── requirements.txt
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── App.js
│   │   ├── index.js
│   │   └── components/
│   ├── package.json
│   └── package-lock.json
│
├── README.md
└── .gitignore

🔌 API Endpoints

Method	Endpoint	Description
GET	/vehicles	List vehicles
POST	/vehicles	Create vehicle
GET	/drivers	List drivers
POST	/drivers	Create driver
GET	/dashboard	Fleet KPIs

---

🧪 MVP Test Flow

1. Start backend
2. Start frontend
3. Add vehicle (e.g., VAN001, 500kg)
4. Add driver
5. Verify dashboard metrics update

---

🚧 Future Enhancements

• Trip management system
• Maintenance scheduling
• Expense tracking
• Cost-per-km analytics
• Authentication (JWT)
• PostgreSQL production migration
• Deployment pipeline

---

🌍 Deployment (Optional)

• Frontend → Vercel / Netlify
• Backend → Render / Railway
• Database → PostgreSQL

---

🤝 Contributing

git checkout -b feature/new-feature
git commit -m "Add new feature"
git push origin feature/new-feature

Open a Pull Request for review.

📄 License

MIT License © 2026 FleetFlow Team