# akshatugale/mlopps_telecomm_customer_churnpredictionmodel architecture

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

## Overview

This repository currently contains a small churn-data ingestion and preprocessing script, rather than the complete MLOps template described in the README. The visible runtime starts in `main.py`, reads data through `data_ingestion`, and passes it to `data_preprocessing`. The README documents later training, evaluation, prediction, API, and console capabilities, but the model modules are empty and `src/api.py` is absent from the tree; those capabilities therefore cannot be shown as implemented runtime components. Edges reflect the sampled calls or explicit README statements.

Main entry points: [`src/data_preprocessing.py`](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_preprocessing.py) (Data preprocessing), [`main.py`](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/main.py) (Pipeline entry), [`src/model_building.py`](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_building.py) (Model training), [`src/data_ingestion.py`](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_ingestion.py) (Data ingestion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Data workflow"]
  node_main["Pipeline entry<br/>[main.py]"]
  node_raw_csv["Churn CSV<br/>[churn - churn.csv]"]
  node_ingestion["Data ingestion<br/>[data_ingestion.py]"]
  node_preprocessing["Data preprocessing"]
end

subgraph group_models["Model lifecycle"]
  node_training["Model training<br/>[model_building.py]"]
  node_evaluation["Model evaluation"]
  node_prediction["Model prediction"]
end

node_user(("CLI user"))

node_user -->|"runs CLI"| node_main
node_main -->|"calls"| node_ingestion
node_main -->|"calls"| node_preprocessing
node_ingestion -->|"passes data"| node_preprocessing
node_preprocessing -.->|"precedes training"| node_training
node_preprocessing -.->|"feeds evaluation"| node_evaluation
node_training -.->|"evaluated by"| node_evaluation
node_training -.->|"supports prediction"| node_prediction

click node_main "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/main.py"
click node_raw_csv "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/data/raw/churn%20-%20churn.csv"
click node_ingestion "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_ingestion.py"
click node_preprocessing "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_preprocessing.py"
click node_training "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_building.py"
click node_evaluation "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_evaluation.py"
click node_prediction "https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_prediction.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_main,node_raw_csv,node_ingestion,node_preprocessing,node_user toneBlue
class node_training,node_evaluation,node_prediction toneAmber
```

## Components

### Data workflow

- [Pipeline entry](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/main.py): `main.py`
- [Churn CSV](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/data/raw/churn%20-%20churn.csv): `data/raw/churn - churn.csv`
- [Data ingestion](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_ingestion.py): `src/data_ingestion.py`
- [Data preprocessing](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/data_preprocessing.py): `src/data_preprocessing.py`

### Model lifecycle

- [Model training](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_building.py): `src/model_building.py`
- [Model evaluation](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_evaluation.py): `src/model_evaluation.py`
- [Model prediction](https://github.com/akshatugale/mlopps_telecomm_customer_churnpredictionmodel/blob/main/src/model_prediction.py): `src/model_prediction.py`

### Other components

- **CLI user**

## Connections

- CLI user → Pipeline entry: runs CLI (evidence: `README.md`)
- Pipeline entry → Data ingestion: calls (evidence: `main.py`)
- Pipeline entry → Data preprocessing: calls (evidence: `main.py`)
- Data ingestion → Data preprocessing: passes data (evidence: `main.py`)
- Data preprocessing → Model training: precedes training (evidence: `README.md`)
- Data preprocessing → Model evaluation: feeds evaluation (evidence: `README.md`)
- Model training → Model evaluation: evaluated by (evidence: `README.md`)
- Model training → Model prediction: supports prediction (evidence: `README.md`)
