# najlaalhusaini/telchochurn-datamining architecture

> Architecture diagram of the GitHub repository najlaalhusaini/telchochurn-datamining, 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/najlaalhusaini/telchochurn-datamining
- Repository: https://github.com/najlaalhusaini/telchochurn-datamining

## Overview

This is a notebook-based telecom churn data-mining project, not a deployed application. Its documented workflow moves from data collection through preprocessing and feature analysis to classification, clustering, evaluation, and performance comparison. The README does not map those stages to individual notebooks, so workflow nodes use the existing Source Code directory rather than assigning responsibilities to particular phases. Relationships shown are documented workflow order; notebook internals were not available for inspection.

Main entry points: [`DataSet/Raw_dataset.csv`](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/DataSet/Raw_dataset.csv) (Raw customer data), [`Source Code`](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code) (Data preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_raw_data["Raw customer data<br/>[Raw_dataset.csv]"]
  node_preprocessing["Data preprocessing"]
  node_preprocessed_data["Prepared customer data"]
  node_phase1["Phase 1 notebook<br/>[Phase1.ipynb]"]
end

subgraph group_analysis["Modeling and analysis"]
  node_feature_analysis["Feature analysis"]
  node_classification["Churn classification"]
  node_clustering["Customer clustering"]
  node_phase2["Phase 2 notebook<br/>[Phase2.ipynb]"]
end

subgraph group_results["Evaluation"]
  node_evaluation["Model evaluation"]
  node_comparison["Performance comparison"]
  node_phase3["Phase 3 notebook<br/>[Phase3.ipynb]"]
end

node_analyst(("Project analyst"))

node_analyst -->|"provides data"| node_raw_data
node_raw_data -->|"collects then prepares"| node_preprocessing
node_preprocessing -->|"precedes"| node_feature_analysis
node_feature_analysis -->|"precedes"| node_classification
node_classification -->|"precedes"| node_clustering
node_clustering -->|"precedes"| node_evaluation
node_evaluation -->|"precedes"| node_comparison

click node_raw_data "https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/DataSet/Raw_dataset.csv"
click node_preprocessing "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_feature_analysis "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_classification "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_clustering "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_preprocessed_data "https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/DataSet/Preprocessed_dataset%20(1).csv"
click node_evaluation "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_comparison "https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code"
click node_phase1 "https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase1.ipynb"
click node_phase2 "https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase2.ipynb"
click node_phase3 "https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase3.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_raw_data,node_preprocessing,node_preprocessed_data,node_phase1 toneBlue
class node_feature_analysis,node_classification,node_clustering,node_phase2 toneAmber
class node_evaluation,node_comparison,node_phase3 toneMint
class node_analyst toneIndigo
```

## Components

### Data preparation

- [Raw customer data](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/DataSet/Raw_dataset.csv): `DataSet/Raw_dataset.csv`
- [Data preprocessing](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Prepared customer data](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/DataSet/Preprocessed_dataset%20(1).csv): `DataSet/Preprocessed_dataset (1).csv`
- [Phase 1 notebook](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase1.ipynb): `Source Code/Phase1.ipynb`

### Modeling and analysis

- [Feature analysis](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Churn classification](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Customer clustering](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Phase 2 notebook](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase2.ipynb): `Source Code/Phase2.ipynb`

### Evaluation

- [Model evaluation](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Performance comparison](https://github.com/najlaalhusaini/telchochurn-datamining/tree/main/Source%20Code): `Source Code`
- [Phase 3 notebook](https://github.com/najlaalhusaini/telchochurn-datamining/blob/main/Source%20Code/Phase3.ipynb): `Source Code/Phase3.ipynb`

### Other components

- **Project analyst**

## Connections

- Project analyst → Raw customer data: provides data (evidence: `README.md`)
- Raw customer data → Data preprocessing: collects then prepares (evidence: `README.md`)
- Data preprocessing → Feature analysis: precedes (evidence: `README.md`)
- Feature analysis → Churn classification: precedes (evidence: `README.md`)
- Churn classification → Customer clustering: precedes (evidence: `README.md`)
- Customer clustering → Model evaluation: precedes (evidence: `README.md`)
- Model evaluation → Performance comparison: precedes (evidence: `README.md`)
