Initial commit: smartrun MVP

Garmin run classification and progression tracker. Go backend (MCP
client to mcp-garmin, SQLite store, deterministic rule engine, REST
API) and React/TS frontend (Dashboard, Review Queue, Workout Kinds).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-17 18:33:06 +02:00
commit f689f74ae0
69 changed files with 10666 additions and 0 deletions

24
frontend/.gitignore vendored Normal file
View File

@@ -0,0 +1,24 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
node_modules
dist
dist-ssr
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

8
frontend/.oxlintrc.json Normal file
View File

@@ -0,0 +1,8 @@
{
"$schema": "./node_modules/oxlint/configuration_schema.json",
"plugins": ["react", "typescript", "oxc"],
"rules": {
"react/rules-of-hooks": "error",
"react/only-export-components": ["warn", { "allowConstantExport": true }]
}
}

32
frontend/README.md Normal file
View File

@@ -0,0 +1,32 @@
# React + TypeScript + Vite
This template provides a minimal setup to get React working in Vite with HMR and some Oxlint rules.
Currently, two official plugins are available:
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
## React Compiler
The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
## Expanding the Oxlint configuration
If you are developing a production application, we recommend enabling type-aware lint rules by installing `oxlint-tsgolint` and editing `.oxlintrc.json`:
```json
{
"$schema": "./node_modules/oxlint/configuration_schema.json",
"plugins": ["react", "typescript", "oxc"],
"options": {
"typeAware": true
},
"rules": {
"react/rules-of-hooks": "error",
"react/only-export-components": ["warn", { "allowConstantExport": true }]
}
}
```
See the [Oxlint rules documentation](https://oxc.rs/docs/guide/usage/linter/rules) for the full list of rules and categories.

13
frontend/index.html Normal file
View File

@@ -0,0 +1,13 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>frontend</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>

1816
frontend/package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

26
frontend/package.json Normal file
View File

@@ -0,0 +1,26 @@
{
"name": "frontend",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
"lint": "oxlint",
"preview": "vite preview"
},
"dependencies": {
"react": "^19.2.7",
"react-dom": "^19.2.7",
"recharts": "^3.9.2"
},
"devDependencies": {
"@types/node": "^24.13.2",
"@types/react": "^19.2.17",
"@types/react-dom": "^19.2.3",
"@vitejs/plugin-react": "^6.0.3",
"oxlint": "^1.71.0",
"typescript": "~6.0.2",
"vite": "^8.1.1"
}
}

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 9.3 KiB

24
frontend/public/icons.svg Normal file
View File

@@ -0,0 +1,24 @@
<svg xmlns="http://www.w3.org/2000/svg">
<symbol id="bluesky-icon" viewBox="0 0 16 17">
<g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
<defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
</symbol>
<symbol id="discord-icon" viewBox="0 0 20 19">
<path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
</symbol>
<symbol id="documentation-icon" viewBox="0 0 21 20">
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
</symbol>
<symbol id="github-icon" viewBox="0 0 19 19">
<path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
</symbol>
<symbol id="social-icon" viewBox="0 0 20 20">
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
</symbol>
<symbol id="x-icon" viewBox="0 0 19 19">
<path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
</symbol>
</svg>

After

Width:  |  Height:  |  Size: 4.9 KiB

230
frontend/src/App.css Normal file
View File

