ApexLab Documentation¶

ApexLab is a Windows desktop application for sim-racing telemetry analysis. It captures live lap data from racing simulators, stores sessions locally, and provides lap comparison, visual track analysis, leaderboards, and AI coaching through a companion REST API.

Project Pillars¶

Pillar	What it is
Desktop App	WPF app for Windows. Captures live telemetry, compares laps, renders track maps, hosts AI coach.
Backend API	ASP.NET Core 8 REST API deployed on Railway. Handles auth, cloud sync, leaderboards, and AI calls.
SafeWatch	Blazor Server admin dashboard at `/safewatch`. Internal monitoring for 4 roles.
Infrastructure	Railway (Docker), Neon Postgres, Redis, Sentry, Prometheus.

Quick Links¶

Local Setup — get the project running in 5 minutes
Architecture Overview — high-level system diagram
Endpoint Reference — all API routes
Data Dictionary — every data structure explained

Repository Structure¶

SimCopilot/
├── SimCopilot.App/          WPF desktop client
├── SimCopilot.Core/         Analysis engine (no UI/network deps)
├── SimCopilot.Storage/      SQLite + CSV persistence
├── SimCopilot.Telemetry/    CSV telemetry I/O
├── SimCopilot.Lmu/          LMU/rF2 shared memory integration
├── SimCopilot.Connectors/   Multi-game abstraction layer
├── SimCopilot.Shared/       DTOs shared by App + API
├── SimCopilot.Tests/        xUnit unit tests (30+)
└── SimCopilot.Api/          ASP.NET Core 8 REST API
    └── SimCopilot.Api.Tests/ API + SafeWatch unit tests