FleetOps - Real-Time Fleet Management Backend

🎯 Project Overview

FleetOps is a real-time fleet tracking backend system designed to ingest, store, and analyze GPS data from moving vehicles. It simulates a real-world logistics platform with microservices, event streaming, caching, background tasks, and cloud infrastructure.

🛠 Tech Stack

• FastAPI for API development

• Kafka for real-time message streaming

• Redis for caching

• Docker and Docker Compose for local development

• Design RESTful APIs with FastAPI

• Stream and process data in real time with Kafka

• Cache dynamic data for low-latency access with Redis

• Set up local dev environments with Docker Compose

• Write and maintain unit/integration tests with pytest

🧪 How to Run Locally

1. Ensure Docker and Docker Compose are installed
2. Copy .env.example to .env and update environment variables
3. From the infra/ directory, run:

   docker compose up --build

4. Visit the FastAPI docs at: http://localhost:8000/docs
5. Run tests from the root directory:

   pytest

📁 Project Structure

project/
├── backend/
│   ├── app/
│   │   ├── api/
│   │   │   ├── routes/
│   │   │   │   ├── fleet.py
│   │   │   │   └── analytics.py
│   │   │   └── deps.py
│   │   ├── core/
│   │   │   ├── config.py
│   │   │   └── security.py
│   │   ├── models/
│   │   │   ├── truck.py
│   │   │   └── location.py
│   │   ├── services/
│   │   │   ├── kafka_consumer.py
│   │   │   └── location_cache.py
│   │   ├── tasks/
│   │   │   └── analytics.py
│   │   ├── main.py
│   │   └── database.py
│   ├── Dockerfile
│   ├── requirements.txt
│   └── .env
├── infra/
│   ├── docker-compose.yml
│   └── terraform/
│       ├── main.tf
│       ├── variables.tf
│       └── outputs.tf
├── tests/
│   ├── test_fleet.py
│   ├── test_analytics.py
│   └── conftest.py
├── .github/
│   └── workflows/
│       └── ci.yml
├── README.md
└── Makefile

🔋 Future Enhancements

• WebSocket support for live UI updates
• React dashboard with Leaflet for tracking
• S3 integration for file uploads
• Kubernetes deployment