# darshanghole7-maker/mlops_customer_prediction_model architecture

> Architecture diagram of the GitHub repository darshanghole7-maker/mlops_customer_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/darshanghole7-maker/mlops_customer_prediction_model
- Repository: https://github.com/darshanghole7-maker/mlops_customer_prediction_model

## Overview

This repository is a customer-churn ML project, but the checked-in implementation is much smaller than the README’s production-template description. The visible workflow loads a CSV and preprocesses it into train/test data; training, evaluation, and prediction modules are empty in the supplied excerpts. The README also documents a model registry, REST API, web console, and Docker services, but the API source it names is absent from the tree. Those documented capabilities are shown where their paths are supported; edges reflect only the visible calls or README workflow.

Main entry points: [`docker/docker-compose.yml`](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/docker/docker-compose.yml) (Stage services), [`src/data_ingestion.py`](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_ingestion.py) (CSV ingestion), [`data/processed`](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/tree/main/data/processed) (Train/test data), [`src/data_preprocessing.py`](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_preprocessing.py) (Data preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Data workflow"]
  node_cli["Pipeline entry<br/>[main.py]"]
  node_ingestion["CSV ingestion<br/>[data_ingestion.py]"]
  node_rawdata[("Raw churn CSV<br/>[churn - churn.csv]")]
  node_preprocess["Data preprocessing"]
  node_prepared[("Train/test data")]
end

subgraph group_modeling["Model lifecycle"]
  node_training["Model training<br/>[model_building.py]"]
  node_registry[("Model registry")]
  node_evaluation["Model evaluation"]
  node_reports[("Evaluation reports")]
  node_prediction["Prediction"]
end

subgraph group_serving["Serving"]
  node_api["REST API"]
  node_console["Web console<br/>[index.html]"]
  node_compose["Stage services<br/>[docker-compose.yml]"]
end

node_operator(("Operator"))
node_browser(("Browser"))
node_api_client(("API client"))

node_operator -->|"runs"| node_cli
node_cli -->|"calls"| node_ingestion
node_ingestion -.->|"reads"| node_rawdata
node_cli -->|"calls"| node_preprocess
node_ingestion -->|"passes data"| node_preprocess
node_preprocess -.->|"produces"| node_prepared
node_prepared -.->|"feeds"| node_training
node_training -.->|"saves model"| node_registry
node_prepared -.->|"feeds"| node_evaluation
node_registry -.->|"loads model"| node_evaluation
node_evaluation -.->|"writes metrics"| node_reports
node_registry -.->|"loads model"| node_prediction
node_browser -.->|"opens"| node_console
node_console -.->|"HTTP"| node_api
node_api_client -.->|"REST"| node_api
node_api -.->|"loads model"| node_registry
node_api -.->|"reads features"| node_prepared
node_compose -.->|"runs stage"| node_ingestion
node_compose -.->|"runs stage"| node_preprocess
node_compose -.->|"runs stage"| node_training
node_compose -.->|"runs stage"| node_evaluation

click node_cli "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/main.py"
click node_ingestion "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_ingestion.py"
click node_rawdata "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/data/raw/churn%20-%20churn.csv"
click node_preprocess "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_preprocessing.py"
click node_prepared "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/tree/main/data/processed"
click node_training "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_building.py"
click node_evaluation "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_evaluation.py"
click node_reports "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/tree/main/reports"
click node_prediction "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_prediction.py"
click node_console "https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/frontend/index.html"
click node_compose "https://github.com/darshanghole7-maker/mlops_customer_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_ingestion,node_rawdata,node_preprocess,node_prepared,node_browser,node_api_client toneBlue
class node_training,node_registry,node_evaluation,node_reports,node_prediction toneAmber
class node_api,node_console,node_compose toneMint
class node_operator toneIndigo
```

## Components

### Data workflow

- [Pipeline entry](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/main.py): `main.py`
- [CSV ingestion](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_ingestion.py): `src/data_ingestion.py`
- [Raw churn CSV](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/data/raw/churn%20-%20churn.csv): `data/raw/churn - churn.csv`
- [Data preprocessing](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/data_preprocessing.py): `src/data_preprocessing.py`
- [Train/test data](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/tree/main/data/processed): `data/processed`

### Model lifecycle

- [Model training](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_building.py): `src/model_building.py`
- **Model registry**
- [Model evaluation](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_evaluation.py): `src/model_evaluation.py`
- [Evaluation reports](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/tree/main/reports): `reports`
- [Prediction](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/src/model_prediction.py): `src/model_prediction.py`

### Serving

- **REST API**
- [Web console](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/frontend/index.html): `frontend/index.html`
- [Stage services](https://github.com/darshanghole7-maker/mlops_customer_prediction_model/blob/main/docker/docker-compose.yml): `docker/docker-compose.yml`

### Other components

- **Operator**
- **Browser**
- **API client**

## Connections

- Operator → Pipeline entry: runs (evidence: `main.py`)
- Pipeline entry → CSV ingestion: calls (evidence: `main.py`)
- CSV ingestion → Raw churn CSV: reads
- Pipeline entry → Data preprocessing: calls (evidence: `main.py`)
- CSV ingestion → Data preprocessing: passes data (evidence: `main.py`)
- Data preprocessing → Train/test data: produces (evidence: `README.md`)
- Train/test data → Model training: feeds (evidence: `README.md`)
- Model training → Model registry: saves model (evidence: `README.md`)
- Train/test data → Model evaluation: feeds (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 → Web console: opens (evidence: `README.md`)
- Web console → REST API: HTTP (evidence: `README.md`)
- API client → REST API: REST (evidence: `README.md`)
- REST API → Model registry: loads model (evidence: `README.md`)
- REST API → Train/test data: reads features (evidence: `README.md`)
- Stage services → CSV ingestion: runs stage (evidence: `README.md`)
- Stage services → Data preprocessing: runs stage (evidence: `README.md`)
- Stage services → Model training: runs stage (evidence: `README.md`)
- Stage services → Model evaluation: runs stage (evidence: `README.md`)
