# lokavishal021/professional-sales-demand-forecasting-system architecture

> Architecture diagram of the GitHub repository lokavishal021/professional-sales-demand-forecasting-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lokavishal021/professional-sales-demand-forecasting-system
- Repository: https://github.com/lokavishal021/professional-sales-demand-forecasting-system

## Overview

This repository forecasts daily Online Retail sales and presents the results for operational analysis. The principal workflow is a refreshable master run: preprocessing cleans and aggregates the workbook, model training builds and saves an XGBoost model, and forecast generation produces a 30-day outlook, analytical plots, and a Power BI report. A Streamlit dashboard offers interactive analysis and can trigger a refresh. Regional aggregation and hold-out validation are distinct supporting capabilities. The dashboard excerpt is partial, so links from it to specific generated files are not asserted.

Main entry points: [`predict_future.py`](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/predict_future.py) (Forecast & Reporting), [`main.py`](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/main.py) (Run Coordinator), [`preprocess_data.py`](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/preprocess_data.py) (Sales Preprocessing), [`sales_forecasting.py`](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/sales_forecasting.py) (Feature Engineering & Training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Forecast Workflow"]
  node_main["Run Coordinator<br/>[main.py]"]
  node_preprocessing["Sales Preprocessing<br/>[preprocess_data.py]"]
  node_raw_workbook["Retail Workbook<br/>[Online Retail.xlsx]"]
  node_processed_sales["Daily Sales Data"]
  node_regional_sales["Regional Sales<br/>[regional_sales.csv]"]
end

subgraph group_modeling["Modeling"]
  node_feature_training["Feature Engineering &amp; Training"]
  node_trained_model["Trained Model<br/>[sales_model.joblib]"]
  node_validation_results["Backtest Results"]
end

subgraph group_outputs["Forecast Outputs"]
  node_forecast_generation["Forecast &amp; Reporting<br/>[predict_future.py]"]
  node_master_report["Power BI Report"]
  node_analytical_plots["Forecast Charts"]
end

subgraph group_experience["Analysis Interfaces"]
  node_dashboard["Streamlit Dashboard<br/>[dashboard.py]"]
  node_power_bi["Power BI"]
end

node_retail_user(("Retail Analyst"))

node_retail_user -->|"runs pipeline"| node_main
node_main -->|"calls preprocessing"| node_preprocessing
node_main -->|"calls training"| node_feature_training
node_main -->|"calls forecast"| node_forecast_generation
node_preprocessing -->|"reads workbook"| node_raw_workbook
node_preprocessing -->|"writes daily data"| node_processed_sales
node_preprocessing -->|"writes regional totals"| node_regional_sales
node_feature_training -->|"reads daily data"| node_processed_sales
node_feature_training -->|"saves model"| node_trained_model
node_feature_training -->|"writes backtest"| node_validation_results
node_forecast_generation -->|"reads daily data"| node_processed_sales
node_forecast_generation -->|"loads model"| node_trained_model
node_forecast_generation -->|"exports report"| node_master_report
node_forecast_generation -->|"saves charts"| node_analytical_plots
node_retail_user -->|"opens dashboard"| node_dashboard
node_dashboard -->|"starts refresh"| node_main
node_power_bi -->|"imports report"| node_master_report

click node_main "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/main.py"
click node_preprocessing "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/preprocess_data.py"
click node_raw_workbook "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/raw_data/Online%20Retail.xlsx"
click node_processed_sales "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/processed_daily_sales.csv"
click node_regional_sales "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/regional_sales.csv"
click node_feature_training "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/sales_forecasting.py"
click node_trained_model "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/models/sales_model.joblib"
click node_validation_results "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/validation_results.csv"
click node_forecast_generation "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/predict_future.py"
click node_master_report "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/powerbi_master_report.csv"
click node_dashboard "https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/dashboard.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_preprocessing,node_raw_workbook,node_processed_sales,node_regional_sales toneBlue
class node_feature_training,node_trained_model,node_validation_results toneAmber
class node_forecast_generation,node_master_report,node_analytical_plots toneMint
class node_dashboard,node_power_bi toneRose
class node_retail_user toneIndigo
```

## Components

### Forecast Workflow

- [Run Coordinator](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/main.py): `main.py`
- [Sales Preprocessing](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/preprocess_data.py): `preprocess_data.py`
- [Retail Workbook](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/raw_data/Online%20Retail.xlsx): `raw_data/Online Retail.xlsx`
- [Daily Sales Data](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/processed_daily_sales.csv): `data/processed_daily_sales.csv`
- [Regional Sales](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/regional_sales.csv): `data/regional_sales.csv`

### Modeling

- [Feature Engineering & Training](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/sales_forecasting.py): `sales_forecasting.py`
- [Trained Model](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/models/sales_model.joblib): `models/sales_model.joblib`
- [Backtest Results](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/validation_results.csv): `data/validation_results.csv`

### Forecast Outputs

- [Forecast & Reporting](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/predict_future.py): `predict_future.py`
- [Power BI Report](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/data/powerbi_master_report.csv): `data/powerbi_master_report.csv`
- **Forecast Charts**

### Analysis Interfaces

- [Streamlit Dashboard](https://github.com/lokavishal021/professional-sales-demand-forecasting-system/blob/main/dashboard.py): `dashboard.py`
- **Power BI**

### Other components

- **Retail Analyst**

## Connections

- Retail Analyst → Run Coordinator: runs pipeline (evidence: `README.md`)
- Run Coordinator → Sales Preprocessing: calls preprocessing (evidence: `main.py`)
- Run Coordinator → Feature Engineering & Training: calls training (evidence: `main.py`)
- Run Coordinator → Forecast & Reporting: calls forecast (evidence: `main.py`)
- Sales Preprocessing → Retail Workbook: reads workbook (evidence: `preprocess_data.py`)
- Sales Preprocessing → Daily Sales Data: writes daily data (evidence: `preprocess_data.py`)
- Sales Preprocessing → Regional Sales: writes regional totals (evidence: `preprocess_data.py`)
- Feature Engineering & Training → Daily Sales Data: reads daily data (evidence: `sales_forecasting.py`)
- Feature Engineering & Training → Trained Model: saves model (evidence: `sales_forecasting.py`)
- Feature Engineering & Training → Backtest Results: writes backtest (evidence: `sales_forecasting.py`)
- Forecast & Reporting → Daily Sales Data: reads daily data (evidence: `predict_future.py`)
- Forecast & Reporting → Trained Model: loads model (evidence: `predict_future.py`)
- Forecast & Reporting → Power BI Report: exports report (evidence: `predict_future.py`)
- Forecast & Reporting → Forecast Charts: saves charts (evidence: `predict_future.py`)
- Retail Analyst → Streamlit Dashboard: opens dashboard (evidence: `README.md`)
- Streamlit Dashboard → Run Coordinator: starts refresh (evidence: `dashboard.py`)
- Power BI → Power BI Report: imports report (evidence: `README.md`)