@@ -0,0 +1,230 @@
* {
box-sizing: border-box;
}
body {
margin: 0;
font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
background: #0f1115;
color: #e6e6e6;
}
.app {
max-width: 960px;
margin: 0 auto;
padding: 0 1.5rem 3rem;
}
.app-header {
display: flex;
align-items: center;
gap: 2rem;
padding: 1.5rem 0;
border-bottom: 1px solid #2a2d35;
}
.app-header h1 {
font-size: 1.25rem;
margin: 0;
}
.tabs {
display: flex;
gap: 0.5rem;
}
.tab {
background: none;
border: 1px solid #2a2d35;
color: #b7bcc7;
padding: 0.5rem 1rem;
border-radius: 6px;
cursor: pointer;
}
.tab.active {
background: #3b82f6;
border-color: #3b82f6;
color: white;
}
.garmin-connection {
display: flex;
flex-direction: column;
gap: 0.5rem;
padding: 0.75rem 0;
border-bottom: 1px solid #2a2d35;
}
.garmin-connection-row {
display: flex;
align-items: center;
gap: 0.75rem;
}
.garmin-connection-message {
margin: 0;
font-size: 0.8rem;
color: #9aa0ab;
}
.status-dot {
width: 8px;
height: 8px;
border-radius: 50%;
background: #6b7280;
}
.status-dot.status-authenticated {
background: #22c55e;
}
.status-dot.status-mfa_required {
background: #f59e0b;
}
.status-dot.status-failed {
background: #f87171;
}
.status-label {
font-size: 0.85rem;
color: #9aa0ab;
}
.page {
padding-top: 1.5rem;
}
.controls {
display: flex;
gap: 1.5rem;
margin-bottom: 1rem;
}
.controls label,
.kind-editor label {
display: flex;
flex-direction: column;
gap: 0.25rem;
font-size: 0.85rem;
color: #9aa0ab;
}
select,
input,
textarea,
button {
font-family: inherit;
font-size: 0.95rem;
background: #1a1d24;
color: #e6e6e6;
border: 1px solid #2a2d35;
border-radius: 6px;
padding: 0.4rem 0.6rem;
}
button {
cursor: pointer;
}
button:hover:not(:disabled) {
border-color: #3b82f6;
}
button:disabled {
opacity: 0.5;
cursor: default;
}
.empty-state {
color: #9aa0ab;
}
.error {
color: #f87171;
}
.review-list {
list-style: none;
padding: 0;
display: flex;
flex-direction: column;
gap: 1rem;
}
.review-item {
border: 1px solid #2a2d35;
border-radius: 8px;
padding: 1rem;
}
.review-item-header {
display: flex;
justify-content: space-between;
font-size: 1rem;
}
.review-item-header span {
color: #9aa0ab;
font-size: 0.85rem;
}
.review-item-stats {
display: flex;
gap: 1rem;
color: #9aa0ab;
font-size: 0.85rem;
margin-top: 0.25rem;
}
.candidates {
font-size: 0.8rem;
color: #9aa0ab;
margin: 0.5rem 0;
}
.review-item-actions {
display: flex;
gap: 0.5rem;
flex-wrap: wrap;
margin-top: 0.5rem;
}
.kinds-table {
width: 100%;
border-collapse: collapse;
margin-bottom: 1rem;
}
.kinds-table th,
.kinds-table td {
text-align: left;
padding: 0.5rem;
border-bottom: 1px solid #2a2d35;
}
.kinds-table-actions {
display: flex;
gap: 0.5rem;
}
.kind-editor {
display: flex;
flex-direction: column;
gap: 0.75rem;
border: 1px solid #2a2d35;
border-radius: 8px;
padding: 1rem;
max-width: 480px;
}
.kind-editor textarea {
font-family: ui-monospace, monospace;
font-size: 0.85rem;
}
.kind-editor-actions {
display: flex;
gap: 0.5rem;
}

44
frontend/src/App.tsx Normal file
View File

