# chaitali771/mlops_telecom_customer_churnpredictionmodel architecture

> Architecture diagram of the GitHub repository chaitali771/mlops_telecom_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/chaitali771/mlops_telecom_customer_churnpredictionmodel
- Repository: https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel

## Overview

This is a telecom-customer-churn ML pipeline template. The visible runtime entry point reads the raw CSV, then cleans, splits, transforms, and resamples it; later training, evaluation, and prediction modules exist but are empty in the supplied excerpts. The README describes a broader CLI, model registry, REST API/web console, and Docker deployment, but several documented paths and capabilities are not present in the tree. Those branches are represented only where paths are supported; links rely on README documentation where source wiring is unavailable.

Main entry points: [`main.py`](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/main.py) (Pipeline entry), [`frontend/index.html`](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/frontend/index.html) (Web console), [`data/processed`](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/data/processed) (Train/test data), [`models`](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/models) (Model registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Pipeline 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["Model prediction"]
end

subgraph group_serving["Serving interface"]
  node_frontend["Web console<br/>[index.html]"]
  node_styles["Console styling<br/>[style.css]"]
  node_api["REST API"]
end

subgraph group_configuration["Configuration and state"]
  node_rawdata[("Raw churn CSV<br/>[churn.csv]")]
  node_splitdata[("Train/test data")]
  node_models[("Model registry")]
  node_reports[("Evaluation reports")]
  node_config["Pipeline config<br/>[config.yaml]"]
end

subgraph group_deployment["Deployment"]
  node_docker["Container services<br/>[docker-compose.yml]"]
end

node_user(("CLI user"))
node_browser(("Browser user"))
node_api_client(("API client"))

node_user -->|"runs"| node_cli
node_cli -->|"calls"| node_ingest
node_ingest -->|"reads"| node_rawdata
node_cli -->|"calls"| node_preprocess
node_preprocess -.->|"produces"| node_splitdata
node_splitdata -.->|"trains from"| node_train
node_train -.->|"saves model"| node_models
node_splitdata -.->|"evaluates data"| node_evaluate
node_models -.->|"evaluates model"| node_evaluate
node_evaluate -.->|"writes metrics"| node_reports
node_models -.->|"loads model"| node_predict
node_config -.->|"configures"| node_cli
node_browser -->|"opens"| node_frontend
node_frontend -.->|"HTTP requests"| node_api
node_api_client -.->|"REST requests"| node_api
node_docker -.->|"runs stages"| node_cli
node_frontend -->|"uses styles"| node_styles

click node_cli "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/main.py"
click node_ingest "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/src/data_ingestion.py"
click node_rawdata "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/data/raw/churn.csv"
click node_preprocess "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/src/data_preprocessing.py"
click node_splitdata "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/data/processed"
click node_train "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/src/model_building.py"
click node_models "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/models"
click node_evaluate "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/src/model_evaluation.py"
click node_reports "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/reports"
click node_predict "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/src/model_prediction.py"
click node_config "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/config.yaml"
click node_frontend "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/frontend/index.html"
click node_styles "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/frontend/css/style.css"
click node_api "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/src"
click node_docker "https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/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_user,node_browser,node_api_client toneBlue
class node_frontend,node_styles,node_api toneAmber
class node_rawdata,node_splitdata,node_models,node_reports,node_config toneMint
class node_docker toneRose
```

## Components

### Pipeline workflow

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

### Serving interface

- [Web console](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/frontend/index.html): `frontend/index.html`
- [Console styling](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/frontend/css/style.css): `frontend/css/style.css`
- [REST API](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/src): `src`

### Configuration and state

- [Raw churn CSV](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/data/raw/churn.csv): `data/raw/churn.csv`
- [Train/test data](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/data/processed): `data/processed`
- [Model registry](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/models): `models`
- [Evaluation reports](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/tree/main/reports): `reports`
- [Pipeline config](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/config.yaml): `config.yaml`

### Deployment

- [Container services](https://github.com/chaitali771/mlops_telecom_customer_churnpredictionmodel/blob/main/docker/docker-compose.yml): `docker/docker-compose.yml`

### Other components

- **CLI user**
- **Browser user**
- **API client**

## Connections

- CLI user → Pipeline entry: runs (evidence: `README.md`)
- Pipeline entry → Data ingestion: calls (evidence: `main.py`)
- Data ingestion → Raw churn CSV: reads (evidence: `src/data_ingestion.py`)
- Pipeline entry → Preprocessing: calls (evidence: `main.py`)
- Preprocessing → Train/test data: produces (evidence: `README.md`)
- Train/test data → Model training: trains from (evidence: `README.md`)
- Model training → Model registry: saves model (evidence: `README.md`)
- Train/test data → Model evaluation: evaluates data (evidence: `README.md`)
- Model registry → Model evaluation: evaluates model (evidence: `README.md`)
- Model evaluation → Evaluation reports: writes metrics (evidence: `README.md`)
- Model registry → Model prediction: loads model (evidence: `README.md`)
- Pipeline config → Pipeline entry: configures (evidence: `README.md`)
- Browser user → Web console: opens (evidence: `README.md`)
- Web console → REST API: HTTP requests (evidence: `README.md`)
- API client → REST API: REST requests (evidence: `README.md`)
- Container services → Pipeline entry: runs stages (evidence: `README.md`)
- Web console → Console styling: uses styles (evidence: `README.md`)
