Skip to main content

Product Distribution Dashboard

Optimize warehouse-to-store product distribution with intelligent algorithms, real-time metrics, and interactive map visualizations.

Key Features

Intelligent Distribution Algorithm

Configurable warehouse selection strategies optimize product allocation based on distance and capacity constraints.

Interactive Map Visualization

Visualize warehouses, stores, and distribution routes on an interactive Leaflet map with clustering and route overlays.

Real-Time Metrics & Analytics

Track global and detailed metrics including capacity utilization, distance statistics, and unfulfilled demand analysis.

RESTful API

Full-featured REST API for managing products, stores, warehouses, and stock assignments with filtering and validation.

Tech Stack

Built with modern, production-ready technologies:

Backend

  • Spring Boot 3.4.5
  • Java 17
  • PostgreSQL 16
  • Flyway Migrations

Frontend

  • Angular 18
  • TypeScript
  • Leaflet Maps
  • Chart.js

DevOps

  • Docker Compose
  • GitHub Actions
  • Render Deployment
  • SonarCloud

Quick Start

Get up and running in minutes with Docker Compose:
1

Clone the repository

git clone https://github.com/raulHerediaHorcajo/product-distribution.git
cd product-distribution
2

Start the stack

docker compose up --build
This launches PostgreSQL, backend, frontend, and pgAdmin.
3

Access the application

The application automatically loads sample data on startup, including products, stores, and warehouses from JSON files.

Use Cases

Optimize product distribution across retail store networks by automatically calculating the most efficient warehouse-to-store assignments based on distance and capacity.
Visualize capacity utilization across warehouses and stores to identify bottlenecks and plan inventory replenishment strategies.
Analyze distribution metrics including average delivery distance, unfulfilled demand patterns, and warehouse efficiency to improve supply chain operations.
Manage product distribution for multiple brands (e.g., Zara, Massimo Dutti, Bershka) with configurable strategies and real-time tracking.

What’s Next?

Installation Guide

Learn how to install and deploy the application in various environments.

Architecture Overview

Understand the system architecture, data flow, and key design decisions.

Configuration

Configure environment variables, database connections, and distribution strategies.

API Documentation

Explore the complete REST API with endpoints, models, and examples.

Build docs developers (and LLMs) love