@@ -0,0 +1,44 @@
import { useState } from "react";
import "./App.css";
import { GarminConnection } from "./components/GarminConnection";
import { Dashboard } from "./pages/Dashboard";
import { ReviewQueue } from "./pages/ReviewQueue";
import { WorkoutKinds } from "./pages/WorkoutKinds";
const TABS = [
{ key: "dashboard", label: "Progression", Component: Dashboard },
{ key: "review", label: "Review Queue", Component: ReviewQueue },
{ key: "kinds", label: "Workout Kinds", Component: WorkoutKinds },
] as const;
type TabKey = (typeof TABS)[number]["key"];
function App() {
const [tab, setTab] = useState<TabKey>("dashboard");
const Active = TABS.find((t) => t.key === tab)!.Component;
return (
<div className="app">
<header className="app-header">
<h1>smartrun</h1>
<nav className="tabs">
{TABS.map((t) => (
<button
key={t.key}
className={t.key === tab ? "tab active" : "tab"}
onClick={() => setTab(t.key)}
>
{t.label}
</button>
))}
</nav>
</header>
<GarminConnection />
<main>
<Active />
</main>
</div>
);
}
export default App;

View File

@@ -0,0 +1,81 @@
import type {
Activity,
AuthResponse,
KindAssignment,
ProgressionMetric,
ProgressionPoint,
ReviewQueueItem,
SyncRun,
SyncStatus,
WorkoutKind,
} from "../types/api";
const BASE_URL = import.meta.env.VITE_API_BASE_URL ?? "http://localhost:8080";
async function request<T>(path: string, init?: RequestInit): Promise<T> {
const res = await fetch(`${BASE_URL}${path}`, {
headers: { "Content-Type": "application/json" },
...init,
});
if (!res.ok) {
const body = await res.text();
throw new Error(`${init?.method ?? "GET"} ${path} failed: ${res.status} ${body}`);
}
if (res.status === 204) return undefined as T;
return res.json() as Promise<T>;
}
export const api = {
// Auth
login: () => request<AuthResponse>("/api/auth/login", { method: "POST" }),
submitMFA: (code: string) =>
request<AuthResponse>("/api/auth/mfa", { method: "POST", body: JSON.stringify({ code }) }),
authStatus: () => request<AuthResponse>("/api/auth/status"),
// Sync
syncRun: () => request<{ status: string }>("/api/sync/run", { method: "POST" }),
syncBackfill: () => request<{ status: string }>("/api/sync/backfill", { method: "POST" }),
syncRuns: () => request<SyncRun[]>("/api/sync/runs"),
syncStatus: () => request<SyncStatus>("/api/sync/status"),
// Activities
listActivities: (params?: { from?: string; to?: string; limit?: number }) => {
const q = new URLSearchParams();
if (params?.from) q.set("from", params.from);
if (params?.to) q.set("to", params.to);
if (params?.limit) q.set("limit", String(params.limit));
const qs = q.toString();
return request<Activity[]>(`/api/activities/${qs ? `?${qs}` : ""}`);
},
getActivity: (id: number) =>
request<{ activity: Activity; laps: unknown[]; assignment?: KindAssignment }>(`/api/activities/${id}`),
// Workout kinds
listWorkoutKinds: (includeInactive = false) =>
request<WorkoutKind[]>(`/api/workout-kinds/${includeInactive ? "?include_inactive=true" : ""}`),
createWorkoutKind: (body: { name: string; description?: string; color?: string; rule: unknown; priority?: number }) =>
request<WorkoutKind>("/api/workout-kinds/", { method: "POST", body: JSON.stringify(body) }),
updateWorkoutKind: (
id: number,
body: { name: string; description?: string; color?: string; rule: unknown; priority?: number; is_active?: boolean },
) => request<WorkoutKind>(`/api/workout-kinds/${id}`, { method: "PUT", body: JSON.stringify(body) }),
deleteWorkoutKind: (id: number) => request<void>(`/api/workout-kinds/${id}`, { method: "DELETE" }),
reclassifyWorkoutKind: (id: number) =>
request<{ reclassified: number }>(`/api/workout-kinds/${id}/reclassify`, { method: "POST" }),
// Review queue
reviewQueue: () => request<ReviewQueueItem[]>("/api/review-queue/"),
resolveReview: (activityId: number, workoutKindId: number) =>
request<{ status: string }>(`/api/review-queue/${activityId}/resolve`, {
method: "POST",
body: JSON.stringify({ workout_kind_id: workoutKindId }),
}),
// Progression
progression: (kindId: number, metric: ProgressionMetric = "pace", from?: string, to?: string) => {
const q = new URLSearchParams({ metric });
if (from) q.set("from", from);
if (to) q.set("to", to);
return request<ProgressionPoint[]>(`/api/progression/${kindId}?${q.toString()}`);
},
};

