Skip to main content

​
What is Product Distribution Dashboard?

The Product Distribution Dashboard is a full-stack application designed to manage and visualize product distribution across warehouses and stores. It provides an intelligent distribution system that optimizes how products are allocated from warehouses to stores based on geographical distance, capacity constraints, and demand patterns.

​
Key Capabilities

Interactive Map Visualization

Real-time visualization of distribution routes between warehouses and stores using Leaflet maps with clustering and route animations

Intelligent Distribution

Automated product allocation using configurable warehouse selection strategies that optimize for distance and capacity

Comprehensive Metrics

Detailed analytics on fulfillment rates, distribution distances, capacity utilization, and unfulfilled demands

Data-Driven Insights

Dynamic data loading from JSON sources with PostgreSQL persistence and real-time filtering capabilities

​
How It Works

The Product Distribution Dashboard operates through a three-phase workflow:
1

Data Loading

On startup, the system loads product, store, and warehouse data from configured JSON sources into PostgreSQL using Flyway migrations for schema management.
2

Distribution Algorithm

The backend runs a sophisticated distribution algorithm that:
  • Calculates adjusted demand based on expected return rates
  • Selects optimal warehouses using configurable strategies
  • Allocates inventory while respecting store capacity constraints
  • Tracks unfulfilled demands due to stock or capacity shortages
3

Visualization & Analysis

The Angular frontend displays distribution results through:
  • Interactive maps showing warehouse-to-store routes
  • Detailed tables with filtering and sorting
  • Real-time metrics dashboards
  • Product and location-specific breakdowns

​
Target Users

This application is ideal for:
  • Supply Chain Managers - Optimize product distribution and identify bottlenecks
  • Operations Teams - Monitor fulfillment rates and capacity utilization
  • Logistics Planners - Analyze distribution distances and route efficiency
  • Business Analysts - Extract insights from distribution patterns and demand data

​
Use Cases

Plan and optimize how products are distributed from distribution centers to retail stores, ensuring each location receives appropriate inventory based on demand and capacity.
Monitor store capacity utilization and identify locations that are reaching their limits, enabling proactive capacity planning.
Track which stores have unfulfilled demands and understand whether shortages are due to insufficient stock or capacity constraints.
Visualize distribution routes and distances to identify opportunities for reducing transportation costs and improving delivery times.

​
Technology Stack

The application is built with modern, production-ready technologies: Backend:
  • Spring Boot 3.4.5 (Java 17)
  • PostgreSQL 16 for data persistence
  • Flyway for database migrations
  • MapStruct for object mapping
Frontend:
  • Angular 18 with TypeScript
  • Leaflet for map visualization
  • Chart.js for data visualization
  • RxJS for reactive programming
Infrastructure:
  • Docker & Docker Compose for containerization
  • GitHub Actions for CI/CD
  • Render.com deployment support

​
What’s Next?

Quickstart Guide

Get the application running locally in minutes with Docker Compose

Architecture Overview

Understand the system architecture, data flow, and core components
The Product Distribution Dashboard is designed to run entirely with Docker Compose, making it easy to get started without complex setup procedures.

Build docs developers (and LLMs) love

Get started for freeTalk to us