System Architecture

A modern, scalable architecture designed for real-time delivery optimization with ML-powered decision making.

Data Flow

Dashboard
Map
Orders
Alerts

API Gateway

FastAPI + WebSocket

Apache Kafka

Event Streaming

ML Serving

Forecasting + VRP

PostgreSQL

PostGIS + TimescaleDB

Architecture Layers

Presentation Layer

Next.js

Next.js

Next.js 16 App Router

Deck.gl

Deck.gl

WebGL Map Visualization

tRPC

tRPC

End-to-end typesafe API

Tailwind

Tailwind

Utility-first CSS

API Layer

FastAPI

FastAPI

High-performance Python API

WebSocket

WebSocket

Real-time bidirectional

Redis

Redis

Response caching layer

Processing Layer

Kafka

Kafka

Event streaming platform

Airflow

Airflow

Workflow orchestration

dbt

dbt

Data transformations

ML Layer

Prophet

Prophet

Demand forecasting

OR-Tools

OR-Tools

Route optimization VRP

MLflow

MLflow

Experiment tracking

Data Layer

PostgreSQL

PostgreSQL

PostGIS + TimescaleDB

MongoDB

MongoDB

Document store

Redis

Redis

Cache & sessions

Infrastructure

Docker

Docker

8 containerized services

Nginx

Nginx

Reverse proxy

GitHub

GitHub

CI/CD Actions