# c-wilkinson/stravadataanalysis architecture

> Architecture diagram of the GitHub repository c-wilkinson/stravadataanalysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/c-wilkinson/stravadataanalysis
- Repository: https://github.com/c-wilkinson/stravadataanalysis

## Overview

StravaDataAnalysis fetches Strava activities and run splits, persists them locally, then produces static charts and datasets for a Streamlit analytics dashboard. The principal workflow is token-backed retrieval, transformation and storage, followed by analysis and visualization; the dashboard loads generated Parquet data and presents filtered overview, distance, pace, effort, activity, and ML views. The graph groups these stages plus authentication/persistence and ML recommendations. Several dashboard routes and chart capabilities are documented or indexed but unsampled, so links without direct evidence are omitted.

Main entry points: [`src/main.py`](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/main.py) (Pipeline runner), [`src/dashboard/app.py`](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/app.py) (Streamlit application), [`src/strava_data/strava_api/processing/analytics.py`](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/processing/analytics.py) (Analytics preparation), [`src/dashboard/page_utils.py`](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/page_utils.py) (Page rendering helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Strava ingestion"]
  node_runner["Pipeline runner<br/>[main.py]"]
  node_oauth["Token management<br/>[auth.py]"]
  node_strava["Strava API client<br/>[client.py]"]
  node_transform["Activity transforms<br/>[transform.py]"]
end

subgraph group_storage["Local data"]
  node_db[("Encrypted SQLite DAO<br/>[dao.py]")]
  node_models["Data models<br/>[models.py]"]
  node_parquet["Dashboard export<br/>[parquet.py]"]
end

subgraph group_analytics["Analysis and charts"]
  node_analytics["Analytics preparation<br/>[analytics.py]"]
  node_distance["Distance charts<br/>[graphs_distance.py]"]
  node_distribution["Distribution charts"]
  node_effort["Effort charts<br/>[graphs_effort.py]"]
  node_pace["Pace charts<br/>[graphs_pace.py]"]
  node_cards["Summary cards<br/>[summary_cards.py]"]
  node_chartutils["Chart utilities<br/>[utils.py]"]
  node_interactive["Interactive chart helpers"]
end

subgraph group_dashboard["Interactive dashboard"]
  node_dashboard["Streamlit application<br/>[app.py]"]
  node_loader["Parquet data loader<br/>[data_loader.py]"]
  node_filters["Dashboard filters<br/>[filters.py]"]
  node_overview["Overview page<br/>[overview.py]"]
  node_activities["Activities page<br/>[activities.py]"]
  node_distancepage["Distance page<br/>[distance.py]"]
  node_pacepage["Pace page<br/>[pace.py]"]
  node_effortpage["Effort page<br/>[effort.py]"]
  node_mlpage["Machine learning page"]
  node_pageutils["Page rendering helpers<br/>[page_utils.py]"]
end

subgraph group_learning["Training insights"]
  node_forecast["Pace forecasting<br/>[pace_forecast.py]"]
  node_classifier["Run classifier"]
  node_advisor["Training advisor"]
  node_mlcharts["ML charts<br/>[graphs_ml.py]"]
end

node_athlete(("Athlete"))
node_stravasvc{{"Strava service"}}
node_localfiles["Generated Parquet files"]
node_viewer(("Dashboard viewer"))

node_athlete -->|"authorizes"| node_oauth
node_runner -->|"loads tokens"| node_oauth
node_runner -->|"fetches activities"| node_strava
node_strava -->|"requests data"| node_stravasvc
node_strava -->|"checks latest date"| node_db
node_runner -->|"transforms records"| node_transform
node_strava -->|"transforms API payload"| node_transform
node_runner -->|"stores records"| node_db
node_runner -->|"exports dashboard data"| node_parquet
node_parquet -->|"prepares exported data"| node_analytics
node_parquet -->|"writes files"| node_localfiles
node_dashboard -->|"loads datasets"| node_loader
node_loader -->|"reads files"| node_localfiles
node_dashboard -->|"filters datasets"| node_filters
node_dashboard -->|"routes to"| node_overview
node_dashboard -->|"routes to"| node_activities
node_dashboard -->|"routes to"| node_distancepage
node_dashboard -->|"routes to"| node_pacepage
node_dashboard -->|"routes to"| node_effortpage
node_dashboard -->|"routes to"| node_mlpage
node_viewer -->|"views"| node_dashboard
node_overview -.->|"renders figures"| node_pageutils
node_distancepage -->|"renders figures"| node_pageutils
node_pacepage -->|"renders figures"| node_pageutils
node_effortpage -->|"renders figures"| node_pageutils
node_mlpage -->|"renders figures"| node_pageutils
node_distancepage -->|"builds charts"| node_distance
node_distancepage -->|"builds charts"| node_distribution
node_pacepage -->|"builds charts"| node_pace
node_pacepage -->|"builds charts"| node_distance
node_effortpage -->|"builds charts"| node_effort
node_effortpage -->|"builds charts"| node_distribution
node_overview -->|"uses summaries"| node_analytics
node_activities -->|"uses analytics"| node_analytics
node_distance -->|"prepares data"| node_analytics
node_distribution -->|"prepares data"| node_analytics
node_effort -->|"prepares data"| node_analytics
node_pace -->|"prepares data"| node_analytics
node_runner -->|"generates cards"| node_cards
node_runner -->|"runs forecast"| node_forecast
node_runner -->|"runs clustering"| node_classifier
node_runner -->|"generates plan"| node_advisor
node_mlpage -->|"builds charts"| node_mlcharts
node_classifier -->|"classifies runs"| node_advisor
node_mlcharts -->|"uses data preparation"| node_analytics
node_distance -->|"uses chart helpers"| node_interactive
node_distribution -->|"uses chart helpers"| node_interactive
node_pace -->|"uses chart helpers"| node_interactive

click node_runner "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/main.py"
click node_oauth "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/auth.py"
click node_strava "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/client.py"
click node_transform "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/processing/transform.py"
click node_db "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/dao.py"
click node_models "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/models.py"
click node_parquet "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/parquet.py"
click node_analytics "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/processing/analytics.py"
click node_distance "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_distance.py"
click node_distribution "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_distribution.py"
click node_effort "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_effort.py"
click node_pace "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_pace.py"
click node_cards "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/summary_cards.py"
click node_chartutils "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/utils.py"
click node_interactive "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/interactive_utils.py"
click node_forecast "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/pace_forecast.py"
click node_classifier "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/run_type_classifier.py"
click node_advisor "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/training_advisor.py"
click node_mlcharts "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_ml.py"
click node_dashboard "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/app.py"
click node_loader "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/data_loader.py"
click node_filters "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/filters.py"
click node_overview "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/overview.py"
click node_activities "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/activities.py"
click node_distancepage "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/distance.py"
click node_pacepage "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/pace.py"
click node_effortpage "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/effort.py"
click node_mlpage "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/machine_learning.py"
click node_pageutils "https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/page_utils.py"

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_runner,node_oauth,node_strava,node_transform,node_viewer toneBlue
class node_db,node_models,node_parquet toneAmber
class node_analytics,node_distance,node_distribution,node_effort,node_pace,node_cards,node_chartutils,node_interactive toneMint
class node_dashboard,node_loader,node_filters,node_overview,node_activities,node_distancepage,node_pacepage,node_effortpage,node_mlpage,node_pageutils toneRose
class node_forecast,node_classifier,node_advisor,node_mlcharts,node_athlete,node_stravasvc,node_localfiles toneIndigo
```

## Components

### Strava ingestion

- [Pipeline runner](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/main.py): `src/main.py`
- [Token management](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/auth.py): `src/strava_data/auth.py`
- [Strava API client](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/client.py): `src/strava_data/strava_api/client.py`
- [Activity transforms](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/processing/transform.py): `src/strava_data/strava_api/processing/transform.py`

### Local data

- [Encrypted SQLite DAO](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/dao.py): `src/strava_data/db/dao.py`
- [Data models](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/models.py): `src/strava_data/db/models.py`
- [Dashboard export](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/db/parquet.py): `src/strava_data/db/parquet.py`

### Analysis and charts

- [Analytics preparation](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/processing/analytics.py): `src/strava_data/strava_api/processing/analytics.py`
- [Distance charts](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_distance.py): `src/strava_data/strava_api/visualisation/graphs_distance.py`
- [Distribution charts](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_distribution.py): `src/strava_data/strava_api/visualisation/graphs_distribution.py`
- [Effort charts](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_effort.py): `src/strava_data/strava_api/visualisation/graphs_effort.py`
- [Pace charts](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_pace.py): `src/strava_data/strava_api/visualisation/graphs_pace.py`
- [Summary cards](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/summary_cards.py): `src/strava_data/strava_api/visualisation/summary_cards.py`
- [Chart utilities](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/utils.py): `src/strava_data/strava_api/visualisation/utils.py`
- [Interactive chart helpers](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/interactive_utils.py): `src/strava_data/strava_api/visualisation/interactive_utils.py`

### Interactive dashboard

- [Streamlit application](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/app.py): `src/dashboard/app.py`
- [Parquet data loader](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/data_loader.py): `src/dashboard/data_loader.py`
- [Dashboard filters](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/filters.py): `src/dashboard/filters.py`
- [Overview page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/overview.py): `src/dashboard/pages/overview.py`
- [Activities page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/activities.py): `src/dashboard/pages/activities.py`
- [Distance page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/distance.py): `src/dashboard/pages/distance.py`
- [Pace page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/pace.py): `src/dashboard/pages/pace.py`
- [Effort page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/effort.py): `src/dashboard/pages/effort.py`
- [Machine learning page](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/pages/machine_learning.py): `src/dashboard/pages/machine_learning.py`
- [Page rendering helpers](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/dashboard/page_utils.py): `src/dashboard/page_utils.py`

### Training insights

- [Pace forecasting](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/pace_forecast.py): `src/strava_data/ml/pace_forecast.py`
- [Run classifier](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/run_type_classifier.py): `src/strava_data/ml/run_type_classifier.py`
- [Training advisor](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/ml/training_advisor.py): `src/strava_data/ml/training_advisor.py`
- [ML charts](https://github.com/c-wilkinson/stravadataanalysis/blob/main/src/strava_data/strava_api/visualisation/graphs_ml.py): `src/strava_data/strava_api/visualisation/graphs_ml.py`

### Other components

- **Athlete**
- **Strava service**
- **Generated Parquet files**
- **Dashboard viewer**

## Connections

- Athlete → Token management: authorizes (evidence: `README.md`)
- Pipeline runner → Token management: loads tokens (evidence: `src/main.py`)
- Pipeline runner → Strava API client: fetches activities (evidence: `src/main.py`)
- Strava API client → Strava service: requests data (evidence: `src/strava_data/strava_api/client.py`)
- Strava API client → Encrypted SQLite DAO: checks latest date (evidence: `src/strava_data/strava_api/client.py`)
- Pipeline runner → Activity transforms: transforms records (evidence: `src/main.py`)
- Strava API client → Activity transforms: transforms API payload (evidence: `src/strava_data/strava_api/client.py`)
- Pipeline runner → Encrypted SQLite DAO: stores records (evidence: `src/main.py`)
- Pipeline runner → Dashboard export: exports dashboard data (evidence: `src/main.py`)
- Dashboard export → Analytics preparation: prepares exported data (evidence: `src/strava_data/db/parquet.py`)
- Dashboard export → Generated Parquet files: writes files
- Streamlit application → Parquet data loader: loads datasets (evidence: `src/dashboard/app.py`)
- Parquet data loader → Generated Parquet files: reads files (evidence: `src/dashboard/data_loader.py`)
- Streamlit application → Dashboard filters: filters datasets (evidence: `src/dashboard/app.py`)
- Streamlit application → Overview page: routes to (evidence: `src/dashboard/app.py`)
- Streamlit application → Activities page: routes to (evidence: `src/dashboard/app.py`)
- Streamlit application → Distance page: routes to (evidence: `src/dashboard/app.py`)
- Streamlit application → Pace page: routes to (evidence: `src/dashboard/app.py`)
- Streamlit application → Effort page: routes to (evidence: `src/dashboard/app.py`)
- Streamlit application → Machine learning page: routes to (evidence: `src/dashboard/app.py`)
- Dashboard viewer → Streamlit application: views (evidence: `src/dashboard/app.py`)
- Overview page → Page rendering helpers: renders figures (evidence: `src/dashboard/pages/overview.py`)
- Distance page → Page rendering helpers: renders figures (evidence: `src/dashboard/pages/distance.py`)
- Pace page → Page rendering helpers: renders figures (evidence: `src/dashboard/pages/pace.py`)
- Effort page → Page rendering helpers: renders figures (evidence: `src/dashboard/pages/effort.py`)
- Machine learning page → Page rendering helpers: renders figures (evidence: `src/dashboard/pages/machine_learning.py`)
- Distance page → Distance charts: builds charts (evidence: `src/dashboard/pages/distance.py`)
- Distance page → Distribution charts: builds charts (evidence: `src/dashboard/pages/distance.py`)
- Pace page → Pace charts: builds charts (evidence: `src/dashboard/pages/pace.py`)
- Pace page → Distance charts: builds charts (evidence: `src/dashboard/pages/pace.py`)
- Effort page → Effort charts: builds charts (evidence: `src/dashboard/pages/effort.py`)
- Effort page → Distribution charts: builds charts (evidence: `src/dashboard/pages/effort.py`)
- Overview page → Analytics preparation: uses summaries (evidence: `src/dashboard/pages/overview.py`)
- Activities page → Analytics preparation: uses analytics (evidence: `src/dashboard/pages/activities.py`)
- Distance charts → Analytics preparation: prepares data (evidence: `src/strava_data/strava_api/visualisation/graphs_distance.py`)
- Distribution charts → Analytics preparation: prepares data (evidence: `src/strava_data/strava_api/visualisation/graphs_distribution.py`)
- Effort charts → Analytics preparation: prepares data (evidence: `src/strava_data/strava_api/visualisation/graphs_effort.py`)
- Pace charts → Analytics preparation: prepares data (evidence: `src/strava_data/strava_api/visualisation/graphs_pace.py`)
- Pipeline runner → Summary cards: generates cards (evidence: `src/main.py`)
- Pipeline runner → Pace forecasting: runs forecast (evidence: `src/main.py`)
- Pipeline runner → Run classifier: runs clustering (evidence: `src/main.py`)
- Pipeline runner → Training advisor: generates plan (evidence: `src/main.py`)
- Machine learning page → ML charts: builds charts (evidence: `src/dashboard/pages/machine_learning.py`)
- Run classifier → Training advisor: classifies runs (evidence: `src/strava_data/ml/training_advisor.py`)
- ML charts → Analytics preparation: uses data preparation (evidence: `src/strava_data/strava_api/visualisation/graphs_ml.py`)
- Distance charts → Interactive chart helpers: uses chart helpers (evidence: `src/strava_data/strava_api/visualisation/graphs_distance.py`)
- Distribution charts → Interactive chart helpers: uses chart helpers (evidence: `src/strava_data/strava_api/visualisation/graphs_distribution.py`)
- Pace charts → Interactive chart helpers: uses chart helpers (evidence: `src/strava_data/strava_api/visualisation/graphs_pace.py`)
