# shashank975/ml_productionready_project architecture

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

- Interactive diagram: https://gitdiagram.com/shashank975/ml_productionready_project
- Repository: https://github.com/shashank975/ml_productionready_project

## Overview

US Visa Classification is an ML decision-support application: an operator can launch model training, while a user submits application attributes for an approval/denial prediction. Training orchestrates ingestion, validation, transformation, training, evaluation, and conditional model publishing; prediction loads the published model and applies its preprocessing. The graph reflects README capabilities and indexed imports; unsampled implementation details and web-template wiring are not inferred.

Main entry points: [`US_visa/pipline/training_pipeline.py`](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/pipline/training_pipeline.py) (Training orchestrator), [`US_visa/utils/main_utils.py`](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/utils/main_utils.py) (ML utilities), [`app.py`](https://github.com/shashank975/ml_productionready_project/blob/main/app.py) (Web app), [`US_visa/components/data_ingestion.py`](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_ingestion.py) (Data ingestion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application"]
  node_app["Web app<br/>[app.py]"]
end

subgraph group_training["Model training"]
  node_training_pipeline["Training orchestrator"]
  node_ingestion["Data ingestion<br/>[data_ingestion.py]"]
  node_validation["Data validation<br/>[data_validation.py]"]
  node_transformation["Feature transformation"]
  node_trainer["Model trainer<br/>[model_trainer.py]"]
  node_evaluation["Model evaluation"]
  node_pusher["Model publisher<br/>[model_pusher.py]"]
end

subgraph group_serving["Prediction serving"]
  node_predictor["Prediction pipeline"]
  node_estimator["S3 estimator<br/>[s3_estimator.py]"]
  node_model["Model and preprocessing<br/>[estimator.py]"]
end

subgraph group_infrastructure["Data and model infrastructure"]
  node_mongo_access["Visa data access<br/>[usvisa_data.py]"]
  node_mongo_config["Mongo connection"]
  node_mongo[("MongoDB")]
  node_storage["S3 storage<br/>[aws_storage.py]"]
  node_aws_config["AWS connection<br/>[aws_connection.py]"]
  node_aws[("AWS S3")]
  node_artifacts["Stage artifacts<br/>[artifact_entity.py]"]
  node_configuration["Pipeline configuration<br/>[config_entity.py]"]
  node_utilities["ML utilities<br/>[main_utils.py]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_app
node_app -->|"starts training"| node_training_pipeline
node_app -->|"requests prediction"| node_predictor
node_training_pipeline -->|"runs ingestion"| node_ingestion
node_training_pipeline -->|"runs validation"| node_validation
node_training_pipeline -->|"runs transformation"| node_transformation
node_training_pipeline -->|"runs training"| node_trainer
node_training_pipeline -->|"runs evaluation"| node_evaluation
node_training_pipeline -->|"publishes accepted model"| node_pusher
node_training_pipeline -->|"passes stage results"| node_artifacts
node_ingestion -->|"exports collection"| node_mongo_access
node_mongo_access -->|"uses connection"| node_mongo_config
node_mongo_config -->|"connects to"| node_mongo
node_predictor -->|"loads and predicts"| node_estimator
node_estimator -->|"loads model"| node_storage
node_estimator -->|"predicts with"| node_model
node_pusher -->|"uploads model"| node_storage
node_storage -->|"creates client"| node_aws_config
node_aws_config -.->|"connects to"| node_aws
node_ingestion -->|"uses settings"| node_configuration
node_validation -->|"uses helpers"| node_utilities
node_transformation -->|"uses helpers"| node_utilities
node_trainer -->|"uses helpers"| node_utilities
node_predictor -->|"loads YAML"| node_utilities

click node_app "https://github.com/shashank975/ml_productionready_project/blob/main/app.py"
click node_training_pipeline "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/pipline/training_pipeline.py"
click node_ingestion "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_ingestion.py"
click node_validation "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_validation.py"
click node_transformation "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_transformation.py"
click node_trainer "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_trainer.py"
click node_evaluation "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_evaluation.py"
click node_pusher "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_pusher.py"
click node_predictor "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/pipline/prediction_pipeline.py"
click node_estimator "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/s3_estimator.py"
click node_model "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/estimator.py"
click node_mongo_access "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/data_access/usvisa_data.py"
click node_mongo_config "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/configuration/mongo_db_connection.py"
click node_storage "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/cloud_storage/aws_storage.py"
click node_aws_config "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/configuration/aws_connection.py"
click node_artifacts "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/artifact_entity.py"
click node_configuration "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/config_entity.py"
click node_utilities "https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/utils/main_utils.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_app toneBlue
class node_training_pipeline,node_ingestion,node_validation,node_transformation,node_trainer,node_evaluation,node_pusher toneAmber
class node_predictor,node_estimator,node_model toneMint
class node_mongo_access,node_mongo_config,node_mongo,node_storage,node_aws_config,node_aws,node_artifacts,node_configuration,node_utilities toneRose
class node_operator toneIndigo
```

## Components

### Application

- [Web app](https://github.com/shashank975/ml_productionready_project/blob/main/app.py): `app.py`

### Model training

- [Training orchestrator](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/pipline/training_pipeline.py): `US_visa/pipline/training_pipeline.py`
- [Data ingestion](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_ingestion.py): `US_visa/components/data_ingestion.py`
- [Data validation](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_validation.py): `US_visa/components/data_validation.py`
- [Feature transformation](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/data_transformation.py): `US_visa/components/data_transformation.py`
- [Model trainer](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_trainer.py): `US_visa/components/model_trainer.py`
- [Model evaluation](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_evaluation.py): `US_visa/components/model_evaluation.py`
- [Model publisher](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/components/model_pusher.py): `US_visa/components/model_pusher.py`

### Prediction serving

- [Prediction pipeline](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/pipline/prediction_pipeline.py): `US_visa/pipline/prediction_pipeline.py`
- [S3 estimator](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/s3_estimator.py): `US_visa/entity/s3_estimator.py`
- [Model and preprocessing](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/estimator.py): `US_visa/entity/estimator.py`

### Data and model infrastructure

- [Visa data access](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/data_access/usvisa_data.py): `US_visa/data_access/usvisa_data.py`
- [Mongo connection](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/configuration/mongo_db_connection.py): `US_visa/configuration/mongo_db_connection.py`
- **MongoDB**
- [S3 storage](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/cloud_storage/aws_storage.py): `US_visa/cloud_storage/aws_storage.py`
- [AWS connection](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/configuration/aws_connection.py): `US_visa/configuration/aws_connection.py`
- **AWS S3**
- [Stage artifacts](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/artifact_entity.py): `US_visa/entity/artifact_entity.py`
- [Pipeline configuration](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/entity/config_entity.py): `US_visa/entity/config_entity.py`
- [ML utilities](https://github.com/shashank975/ml_productionready_project/blob/main/US_visa/utils/main_utils.py): `US_visa/utils/main_utils.py`

### Other components

- **Operator**

## Connections

- Operator → Web app: uses (evidence: `README.md`)
- Web app → Training orchestrator: starts training (evidence: `app.py`)
- Web app → Prediction pipeline: requests prediction (evidence: `app.py`)
- Training orchestrator → Data ingestion: runs ingestion (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Data validation: runs validation (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Feature transformation: runs transformation (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Model trainer: runs training (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Model evaluation: runs evaluation (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Model publisher: publishes accepted model (evidence: `US_visa/pipline/training_pipeline.py`)
- Training orchestrator → Stage artifacts: passes stage results (evidence: `US_visa/pipline/training_pipeline.py`)
- Data ingestion → Visa data access: exports collection (evidence: `US_visa/components/data_ingestion.py`)
- Visa data access → Mongo connection: uses connection (evidence: `US_visa/data_access/usvisa_data.py`)
- Mongo connection → MongoDB: connects to (evidence: `US_visa/configuration/mongo_db_connection.py`)
- Prediction pipeline → S3 estimator: loads and predicts (evidence: `US_visa/pipline/prediction_pipeline.py`)
- S3 estimator → S3 storage: loads model (evidence: `US_visa/entity/s3_estimator.py`)
- S3 estimator → Model and preprocessing: predicts with (evidence: `US_visa/entity/s3_estimator.py`)
- Model publisher → S3 storage: uploads model (evidence: `US_visa/components/model_pusher.py`)
- S3 storage → AWS connection: creates client (evidence: `US_visa/cloud_storage/aws_storage.py`)
- AWS connection → AWS S3: connects to (evidence: `US_visa/configuration/aws_connection.py`)
- Data ingestion → Pipeline configuration: uses settings (evidence: `US_visa/components/data_ingestion.py`)
- Data validation → ML utilities: uses helpers (evidence: `US_visa/components/data_validation.py`)
- Feature transformation → ML utilities: uses helpers (evidence: `US_visa/components/data_transformation.py`)
- Model trainer → ML utilities: uses helpers (evidence: `US_visa/components/model_trainer.py`)
- Prediction pipeline → ML utilities: loads YAML (evidence: `US_visa/pipline/prediction_pipeline.py`)
