# qurbanovkenan77-tech/online-retail-analysis architecture

> Architecture diagram of the GitHub repository qurbanovkenan77-tech/online-retail-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/qurbanovkenan77-tech/online-retail-analysis
- Repository: https://github.com/qurbanovkenan77-tech/online-retail-analysis

## Overview

Online Retail Merchandise Analysis is a command-line data-analysis application. Its main workflow reads an Excel workbook, cleans and reconciles merchandise rows, computes overall and grouped metrics plus duplicate sensitivity, then writes CSV summaries, charts, and run metadata. The documented capabilities include product, country, monthly, and customer analysis, excluded-entry and cleaning audits, and large-line reporting. The graph distinguishes these domain stages while grouping modules by responsibility; unsampled implementation details are represented only where the README documents them.

Main entry points: [`retail_analysis/analysis.py`](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py) (Analysis Builder), [`retail_analysis/__main__.py`](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py) (CLI Runner), [`retail_analysis/data.py`](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py) (Row Cleaning), [`retail_analysis/charts.py`](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/charts.py) (Chart Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingestion["Input and Cleaning"]
  node_cli["CLI Runner<br/>[__main__.py]"]
  node_workbook["Workbook Reader<br/>[data.py]"]
  node_row_cleaning["Row Cleaning<br/>[data.py]"]
  node_cleaning_audit["Cleaning Audit<br/>[data.py]"]
  node_excluded_entries["Excluded Entries<br/>[data.py]"]
end

subgraph group_analysis["Merchandise Analysis"]
  node_analysis_builder["Analysis Builder<br/>[analysis.py]"]
  node_overall_metrics["Overall Metrics<br/>[analysis.py]"]
  node_product_metrics["Product Summary<br/>[analysis.py]"]
  node_country_metrics["Country Summary<br/>[analysis.py]"]
  node_monthly_metrics["Monthly Summary<br/>[analysis.py]"]
  node_customer_metrics["Customer Summary<br/>[analysis.py]"]
  node_duplicate_sensitivity["Duplicate Sensitivity<br/>[analysis.py]"]
  node_large_lines["Large Value Lines<br/>[analysis.py]"]
end

subgraph group_outputs["Reports and Charts"]
  node_csv_exports["CSV Reports<br/>[__main__.py]"]
  node_chart_builder["Chart Builder<br/>[charts.py]"]
  node_chart_files["PNG Charts<br/>[charts.py]"]
  node_metadata["Run Metadata<br/>[__main__.py]"]
end

node_user(("Analyst"))

node_user -->|"runs command"| node_cli
node_cli -->|"reads workbook"| node_workbook
node_cli -->|"cleans rows"| node_row_cleaning
node_row_cleaning -->|"records audit"| node_cleaning_audit
node_row_cleaning -->|"summarizes exclusions"| node_excluded_entries
node_cli -->|"builds analysis"| node_analysis_builder
node_analysis_builder -->|"calculates"| node_overall_metrics
node_analysis_builder -->|"groups products"| node_product_metrics
node_analysis_builder -->|"groups countries"| node_country_metrics
node_analysis_builder -->|"groups months"| node_monthly_metrics
node_analysis_builder -->|"summarizes customers"| node_customer_metrics
node_analysis_builder -->|"compares duplicates"| node_duplicate_sensitivity
node_analysis_builder -->|"selects large lines"| node_large_lines
node_cli -->|"exports tables"| node_csv_exports
node_cli -->|"creates charts"| node_chart_builder
node_chart_builder -->|"writes charts"| node_chart_files
node_cli -->|"writes metadata"| node_metadata

click node_cli "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py"
click node_workbook "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py"
click node_row_cleaning "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py"
click node_cleaning_audit "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py"
click node_excluded_entries "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py"
click node_analysis_builder "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_overall_metrics "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_product_metrics "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_country_metrics "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_monthly_metrics "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_customer_metrics "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_duplicate_sensitivity "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_large_lines "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py"
click node_csv_exports "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py"
click node_chart_builder "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/charts.py"
click node_chart_files "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/charts.py"
click node_metadata "https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.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_cli,node_workbook,node_row_cleaning,node_cleaning_audit,node_excluded_entries toneBlue
class node_analysis_builder,node_overall_metrics,node_product_metrics,node_country_metrics,node_monthly_metrics,node_customer_metrics,node_duplicate_sensitivity,node_large_lines toneAmber
class node_csv_exports,node_chart_builder,node_chart_files,node_metadata toneMint
class node_user toneIndigo
```

## Components

### Input and Cleaning

- [CLI Runner](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py): `retail_analysis/__main__.py`
- [Workbook Reader](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py): `retail_analysis/data.py`
- [Row Cleaning](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py): `retail_analysis/data.py`
- [Cleaning Audit](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py): `retail_analysis/data.py`
- [Excluded Entries](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/data.py): `retail_analysis/data.py`

### Merchandise Analysis

- [Analysis Builder](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Overall Metrics](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Product Summary](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Country Summary](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Monthly Summary](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Customer Summary](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Duplicate Sensitivity](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`
- [Large Value Lines](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/analysis.py): `retail_analysis/analysis.py`

### Reports and Charts

- [CSV Reports](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py): `retail_analysis/__main__.py`
- [Chart Builder](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/charts.py): `retail_analysis/charts.py`
- [PNG Charts](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/charts.py): `retail_analysis/charts.py`
- [Run Metadata](https://github.com/qurbanovkenan77-tech/online-retail-analysis/blob/main/retail_analysis/__main__.py): `retail_analysis/__main__.py`

### Other components

- **Analyst**

## Connections

- Analyst → CLI Runner: runs command (evidence: `README.md`)
- CLI Runner → Workbook Reader: reads workbook (evidence: `retail_analysis/__main__.py`)
- CLI Runner → Row Cleaning: cleans rows (evidence: `retail_analysis/__main__.py`)
- Row Cleaning → Cleaning Audit: records audit (evidence: `retail_analysis/data.py`)
- Row Cleaning → Excluded Entries: summarizes exclusions (evidence: `retail_analysis/data.py`)
- CLI Runner → Analysis Builder: builds analysis (evidence: `retail_analysis/__main__.py`)
- Analysis Builder → Overall Metrics: calculates (evidence: `retail_analysis/analysis.py`)
- Analysis Builder → Product Summary: groups products (evidence: `retail_analysis/analysis.py`)
- Analysis Builder → Country Summary: groups countries (evidence: `retail_analysis/analysis.py`)
- Analysis Builder → Monthly Summary: groups months (evidence: `retail_analysis/analysis.py`)
- Analysis Builder → Customer Summary: summarizes customers (evidence: `retail_analysis/analysis.py`)
- Analysis Builder → Duplicate Sensitivity: compares duplicates (evidence: `README.md`)
- Analysis Builder → Large Value Lines: selects large lines (evidence: `README.md`)
- CLI Runner → CSV Reports: exports tables (evidence: `retail_analysis/__main__.py`)
- CLI Runner → Chart Builder: creates charts (evidence: `retail_analysis/__main__.py`)
- Chart Builder → PNG Charts: writes charts (evidence: `retail_analysis/charts.py`)
- CLI Runner → Run Metadata: writes metadata (evidence: `retail_analysis/__main__.py`)