View File

@@ -0,0 +1,143 @@
import { useEffect, useRef, useState } from "react";
import { api } from "../api/client";
import type { AuthResponse, SyncStatus } from "../types/api";
function syncProgressLabel(status: SyncStatus): string {
const { detail_fill_progress: fill, activities_pending_details: pending } = status;
if (fill.Total > 0) {
// pending includes the current batch, so subtract what's already
// counted in this batch's Total to avoid double-counting the "beyond
// this batch" remainder.
const beyondBatch = Math.max(0, pending - (fill.Total - fill.Done));
return `syncing: ${fill.Done}/${fill.Total} activities${beyondBatch > 0 ? ` (+${beyondBatch} more queued)` : ""}`;
}
return "syncing...";
}
export function GarminConnection() {
const [auth, setAuth] = useState<AuthResponse | null>(null);
const [code, setCode] = useState("");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const [syncStatus, setSyncStatus] = useState<SyncStatus | null>(null);
function refreshStatus() {
api.authStatus().then(setAuth).catch((e) => setError(String(e)));
api.syncStatus().then(setSyncStatus).catch(() => {});
}
// Poll faster while a sync is actually running, so progress feels live;
// back off to a relaxed interval the rest of the time.
const syncStatusRef = useRef(syncStatus);
syncStatusRef.current = syncStatus;
useEffect(() => {
refreshStatus();
let timeout: ReturnType<typeof setTimeout>;
const tick = () => {
refreshStatus();
timeout = setTimeout(tick, syncStatusRef.current?.in_progress ? 1500 : 6000);
};
timeout = setTimeout(tick, 1500);
return () => clearTimeout(timeout);
}, []);
async function connect() {
setBusy(true);
setError(null);
try {
setAuth(await api.login());
} catch (e) {
setError(String(e));
} finally {
setBusy(false);
}
}
async function submitMFA() {
if (!code.trim()) return;
setBusy(true);
setError(null);
try {
setAuth(await api.submitMFA(code.trim()));
setCode("");
} catch (e) {
setError(String(e));
} finally {
setBusy(false);
}
}
async function sync(kind: "run" | "backfill") {
setBusy(true);
setError(null);
try {
await (kind === "run" ? api.syncRun() : api.syncBackfill());
refreshStatus();
} catch (e) {
setError(String(e));
} finally {
setBusy(false);
}
}
const status = auth?.status ?? "unknown";
return (
<div className="garmin-connection">
<div className="garmin-connection-row">
<span className={`status-dot status-${status}`} />
<span className="status-label">
{status === "authenticated" && "Connected to Garmin"}
{status === "mfa_required" && "MFA code required"}
{status === "failed" && "Connection failed"}
{status === "unknown" && "Not connected to Garmin"}
</span>
{status !== "authenticated" && status !== "mfa_required" && (
<button disabled={busy} onClick={connect}>
Connect to Garmin
</button>
)}
{status === "authenticated" && (
<>
<button disabled={busy} onClick={() => sync("run")}>
Sync now
</button>
<button disabled={busy} onClick={() => sync("backfill")}>
Full backfill
</button>
{syncStatus?.in_progress && (
<span className="status-label">{syncProgressLabel(syncStatus)}</span>
)}
{syncStatus?.last_run && !syncStatus.in_progress && (
<span className="status-label">
last sync: {syncStatus.last_run.Status} ({syncStatus.last_run.ActivitiesFetched} activities)
{syncStatus.activities_pending_details > 0 &&
`${syncStatus.activities_pending_details} still need details, click Sync now again`}
</span>
)}
</>
)}
</div>
{status === "mfa_required" && (
<div className="garmin-connection-row">
<input
placeholder="MFA code"
value={code}
onChange={(e) => setCode(e.target.value)}
onKeyDown={(e) => e.key === "Enter" && submitMFA()}
/>
<button disabled={busy} onClick={submitMFA}>
Submit code
</button>
</div>
)}
{auth?.message && <p className="garmin-connection-message">{auth.message}</p>}
{error && <p className="error">{error}</p>}
</div>
);
}

