# rauschschottmanuel/fuelpricewizzard architecture

> Architecture diagram of the GitHub repository rauschschottmanuel/fuelpricewizzard, 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/rauschschottmanuel/fuelpricewizzard
- Repository: https://github.com/rauschschottmanuel/fuelpricewizzard

## Overview

FuelPriceWizard collects fuel-price readings from configurable provider services, stores them with station and fuel metadata, and exposes gas-station data through an API; its Angular UI includes a map component. The shown collector schedules provider runs and persists returned readings. E-Control’s provider fetches and parses an external response. Evidence is limited to the README, indexed references, and sampled files; the UI-to-API connection and several documented project capabilities are not established by the excerpts, so no such runtime links are asserted.

Main entry points: [`FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs) (Task orchestrator), [`FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs`](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs) (Repository base), [`EControlCollectorService/EControlCollectorService.cs`](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/EControlCollectorService/EControlCollectorService.cs) (E-Control provider), [`FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs`](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs) (Provider base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Collection runtime"]
  node_collector_host["Collector host<br/>[Program.cs]"]
  node_orchestrator["Task orchestrator"]
  node_task["Repeating task<br/>[RepeatingTask.cs]"]
  node_factory["Provider factory"]
end

subgraph group_providers["Price providers"]
  node_source_contract["Provider contract"]
  node_base_source["Provider base"]
  node_econtrol["E-Control provider"]
  node_mock_provider["Mock provider"]
end

subgraph group_storage["Data access"]
  node_gas_station_repo["Station repository"]
  node_price_repo["Price repository<br/>[PriceRepository.cs]"]
  node_reference_repos["Reference repositories<br/>[Implementation]"]
  node_base_repository["Repository base<br/>[BaseRepository.cs]"]
  node_db_context["Entity context"]
  node_data_registration["Data registration"]
end

subgraph group_api["API"]
  node_stations_controller["Stations controller"]
  node_station_dto["Station DTO<br/>[GasStationDto.cs]"]
end

subgraph group_ui["Web UI"]
  node_ui_app["Angular app<br/>[app.component.ts]"]
  node_map["OSM map"]
end

node_operator(("Collector operator"))
node_econtrol_api["E-Control service"]
node_sql_server[("SQL Server")]

node_operator -.->|"starts"| node_collector_host
node_collector_host -->|"creates"| node_orchestrator
node_orchestrator -->|"loads providers"| node_factory
node_orchestrator -->|"schedules"| node_task
node_orchestrator -->|"runs collection"| node_source_contract
node_orchestrator -->|"reads stations"| node_gas_station_repo
node_orchestrator -->|"inserts readings"| node_price_repo
node_factory -->|"creates providers"| node_source_contract
node_econtrol -->|"extends"| node_base_source
node_econtrol -->|"implements"| node_source_contract
node_mock_provider -->|"extends"| node_base_source
node_base_source -->|"loads reference data"| node_reference_repos
node_econtrol -->|"requests prices"| node_econtrol_api
node_stations_controller -->|"queries stations"| node_gas_station_repo
node_stations_controller -->|"returns DTO"| node_station_dto
node_gas_station_repo -.->|"inherits"| node_base_repository
node_price_repo -.->|"inherits"| node_base_repository
node_reference_repos -.->|"reuse repository"| node_base_repository
node_base_repository -->|"queries and writes"| node_db_context
node_data_registration -->|"configures"| node_db_context
node_data_registration -->|"configures provider"| node_sql_server
node_ui_app -->|"renders"| node_map

click node_collector_host "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/Program.cs"
click node_orchestrator "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs"
click node_task "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/RepeatingTask.cs"
click node_factory "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/FuelPriceSourceServiceFactory.cs"
click node_source_contract "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.BusinessLogic/IFuelPriceSourceService.cs"
click node_base_source "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs"
click node_econtrol "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/EControlCollectorService/EControlCollectorService.cs"
click node_mock_provider "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/MockUpFuelPriceSourceCollectorService/MockUpFuelPriceService.cs"
click node_gas_station_repo "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/GasStationRepository.cs"
click node_price_repo "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/PriceRepository.cs"
click node_reference_repos "https://github.com/rauschschottmanuel/fuelpricewizzard/tree/main/FuelPriceWizard.DataAccess/Implementation"
click node_base_repository "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs"
click node_db_context "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/FuelPriceWizardDbContext.cs"
click node_data_registration "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/ServiceRegistrationHelper.cs"
click node_stations_controller "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.API/Controllers/GasStationsController.cs"
click node_station_dto "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.API/DTOs/GasStationDto.cs"
click node_ui_app "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.UI/fuelpricewizard/src/app/app.component.ts"
click node_map "https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.UI/fuelpricewizard/src/app/shared/osm-map/osm-map.component.ts"

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_collector_host,node_orchestrator,node_task,node_factory toneBlue
class node_source_contract,node_base_source,node_econtrol,node_mock_provider,node_sql_server toneAmber
class node_gas_station_repo,node_price_repo,node_reference_repos,node_base_repository,node_db_context,node_data_registration toneMint
class node_stations_controller,node_station_dto toneRose
class node_ui_app,node_map,node_operator,node_econtrol_api toneIndigo
```

## Components

### Collection runtime

- [Collector host](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/Program.cs): `FuelPriceWizard.DataCollector/Program.cs`
- [Task orchestrator](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs): `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`
- [Repeating task](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/RepeatingTask.cs): `FuelPriceWizard.DataCollector/RepeatingTask.cs`
- [Provider factory](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataCollector/FuelPriceSourceServiceFactory.cs): `FuelPriceWizard.DataCollector/FuelPriceSourceServiceFactory.cs`

### Price providers

- [Provider contract](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.BusinessLogic/IFuelPriceSourceService.cs): `FuelPriceWizard.BusinessLogic/IFuelPriceSourceService.cs`
- [Provider base](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs): `FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs`
- [E-Control provider](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/EControlCollectorService/EControlCollectorService.cs): `EControlCollectorService/EControlCollectorService.cs`
- [Mock provider](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/MockUpFuelPriceSourceCollectorService/MockUpFuelPriceService.cs): `MockUpFuelPriceSourceCollectorService/MockUpFuelPriceService.cs`

### Data access

- [Station repository](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/GasStationRepository.cs): `FuelPriceWizard.DataAccess/Implementation/GasStationRepository.cs`
- [Price repository](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/PriceRepository.cs): `FuelPriceWizard.DataAccess/Implementation/PriceRepository.cs`
- [Reference repositories](https://github.com/rauschschottmanuel/fuelpricewizzard/tree/main/FuelPriceWizard.DataAccess/Implementation): `FuelPriceWizard.DataAccess/Implementation`
- [Repository base](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs): `FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs`
- [Entity context](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/FuelPriceWizardDbContext.cs): `FuelPriceWizard.DataAccess/FuelPriceWizardDbContext.cs`
- [Data registration](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.DataAccess/ServiceRegistrationHelper.cs): `FuelPriceWizard.DataAccess/ServiceRegistrationHelper.cs`

### API

- [Stations controller](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.API/Controllers/GasStationsController.cs): `FuelPriceWizard.API/Controllers/GasStationsController.cs`
- [Station DTO](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.API/DTOs/GasStationDto.cs): `FuelPriceWizard.API/DTOs/GasStationDto.cs`

### Web UI

- [Angular app](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.UI/fuelpricewizard/src/app/app.component.ts): `FuelPriceWizard.UI/fuelpricewizard/src/app/app.component.ts`
- [OSM map](https://github.com/rauschschottmanuel/fuelpricewizzard/blob/main/FuelPriceWizard.UI/fuelpricewizard/src/app/shared/osm-map/osm-map.component.ts): `FuelPriceWizard.UI/fuelpricewizard/src/app/shared/osm-map/osm-map.component.ts`

### Other components

- **Collector operator**
- **E-Control service**
- **SQL Server**

## Connections

- Collector operator → Collector host: starts
- Collector host → Task orchestrator: creates (evidence: `FuelPriceWizard.DataCollector/Program.cs`)
- Task orchestrator → Provider factory: loads providers (evidence: `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`)
- Task orchestrator → Repeating task: schedules (evidence: `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`)
- Task orchestrator → Provider contract: runs collection (evidence: `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`)
- Task orchestrator → Station repository: reads stations (evidence: `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`)
- Task orchestrator → Price repository: inserts readings (evidence: `FuelPriceWizard.DataCollector/DataCollectorOrchestrator.cs`)
- Provider factory → Provider contract: creates providers (evidence: `FuelPriceWizard.DataCollector/FuelPriceSourceServiceFactory.cs`)
- E-Control provider → Provider base: extends (evidence: `EControlCollectorService/EControlCollectorService.cs`)
- E-Control provider → Provider contract: implements (evidence: `EControlCollectorService/EControlCollectorService.cs`)
- Mock provider → Provider base: extends (evidence: `MockUpFuelPriceSourceCollectorService/MockUpFuelPriceService.cs`)
- Provider base → Reference repositories: loads reference data (evidence: `FuelPriceWizard.BusinessLogic/BaseFuelPriceSourceService.cs`)
- E-Control provider → E-Control service: requests prices (evidence: `EControlCollectorService/EControlCollectorService.cs`)
- Stations controller → Station repository: queries stations (evidence: `FuelPriceWizard.API/Controllers/GasStationsController.cs`)
- Stations controller → Station DTO: returns DTO (evidence: `FuelPriceWizard.API/Controllers/GasStationsController.cs`)
- Station repository → Repository base: inherits (evidence: `FuelPriceWizard.DataAccess/Implementation/GasStationRepository.cs`)
- Price repository → Repository base: inherits
- Reference repositories → Repository base: reuse repository (evidence: `FuelPriceWizard.DataAccess/Implementation/CurrencyRepository.cs`)
- Repository base → Entity context: queries and writes (evidence: `FuelPriceWizard.DataAccess/Implementation/BaseRepository.cs`)
- Data registration → Entity context: configures (evidence: `FuelPriceWizard.DataAccess/ServiceRegistrationHelper.cs`)
- Data registration → SQL Server: configures provider (evidence: `FuelPriceWizard.DataAccess/ServiceRegistrationHelper.cs`)
- Angular app → OSM map: renders (evidence: `FuelPriceWizard.UI/fuelpricewizard/src/app/app.component.ts`)
