# volkan35koc/supermarket-sales-and-profitability-performance-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis
- Repository: https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis

## Overview

This repository is a supermarket performance analysis project, not a software service. Its documented workflow uses Superstore.csv in a Jupyter notebook for data preparation and exploratory analysis, then applies a Random Forest regressor to predict profit and evaluates it with MAE. The README also reports findings on yearly performance, loss-making furniture subcategories, and discount-related losses. No notebook source was provided, so the graph reflects documented capabilities and relationships only; component paths identify the notebook or dataset, not inspected implementation details.

Main entry points: [`superstore.ipynb`](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb) (Data preparation), [`Superstore.csv`](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/Superstore.csv) (Superstore sales)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data"]
  node_sales_data["Superstore sales<br/>[Superstore.csv]"]
end

subgraph group_eda["Exploratory analysis"]
  node_notebook["Analysis notebook<br/>[superstore.ipynb]"]
  node_preparation["Data preparation<br/>[superstore.ipynb]"]
  node_time_analysis["Time trends<br/>[superstore.ipynb]"]
  node_category_analysis["Category profitability<br/>[superstore.ipynb]"]
  node_discount_analysis["Discount analysis<br/>[superstore.ipynb]"]
  node_business_findings["Business findings<br/>[superstore.ipynb]"]
end

subgraph group_ml["Profit prediction"]
  node_profit_model["Random Forest<br/>[superstore.ipynb]"]
  node_model_evaluation["MAE evaluation<br/>[superstore.ipynb]"]
end

node_analyst(("Analyst"))

node_analyst -->|"runs"| node_notebook
node_sales_data -->|"provides data"| node_preparation
node_notebook -->|"performs"| node_preparation
node_preparation -->|"enables"| node_time_analysis
node_preparation -->|"enables"| node_category_analysis
node_preparation -->|"enables"| node_discount_analysis
node_time_analysis -->|"identifies trends"| node_business_findings
node_category_analysis -->|"identifies losses"| node_business_findings
node_discount_analysis -->|"reveals impact"| node_business_findings
node_preparation -->|"supplies features"| node_profit_model
node_profit_model -->|"evaluated by"| node_model_evaluation

click node_sales_data "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/Superstore.csv"
click node_notebook "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_preparation "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_time_analysis "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_category_analysis "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_discount_analysis "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_business_findings "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_profit_model "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"
click node_model_evaluation "https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb"

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_data toneBlue
class node_notebook,node_preparation,node_time_analysis,node_category_analysis,node_discount_analysis,node_business_findings toneAmber
class node_profit_model,node_model_evaluation toneMint
class node_analyst toneIndigo
```

## Components

### Data

- [Superstore sales](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/Superstore.csv): `Superstore.csv`

### Exploratory analysis

- [Analysis notebook](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [Data preparation](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [Time trends](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [Category profitability](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [Discount analysis](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [Business findings](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`

### Profit prediction

- [Random Forest](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`
- [MAE evaluation](https://github.com/volkan35koc/supermarket-sales-and-profitability-performance-analysis/blob/main/superstore.ipynb): `superstore.ipynb`

### Other components

- **Analyst**

## Connections

- Analyst → Analysis notebook: runs (evidence: `README.md`)
- Superstore sales → Data preparation: provides data (evidence: `README.md`)
- Analysis notebook → Data preparation: performs (evidence: `README.md`)
- Data preparation → Time trends: enables (evidence: `README.md`)
- Data preparation → Category profitability: enables (evidence: `README.md`)
- Data preparation → Discount analysis: enables (evidence: `README.md`)
- Time trends → Business findings: identifies trends (evidence: `README.md`)
- Category profitability → Business findings: identifies losses (evidence: `README.md`)
- Discount analysis → Business findings: reveals impact (evidence: `README.md`)
- Data preparation → Random Forest: supplies features (evidence: `README.md`)
- Random Forest → MAE evaluation: evaluated by (evidence: `README.md`)
