# vedheshvlv/sales-data-analysis-prediction architecture

> Architecture diagram of the GitHub repository vedheshvlv/sales-data-analysis-prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vedheshvlv/sales-data-analysis-prediction
- Repository: https://github.com/vedheshvlv/sales-data-analysis-prediction

## Overview

This is a single-script retail sales forecasting project. The documented workflow loads and cleans the sales CSV, explores the data, encodes selected features, splits the data, trains four regressors, evaluates them, and visualizes comparisons and predictions. The script excerpt supports these internal stages, though they are not separate modules. The README also documents business interpretation and feature-importance analysis; source-level evidence for the latter is present in the script. No external services or persistent output stores are shown.

Main entry points: [`analysis.py`](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py) (Load & Clean), [`sales.csv`](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/sales.csv) (Sales Dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data_prep["Data Preparation"]
  node_sales_csv["Sales Dataset<br/>[sales.csv]"]
  node_load_clean["Load &amp; Clean<br/>[analysis.py]"]
end

subgraph group_analytics["Exploration &amp; Features"]
  node_eda["Sales EDA<br/>[analysis.py]"]
  node_features["Feature Encoding<br/>[analysis.py]"]
  node_split["Train-Test Split<br/>[analysis.py]"]
end

subgraph group_modeling["Forecast Models"]
  node_regressors["Four Regressors<br/>[analysis.py]"]
end

subgraph group_results["Evaluation &amp; Insights"]
  node_metrics["Metric Evaluation<br/>[analysis.py]"]
  node_comparison["Model Comparison<br/>[analysis.py]"]
  node_importance["Feature Importance<br/>[analysis.py]"]
  node_prediction_plot["Prediction Plot<br/>[analysis.py]"]
end

node_user(("Project User"))
node_runner(("Script Runner"))

node_user -->|"runs script"| node_runner
node_runner -->|"executes"| node_load_clean
node_load_clean -->|"reads"| node_sales_csv
node_load_clean -->|"provides cleaned data"| node_eda
node_load_clean -->|"provides cleaned data"| node_features
node_features -->|"passes encoded data"| node_split
node_split -->|"supplies train-test sets"| node_regressors
node_regressors -->|"provides predictions"| node_metrics
node_metrics -->|"supplies MAE RMSE"| node_comparison
node_regressors -->|"supplies forest model"| node_importance
node_regressors -->|"supplies predictions"| node_prediction_plot

click node_sales_csv "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/sales.csv"
click node_load_clean "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_eda "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_features "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_split "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_regressors "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_metrics "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_comparison "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_importance "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py"
click node_prediction_plot "https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.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_sales_csv,node_load_clean,node_user toneBlue
class node_eda,node_features,node_split toneAmber
class node_regressors toneMint
class node_metrics,node_comparison,node_importance,node_prediction_plot toneRose
class node_runner toneIndigo
```

## Components

### Data Preparation

- [Sales Dataset](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/sales.csv): `sales.csv`
- [Load & Clean](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`

### Exploration & Features

- [Sales EDA](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`
- [Feature Encoding](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`
- [Train-Test Split](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`

### Forecast Models

- [Four Regressors](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`

### Evaluation & Insights

- [Metric Evaluation](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`
- [Model Comparison](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`
- [Feature Importance](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`
- [Prediction Plot](https://github.com/vedheshvlv/sales-data-analysis-prediction/blob/main/analysis.py): `analysis.py`

### Other components

- **Project User**
- **Script Runner**

## Connections

- Project User → Script Runner: runs script (evidence: `README.md`)
- Script Runner → Load & Clean: executes (evidence: `README.md`)
- Load & Clean → Sales Dataset: reads (evidence: `analysis.py`)
- Load & Clean → Sales EDA: provides cleaned data (evidence: `analysis.py`)
- Load & Clean → Feature Encoding: provides cleaned data (evidence: `analysis.py`)
- Feature Encoding → Train-Test Split: passes encoded data (evidence: `analysis.py`)
- Train-Test Split → Four Regressors: supplies train-test sets (evidence: `analysis.py`)
- Four Regressors → Metric Evaluation: provides predictions (evidence: `analysis.py`)
- Metric Evaluation → Model Comparison: supplies MAE RMSE (evidence: `analysis.py`)
- Four Regressors → Feature Importance: supplies forest model (evidence: `analysis.py`)
- Four Regressors → Prediction Plot: supplies predictions (evidence: `analysis.py`)
