# aleksopi/cloud-computing-optimierung-von-logistikrouten architecture

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

- Interactive diagram: https://gitdiagram.com/aleksopi/cloud-computing-optimierung-von-logistikrouten
- Repository: https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten

## Overview

Pharma Logistics CH is a web-based optimizer for Swiss pharmacy supply: users configure the fleet and optimization settings, run a four-step calculation, then inspect routes and analysis on an interactive map and dashboard. The backend orchestrates demand estimation, demand-weighted hub placement, catchment assignment, and multi-objective vehicle routing; results and configuration are persisted in PostgreSQL. The README documents these product stages and capabilities. Connections to unsampled stage internals are limited to documented pipeline flow or the runner’s indexed imports.

Main entry points: [`frontend/src/api/client.ts`](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/api/client.ts) (API client), [`backend/app/api/results.py`](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/results.py) (Results API), [`frontend/src/App.tsx`](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/App.tsx) (Web app), [`backend/app/pipeline/runner.py`](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/runner.py) (Pipeline runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Web app<br/>[App.tsx]"]
  node_pipeline_ui["Pipeline controls<br/>[PipelinePanel.tsx]"]
  node_pipeline_hook["Pipeline state<br/>[usePipeline.ts]"]
  node_map["Interactive map<br/>[MapView.tsx]"]
  node_analysis["Analysis dashboard<br/>[SummaryPage.tsx]"]
  node_settings_ui["Settings<br/>[SettingsPage.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
end

subgraph group_api["Backend API"]
  node_api_entry["FastAPI app<br/>[main.py]"]
  node_pipeline_api["Pipeline API<br/>[pipeline.py]"]
  node_results_api["Results API<br/>[results.py]"]
  node_settings_api["Settings API<br/>[settings.py]"]
end

subgraph group_pipeline["Optimization pipeline"]
  node_runner["Pipeline runner<br/>[runner.py]"]
  node_demand["Demand calculation<br/>[a3_demand.py]"]
  node_placement["Hub placement"]
  node_assignment["Catchment assignment<br/>[a2_influence.py]"]
  node_routing["Route optimization<br/>[a4_routes.py]"]
end

subgraph group_data["Data and integrations"]
  node_database[("PostgreSQL data<br/>[models.py]")]
  node_db_session["Database sessions<br/>[session.py]"]
  node_osrm["OSRM routing<br/>[osrm.py]"]
  node_traffic["Traffic service<br/>[traffic.py]"]
  node_tomtom["TomTom traffic<br/>[tomtom.py]"]
  node_metrics["Result metrics<br/>[metrics.py]"]
end

node_operator(("Operator"))
node_road_network{{"Road network"}}
node_tomtom_service{{"TomTom API"}}

node_operator -->|"uses"| node_app
node_app -->|"renders"| node_pipeline_ui
node_app -->|"renders"| node_map
node_app -->|"renders"| node_analysis
node_app -->|"renders"| node_settings_ui
node_pipeline_ui -.->|"uses state"| node_pipeline_hook
node_pipeline_ui -->|"requests summary"| node_api_client
node_pipeline_hook -->|"calls"| node_api_client
node_settings_ui -->|"configures"| node_api_client
node_analysis -->|"fetches results"| node_api_client
node_api_client -->|"requests pipeline"| node_pipeline_api
node_api_client -->|"requests results"| node_results_api
node_api_client -->|"requests settings"| node_settings_api
node_api_entry -->|"mounts routes"| node_pipeline_api
node_api_entry -->|"mounts routes"| node_results_api
node_api_entry -->|"mounts routes"| node_settings_api
node_pipeline_api -->|"dispatches steps"| node_runner
node_pipeline_api -->|"opens sessions"| node_db_session
node_pipeline_api -->|"reads and resets"| node_database
node_runner -->|"runs step one"| node_demand
node_runner -->|"runs step two"| node_placement
node_runner -->|"runs step three"| node_assignment
node_runner -->|"runs step four"| node_routing
node_demand -->|"precedes"| node_placement
node_placement -->|"precedes"| node_assignment
node_assignment -->|"precedes"| node_routing
node_routing -->|"requests road routes"| node_osrm
node_routing -->|"gets traffic times"| node_traffic
node_traffic -->|"uses provider"| node_tomtom
node_tomtom -.->|"queries"| node_tomtom_service
node_osrm -.->|"routes on"| node_road_network
node_routing -->|"stores routes"| node_database
node_results_api -->|"queries"| node_db_session
node_results_api -->|"reads results"| node_database
node_results_api -->|"computes summaries"| node_metrics
node_results_api -->|"reports traffic"| node_traffic
node_settings_api -->|"queries settings"| node_db_session
node_settings_api -->|"reads and updates"| node_database
node_settings_api -->|"configures traffic"| node_traffic

click node_app "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/App.tsx"
click node_pipeline_ui "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Pipeline/PipelinePanel.tsx"
click node_pipeline_hook "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/hooks/usePipeline.ts"
click node_map "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Map/MapView.tsx"
click node_analysis "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Summary/SummaryPage.tsx"
click node_settings_ui "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Settings/SettingsPage.tsx"
click node_api_client "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/api/client.ts"
click node_api_entry "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/main.py"
click node_pipeline_api "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/pipeline.py"
click node_results_api "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/results.py"
click node_settings_api "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/settings.py"
click node_runner "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/runner.py"
click node_demand "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a3_demand.py"
click node_placement "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a1_hub_placement.py"
click node_assignment "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a2_influence.py"
click node_routing "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a4_routes.py"
click node_database "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/db/models.py"
click node_db_session "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/db/session.py"
click node_osrm "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/osrm.py"
click node_traffic "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/traffic.py"
click node_tomtom "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/tomtom.py"
click node_metrics "https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/metrics.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,node_pipeline_ui,node_pipeline_hook,node_map,node_analysis,node_settings_ui,node_api_client toneBlue
class node_api_entry,node_pipeline_api,node_results_api,node_settings_api toneAmber
class node_runner,node_demand,node_placement,node_assignment,node_routing,node_tomtom_service toneMint
class node_database,node_db_session,node_osrm,node_traffic,node_tomtom,node_metrics toneRose
class node_operator,node_road_network toneIndigo
```

## Components

### Web experience

- [Web app](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Pipeline controls](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Pipeline/PipelinePanel.tsx): `frontend/src/components/Pipeline/PipelinePanel.tsx`
- [Pipeline state](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/hooks/usePipeline.ts): `frontend/src/hooks/usePipeline.ts`
- [Interactive map](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Map/MapView.tsx): `frontend/src/components/Map/MapView.tsx`
- [Analysis dashboard](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Summary/SummaryPage.tsx): `frontend/src/components/Summary/SummaryPage.tsx`
- [Settings](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/components/Settings/SettingsPage.tsx): `frontend/src/components/Settings/SettingsPage.tsx`
- [API client](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Backend API

- [FastAPI app](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/main.py): `backend/app/main.py`
- [Pipeline API](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/pipeline.py): `backend/app/api/pipeline.py`
- [Results API](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/results.py): `backend/app/api/results.py`
- [Settings API](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/api/settings.py): `backend/app/api/settings.py`

### Optimization pipeline

- [Pipeline runner](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/runner.py): `backend/app/pipeline/runner.py`
- [Demand calculation](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a3_demand.py): `backend/app/pipeline/a3_demand.py`
- [Hub placement](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a1_hub_placement.py): `backend/app/pipeline/a1_hub_placement.py`
- [Catchment assignment](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a2_influence.py): `backend/app/pipeline/a2_influence.py`
- [Route optimization](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/pipeline/a4_routes.py): `backend/app/pipeline/a4_routes.py`

### Data and integrations

- [PostgreSQL data](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/db/models.py): `backend/app/db/models.py`
- [Database sessions](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [OSRM routing](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/osrm.py): `backend/app/services/osrm.py`
- [Traffic service](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/traffic.py): `backend/app/services/traffic.py`
- [TomTom traffic](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/tomtom.py): `backend/app/services/tomtom.py`
- [Result metrics](https://github.com/aleksopi/cloud-computing-optimierung-von-logistikrouten/blob/main/backend/app/services/metrics.py): `backend/app/services/metrics.py`

### Other components

- **Operator**
- **Road network**
- **TomTom API**

## Connections

- Operator → Web app: uses (evidence: `README.md`)
- Web app → Pipeline controls: renders (evidence: `frontend/src/App.tsx`)
- Web app → Interactive map: renders (evidence: `frontend/src/App.tsx`)
- Web app → Analysis dashboard: renders (evidence: `frontend/src/App.tsx`)
- Web app → Settings: renders (evidence: `frontend/src/App.tsx`)
- Pipeline controls → Pipeline state: uses state
- Pipeline controls → API client: requests summary (evidence: `frontend/src/components/Pipeline/PipelinePanel.tsx`)
- Pipeline state → API client: calls (evidence: `frontend/src/hooks/usePipeline.ts`)
- Settings → API client: configures (evidence: `frontend/src/components/Settings/SettingsPage.tsx`)
- Analysis dashboard → API client: fetches results (evidence: `frontend/src/components/Summary/SummaryPage.tsx`)
- API client → Pipeline API: requests pipeline (evidence: `frontend/src/api/client.ts`)
- API client → Results API: requests results (evidence: `frontend/src/api/client.ts`)
- API client → Settings API: requests settings (evidence: `frontend/src/api/client.ts`)
- FastAPI app → Pipeline API: mounts routes (evidence: `backend/app/main.py`)
- FastAPI app → Results API: mounts routes (evidence: `backend/app/main.py`)
- FastAPI app → Settings API: mounts routes (evidence: `backend/app/main.py`)
- Pipeline API → Pipeline runner: dispatches steps (evidence: `backend/app/api/pipeline.py`)
- Pipeline API → Database sessions: opens sessions (evidence: `backend/app/api/pipeline.py`)
- Pipeline API → PostgreSQL data: reads and resets (evidence: `backend/app/api/pipeline.py`)
- Pipeline runner → Demand calculation: runs step one (evidence: `backend/app/pipeline/runner.py`)
- Pipeline runner → Hub placement: runs step two (evidence: `backend/app/pipeline/runner.py`)
- Pipeline runner → Catchment assignment: runs step three (evidence: `backend/app/pipeline/runner.py`)
- Pipeline runner → Route optimization: runs step four (evidence: `backend/app/pipeline/runner.py`)
- Demand calculation → Hub placement: precedes (evidence: `README.md`)
- Hub placement → Catchment assignment: precedes (evidence: `README.md`)
- Catchment assignment → Route optimization: precedes (evidence: `README.md`)
- Route optimization → OSRM routing: requests road routes (evidence: `backend/app/pipeline/a4_routes.py`)
- Route optimization → Traffic service: gets traffic times (evidence: `backend/app/pipeline/a4_routes.py`)
- Traffic service → TomTom traffic: uses provider (evidence: `backend/app/services/traffic.py`)
- TomTom traffic → TomTom API: queries
- OSRM routing → Road network: routes on
- Route optimization → PostgreSQL data: stores routes (evidence: `README.md`)
- Results API → Database sessions: queries (evidence: `backend/app/api/results.py`)
- Results API → PostgreSQL data: reads results (evidence: `backend/app/api/results.py`)
- Results API → Result metrics: computes summaries (evidence: `backend/app/api/results.py`)
- Results API → Traffic service: reports traffic (evidence: `backend/app/api/results.py`)
- Settings API → Database sessions: queries settings (evidence: `backend/app/api/settings.py`)
- Settings API → PostgreSQL data: reads and updates (evidence: `backend/app/api/settings.py`)
- Settings API → Traffic service: configures traffic (evidence: `backend/app/api/settings.py`)
