How flappedear/betterdriver works
BetterDriver is a cross-platform track-day coaching product: a phone records a drive and live timing, optional spoken coaching accompanies it, and the resulting session is reviewed and analysed with video. The map emphasizes this user journey plus the documented setup, track/timing, transfer, video and analysis capabilities. Edges are limited to relationships shown in the excerpts or README; several broader module interactions are therefore omitted rather than inferred.
Main entry points: SessionAnalysis.kt Session Analysis · SessionReview.kt Session Review · RecorderService.kt Android Recorder · Track.kt Track and Timing
Components 22
Recording and Sensors
- Equipment Setup
setup/src/commonMain/kotlin/com/flappedear/betterdriver/setup/SessionEquipment.kt - iOS Recording
ios/BetterDriver/Recording/RecordingController.swift - Android Recorder
app/src/main/kotlin/com/flappedear/betterdriver/recording/RecorderService.kt - Session Store
recorder/src/main/kotlin/com/flappedear/betterdriver/recorder/store/SessionFiles.kt
Track and Live Coaching
- Track and Timing
timing/src/commonMain/kotlin/com/flappedear/betterdriver/timing/track/Track.kt - Track Screen
feature-track/src/main/kotlin/com/flappedear/betterdriver/feature/track - Coach Service
app/src/main/kotlin/com/flappedear/betterdriver/coach/CoachService.kt - Cue Engine
coach/src/commonMain/kotlin/com/flappedear/betterdriver/coach/CueEngine.kt
Session Review
- Session Review
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/review/SessionReview.kt - Lap Review UI
feature-review/src/main/kotlin/com/flappedear/betterdriver/feature/review/ReviewScreen.kt
Analysis and Coaching
- Session Analysis
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/SessionAnalysis.kt - Telemetry Model
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/data/TelemetrySession.kt - Line Plan
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/line/LinePlan.kt - Progress Summary
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/summary/SessionProgress.kt - Analysis Screens
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/feature/analysis/AnalysisUi.kt - Car Analysis
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/feature/analysis/CarUi.kt - Confidence UI
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/feature/analysis/ConfidenceUi.kt - Weather Data
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/weather/OpenMeteo.kt
Video and Transfer
- Video Sync
videosync/src/commonMain/kotlin/com/flappedear/betterdriver/gopro/GoProClient.kt - Phone Camera
app/src/main/kotlin/com/flappedear/betterdriver/camera/CameraService.kt - Session Transfer
transfer/src/main/kotlin/com/flappedear/betterdriver/transfer/SessionBundle.kt
Other components
- Driver
Connections 24
- Driver → Equipment Setup: chooses equipment
- Driver → iOS Recording: starts drive
- Driver → Android Recorder: starts drive
- iOS Recording → Session Store: writes session
- Android Recorder → Session Store: stores session
app/src/main/kotlin/com/flappedear/betterdriver/recording/RecorderService.kt - Track and Timing → Track Screen: times track
- Android Recorder → Track and Timing: feeds live fixes
app/src/main/kotlin/com/flappedear/betterdriver/recording/RecorderService.kt - Coach Service → Cue Engine: runs cues
app/src/main/kotlin/com/flappedear/betterdriver/coach/CoachService.kt - Cue Engine → Track and Timing: uses track data
coach/src/commonMain/kotlin/com/flappedear/betterdriver/coach/CueEngine.kt - Driver → Lap Review UI: reviews laps
- Lap Review UI → Session Review: requests review
- Session Review → Session Analysis: analyzes session
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/analysis/review/SessionReview.kt - Session Review → Session Store: reads session
- Session Analysis → Telemetry Model: analyzes telemetry
- Session Analysis → Line Plan: derives plan
- Session Analysis → Progress Summary: summarizes progress
- Analysis Screens → Session Analysis: presents analysis
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/feature/analysis/AnalysisUi.kt - Car Analysis → Session Analysis: presents vehicle
analysis/src/commonMain/kotlin/com/flappedear/betterdriver/feature/analysis/CarUi.kt - Confidence UI → Session Analysis: presents confidence
- Phone Camera → Android Recorder: syncs recording
app/src/main/kotlin/com/flappedear/betterdriver/camera/CameraService.kt - Phone Camera → Video Sync: indexes clips
- Session Review → Video Sync: aligns lap clips
- Driver → Session Transfer: transfers sessions
- Weather Data → Session Analysis: supplies conditions