# manusaviour1506/quantumliverpred architecture

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

- Interactive diagram: https://gitdiagram.com/manusaviour1506/quantumliverpred
- Repository: https://github.com/manusaviour1506/quantumliverpred

## Overview

This is a research web platform for CT-slice liver-tumour modelling and comparison, not a clinical diagnostic system. The main workflow is a user uploading a slice, the backend decoding and screening it, concurrent model-family inference, and live comparison results and history. Separate branches cover labelled-slice benchmarking, whole-volume segmentation, and registry/research and system-monitoring capabilities. Edges reflect the excerpts, SOURCE INDEX references, or README; several route and persistence details are documented but their implementations were not sampled.

Main entry points: [`backend/app/execution/manager.py`](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/execution/manager.py) (Comparison runs), [`src/v10/engine/patch_pipeline.py`](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/patch_pipeline.py) (Patch preparation), [`src/inference/registry.py`](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/inference/registry.py) (Model registry), [`src/v10/engine/compare.py`](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/compare.py) (Comparison engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_frontend["Web client<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_auth_ui["Session auth<br/>[auth.tsx]"]
  node_research_ui["Research workspace<br/>[Research.tsx]"]
end

subgraph group_backend["API and services"]
  node_api["API application<br/>[main.py]"]
  node_comparison_manager["Comparison runs<br/>[manager.py]"]
  node_benchmark_service["Benchmark service<br/>[service.py]"]
  node_storage["File storage<br/>[storage.py]"]
  node_database[("Application database<br/>[database.py]")]
  node_system_monitor["System monitoring<br/>[system.py]"]
end

subgraph group_inference["CT inference"]
  node_inference_pipeline["Slice inference<br/>[pipeline.py]"]
  node_format_decode["Format decoding<br/>[formats.py]"]
  node_ct_preprocess["CT canonicalization<br/>[ct.py]"]
  node_quality_control["Image quality checks<br/>[image_qc.py]"]
  node_comparison_engine["Comparison engine<br/>[compare.py]"]
  node_patch_pipeline["Patch preparation<br/>[patch_pipeline.py]"]
end

subgraph group_models["Model families"]
  node_registry["Model registry<br/>[registry.py]"]
  node_classical["Classical models<br/>[nn.py]"]
  node_quantum["Quantum models<br/>[models.py]"]
  node_quantum_simulator["State-vector simulator<br/>[simulator.py]"]
  node_hybrid["Hybrid models<br/>[hybrid_model.py]"]
end

subgraph group_evaluation["Evaluation and analysis"]
  node_benchmark_engine["Labelled benchmarks<br/>[benchmark.py]"]
  node_volume_pipeline["Volume analysis<br/>[pipeline.py]"]
  node_segmentation["Segmentation metrics<br/>[metrics.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"uses"| node_frontend
node_frontend -.->|"requests data"| node_api_client
node_frontend -->|"checks session"| node_auth_ui
node_auth_ui -->|"uses"| node_api_client
node_api -->|"initializes"| node_comparison_manager
node_comparison_manager -->|"runs families"| node_comparison_engine
node_comparison_manager -.->|"persists runs"| node_database
node_comparison_manager -.->|"stores uploads"| node_storage
node_api -.->|"initializes"| node_benchmark_service
node_benchmark_service -->|"starts evaluation"| node_benchmark_engine
node_benchmark_service -.->|"stores results"| node_database
node_inference_pipeline -->|"decodes input"| node_format_decode
node_inference_pipeline -->|"canonicalizes image"| node_ct_preprocess
node_inference_pipeline -->|"checks quality"| node_quality_control
node_comparison_engine -->|"prepares patches"| node_patch_pipeline
node_patch_pipeline -->|"uses decoder"| node_format_decode
node_patch_pipeline -->|"uses preprocessing"| node_ct_preprocess
node_patch_pipeline -->|"checks quality"| node_quality_control
node_comparison_engine -->|"selects models"| node_registry
node_registry -->|"loads predictors"| node_classical
node_registry -->|"loads predictors"| node_quantum
node_registry -->|"loads predictors"| node_hybrid
node_hybrid -->|"uses models"| node_quantum
node_quantum -->|"simulates circuits"| node_quantum_simulator
node_benchmark_engine -->|"uses live pipeline"| node_comparison_engine
node_volume_pipeline -->|"postprocesses masks"| node_segmentation
node_researcher -->|"explores research"| node_research_ui
node_researcher -->|"monitors runtime"| node_system_monitor

click node_frontend "https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/lib/api.ts"
click node_auth_ui "https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/lib/auth.tsx"
click node_api "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/main.py"
click node_comparison_manager "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/execution/manager.py"
click node_benchmark_service "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/benchmarking/service.py"
click node_storage "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/services/storage.py"
click node_database "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/db/database.py"
click node_inference_pipeline "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/inference/pipeline.py"
click node_format_decode "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/preprocessing/formats.py"
click node_ct_preprocess "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/preprocessing/ct.py"
click node_quality_control "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quality_control/image_qc.py"
click node_comparison_engine "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/compare.py"
click node_patch_pipeline "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/patch_pipeline.py"
click node_registry "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/inference/registry.py"
click node_classical "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/classical/nn.py"
click node_quantum "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quantum/models.py"
click node_quantum_simulator "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quantum/simulator.py"
click node_hybrid "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/hybrid/hybrid_model.py"
click node_benchmark_engine "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/benchmark.py"
click node_volume_pipeline "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/volume/pipeline.py"
click node_segmentation "https://github.com/manusaviour1506/quantumliverpred/blob/main/src/segmentation/metrics.py"
click node_research_ui "https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/pages/Research.tsx"
click node_system_monitor "https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/api/v1/system.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_api_client,node_auth_ui,node_research_ui toneBlue
class node_api,node_comparison_manager,node_benchmark_service,node_storage,node_database,node_system_monitor toneAmber
class node_inference_pipeline,node_format_decode,node_ct_preprocess,node_quality_control,node_comparison_engine,node_patch_pipeline toneMint
class node_registry,node_classical,node_quantum,node_quantum_simulator,node_hybrid toneRose
class node_benchmark_engine,node_volume_pipeline,node_segmentation,node_researcher toneIndigo
```

## Components

### Web application

- [Web client](https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Session auth](https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/lib/auth.tsx): `frontend/src/lib/auth.tsx`
- [Research workspace](https://github.com/manusaviour1506/quantumliverpred/blob/main/frontend/src/pages/Research.tsx): `frontend/src/pages/Research.tsx`

### API and services

- [API application](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/main.py): `backend/app/main.py`
- [Comparison runs](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/execution/manager.py): `backend/app/execution/manager.py`
- [Benchmark service](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/benchmarking/service.py): `backend/app/benchmarking/service.py`
- [File storage](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [Application database](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/db/database.py): `backend/app/db/database.py`
- [System monitoring](https://github.com/manusaviour1506/quantumliverpred/blob/main/backend/app/api/v1/system.py): `backend/app/api/v1/system.py`

### CT inference

- [Slice inference](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/inference/pipeline.py): `src/inference/pipeline.py`
- [Format decoding](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/preprocessing/formats.py): `src/preprocessing/formats.py`
- [CT canonicalization](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/preprocessing/ct.py): `src/preprocessing/ct.py`
- [Image quality checks](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quality_control/image_qc.py): `src/quality_control/image_qc.py`
- [Comparison engine](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/compare.py): `src/v10/engine/compare.py`
- [Patch preparation](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/patch_pipeline.py): `src/v10/engine/patch_pipeline.py`

### Model families

- [Model registry](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/inference/registry.py): `src/inference/registry.py`
- [Classical models](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/classical/nn.py): `src/classical/nn.py`
- [Quantum models](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quantum/models.py): `src/quantum/models.py`
- [State-vector simulator](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/quantum/simulator.py): `src/quantum/simulator.py`
- [Hybrid models](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/hybrid/hybrid_model.py): `src/hybrid/hybrid_model.py`

### Evaluation and analysis

- [Labelled benchmarks](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/v10/engine/benchmark.py): `src/v10/engine/benchmark.py`
- [Volume analysis](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/volume/pipeline.py): `src/volume/pipeline.py`
- [Segmentation metrics](https://github.com/manusaviour1506/quantumliverpred/blob/main/src/segmentation/metrics.py): `src/segmentation/metrics.py`

### Other components

- **Researcher**

## Connections

- Researcher → Web client: uses (evidence: `README.md`)
- Web client → API client: requests data
- Web client → Session auth: checks session (evidence: `frontend/src/App.tsx`)
- Session auth → API client: uses (evidence: `frontend/src/lib/auth.tsx`)
- API application → Comparison runs: initializes (evidence: `backend/app/main.py`)
- Comparison runs → Comparison engine: runs families (evidence: `backend/app/execution/manager.py`)
- Comparison runs → Application database: persists runs
- Comparison runs → File storage: stores uploads
- API application → Benchmark service: initializes (evidence: `backend/app/main.py`)
- Benchmark service → Labelled benchmarks: starts evaluation (evidence: `backend/app/benchmarking/service.py`)
- Benchmark service → Application database: stores results (evidence: `backend/app/benchmarking/service.py`)
- Slice inference → Format decoding: decodes input (evidence: `src/inference/pipeline.py`)
- Slice inference → CT canonicalization: canonicalizes image (evidence: `src/inference/pipeline.py`)
- Slice inference → Image quality checks: checks quality (evidence: `src/inference/pipeline.py`)
- Comparison engine → Patch preparation: prepares patches (evidence: `src/v10/engine/compare.py`)
- Patch preparation → Format decoding: uses decoder (evidence: `src/v10/engine/patch_pipeline.py`)
- Patch preparation → CT canonicalization: uses preprocessing (evidence: `src/v10/engine/patch_pipeline.py`)
- Patch preparation → Image quality checks: checks quality (evidence: `src/v10/engine/patch_pipeline.py`)
- Comparison engine → Model registry: selects models (evidence: `src/v10/engine/compare.py`)
- Model registry → Classical models: loads predictors (evidence: `src/inference/registry.py`)
- Model registry → Quantum models: loads predictors (evidence: `src/inference/registry.py`)
- Model registry → Hybrid models: loads predictors (evidence: `src/inference/registry.py`)
- Hybrid models → Quantum models: uses models (evidence: `src/hybrid/hybrid_model.py`)
- Quantum models → State-vector simulator: simulates circuits (evidence: `src/quantum/models.py`)
- Labelled benchmarks → Comparison engine: uses live pipeline (evidence: `backend/app/benchmarking/service.py`)
- Volume analysis → Segmentation metrics: postprocesses masks (evidence: `src/volume/pipeline.py`)
- Researcher → Research workspace: explores research (evidence: `README.md`)
- Researcher → System monitoring: monitors runtime (evidence: `README.md`)
