# iamjyotisharma/cloudygui architecture

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

- Interactive diagram: https://gitdiagram.com/iamjyotisharma/cloudygui
- Repository: https://github.com/iamjyotisharma/cloudygui

## Overview

CloudyGUI combines a Django workload-management interface with workload generation, priority scheduling, resource allocation, and predictive autoscaling. The primary user workflow is to manage workloads through the web interface, schedule jobs against available resources, monitor resource use, and apply scaling decisions. The repository also contains a discrete-event cluster simulator. The README documents the broader product capabilities; source excerpts and the index provide only partial implementation evidence, so uncertain runtime connections are omitted.

Main entry points: [`workload_manager/services/mape_loop_service.py`](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/mape_loop_service.py) (MAPE Loop), [`src/cloudy/autoscaler/prediction_handler.py`](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/prediction_handler.py) (Prediction Handler), [`workload_manager/management/commands/run_simulation.py`](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/management/commands/run_simulation.py) (Simulation Command), [`workload_manager/views.py`](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/views.py) (Django Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Management"]
  node_web_ui["Django Interface<br/>[views.py]"]
  node_workload_api["MAPE API<br/>[views_mape.py]"]
end

subgraph group_workload["Workload Lifecycle"]
  node_workload_records[("Workload Records<br/>[models.py]")]
  node_workload_generator["Workload Generator"]
  node_scheduler["Priority Scheduler<br/>[scheduler.py]"]
  node_resource_manager["Resource Manager"]
end

subgraph group_autoscale["Predictive Autoscaling"]
  node_metrics["System Metrics<br/>[system_metrics.py]"]
  node_prediction_handler["Prediction Handler"]
  node_timeseries["Time Series Features"]
  node_resource_models["Resource Models<br/>[models.py]"]
  node_prediction_scaler["Prediction Scaler"]
  node_scaling_engine["Scaling Engine<br/>[scaling_engine.py]"]
  node_mape_loop["MAPE Loop"]
  node_cloud_provider["Cloud Provider Adapter"]
end

subgraph group_simulation["Cluster Simulation"]
  node_simulation_command["Simulation Command<br/>[run_simulation.py]"]
  node_simulation_runner["Simulation Runner"]
  node_simulation_engine["Event Simulation<br/>[__init__.py]"]
  node_control_plane["Cluster Control Plane<br/>[control_plane.py]"]
  node_cluster_model["Cluster Models"]
end

node_operator(("User"))

node_operator -->|"manages workloads"| node_web_ui
node_web_ui -.->|"manages jobs"| node_workload_records
node_workload_generator -.->|"submits workloads"| node_scheduler
node_scheduler -->|"checks resources"| node_resource_manager
node_metrics -->|"provides metrics"| node_mape_loop
node_mape_loop -->|"uses predictions"| node_prediction_scaler
node_prediction_handler -->|"uses features"| node_timeseries
node_prediction_handler -->|"uses models"| node_resource_models
node_prediction_scaler -.->|"evaluates scaling"| node_scaling_engine
node_mape_loop -->|"requests decisions"| node_scaling_engine
node_mape_loop -.->|"provisions resources"| node_cloud_provider
node_operator -->|"checks loop status"| node_workload_api
node_simulation_command -->|"runs simulation"| node_simulation_runner
node_simulation_engine -->|"simulates requests"| node_cluster_model
node_control_plane -->|"deploys replicas"| node_cluster_model
node_simulation_command -.->|"runs cluster simulation"| node_simulation_engine

click node_web_ui "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/views.py"
click node_workload_api "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/api/views_mape.py"
click node_workload_records "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/models.py"
click node_workload_generator "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/utils/workload_generator.py"
click node_scheduler "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/scheduler/scheduler.py"
click node_resource_manager "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/scheduler/resource_manager.py"
click node_metrics "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/system_metrics.py"
click node_prediction_handler "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/prediction_handler.py"
click node_timeseries "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/time_series_utils.py"
click node_resource_models "https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/models.py"
click node_prediction_scaler "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/prediction_auto_scaler.py"
click node_scaling_engine "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/scaling_engine.py"
click node_mape_loop "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/mape_loop_service.py"
click node_cloud_provider "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/mock_cloud_provider.py"
click node_simulation_command "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/management/commands/run_simulation.py"
click node_simulation_runner "https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/simulation_runner.py"
click node_simulation_engine "https://github.com/iamjyotisharma/cloudygui/blob/main/src/module/__init__.py"
click node_control_plane "https://github.com/iamjyotisharma/cloudygui/blob/main/src/policy/control_plane.py"
click node_cluster_model "https://github.com/iamjyotisharma/cloudygui/blob/main/src/model/model_components.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_web_ui,node_workload_api,node_operator toneBlue
class node_workload_records,node_workload_generator,node_scheduler,node_resource_manager toneAmber
class node_metrics,node_prediction_handler,node_timeseries,node_resource_models,node_prediction_scaler,node_scaling_engine,node_mape_loop,node_cloud_provider toneMint
class node_simulation_command,node_simulation_runner,node_simulation_engine,node_control_plane,node_cluster_model toneRose
```

## Components

### Web Management

- [Django Interface](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/views.py): `workload_manager/views.py`
- [MAPE API](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/api/views_mape.py): `workload_manager/api/views_mape.py`

### Workload Lifecycle

- [Workload Records](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/models.py): `workload_manager/models.py`
- [Workload Generator](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/utils/workload_generator.py): `src/cloudy/utils/workload_generator.py`
- [Priority Scheduler](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/scheduler/scheduler.py): `src/cloudy/scheduler/scheduler.py`
- [Resource Manager](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/scheduler/resource_manager.py): `src/cloudy/scheduler/resource_manager.py`

### Predictive Autoscaling

- [System Metrics](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/system_metrics.py): `src/cloudy/autoscaler/system_metrics.py`
- [Prediction Handler](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/prediction_handler.py): `src/cloudy/autoscaler/prediction_handler.py`
- [Time Series Features](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/time_series_utils.py): `src/cloudy/autoscaler/time_series_utils.py`
- [Resource Models](https://github.com/iamjyotisharma/cloudygui/blob/main/src/cloudy/autoscaler/models.py): `src/cloudy/autoscaler/models.py`
- [Prediction Scaler](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/prediction_auto_scaler.py): `workload_manager/services/prediction_auto_scaler.py`
- [Scaling Engine](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/scaling_engine.py): `workload_manager/services/scaling_engine.py`
- [MAPE Loop](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/mape_loop_service.py): `workload_manager/services/mape_loop_service.py`
- [Cloud Provider Adapter](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/mock_cloud_provider.py): `workload_manager/services/mock_cloud_provider.py`

### Cluster Simulation

- [Simulation Command](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/management/commands/run_simulation.py): `workload_manager/management/commands/run_simulation.py`
- [Simulation Runner](https://github.com/iamjyotisharma/cloudygui/blob/main/workload_manager/services/simulation_runner.py): `workload_manager/services/simulation_runner.py`
- [Event Simulation](https://github.com/iamjyotisharma/cloudygui/blob/main/src/module/__init__.py): `src/module/__init__.py`
- [Cluster Control Plane](https://github.com/iamjyotisharma/cloudygui/blob/main/src/policy/control_plane.py): `src/policy/control_plane.py`
- [Cluster Models](https://github.com/iamjyotisharma/cloudygui/blob/main/src/model/model_components.py): `src/model/model_components.py`

### Other components

- **User**

## Connections

- User → Django Interface: manages workloads
- Django Interface → Workload Records: manages jobs
- Workload Generator → Priority Scheduler: submits workloads
- Priority Scheduler → Resource Manager: checks resources
- System Metrics → MAPE Loop: provides metrics
- MAPE Loop → Prediction Scaler: uses predictions (evidence: `workload_manager/services/mape_loop_service.py`)
- Prediction Handler → Time Series Features: uses features (evidence: `src/cloudy/autoscaler/prediction_handler.py`)
- Prediction Handler → Resource Models: uses models (evidence: `src/cloudy/autoscaler/prediction_handler.py`)
- Prediction Scaler → Scaling Engine: evaluates scaling
- MAPE Loop → Scaling Engine: requests decisions (evidence: `workload_manager/services/mape_loop_service.py`)
- MAPE Loop → Cloud Provider Adapter: provisions resources
- User → MAPE API: checks loop status
- Simulation Command → Simulation Runner: runs simulation (evidence: `workload_manager/management/commands/run_simulation.py`)
- Event Simulation → Cluster Models: simulates requests (evidence: `src/module/__init__.py`)
- Cluster Control Plane → Cluster Models: deploys replicas (evidence: `src/policy/control_plane.py`)
- Simulation Command → Event Simulation: runs cluster simulation