View File

@@ -0,0 +1,36 @@
import { CartesianGrid, Line, LineChart, ResponsiveContainer, Tooltip, XAxis, YAxis } from "recharts";
import type { ProgressionPoint } from "../../types/api";
const METRIC_LABELS: Record<string, string> = {
pace: "Pace (sec/km)",
hr: "Avg HR (bpm)",
vo2max: "VO2max",
aerobic_te: "Aerobic Training Effect",
anaerobic_te: "Anaerobic Training Effect",
};
export function ProgressionChart({ points, metric }: { points: ProgressionPoint[]; metric: string }) {
if (points.length === 0) {
return <p className="empty-state">No data yet for this metric.</p>;
}
const data = points.map((p) => ({ date: p.date.slice(0, 10), value: p.value }));
return (
<ResponsiveContainer width="100%" height={320}>
<LineChart data={data} margin={{ top: 8, right: 16, bottom: 8, left: 8 }}>
<CartesianGrid strokeDasharray="3 3" opacity={0.3} />
<XAxis dataKey="date" tick={{ fontSize: 12 }} />
<YAxis
tick={{ fontSize: 12 }}
reversed={metric === "pace"}
label={{ value: METRIC_LABELS[metric] ?? metric, angle: -90, position: "insideLeft", fontSize: 12 }}
/>
<Tooltip
formatter={(value) => [Number(value).toFixed(1), METRIC_LABELS[metric] ?? metric]}
/>
<Line type="monotone" dataKey="value" stroke="#3b82f6" strokeWidth={2} dot={{ r: 3 }} />
</LineChart>
</ResponsiveContainer>
);
}

9
frontend/src/main.tsx Normal file
View File

@@ -0,0 +1,9 @@
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import App from './App.tsx'
createRoot(document.getElementById('root')!).render(
<StrictMode>
<App />
</StrictMode>,
)

View File

@@ -0,0 +1,86 @@
import { useEffect, useState } from "react";
import { api } from "../api/client";
import { ProgressionChart } from "../components/charts/ProgressionChart";
import type { ProgressionMetric, ProgressionPoint, WorkoutKind } from "../types/api";
const METRICS: { key: ProgressionMetric; label: string }[] = [
{ key: "pace", label: "Pace" },
{ key: "hr", label: "Heart Rate" },
{ key: "vo2max", label: "VO2max" },
{ key: "aerobic_te", label: "Aerobic Training Effect" },
{ key: "anaerobic_te", label: "Anaerobic Training Effect" },
];
export function Dashboard() {
const [kinds, setKinds] = useState<WorkoutKind[]>([]);
const [selectedKindId, setSelectedKindId] = useState<number | null>(null);
const [metric, setMetric] = useState<ProgressionMetric>("pace");
const [points, setPoints] = useState<ProgressionPoint[]>([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
api
.listWorkoutKinds()
.then((k) => {
setKinds(k);
if (k.length > 0) setSelectedKindId(k[0].ID);
})
.catch((e) => setError(String(e)));
}, []);
useEffect(() => {
if (selectedKindId == null) return;
setLoading(true);
setError(null);
api
.progression(selectedKindId, metric)
.then(setPoints)
.catch((e) => setError(String(e)))
.finally(() => setLoading(false));
}, [selectedKindId, metric]);
return (
<div className="page">
<h2>Progression</h2>
{kinds.length === 0 ? (
<p className="empty-state">
No workout kinds defined yet. Create one on the Workout Kinds tab to start seeing progression here.
</p>
) : (
<>
<div className="controls">
<label>
Workout kind
<select
value={selectedKindId ?? ""}
onChange={(e) => setSelectedKindId(Number(e.target.value))}
>
{kinds.map((k) => (
<option key={k.ID} value={k.ID}>
{k.Name}
</option>
))}
</select>
</label>
<label>
Metric
<select value={metric} onChange={(e) => setMetric(e.target.value as ProgressionMetric)}>
{METRICS.map((m) => (
<option key={m.key} value={m.key}>
{m.label}
</option>
))}
</select>
</label>
</div>
{error && <p className="error">{error}</p>}
{loading ? <p>Loading...</p> : <ProgressionChart points={points} metric={metric} />}
</>
)}
</div>
);
}

