# hudaa0412/mlops_telecom_customer_churn_prediction_model architecture

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

- Interactive diagram: https://gitdiagram.com/hudaa0412/mlops_telecom_customer_churn_prediction_model
- Repository: https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model

## Overview

This is an incomplete, stage-oriented churn-ML template. The shown runtime starts in `main.py`, reads the raw CSV, and preprocesses it; the README documents later training, evaluation, prediction, registry, and serving capabilities. The model-stage files are present but empty in the excerpts, and the documented API module is absent from the tree, so those links reflect README claims rather than inspected implementation. The graph omits the API node because no matching source path is present.

Main entry points: [`main.py`](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/main.py) (Pipeline entry), [`src/data_ingestion.py`](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_ingestion.py) (Data ingestion), [`src/data_preprocessing.py`](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_preprocessing.py) (Preprocessing), [`data/processed`](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/data/processed) (Processed data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["ML workflow"]
  node_cli["Pipeline entry<br/>[main.py]"]
  node_ingest["Data ingestion<br/>[data_ingestion.py]"]
  node_preprocess["Preprocessing"]
  node_train["Model training<br/>[model_building.py]"]
  node_evaluate["Model evaluation"]
  node_predict["Prediction"]
end

subgraph group_state["Data and artifacts"]
  node_config["Pipeline config<br/>[config.yaml]"]
  node_raw[("Raw churn data<br/>[churn.csv]")]
  node_interim[("Interim data")]
  node_processed[("Processed data")]
  node_models[("Model registry")]
  node_reports[("Evaluation reports")]
end

subgraph group_interfaces["User interfaces"]
  node_frontend["Web console<br/>[index.html]"]
  node_docker["Container services<br/>[docker-compose.yml]"]
end

node_user(("Pipeline operator"))
node_browser(("Browser user"))

node_user -->|"runs"| node_cli
node_cli -->|"calls"| node_ingest
node_ingest -.->|"reads"| node_raw
node_ingest -.->|"writes"| node_interim
node_cli -->|"calls"| node_preprocess
node_preprocess -.->|"reads"| node_interim
node_preprocess -.->|"writes"| node_processed
node_processed -->|"reads"| node_train
node_train -->|"saves model"| node_models
node_processed -->|"reads"| node_evaluate
node_models -->|"loads model"| node_evaluate
node_evaluate -->|"writes metrics"| node_reports
node_models -->|"loads model"| node_predict
node_browser -->|"uses"| node_frontend
node_user -->|"starts services"| node_docker
node_cli -.->|"uses settings"| node_config

click node_cli "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/main.py"
click node_ingest "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_ingestion.py"
click node_preprocess "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_preprocessing.py"
click node_train "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_building.py"
click node_evaluate "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_evaluation.py"
click node_predict "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_prediction.py"
click node_config "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/config.yaml"
click node_raw "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/data/raw/churn.csv"
click node_interim "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/data/interim"
click node_processed "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/data/processed"
click node_models "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/models"
click node_reports "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/reports"
click node_frontend "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/frontend/index.html"
click node_docker "https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/docker/docker-compose.yml"

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_ingest,node_preprocess,node_train,node_evaluate,node_predict,node_browser toneBlue
class node_config,node_raw,node_interim,node_processed,node_models,node_reports toneAmber
class node_frontend,node_docker toneMint
class node_user toneIndigo
```

## Components

### ML workflow

- [Pipeline entry](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/main.py): `main.py`
- [Data ingestion](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_ingestion.py): `src/data_ingestion.py`
- [Preprocessing](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/data_preprocessing.py): `src/data_preprocessing.py`
- [Model training](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_building.py): `src/model_building.py`
- [Model evaluation](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_evaluation.py): `src/model_evaluation.py`
- [Prediction](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/src/model_prediction.py): `src/model_prediction.py`

### Data and artifacts

- [Pipeline config](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/config.yaml): `config.yaml`
- [Raw churn data](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/data/raw/churn.csv): `data/raw/churn.csv`
- [Interim data](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/data/interim): `data/interim`
- [Processed data](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/data/processed): `data/processed`
- [Model registry](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/models): `models`
- [Evaluation reports](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/tree/main/reports): `reports`

### User interfaces

- [Web console](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/frontend/index.html): `frontend/index.html`
- [Container services](https://github.com/hudaa0412/mlops_telecom_customer_churn_prediction_model/blob/main/docker/docker-compose.yml): `docker/docker-compose.yml`

### Other components

- **Pipeline operator**
- **Browser user**

## Connections

- Pipeline operator → Pipeline entry: runs (evidence: `README.md`)
- Pipeline entry → Data ingestion: calls (evidence: `main.py`)
- Data ingestion → Raw churn data: reads
- Data ingestion → Interim data: writes
- Pipeline entry → Preprocessing: calls (evidence: `main.py`)
- Preprocessing → Interim data: reads
- Preprocessing → Processed data: writes
- Processed data → Model training: reads (evidence: `README.md`)
- Model training → Model registry: saves model (evidence: `README.md`)
- Processed data → Model evaluation: reads (evidence: `README.md`)
- Model registry → Model evaluation: loads model (evidence: `README.md`)
- Model evaluation → Evaluation reports: writes metrics (evidence: `README.md`)
- Model registry → Prediction: loads model (evidence: `README.md`)
- Browser user → Web console: uses (evidence: `README.md`)
- Pipeline operator → Container services: starts services (evidence: `README.md`)
- Pipeline entry → Pipeline config: uses settings
