# ravirathodnenavath/bank-customer-churn-prediction architecture

> Architecture diagram of the GitHub repository ravirathodnenavath/bank-customer-churn-prediction, 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/ravirathodnenavath/bank-customer-churn-prediction
- Repository: https://github.com/ravirathodnenavath/bank-customer-churn-prediction

## Overview

This repository is a customer-churn analysis notebook. Its documented workflow loads bank customer data, cleans and engineers features, handles class imbalance and outliers, and scales features; it also explores churn patterns, trains and tunes several classifiers, then evaluates them. The README identifies Random Forest as the best-performing final model. The tree contains only the notebook, and no source excerpts were provided, so component paths point to main.ipynb and relationships are limited to those documented in the README.

Main entry points: [`main.ipynb`](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb) (Preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Data Preparation"]
  node_preprocessing["Preprocessing<br/>[main.ipynb]"]
end

subgraph group_analysis["Churn Analysis"]
  node_eda["Exploratory Analysis<br/>[main.ipynb]"]
  node_findings["Churn Findings<br/>[main.ipynb]"]
end

subgraph group_modeling["Modeling and Evaluation"]
  node_training["Model Training<br/>[main.ipynb]"]
  node_tuning["Hyperparameter Tuning<br/>[main.ipynb]"]
  node_evaluation["Model Evaluation<br/>[main.ipynb]"]
end

node_analyst(("Analyst"))
node_customer_data["Customer Data"]

node_analyst -->|"provides data"| node_customer_data
node_customer_data -->|"loads and cleans"| node_preprocessing
node_preprocessing -->|"supports exploration"| node_eda
node_preprocessing -->|"provides features"| node_training
node_eda -->|"identifies patterns"| node_findings
node_training -->|"tunes models"| node_tuning
node_tuning -->|"evaluates models"| node_evaluation
node_evaluation -->|"reports performance"| node_findings

click node_preprocessing "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb"
click node_eda "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb"
click node_training "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb"
click node_tuning "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb"
click node_evaluation "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb"
click node_findings "https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.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_preprocessing toneBlue
class node_eda,node_findings toneAmber
class node_training,node_tuning,node_evaluation toneMint
class node_analyst,node_customer_data toneIndigo
```

## Components

### Data Preparation

- [Preprocessing](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`

### Churn Analysis

- [Exploratory Analysis](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`
- [Churn Findings](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`

### Modeling and Evaluation

- [Model Training](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`
- [Hyperparameter Tuning](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`
- [Model Evaluation](https://github.com/ravirathodnenavath/bank-customer-churn-prediction/blob/main/main.ipynb): `main.ipynb`

### Other components

- **Analyst**
- **Customer Data**

## Connections

- Analyst → Customer Data: provides data (evidence: `README.md`)
- Customer Data → Preprocessing: loads and cleans (evidence: `README.md`)
- Preprocessing → Exploratory Analysis: supports exploration (evidence: `README.md`)
- Preprocessing → Model Training: provides features (evidence: `README.md`)
- Exploratory Analysis → Churn Findings: identifies patterns (evidence: `README.md`)
- Model Training → Hyperparameter Tuning: tunes models (evidence: `README.md`)
- Hyperparameter Tuning → Model Evaluation: evaluates models (evidence: `README.md`)
- Model Evaluation → Churn Findings: reports performance (evidence: `README.md`)
