# diku-dk/onlinemarketplacebenchmark architecture

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

- Interactive diagram: https://gitdiagram.com/diku-dk/onlinemarketplacebenchmark
- Repository: https://github.com/diku-dk/onlinemarketplacebenchmark

## Overview

Online Marketplace is a C# benchmark driver for running configurable microservice experiments. A user supplies experiment and workload settings; the driver generates or reuses marketplace data, ingests initial state, submits customer, seller, and delivery transactions to a target platform, then collects and writes performance metrics. Common code provides the lifecycle, workload scheduling, service/worker abstractions, and metrics; platform projects adapt those pieces, including platform-specific ingestion or result collection. The README documents the full lifecycle; source excerpts substantiate core orchestration and workload calls, but not every platform-specific runtime detail.

Main entry points: [`Common/Experiment/AbstractExperimentManager.cs`](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Experiment/AbstractExperimentManager.cs) (Experiment lifecycle), [`Common/Metric/MetricManager.cs`](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Metric/MetricManager.cs) (Metric collection), [`Common/Workload/WorkloadManager.cs`](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workload/WorkloadManager.cs) (Workload scheduler), [`Common/Services/CustomerService.cs`](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/CustomerService.cs) (Customer service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Experiment setup"]
  node_config["Experiment config"]
  node_driver["Experiment lifecycle"]
  node_generation["Data generation"]
  node_duckdb[("DuckDB data<br/>[DuckDbUtils.cs]")]
  node_ingestion["Data ingestion"]
end

subgraph group_execution["Workload execution"]
  node_workload["Workload scheduler<br/>[WorkloadManager.cs]"]
  node_customer_service["Customer service<br/>[CustomerService.cs]"]
  node_seller_service["Seller service<br/>[SellerService.cs]"]
  node_delivery_service["Delivery service<br/>[DeliveryService.cs]"]
  node_customer_worker["Customer worker"]
  node_seller_worker["Seller worker"]
  node_delivery_worker["Delivery worker"]
end

subgraph group_platforms["Platform adapters"]
  node_dapr["Dapr adapter"]
  node_statefun["Statefun adapter"]
  node_orleans["Orleans adapter"]
  node_driverbench["Driver benchmark adapter"]
  node_modb["Modb adapter"]
end

subgraph group_results["Metrics and results"]
  node_metrics["Metric collection<br/>[MetricManager.cs]"]
  node_metric_services["Platform metric capture"]
  node_results_file["Metric results file<br/>[MetricManager.cs]"]
end

node_user(("Experiment user"))
node_target{{"Marketplace APIs"}}

node_user -->|"configures"| node_config
node_config -->|"configures"| node_driver
node_driver -->|"generates data"| node_generation
node_generation -->|"writes data"| node_duckdb
node_driver -->|"loads data"| node_duckdb
node_driver -->|"runs ingestion"| node_ingestion
node_driver -->|"runs workload"| node_workload
node_workload -->|"dispatches sessions"| node_customer_service
node_workload -->|"dispatches updates"| node_seller_service
node_workload -->|"dispatches deliveries"| node_delivery_service
node_customer_service -->|"runs customer"| node_customer_worker
node_seller_service -->|"runs seller"| node_seller_worker
node_customer_worker -->|"sends requests"| node_target
node_seller_worker -.->|"sends requests"| node_target
node_delivery_worker -.->|"sends requests"| node_target
node_driver -->|"collects metrics"| node_metrics
node_metrics -->|"reads transactions"| node_customer_service
node_metrics -->|"reads transactions"| node_seller_service
node_metrics -.->|"reads transactions"| node_delivery_service
node_metrics -->|"writes results"| node_results_file
node_dapr -->|"extends lifecycle"| node_driver
node_statefun -->|"extends lifecycle"| node_driver
node_orleans -->|"extends lifecycle"| node_driver
node_driverbench -->|"extends lifecycle"| node_driver
node_modb -->|"extends lifecycle"| node_driver
node_dapr -->|"uses metrics"| node_metric_services
node_metric_services -->|"adapts collection"| node_metrics

click node_config "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Experiment/ExperimentConfig.cs"
click node_driver "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Experiment/AbstractExperimentManager.cs"
click node_generation "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/DataGeneration/Synthetic/SyntheticDataGenerator.cs"
click node_duckdb "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Infra/DuckDbUtils.cs"
click node_ingestion "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Ingestion/DefaultIngestionOrchestrator.cs"
click node_workload "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workload/WorkloadManager.cs"
click node_customer_service "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/CustomerService.cs"
click node_seller_service "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/SellerService.cs"
click node_delivery_service "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/DeliveryService.cs"
click node_customer_worker "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Customer/DefaultCustomerWorker.cs"
click node_seller_worker "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Seller/DefaultSellerWorker.cs"
click node_delivery_worker "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Delivery/DefaultDeliveryWorker.cs"
click node_dapr "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Dapr/Workload/DaprExperimentManager.cs"
click node_statefun "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Statefun/Workload/StatefunExperimentManager.cs"
click node_orleans "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Orleans/Workload/ActorExperimentManager.cs"
click node_driverbench "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/DriverBench/Experiment/DriverBenchExperimentManager.cs"
click node_modb "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Modb/ModbExperimentManager.cs"
click node_metrics "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Metric/MetricManager.cs"
click node_metric_services "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Dapr/Metric/DaprMetricManager.cs"
click node_results_file "https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Metric/MetricManager.cs"

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_config,node_driver,node_generation,node_duckdb,node_ingestion,node_user toneBlue
class node_workload,node_customer_service,node_seller_service,node_delivery_service,node_customer_worker,node_seller_worker,node_delivery_worker toneAmber
class node_dapr,node_statefun,node_orleans,node_driverbench,node_modb,node_target toneMint
class node_metrics,node_metric_services,node_results_file toneRose
```

## Components

### Experiment setup

- [Experiment config](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Experiment/ExperimentConfig.cs): `Common/Experiment/ExperimentConfig.cs`
- [Experiment lifecycle](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Experiment/AbstractExperimentManager.cs): `Common/Experiment/AbstractExperimentManager.cs`
- [Data generation](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/DataGeneration/Synthetic/SyntheticDataGenerator.cs): `Common/DataGeneration/Synthetic/SyntheticDataGenerator.cs`
- [DuckDB data](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Infra/DuckDbUtils.cs): `Common/Infra/DuckDbUtils.cs`
- [Data ingestion](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Ingestion/DefaultIngestionOrchestrator.cs): `Common/Ingestion/DefaultIngestionOrchestrator.cs`

### Workload execution

- [Workload scheduler](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workload/WorkloadManager.cs): `Common/Workload/WorkloadManager.cs`
- [Customer service](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/CustomerService.cs): `Common/Services/CustomerService.cs`
- [Seller service](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/SellerService.cs): `Common/Services/SellerService.cs`
- [Delivery service](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Services/DeliveryService.cs): `Common/Services/DeliveryService.cs`
- [Customer worker](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Customer/DefaultCustomerWorker.cs): `Common/Workers/Customer/DefaultCustomerWorker.cs`
- [Seller worker](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Seller/DefaultSellerWorker.cs): `Common/Workers/Seller/DefaultSellerWorker.cs`
- [Delivery worker](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Workers/Delivery/DefaultDeliveryWorker.cs): `Common/Workers/Delivery/DefaultDeliveryWorker.cs`

### Platform adapters

- [Dapr adapter](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Dapr/Workload/DaprExperimentManager.cs): `Dapr/Workload/DaprExperimentManager.cs`
- [Statefun adapter](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Statefun/Workload/StatefunExperimentManager.cs): `Statefun/Workload/StatefunExperimentManager.cs`
- [Orleans adapter](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Orleans/Workload/ActorExperimentManager.cs): `Orleans/Workload/ActorExperimentManager.cs`
- [Driver benchmark adapter](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/DriverBench/Experiment/DriverBenchExperimentManager.cs): `DriverBench/Experiment/DriverBenchExperimentManager.cs`
- [Modb adapter](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Modb/ModbExperimentManager.cs): `Modb/ModbExperimentManager.cs`

### Metrics and results

- [Metric collection](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Metric/MetricManager.cs): `Common/Metric/MetricManager.cs`
- [Platform metric capture](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Dapr/Metric/DaprMetricManager.cs): `Dapr/Metric/DaprMetricManager.cs`
- [Metric results file](https://github.com/diku-dk/onlinemarketplacebenchmark/blob/main/Common/Metric/MetricManager.cs): `Common/Metric/MetricManager.cs`

### Other components

- **Experiment user**
- **Marketplace APIs**

## Connections

- Experiment user → Experiment config: configures (evidence: `README.md`)
- Experiment config → Experiment lifecycle: configures (evidence: `README.md`)
- Experiment lifecycle → Data generation: generates data (evidence: `Common/Experiment/AbstractExperimentManager.cs`)
- Data generation → DuckDB data: writes data (evidence: `README.md`)
- Experiment lifecycle → DuckDB data: loads data (evidence: `Common/Experiment/AbstractExperimentManager.cs`)
- Experiment lifecycle → Data ingestion: runs ingestion (evidence: `Common/Experiment/AbstractExperimentManager.cs`)
- Experiment lifecycle → Workload scheduler: runs workload (evidence: `Common/Experiment/AbstractExperimentManager.cs`)
- Workload scheduler → Customer service: dispatches sessions (evidence: `Common/Workload/WorkloadManager.cs`)
- Workload scheduler → Seller service: dispatches updates (evidence: `Common/Workload/WorkloadManager.cs`)
- Workload scheduler → Delivery service: dispatches deliveries (evidence: `Common/Workload/WorkloadManager.cs`)
- Customer service → Customer worker: runs customer (evidence: `Common/Services/CustomerService.cs`)
- Seller service → Seller worker: runs seller (evidence: `Common/Services/SellerService.cs`)
- Customer worker → Marketplace APIs: sends requests (evidence: `Common/Workers/Customer/DefaultCustomerWorker.cs`)
- Seller worker → Marketplace APIs: sends requests
- Delivery worker → Marketplace APIs: sends requests
- Experiment lifecycle → Metric collection: collects metrics (evidence: `Common/Experiment/AbstractExperimentManager.cs`)
- Metric collection → Customer service: reads transactions (evidence: `Common/Metric/MetricManager.cs`)
- Metric collection → Seller service: reads transactions (evidence: `Common/Metric/MetricManager.cs`)
- Metric collection → Delivery service: reads transactions
- Metric collection → Metric results file: writes results (evidence: `Common/Metric/MetricManager.cs`)
- Dapr adapter → Experiment lifecycle: extends lifecycle (evidence: `Dapr/Workload/DaprExperimentManager.cs`)
- Statefun adapter → Experiment lifecycle: extends lifecycle (evidence: `Statefun/Workload/StatefunExperimentManager.cs`)
- Orleans adapter → Experiment lifecycle: extends lifecycle (evidence: `Orleans/Workload/ActorExperimentManager.cs`)
- Driver benchmark adapter → Experiment lifecycle: extends lifecycle (evidence: `DriverBench/Experiment/DriverBenchExperimentManager.cs`)
- Modb adapter → Experiment lifecycle: extends lifecycle (evidence: `Modb/ModbExperimentManager.cs`)
- Dapr adapter → Platform metric capture: uses metrics (evidence: `Dapr/Workload/DaprExperimentManager.cs`)
- Platform metric capture → Metric collection: adapts collection (evidence: `Dapr/Metric/DaprMetricManager.cs`)