View File

@@ -0,0 +1,89 @@
import { useEffect, useState } from "react";
import { api } from "../api/client";
import type { ReviewQueueItem, ScoredKind, WorkoutKind } from "../types/api";
function candidates(item: ReviewQueueItem): ScoredKind[] {
try {
return JSON.parse(item.CandidateKindsJSON) as ScoredKind[];
} catch {
return [];
}
}
export function ReviewQueue() {
const [items, setItems] = useState<ReviewQueueItem[]>([]);
const [kinds, setKinds] = useState<WorkoutKind[]>([]);
const [error, setError] = useState<string | null>(null);
const [resolvingId, setResolvingId] = useState<number | null>(null);
function reload() {
Promise.all([api.reviewQueue(), api.listWorkoutKinds()])
.then(([reviewItems, workoutKinds]) => {
setItems(reviewItems);
setKinds(workoutKinds);
})
.catch((e) => setError(String(e)));
}
useEffect(reload, []);
async function resolve(activityId: number, kindId: number) {
setResolvingId(activityId);
try {
await api.resolveReview(activityId, kindId);
setItems((prev) => prev.filter((i) => i.ActivityID !== activityId));
} catch (e) {
setError(String(e));
} finally {
setResolvingId(null);
}
}
return (
<div className="page">
<h2>Review Queue</h2>
{error && <p className="error">{error}</p>}
{items.length === 0 ? (
<p className="empty-state">Nothing needs review right now.</p>
) : (
<ul className="review-list">
{items.map((item) => {
const scored = candidates(item);
return (
<li key={item.ActivityID} className="review-item">
<div className="review-item-header">
<strong>{item.activity.ActivityName || item.activity.ActivityType}</strong>
<span>{item.activity.StartTimeUTC}</span>
</div>
<div className="review-item-stats">
<span>{(item.activity.DistanceMeters / 1000).toFixed(2)} km</span>
<span>{Math.round(item.activity.DurationSeconds / 60)} min</span>
{item.activity.AvgHR != null && <span>{Math.round(item.activity.AvgHR)} bpm avg</span>}
</div>
{scored.length > 0 && (
<p className="candidates">
Rule engine candidates: {scored.map((c) => `${c.name} (${c.score.toFixed(2)})`).join(", ")}
</p>
)}
<div className="review-item-actions">
{kinds.map((k) => (
<button
key={k.ID}
disabled={resolvingId === item.ActivityID}
onClick={() => resolve(item.ActivityID, k.ID)}
>
{k.Name}
</button>
))}
</div>
</li>
);
})}
</ul>
)}
</div>
);
}

View File

