# furalpha/de2026 architecture

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

- Interactive diagram: https://gitdiagram.com/furalpha/de2026
- Repository: https://github.com/furalpha/de2026

## Overview

DE2026 is a collection of data-engineering course labs, not one integrated application. Lab0 demonstrates Flask client/server and form-based UI patterns; Lab1 covers VM/Bash exercises and a small JSON data processor. Lab2 contains a diabetes-model training API and prediction UI/API. The clearest end-to-end workflow is form submission through the prediction UI to the prediction service and model; training is a separate API workflow. Edges reflect shown calls or explicit source references; unsampled Lab2 infrastructure is not connected speculatively.

Main entry points: [`lab2/prediction-ui/app.py`](https://github.com/furalpha/de2026/blob/main/lab2/prediction-ui/app.py) (Prediction UI), [`lab0/flask-ui-example/app.py`](https://github.com/furalpha/de2026/blob/main/lab0/flask-ui-example/app.py) (Form UI), [`lab2/prediction-api/app.py`](https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/app.py) (Prediction API), [`lab2/prediction-api/diabetes_predictor.py`](https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/diabetes_predictor.py) (Diabetes Predictor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lab0["Lab 0 Demos"]
  node_hello_client["Hello Client<br/>[client.py]"]
  node_hello_server["Hello Server<br/>[app.py]"]
  node_form_ui["Form UI<br/>[app.py]"]
  node_form_templates["Form Templates"]
end

subgraph group_lab1["Lab 1 Exercises"]
  node_bash_exercises["Bash Exercises"]
  node_data_processor["JSON Processor"]
end

subgraph group_lab2["Lab 2 ML Services"]
  node_prediction_ui["Prediction UI<br/>[app.py]"]
  node_prediction_pages["Prediction Pages"]
  node_prediction_api["Prediction API<br/>[app.py]"]
  node_predictor["Diabetes Predictor"]
  node_prediction_model[("Local Model File<br/>[model.pkl]")]
  node_training_api["Training API<br/>[app.py]"]
  node_model_trainer["Model Trainer<br/>[model_trainer.py]"]
end

node_learner(("Learner"))
node_learner_data(("Learner"))

node_hello_client -->|"requests"| node_hello_server
node_learner -.->|"submits form"| node_form_ui
node_form_ui -->|"renders"| node_form_templates
node_learner -.->|"submits form"| node_prediction_ui
node_prediction_ui -->|"posts prediction"| node_prediction_api
node_prediction_ui -.->|"renders"| node_prediction_pages
node_prediction_api -->|"calls"| node_predictor
node_predictor -->|"loads locally"| node_prediction_model
node_learner_data -.->|"posts data"| node_training_api
node_training_api -->|"calls"| node_model_trainer

click node_hello_client "https://github.com/furalpha/de2026/blob/main/lab0/helloworld-client/client.py"
click node_hello_server "https://github.com/furalpha/de2026/blob/main/lab0/flask-helloworld/app.py"
click node_form_ui "https://github.com/furalpha/de2026/blob/main/lab0/flask-ui-example/app.py"
click node_form_templates "https://github.com/furalpha/de2026/tree/main/lab0/flask-ui-example/templates"
click node_bash_exercises "https://github.com/furalpha/de2026/tree/main/lab1"
click node_data_processor "https://github.com/furalpha/de2026/blob/main/lab1/unit-test-example/src/simple_data_processor.py"
click node_prediction_ui "https://github.com/furalpha/de2026/blob/main/lab2/prediction-ui/app.py"
click node_prediction_pages "https://github.com/furalpha/de2026/tree/main/lab2/prediction-ui/templates"
click node_prediction_api "https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/app.py"
click node_predictor "https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/diabetes_predictor.py"
click node_prediction_model "https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/model.pkl"
click node_training_api "https://github.com/furalpha/de2026/blob/main/lab2/training-api/app.py"
click node_model_trainer "https://github.com/furalpha/de2026/blob/main/lab2/training-api/resources/model_trainer.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_hello_client,node_hello_server,node_form_ui,node_form_templates toneBlue
class node_bash_exercises,node_data_processor toneAmber
class node_prediction_ui,node_prediction_pages,node_prediction_api,node_predictor,node_prediction_model,node_training_api,node_model_trainer toneMint
class node_learner,node_learner_data toneIndigo
```

## Components

### Lab 0 Demos

- [Hello Client](https://github.com/furalpha/de2026/blob/main/lab0/helloworld-client/client.py): `lab0/helloworld-client/client.py`
- [Hello Server](https://github.com/furalpha/de2026/blob/main/lab0/flask-helloworld/app.py): `lab0/flask-helloworld/app.py`
- [Form UI](https://github.com/furalpha/de2026/blob/main/lab0/flask-ui-example/app.py): `lab0/flask-ui-example/app.py`
- [Form Templates](https://github.com/furalpha/de2026/tree/main/lab0/flask-ui-example/templates): `lab0/flask-ui-example/templates`

### Lab 1 Exercises

- [Bash Exercises](https://github.com/furalpha/de2026/tree/main/lab1): `lab1`
- [JSON Processor](https://github.com/furalpha/de2026/blob/main/lab1/unit-test-example/src/simple_data_processor.py): `lab1/unit-test-example/src/simple_data_processor.py`

### Lab 2 ML Services

- [Prediction UI](https://github.com/furalpha/de2026/blob/main/lab2/prediction-ui/app.py): `lab2/prediction-ui/app.py`
- [Prediction Pages](https://github.com/furalpha/de2026/tree/main/lab2/prediction-ui/templates): `lab2/prediction-ui/templates`
- [Prediction API](https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/app.py): `lab2/prediction-api/app.py`
- [Diabetes Predictor](https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/diabetes_predictor.py): `lab2/prediction-api/diabetes_predictor.py`
- [Local Model File](https://github.com/furalpha/de2026/blob/main/lab2/prediction-api/model.pkl): `lab2/prediction-api/model.pkl`
- [Training API](https://github.com/furalpha/de2026/blob/main/lab2/training-api/app.py): `lab2/training-api/app.py`
- [Model Trainer](https://github.com/furalpha/de2026/blob/main/lab2/training-api/resources/model_trainer.py): `lab2/training-api/resources/model_trainer.py`

### Other components

- **Learner**
- **Learner**

## Connections

- Hello Client → Hello Server: requests (evidence: `lab0/helloworld-client/client.py`)
- Learner → Form UI: submits form
- Form UI → Form Templates: renders (evidence: `lab0/flask-ui-example/app.py`)
- Learner → Prediction UI: submits form
- Prediction UI → Prediction API: posts prediction (evidence: `lab2/prediction-ui/app.py`)
- Prediction UI → Prediction Pages: renders
- Prediction API → Diabetes Predictor: calls (evidence: `lab2/prediction-api/app.py`)
- Diabetes Predictor → Local Model File: loads locally (evidence: `lab2/prediction-api/diabetes_predictor.py`)
- Learner → Training API: posts data
- Training API → Model Trainer: calls (evidence: `lab2/training-api/app.py`)
