# aps31012005-prog/task15_end_to_end_deep_learning architecture

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

- Interactive diagram: https://gitdiagram.com/aps31012005-prog/task15_end_to_end_deep_learning
- Repository: https://github.com/aps31012005-prog/task15_end_to_end_deep_learning

## Overview

Users upload an image in the Streamlit interface, which previews it and, on request, sends it to Flask. Flask validates and preprocesses the image, runs the CIFAR-10 model, maps the highest-scoring class to a label, and returns class and confidence for display. The README also documents Docker Compose, Kubernetes, and Render deployment options. Deployment relationships below follow README descriptions; source excerpts show the application request and inference flow, but not deployment configuration contents.

Main entry points: [`flask_api.py`](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py) (Flask API), [`app.py`](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/app.py) (Streamlit UI), [`docker-compose.yml`](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/docker-compose.yml) (Docker Compose), [`kubernetes/flask-deployment.yaml`](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/flask-deployment.yaml) (Flask Kubernetes deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_streamlit["Streamlit UI<br/>[app.py]"]
end

subgraph group_inference["Prediction service"]
  node_flask["Flask API<br/>[flask_api.py]"]
  node_preprocess["Image preprocessing<br/>[flask_api.py]"]
  node_cnn["CIFAR-10 CNN<br/>[cifar10_cnn.keras]"]
  node_classify["Class and confidence<br/>[flask_api.py]"]
end

subgraph group_deployment["Deployment"]
  node_compose["Docker Compose<br/>[docker-compose.yml]"]
  node_flask_image["Flask container<br/>[Dockerfile.flask]"]
  node_streamlit_image["Streamlit container"]
  node_flask_k8s["Flask Kubernetes service<br/>[flask-service.yaml]"]
  node_flask_deploy["Flask Kubernetes deployment"]
  node_streamlit_k8s["Streamlit Kubernetes service"]
  node_streamlit_deploy["Streamlit Kubernetes deployment"]
  node_render["Render hosting"]
end

node_user(("User"))

node_user -->|"uploads image"| node_streamlit
node_streamlit -->|"POSTs image"| node_flask
node_flask -->|"preprocesses image"| node_preprocess
node_flask -->|"runs prediction"| node_cnn
node_flask -->|"maps scores"| node_classify
node_flask -->|"returns result"| node_streamlit
node_compose -->|"runs service"| node_flask_image
node_compose -->|"runs service"| node_streamlit_image
node_flask_deploy -->|"exposes pods"| node_flask_k8s
node_streamlit_deploy -->|"exposes pods"| node_streamlit_k8s
node_render -->|"hosts frontend"| node_streamlit
node_render -->|"hosts API"| node_flask

click node_streamlit "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/app.py"
click node_flask "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py"
click node_preprocess "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py"
click node_cnn "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/model/cifar10_cnn.keras"
click node_classify "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py"
click node_compose "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/docker-compose.yml"
click node_flask_image "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/Dockerfile.flask"
click node_streamlit_image "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/Dockerfile.streamlit"
click node_flask_k8s "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/flask-service.yaml"
click node_flask_deploy "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/flask-deployment.yaml"
click node_streamlit_k8s "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/streamlit-service.yaml"
click node_streamlit_deploy "https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/streamlit-deployment.yaml"

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_streamlit,node_user toneBlue
class node_flask,node_preprocess,node_cnn,node_classify toneAmber
class node_compose,node_flask_image,node_streamlit_image,node_flask_k8s,node_flask_deploy,node_streamlit_k8s,node_streamlit_deploy,node_render toneMint
```

## Components

### User interface

- [Streamlit UI](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/app.py): `app.py`

### Prediction service

- [Flask API](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py): `flask_api.py`
- [Image preprocessing](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py): `flask_api.py`
- [CIFAR-10 CNN](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/model/cifar10_cnn.keras): `model/cifar10_cnn.keras`
- [Class and confidence](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/flask_api.py): `flask_api.py`

### Deployment

- [Docker Compose](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/docker-compose.yml): `docker-compose.yml`
- [Flask container](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/Dockerfile.flask): `Dockerfile.flask`
- [Streamlit container](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/Dockerfile.streamlit): `Dockerfile.streamlit`
- [Flask Kubernetes service](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/flask-service.yaml): `kubernetes/flask-service.yaml`
- [Flask Kubernetes deployment](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/flask-deployment.yaml): `kubernetes/flask-deployment.yaml`
- [Streamlit Kubernetes service](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/streamlit-service.yaml): `kubernetes/streamlit-service.yaml`
- [Streamlit Kubernetes deployment](https://github.com/aps31012005-prog/task15_end_to_end_deep_learning/blob/main/kubernetes/streamlit-deployment.yaml): `kubernetes/streamlit-deployment.yaml`
- **Render hosting**

### Other components

- **User**

## Connections

- User → Streamlit UI: uploads image (evidence: `README.md`)
- Streamlit UI → Flask API: POSTs image (evidence: `app.py`)
- Flask API → Image preprocessing: preprocesses image (evidence: `flask_api.py`)
- Flask API → CIFAR-10 CNN: runs prediction (evidence: `flask_api.py`)
- Flask API → Class and confidence: maps scores (evidence: `flask_api.py`)
- Flask API → Streamlit UI: returns result (evidence: `README.md`)
- Docker Compose → Flask container: runs service (evidence: `README.md`)
- Docker Compose → Streamlit container: runs service (evidence: `README.md`)
- Flask Kubernetes deployment → Flask Kubernetes service: exposes pods (evidence: `README.md`)
- Streamlit Kubernetes deployment → Streamlit Kubernetes service: exposes pods (evidence: `README.md`)
- Render hosting → Streamlit UI: hosts frontend (evidence: `README.md`)
- Render hosting → Flask API: hosts API (evidence: `README.md`)