@@ -0,0 +1,148 @@
import { useEffect, useState } from "react";
import { api } from "../api/client";
import type { WorkoutKind } from "../types/api";
const EXAMPLE_RULE = `{
"match": "all",
"conditions": [
{ "metric": "avg_pace_sec_per_km", "op": "between", "value": [330, 420] },
{ "metric": "avg_hr_pct_max", "op": "<=", "value": 0.75 }
]
}`;
export function WorkoutKinds() {
const [kinds, setKinds] = useState<WorkoutKind[]>([]);
const [editingId, setEditingId] = useState<number | "new" | null>(null);
const [name, setName] = useState("");
const [description, setDescription] = useState("");
const [ruleText, setRuleText] = useState(EXAMPLE_RULE);
const [error, setError] = useState<string | null>(null);
const [busyId, setBusyId] = useState<number | null>(null);
function reload() {
api.listWorkoutKinds(true).then(setKinds).catch((e) => setError(String(e)));
}
useEffect(reload, []);
function startCreate() {
setEditingId("new");
setName("");
setDescription("");
setRuleText(EXAMPLE_RULE);
setError(null);
}
function startEdit(k: WorkoutKind) {
setEditingId(k.ID);
setName(k.Name);
setDescription(k.Description);
setRuleText(JSON.stringify(JSON.parse(k.RuleJSON || "{}"), null, 2));
setError(null);
}
async function save() {
let rule: unknown;
try {
rule = JSON.parse(ruleText);
} catch {
setError("Rule is not valid JSON");
return;
}
try {
if (editingId === "new") {
await api.createWorkoutKind({ name, description, rule });
} else if (typeof editingId === "number") {
await api.updateWorkoutKind(editingId, { name, description, rule });
}
setEditingId(null);
reload();
} catch (e) {
setError(String(e));
}
}
async function remove(id: number) {
setBusyId(id);
try {
await api.deleteWorkoutKind(id);
reload();
} catch (e) {
setError(String(e));
} finally {
setBusyId(null);
}
}
async function reclassify(id: number) {
setBusyId(id);
try {
const res = await api.reclassifyWorkoutKind(id);
setError(`Reclassified ${res.reclassified} activities.`);
} catch (e) {
setError(String(e));
} finally {
setBusyId(null);
}
}
return (
<div className="page">
<h2>Workout Kinds</h2>
{error && <p className="error">{error}</p>}
<table className="kinds-table">
<thead>
<tr>
<th>Name</th>
<th>Description</th>
<th>Active</th>
<th></th>
</tr>
</thead>
<tbody>
{kinds.map((k) => (
<tr key={k.ID}>
<td>{k.Name}</td>
<td>{k.Description}</td>
<td>{k.IsActive ? "yes" : "no"}</td>
<td className="kinds-table-actions">
<button onClick={() => startEdit(k)}>Edit</button>
<button disabled={busyId === k.ID} onClick={() => reclassify(k.ID)}>
Reclassify
</button>
<button disabled={busyId === k.ID} onClick={() => remove(k.ID)}>
Delete
</button>
</td>
</tr>
))}
</tbody>
</table>
{editingId === null ? (
<button onClick={startCreate}>+ New workout kind</button>
) : (
<div className="kind-editor">
<label>
Name
<input value={name} onChange={(e) => setName(e.target.value)} />
</label>
<label>
Description
<input value={description} onChange={(e) => setDescription(e.target.value)} />
</label>
<label>
Rule (JSON condition tree)
<textarea rows={12} value={ruleText} onChange={(e) => setRuleText(e.target.value)} />
</label>
<div className="kind-editor-actions">
<button onClick={save}>Save</button>
<button onClick={() => setEditingId(null)}>Cancel</button>
</div>
</div>
)}
</div>
);
}

116
frontend/src/types/api.ts Normal file
View File

