# t0pcup/diploma architecture

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

- Interactive diagram: https://gitdiagram.com/t0pcup/diploma
- Repository: https://github.com/t0pcup/diploma

## Overview

This is a geospatial sea-ice workbench: users draw or load areas, select imagery dates, and view or export map features; the backend supports accounts and persisted imagery orders, while a separate worker retrieves imagery and produces ice-segmentation results. The sampled code shows the account/order API and parts of the frontend and processing pipeline. The README is empty, and frontend request wiring plus some worker details were not sampled, so those connections are omitted.

Main entry points: [`backend/showcase/models.py`](https://github.com/t0pcup/diploma/blob/master/backend/showcase/models.py) (Order records), [`frontend/main.js`](https://github.com/t0pcup/diploma/blob/master/frontend/main.js) (Map interface), [`backend/deep_api/client.py`](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/client.py) (Socket worker), [`backend/authentication/views.py`](https://github.com/t0pcup/diploma/blob/master/backend/authentication/views.py) (Account API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mapping["Mapping workbench"]
  node_frontend["Map interface<br/>[main.js]"]
end

subgraph group_accounts["Accounts"]
  node_auth_routes["Account routes<br/>[urls.py]"]
  node_auth_views["Account API<br/>[views.py]"]
  node_auth_serializers["Account validation<br/>[serializers.py]"]
  node_user_model[("User and JWT<br/>[models.py]")]
end

subgraph group_orders["Order management"]
  node_order_routes["Order routes<br/>[urls.py]"]
  node_order_views["Order API<br/>[views.py]"]
  node_order_serializers["Order validation<br/>[serializers.py]"]
  node_order_model[("Order records<br/>[models.py]")]
end

subgraph group_processing["Ice processing"]
  node_redis["Redis queue"]
  node_worker_client["Socket worker<br/>[client.py]"]
  node_order_loader["Order loading<br/>[helpers.py]"]
  node_imagery["Imagery preparation<br/>[helpers.py]"]
  node_inference["Ice segmentation<br/>[helpers.py]"]
  node_result_store["Result persistence<br/>[helpers.py]"]
  node_etl["Processing ETL<br/>[etl.py]"]
  node_export["Result export<br/>[export.py]"]
end

node_user(("Workbench user"))
node_sentinel["Sentinel Hub"]

node_user -->|"uses map"| node_frontend
node_frontend -->|"requests imagery"| node_sentinel
node_frontend -->|"draws and exports"| node_frontend
node_auth_routes -->|"routes requests"| node_auth_views
node_auth_views -->|"validates data"| node_auth_serializers
node_auth_views -->|"looks up user"| node_user_model
node_auth_serializers -->|"authenticates and updates"| node_user_model
node_auth_serializers -->|"deletes user orders"| node_order_model
node_order_routes -->|"routes requests"| node_order_views
node_order_views -->|"validates order"| node_order_serializers
node_order_views -->|"reads order"| node_order_model
node_order_serializers -->|"creates order"| node_order_model
node_order_model -->|"checks owner"| node_user_model
node_order_model -->|"queues order ID"| node_redis
node_order_serializers -->|"removes queued ID"| node_redis
node_worker_client -->|"loads order"| node_order_loader
node_worker_client -->|"runs prediction"| node_inference
node_worker_client -->|"saves prediction"| node_result_store
node_order_loader -.->|"retrieves imagery"| node_imagery
node_imagery -.->|"prepares inputs"| node_inference
node_inference -->|"stores prediction"| node_result_store
node_etl -->|"uses helpers"| node_imagery
node_export -->|"uses helpers"| node_result_store

click node_frontend "https://github.com/t0pcup/diploma/blob/master/frontend/main.js"
click node_auth_routes "https://github.com/t0pcup/diploma/blob/master/backend/authentication/urls.py"
click node_auth_views "https://github.com/t0pcup/diploma/blob/master/backend/authentication/views.py"
click node_auth_serializers "https://github.com/t0pcup/diploma/blob/master/backend/authentication/serializers.py"
click node_user_model "https://github.com/t0pcup/diploma/blob/master/backend/authentication/models.py"
click node_order_routes "https://github.com/t0pcup/diploma/blob/master/backend/showcase/urls.py"
click node_order_views "https://github.com/t0pcup/diploma/blob/master/backend/showcase/views.py"
click node_order_serializers "https://github.com/t0pcup/diploma/blob/master/backend/showcase/serializers.py"
click node_order_model "https://github.com/t0pcup/diploma/blob/master/backend/showcase/models.py"
click node_worker_client "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/client.py"
click node_order_loader "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py"
click node_imagery "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py"
click node_inference "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py"
click node_result_store "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py"
click node_etl "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/etl.py"
click node_export "https://github.com/t0pcup/diploma/blob/master/backend/deep_api/export.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_frontend,node_user toneBlue
class node_auth_routes,node_auth_views,node_auth_serializers,node_user_model toneAmber
class node_order_routes,node_order_views,node_order_serializers,node_order_model toneMint
class node_redis,node_worker_client,node_order_loader,node_imagery,node_inference,node_result_store,node_etl,node_export toneRose
class node_sentinel toneIndigo
```

## Components

### Mapping workbench

- [Map interface](https://github.com/t0pcup/diploma/blob/master/frontend/main.js): `frontend/main.js`

### Accounts

- [Account routes](https://github.com/t0pcup/diploma/blob/master/backend/authentication/urls.py): `backend/authentication/urls.py`
- [Account API](https://github.com/t0pcup/diploma/blob/master/backend/authentication/views.py): `backend/authentication/views.py`
- [Account validation](https://github.com/t0pcup/diploma/blob/master/backend/authentication/serializers.py): `backend/authentication/serializers.py`
- [User and JWT](https://github.com/t0pcup/diploma/blob/master/backend/authentication/models.py): `backend/authentication/models.py`

### Order management

- [Order routes](https://github.com/t0pcup/diploma/blob/master/backend/showcase/urls.py): `backend/showcase/urls.py`
- [Order API](https://github.com/t0pcup/diploma/blob/master/backend/showcase/views.py): `backend/showcase/views.py`
- [Order validation](https://github.com/t0pcup/diploma/blob/master/backend/showcase/serializers.py): `backend/showcase/serializers.py`
- [Order records](https://github.com/t0pcup/diploma/blob/master/backend/showcase/models.py): `backend/showcase/models.py`

### Ice processing

- **Redis queue**
- [Socket worker](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/client.py): `backend/deep_api/client.py`
- [Order loading](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py): `backend/deep_api/helpers.py`
- [Imagery preparation](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py): `backend/deep_api/helpers.py`
- [Ice segmentation](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py): `backend/deep_api/helpers.py`
- [Result persistence](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/helpers.py): `backend/deep_api/helpers.py`
- [Processing ETL](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/etl.py): `backend/deep_api/etl.py`
- [Result export](https://github.com/t0pcup/diploma/blob/master/backend/deep_api/export.py): `backend/deep_api/export.py`

### Other components

- **Workbench user**
- **Sentinel Hub**

## Connections

- Workbench user → Map interface: uses map (evidence: `frontend/main.js`)
- Map interface → Sentinel Hub: requests imagery (evidence: `frontend/main.js`)
- Map interface → Map interface: draws and exports (evidence: `frontend/main.js`)
- Account routes → Account API: routes requests (evidence: `backend/authentication/urls.py`)
- Account API → Account validation: validates data (evidence: `backend/authentication/views.py`)
- Account API → User and JWT: looks up user (evidence: `backend/authentication/views.py`)
- Account validation → User and JWT: authenticates and updates (evidence: `backend/authentication/serializers.py`)
- Account validation → Order records: deletes user orders (evidence: `backend/authentication/serializers.py`)
- Order routes → Order API: routes requests (evidence: `backend/showcase/urls.py`)
- Order API → Order validation: validates order (evidence: `backend/showcase/views.py`)
- Order API → Order records: reads order (evidence: `backend/showcase/views.py`)
- Order validation → Order records: creates order (evidence: `backend/showcase/serializers.py`)
- Order records → User and JWT: checks owner (evidence: `backend/showcase/models.py`)
- Order records → Redis queue: queues order ID (evidence: `backend/showcase/models.py`)
- Order validation → Redis queue: removes queued ID (evidence: `backend/showcase/serializers.py`)
- Socket worker → Order loading: loads order (evidence: `backend/deep_api/client.py`)
- Socket worker → Ice segmentation: runs prediction (evidence: `backend/deep_api/client.py`)
- Socket worker → Result persistence: saves prediction (evidence: `backend/deep_api/client.py`)
- Order loading → Imagery preparation: retrieves imagery (evidence: `backend/deep_api/helpers.py`)
- Imagery preparation → Ice segmentation: prepares inputs (evidence: `backend/deep_api/helpers.py`)
- Ice segmentation → Result persistence: stores prediction (evidence: `backend/deep_api/helpers.py`)
- Processing ETL → Imagery preparation: uses helpers (evidence: `backend/deep_api/etl.py`)
- Result export → Result persistence: uses helpers (evidence: `backend/deep_api/export.py`)
