# bramvdfange/bpexi architecture

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

- Interactive diagram: https://gitdiagram.com/bramvdfange/bpexi
- Repository: https://github.com/bramvdfange/bpexi

## Overview

Spectraculair is a web application for uploading IR, UV-VIS, H-NMR and 13C-NMR spectra, then visualizing, preprocessing and analyzing them with PCA. Users work through a React dashboard; its controls send requests to Django REST endpoints, which parse data, persist spectra and processing results, and return data for charts and exports. The README documents the wider feature set; connections for unsampled backend details are limited to documented or indexed relationships, rather than inferred call chains.

Main entry points: [`_internal/bpexi_project/bpexi_app/api_views.py`](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/api_views.py) (API Handlers), [`_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx`](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx) (Dashboard), [`_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx`](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx) (Workflow Controls), [`_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx`](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx) (Analysis Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_sidebar["Workflow Controls<br/>[Sidebar.jsx]"]
  node_upload["Spectrum Upload<br/>[UploadDropzone.jsx]"]
  node_preproc_ui["Preprocessing Controls"]
  node_pca_ui["PCA Settings<br/>[PCASettings.jsx]"]
  node_charts["Chart View<br/>[RawDataView.jsx]"]
  node_pca_charts["PCA Plots<br/>[PCAView.jsx]"]
  node_chart_card["Analysis Panel<br/>[ChartCard.jsx]"]
  node_pdf["PDF Export<br/>[exportToPDF.js]"]
end

subgraph group_api["API and Workflow"]
  node_api_routes["API Routes<br/>[api_urls.py]"]
  node_api_views["API Handlers<br/>[api_views.py]"]
  node_web_views["Template Upload Views<br/>[views.py]"]
  node_serializers["JSON Serializers<br/>[serializers.py]"]
end

subgraph group_domain["Spectral Analysis"]
  node_parsing["Parsing and Processing"]
end

subgraph group_storage["Persisted Data"]
  node_dataset[("Dataset Records<br/>[models.py]")]
  node_spectra[("Spectra and Metadata<br/>[models.py]")]
  node_processed[("Processed Results<br/>[models.py]")]
  node_pca_result[("PCA Results<br/>[models.py]")]
end

node_user(("Analyst"))

node_user -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_sidebar
node_dashboard -->|"renders"| node_chart_card
node_sidebar -->|"renders"| node_upload
node_sidebar -->|"renders"| node_preproc_ui
node_sidebar -->|"renders"| node_pca_ui
node_chart_card -->|"renders"| node_charts
node_chart_card -->|"renders"| node_pca_charts
node_chart_card -->|"calls"| node_pdf
node_dashboard -->|"requests"| node_api_views
node_api_routes -->|"routes to"| node_api_views
node_api_views -->|"calls parsers"| node_parsing
node_api_views -->|"reads and writes"| node_dataset
node_api_views -->|"reads and writes"| node_spectra
node_api_views -->|"writes"| node_processed
node_api_views -.->|"writes"| node_pca_result
node_api_views -->|"serializes"| node_serializers
node_parsing -.->|"calculates"| node_pca_result
node_web_views -->|"uses"| node_parsing
node_web_views -->|"creates"| node_dataset
node_web_views -->|"writes"| node_spectra
node_api_views -->|"exposed by"| node_api_routes

click node_dashboard "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx"
click node_sidebar "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx"
click node_upload "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/UploadDropzone.jsx"
click node_preproc_ui "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PreprocessingPanel.jsx"
click node_pca_ui "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PCASettings.jsx"
click node_charts "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/RawDataView.jsx"
click node_pca_charts "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PCAView.jsx"
click node_chart_card "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx"
click node_pdf "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/utils/exportToPDF.js"
click node_api_routes "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/api_urls.py"
click node_api_views "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/api_views.py"
click node_web_views "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/views.py"
click node_parsing "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/utils/processing_script.py"
click node_serializers "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/serializers.py"
click node_dataset "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py"
click node_spectra "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py"
click node_processed "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py"
click node_pca_result "https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.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_dashboard,node_sidebar,node_upload,node_preproc_ui,node_pca_ui,node_charts,node_pca_charts,node_chart_card,node_pdf toneBlue
class node_api_routes,node_api_views,node_web_views,node_serializers toneAmber
class node_parsing toneMint
class node_dataset,node_spectra,node_processed,node_pca_result toneRose
class node_user toneIndigo
```

## Components

### Dashboard UI

- [Dashboard](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx`
- [Workflow Controls](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx`
- [Spectrum Upload](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/UploadDropzone.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/UploadDropzone.jsx`
- [Preprocessing Controls](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PreprocessingPanel.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/PreprocessingPanel.jsx`
- [PCA Settings](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PCASettings.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/PCASettings.jsx`
- [Chart View](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/RawDataView.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/RawDataView.jsx`
- [PCA Plots](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/PCAView.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/PCAView.jsx`
- [Analysis Panel](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx): `_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx`
- [PDF Export](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_project/frontend/src/utils/exportToPDF.js): `_internal/bpexi_project/bpexi_project/frontend/src/utils/exportToPDF.js`

### API and Workflow

- [API Routes](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/api_urls.py): `_internal/bpexi_project/bpexi_app/api_urls.py`
- [API Handlers](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/api_views.py): `_internal/bpexi_project/bpexi_app/api_views.py`
- [Template Upload Views](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/views.py): `_internal/bpexi_project/bpexi_app/views.py`
- [JSON Serializers](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/serializers.py): `_internal/bpexi_project/bpexi_app/serializers.py`

### Spectral Analysis

- [Parsing and Processing](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/utils/processing_script.py): `_internal/bpexi_project/bpexi_app/utils/processing_script.py`

### Persisted Data

- [Dataset Records](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py): `_internal/bpexi_project/bpexi_app/models.py`
- [Spectra and Metadata](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py): `_internal/bpexi_project/bpexi_app/models.py`
- [Processed Results](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py): `_internal/bpexi_project/bpexi_app/models.py`
- [PCA Results](https://github.com/bramvdfange/bpexi/blob/main/_internal/bpexi_project/bpexi_app/models.py): `_internal/bpexi_project/bpexi_app/models.py`

### Other components

- **Analyst**

## Connections

- Analyst → Dashboard: uses
- Dashboard → Workflow Controls: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx`)
- Dashboard → Analysis Panel: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx`)
- Workflow Controls → Spectrum Upload: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx`)
- Workflow Controls → Preprocessing Controls: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx`)
- Workflow Controls → PCA Settings: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/Sidebar.jsx`)
- Analysis Panel → Chart View: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx`)
- Analysis Panel → PCA Plots: renders (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx`)
- Analysis Panel → PDF Export: calls (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/components/ChartCard.jsx`)
- Dashboard → API Handlers: requests (evidence: `_internal/bpexi_project/bpexi_project/frontend/src/pages/DashboardPage.jsx`)
- API Routes → API Handlers: routes to (evidence: `_internal/bpexi_project/bpexi_app/api_urls.py`)
- API Handlers → Parsing and Processing: calls parsers (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- API Handlers → Dataset Records: reads and writes (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- API Handlers → Spectra and Metadata: reads and writes (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- API Handlers → Processed Results: writes (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- API Handlers → PCA Results: writes (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- API Handlers → JSON Serializers: serializes (evidence: `_internal/bpexi_project/bpexi_app/api_views.py`)
- Parsing and Processing → PCA Results: calculates (evidence: `_internal/bpexi_project/bpexi_app/utils/processing_script.py`)
- Template Upload Views → Parsing and Processing: uses (evidence: `_internal/bpexi_project/bpexi_app/views.py`)
- Template Upload Views → Dataset Records: creates (evidence: `_internal/bpexi_project/bpexi_app/views.py`)
- Template Upload Views → Spectra and Metadata: writes (evidence: `_internal/bpexi_project/bpexi_app/views.py`)
- API Handlers → API Routes: exposed by (evidence: `_internal/bpexi_project/bpexi_app/api_urls.py`)
