# viggi-1390/racing-telemetry-analyzer architecture

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

- Interactive diagram: https://gitdiagram.com/viggi-1390/racing-telemetry-analyzer
- Repository: https://github.com/viggi-1390/racing-telemetry-analyzer

## Overview

Racing Telemetry Analyzer is an ASP.NET Core MVC workstation for managing vehicles and tracks, importing or generating session telemetry, and reviewing replay and performance insights. The main workflow selects a vehicle and track, loads a session into the telemetry workstation, and presents lap data and analysis; CSV import creates session, lap, telemetry, and summary-analysis records. The README documents additional replay, vehicle-specific telemetry, track sections, conditions, setup, notes, and API capabilities. Some controller and view excerpts are incomplete, so edges not supported by shown calls or documentation are omitted.

Main entry points: [`Controllers/TelemetryController.cs`](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TelemetryController.cs) (Telemetry Workstation), [`Data/ApplicationDbContext.cs`](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Data/ApplicationDbContext.cs) (Data Context), [`Controllers/HomeController.cs`](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/HomeController.cs) (Vehicle Management), [`Controllers/TrackController.cs`](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TrackController.cs) (Track Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Garage And Tracks"]
  node_garage["Vehicle Management<br/>[HomeController.cs]"]
  node_trackmgmt["Track Management<br/>[TrackController.cs]"]
  node_homeview["Garage Views<br/>[Index.cshtml]"]
  node_trackview["Track Views<br/>[Index.cshtml]"]
end

subgraph group_ingestion["Telemetry Ingestion"]
  node_csv["CSV Import"]
  node_generator["Demo Data Generator"]
end

subgraph group_workstation["Analysis Workstation"]
  node_telemetry["Telemetry Workstation"]
  node_graph["Rolling Telemetry Graph"]
  node_analysis["Lap Analysis"]
  node_analysiscontract["Analysis Contract"]
  node_replay["Session Replay"]
  node_telemetryview["Telemetry Views<br/>[Index.cshtml]"]
end

subgraph group_platform["Persistence And API"]
  node_models["Racing Domain<br/>[DomainModels.cs]"]
  node_api["Telemetry API"]
  node_dbcontext["Data Context"]
  node_database[("Telemetry Database")]
  node_error["Error View Model<br/>[ErrorViewModel.cs]"]
end

node_engineer(("Engineer"))

node_engineer -->|"manages vehicles"| node_garage
node_engineer -->|"manages tracks"| node_trackmgmt
node_engineer -->|"reviews sessions"| node_telemetry
node_garage -->|"reads and writes"| node_dbcontext
node_trackmgmt -->|"reads and writes"| node_dbcontext
node_telemetry -->|"queries sessions"| node_dbcontext
node_telemetry -->|"invokes import"| node_csv
node_telemetry -->|"uses generator"| node_generator
node_telemetry -->|"uses analysis"| node_analysiscontract
node_analysis -->|"implements"| node_analysiscontract
node_csv -->|"persists batches"| node_dbcontext
node_api -->|"queries data"| node_dbcontext
node_dbcontext -->|"stores entities"| node_database
node_telemetry -.->|"renders telemetry"| node_graph
node_telemetry -.->|"syncs playback"| node_replay
node_garage -.->|"presents garage"| node_homeview
node_trackmgmt -.->|"presents tracks"| node_trackview
node_telemetry -.->|"presents workstation"| node_telemetryview

click node_garage "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/HomeController.cs"
click node_trackmgmt "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TrackController.cs"
click node_models "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Models/DomainModels.cs"
click node_telemetry "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TelemetryController.cs"
click node_graph "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Components/TelemetryRollingGraph.razor"
click node_analysis "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/TelemetryAnalysisService.cs"
click node_analysiscontract "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/ITelemetryAnalysisService.cs"
click node_csv "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/CsvImportService.cs"
click node_generator "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/DataGeneratorService.cs"
click node_api "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TelemetryApiController.cs"
click node_dbcontext "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Data/ApplicationDbContext.cs"
click node_database "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Data/ApplicationDbContext.cs"
click node_error "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Models/ErrorViewModel.cs"
click node_replay "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/wwwroot/js/rollingTelemetry.js"
click node_homeview "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Home/Index.cshtml"
click node_trackview "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Track/Index.cshtml"
click node_telemetryview "https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Telemetry/Index.cshtml"

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_garage,node_trackmgmt,node_homeview,node_trackview toneBlue
class node_csv,node_generator toneAmber
class node_telemetry,node_graph,node_analysis,node_analysiscontract,node_replay,node_telemetryview toneMint
class node_models,node_api,node_dbcontext,node_database,node_error toneRose
class node_engineer toneIndigo
```

## Components

### Garage And Tracks

- [Vehicle Management](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/HomeController.cs): `Controllers/HomeController.cs`
- [Track Management](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TrackController.cs): `Controllers/TrackController.cs`
- [Garage Views](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Home/Index.cshtml): `Views/Home/Index.cshtml`
- [Track Views](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Track/Index.cshtml): `Views/Track/Index.cshtml`

### Telemetry Ingestion

- [CSV Import](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/CsvImportService.cs): `Services/CsvImportService.cs`
- [Demo Data Generator](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/DataGeneratorService.cs): `Services/DataGeneratorService.cs`

### Analysis Workstation

- [Telemetry Workstation](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TelemetryController.cs): `Controllers/TelemetryController.cs`
- [Rolling Telemetry Graph](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Components/TelemetryRollingGraph.razor): `Components/TelemetryRollingGraph.razor`
- [Lap Analysis](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/TelemetryAnalysisService.cs): `Services/TelemetryAnalysisService.cs`
- [Analysis Contract](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Services/ITelemetryAnalysisService.cs): `Services/ITelemetryAnalysisService.cs`
- [Session Replay](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/wwwroot/js/rollingTelemetry.js): `wwwroot/js/rollingTelemetry.js`
- [Telemetry Views](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Views/Telemetry/Index.cshtml): `Views/Telemetry/Index.cshtml`

### Persistence And API

- [Racing Domain](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Models/DomainModels.cs): `Models/DomainModels.cs`
- [Telemetry API](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Controllers/TelemetryApiController.cs): `Controllers/TelemetryApiController.cs`
- [Data Context](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Data/ApplicationDbContext.cs): `Data/ApplicationDbContext.cs`
- [Telemetry Database](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Data/ApplicationDbContext.cs): `Data/ApplicationDbContext.cs`
- [Error View Model](https://github.com/viggi-1390/racing-telemetry-analyzer/blob/main/Models/ErrorViewModel.cs): `Models/ErrorViewModel.cs`

### Other components

- **Engineer**

## Connections

- Engineer → Vehicle Management: manages vehicles (evidence: `README.md`)
- Engineer → Track Management: manages tracks (evidence: `README.md`)
- Engineer → Telemetry Workstation: reviews sessions (evidence: `README.md`)
- Vehicle Management → Data Context: reads and writes (evidence: `Controllers/HomeController.cs`)
- Track Management → Data Context: reads and writes (evidence: `Controllers/TrackController.cs`)
- Telemetry Workstation → Data Context: queries sessions (evidence: `Controllers/TelemetryController.cs`)
- Telemetry Workstation → CSV Import: invokes import (evidence: `Controllers/TelemetryController.cs`)
- Telemetry Workstation → Demo Data Generator: uses generator (evidence: `Controllers/TelemetryController.cs`)
- Telemetry Workstation → Analysis Contract: uses analysis (evidence: `Controllers/TelemetryController.cs`)
- Lap Analysis → Analysis Contract: implements (evidence: `Services/TelemetryAnalysisService.cs`)
- CSV Import → Data Context: persists batches (evidence: `Services/CsvImportService.cs`)
- Telemetry API → Data Context: queries data (evidence: `Controllers/TelemetryApiController.cs`)
- Data Context → Telemetry Database: stores entities (evidence: `Data/ApplicationDbContext.cs`)
- Telemetry Workstation → Rolling Telemetry Graph: renders telemetry
- Telemetry Workstation → Session Replay: syncs playback
- Vehicle Management → Garage Views: presents garage
- Track Management → Track Views: presents tracks
- Telemetry Workstation → Telemetry Views: presents workstation
