# manojbamniya/customer_segmentation_recommendation architecture

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

- Interactive diagram: https://gitdiagram.com/manojbamniya/customer_segmentation_recommendation
- Repository: https://github.com/manojbamniya/customer_segmentation_recommendation

## Overview

This notebook-based project turns UK online-retail transactions into customer segments, then recommends popular products that customers in each segment have not bought. The README documents the workflow, but no notebook source was provided, so the graph shows only those documented stages and does not infer their internal implementation.

Main entry points: [`Customer_Segmentation_Recommendation_System.ipynb`](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb) (Segment recommendations), [`customer.csv`](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/customer.csv) (Retail transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data_prep["Customer data"]
  node_retail_transactions[("Retail transactions<br/>[customer.csv]")]
  node_feature_engineering["Customer features"]
end

subgraph group_segmentation["Segmentation"]
  node_kmeans["K-means segments"]
end

subgraph group_recommendations["Recommendations"]
  node_product_recommender["Segment recommendations"]
end

node_marketing(("Marketing user"))

node_retail_transactions -->|"provides transactions"| node_feature_engineering
node_feature_engineering -->|"supplies customer features"| node_kmeans
node_kmeans -->|"defines segments"| node_product_recommender
node_retail_transactions -->|"informs product popularity"| node_product_recommender
node_product_recommender -->|"suggests products"| node_marketing

click node_retail_transactions "https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/customer.csv"
click node_feature_engineering "https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb"
click node_kmeans "https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb"
click node_product_recommender "https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.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_retail_transactions,node_feature_engineering,node_marketing toneBlue
class node_kmeans toneAmber
class node_product_recommender toneMint
```

## Components

### Customer data

- [Retail transactions](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/customer.csv): `customer.csv`
- [Customer features](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb): `Customer_Segmentation_Recommendation_System.ipynb`

### Segmentation

- [K-means segments](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb): `Customer_Segmentation_Recommendation_System.ipynb`

### Recommendations

- [Segment recommendations](https://github.com/manojbamniya/customer_segmentation_recommendation/blob/main/Customer_Segmentation_Recommendation_System.ipynb): `Customer_Segmentation_Recommendation_System.ipynb`

### Other components

- **Marketing user**

## Connections

- Retail transactions → Customer features: provides transactions (evidence: `README.md`)
- Customer features → K-means segments: supplies customer features (evidence: `README.md`)
- K-means segments → Segment recommendations: defines segments (evidence: `README.md`)
- Retail transactions → Segment recommendations: informs product popularity (evidence: `README.md`)
- Segment recommendations → Marketing user: suggests products (evidence: `README.md`)
