FitTrack_ReportGenerator/initialspec.md

Purpose

Perform deterministic workout analysis and generate reports/charts

Core Requirements

• Analysis Capabilities

  • FIT/TCX/GPX file parsing
  • Power, heart rate, and speed analysis
  • Training metrics calculation (TSS, IF, NP)
  • Zone distribution analysis
  • Chart generation (power curves, elevation profiles)

• API Endpoints

  • POST /api/analyze/workout - Analyze single workout
  • POST /api/analyze/batch - Analyze multiple workouts
  • GET /api/analysis/{id}/charts - Generate charts
  • GET /api/analysis/{id}/summary - LLM-ready summary

• Technical

  • CPU-intensive processing isolation

  • Support for existing GarminAnalyser codebase

  • Chart generation (PNG, HTML, PDF)

  • Standardized output format for LLM consumption

  • Result caching

  • Existing Code

  • Use @GarminAnalyser.md to pull code from the existing implementation

  • use @DB_API_SPEC.json to get the API spec for the CentralDB that will store the Activity files and artifacts that we create