@@ -0,0 +1,116 @@
// Hand-written types mirroring backend/internal/api's JSON DTOs. Kept in
// sync manually while the API surface is small; revisit codegen once it
// stabilizes post-MVP.
export interface Activity {
ID: number;
GarminActivityID: number;
ActivityName: string;
ActivityType: string;
StartTimeUTC: string;
BeginTimestampMs: number;
DurationSeconds: number;
DistanceMeters: number;
AvgHR: number | null;
MaxHR: number | null;
AvgSpeedMps: number | null;
MaxSpeedMps: number | null;
ElevationGainM: number | null;
ElevationLossM: number | null;
Calories: number | null;
LapCount: number;
AerobicTrainingEffect: number | null;
AnaerobicTrainingEffect: number | null;
TrainingEffectLabel: string;
VO2MaxValue: number | null;
DetailsFetchedAt: string | null;
SplitsFetchedAt: string | null;
CreatedAt: string;
UpdatedAt: string;
}
export interface Lap {
ID: number;
ActivityID: number;
LapIndex: number;
StartTimeUTC: string;
DurationSeconds: number;
DistanceMeters: number;
AvgHR: number | null;
MaxHR: number | null;
AvgSpeedMps: number | null;
MaxSpeedMps: number | null;
ElevationGainM: number | null;
ElevationLossM: number | null;
IntensityType: string;
HRDriftBpmPerMin: number | null;
HRRecoveryBpmPerMin: number | null;
}
export interface WorkoutKind {
ID: number;
Name: string;
Description: string;
Color: string;
RuleJSON: string;
Priority: number;
IsActive: boolean;
CreatedAt: string;
UpdatedAt: string;
}
export interface ScoredKind {
workout_kind_id: number;
name: string;
score: number;
}
export interface KindAssignment {
ID: number;
ActivityID: number;
WorkoutKindID: number | null;
AssignmentSource: "rule_engine" | "manual";
Status: "assigned" | "needs_review";
Confidence: number | null;
CandidateKindsJSON: string;
CreatedAt: string;
}
export interface ReviewQueueItem extends KindAssignment {
activity: Activity;
}
export interface ProgressionPoint {
date: string;
activity_id: number;
value: number;
}
export interface SyncRun {
ID: number;
Kind: "backfill" | "incremental";
StartedAt: string;
FinishedAt: string | null;
ActivitiesFetched: number;
Status: "running" | "success" | "error";
ErrorMessage: string | null;
}
export interface AuthResponse {
status: "authenticated" | "mfa_required" | "failed" | "unknown";
message: string;
}
export interface DetailFillProgress {
Done: number;
Total: number;
}
export interface SyncStatus {
in_progress: boolean;
detail_fill_progress: DetailFillProgress;
activities_pending_details: number;
last_run?: SyncRun;
}
export type ProgressionMetric = "pace" | "hr" | "vo2max" | "aerobic_te" | "anaerobic_te";

View File

@@ -0,0 +1,26 @@
{
"compilerOptions": {
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
"target": "es2023",
"lib": ["ES2023", "DOM"],
"module": "esnext",
"types": ["vite/client"],
"allowArbitraryExtensions": true,
"skipLibCheck": true,
/* Bundler mode */
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"verbatimModuleSyntax": true,
"moduleDetection": "force",
"noEmit": true,
"jsx": "react-jsx",
/* Linting */
"noUnusedLocals": true,
"noUnusedParameters": true,
"erasableSyntaxOnly": true,
"noFallthroughCasesInSwitch": true
},
"include": ["src"]
}

7
frontend/tsconfig.json Normal file
View File

@@ -0,0 +1,7 @@
{
"files": [],
"references": [
{ "path": "./tsconfig.app.json" },
{ "path": "./tsconfig.node.json" }
]
}

View File

@@ -0,0 +1,23 @@
{
"compilerOptions": {
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
"target": "es2023",
"lib": ["ES2023"],
"types": ["node"],
"skipLibCheck": true,
/* Bundler mode */
"module": "nodenext",
"allowImportingTsExtensions": true,
"verbatimModuleSyntax": true,
"moduleDetection": "force",
"noEmit": true,
/* Linting */
"noUnusedLocals": true,
"noUnusedParameters": true,
"erasableSyntaxOnly": true,
"noFallthroughCasesInSwitch": true
},
"include": ["vite.config.ts"]
}

7
frontend/vite.config.ts Normal file
View File

@@ -0,0 +1,7 @@
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
// https://vite.dev/config/
export default defineConfig({
plugins: [react()],
})