# moyshavondervals/trainingapp architecture

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

- Interactive diagram: https://gitdiagram.com/moyshavondervals/trainingapp
- Repository: https://github.com/moyshavondervals/trainingapp

## Overview

trainingApp is a strength-training journal with a React client and Go HTTP API backed by PostgreSQL. Users authenticate, record workouts and sets, manage exercises and training plans, and review training statistics and body-weight trends. The graph follows those user-facing capabilities through the client API and server layers. Backend handler-to-repository links are shown at subsystem level based on the README’s architecture description; unsampled handler implementations were not inspected.

Main entry points: [`frontend/src/App.tsx`](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/App.tsx) (App routing), [`frontend/src/api/client.ts`](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/api/client.ts) (API client), [`internal/api`](https://github.com/moyshavondervals/trainingapp/tree/main/internal/api) (HTTP handlers), [`frontend/src/auth/AuthContext.tsx`](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/auth/AuthContext.tsx) (Session context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routing<br/>[App.tsx]"]
  node_authui["Session context<br/>[AuthContext.tsx]"]
  node_authguard["Route guard<br/>[RequireAuth.tsx]"]
  node_clientapi["API client<br/>[client.ts]"]
  node_workouts["Workout journal<br/>[Workouts.tsx]"]
  node_workoutdetail["Set logging<br/>[WorkoutDetail.tsx]"]
  node_exercises["Exercise catalog<br/>[Exercises.tsx]"]
  node_musclepicker["Muscle picker<br/>[MusclePicker.tsx]"]
  node_plans["Training plans<br/>[Plans.tsx]"]
  node_stats["Training statistics<br/>[Stats.tsx]"]
  node_weight["Body weight<br/>[Weight.tsx]"]
  node_weightchart["Weight chart<br/>[WeightChart.tsx]"]
  node_sharedcomponents["Shared controls"]
end

subgraph group_server["HTTP and domain"]
  node_api["HTTP handlers"]
  node_domain["Domain models"]
end

subgraph group_storage["Persistence"]
  node_repositories["SQL repositories"]
end

subgraph group_security["Authentication"]
  node_jwt["JWT auth<br/>[jwt.go]"]
end

node_trainee(("Trainee"))
node_postgres[("PostgreSQL")]

node_trainee -->|"uses"| node_app
node_app -->|"provides session"| node_authui
node_app -->|"guards routes"| node_authguard
node_app -->|"routes to"| node_workouts
node_app -->|"routes to"| node_workoutdetail
node_app -->|"routes to"| node_exercises
node_app -->|"routes to"| node_stats
node_app -->|"routes to"| node_weight
node_app -->|"routes to"| node_plans
node_authui -->|"calls"| node_clientapi
node_authguard -->|"checks session"| node_authui
node_workouts -->|"requests data"| node_clientapi
node_workoutdetail -->|"logs sets"| node_clientapi
node_exercises -->|"manages catalog"| node_clientapi
node_exercises -->|"uses picker"| node_musclepicker
node_workoutdetail -->|"renders summary"| node_musclepicker
node_plans -->|"manages plans"| node_clientapi
node_stats -->|"loads statistics"| node_clientapi
node_weight -->|"manages entries"| node_clientapi
node_weight -->|"renders trend"| node_weightchart
node_plans -->|"uses controls"| node_sharedcomponents
node_clientapi -->|"sends API requests"| node_api
node_api -.->|"validates domain data"| node_domain
node_api -->|"calls repositories"| node_repositories
node_repositories -->|"queries"| node_postgres
node_api -->|"authenticates requests"| node_jwt
node_authui -->|"refreshes session"| node_clientapi

click node_app "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/auth/AuthContext.tsx"
click node_authguard "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/auth/RequireAuth.tsx"
click node_clientapi "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/api/client.ts"
click node_workouts "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Workouts.tsx"
click node_workoutdetail "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/WorkoutDetail.tsx"
click node_exercises "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Exercises.tsx"
click node_musclepicker "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/components/MusclePicker.tsx"
click node_plans "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Plans.tsx"
click node_stats "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Stats.tsx"
click node_weight "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Weight.tsx"
click node_weightchart "https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/components/WeightChart.tsx"
click node_sharedcomponents "https://github.com/moyshavondervals/trainingapp/tree/main/frontend/src/components"
click node_api "https://github.com/moyshavondervals/trainingapp/tree/main/internal/api"
click node_domain "https://github.com/moyshavondervals/trainingapp/tree/main/internal"
click node_jwt "https://github.com/moyshavondervals/trainingapp/blob/main/internal/auth/jwt.go"
click node_repositories "https://github.com/moyshavondervals/trainingapp/tree/main/internal/postgres"

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_app,node_authui,node_authguard,node_clientapi,node_workouts,node_workoutdetail,node_exercises,node_musclepicker,node_plans,node_stats,node_weight,node_weightchart,node_sharedcomponents toneBlue
class node_api,node_domain,node_postgres toneAmber
class node_repositories toneMint
class node_jwt toneRose
class node_trainee toneIndigo
```

## Components

### React client

- [App routing](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session context](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/auth/AuthContext.tsx): `frontend/src/auth/AuthContext.tsx`
- [Route guard](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/auth/RequireAuth.tsx): `frontend/src/auth/RequireAuth.tsx`
- [API client](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Workout journal](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Workouts.tsx): `frontend/src/pages/Workouts.tsx`
- [Set logging](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/WorkoutDetail.tsx): `frontend/src/pages/WorkoutDetail.tsx`
- [Exercise catalog](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Exercises.tsx): `frontend/src/pages/Exercises.tsx`
- [Muscle picker](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/components/MusclePicker.tsx): `frontend/src/components/MusclePicker.tsx`
- [Training plans](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Plans.tsx): `frontend/src/pages/Plans.tsx`
- [Training statistics](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Stats.tsx): `frontend/src/pages/Stats.tsx`
- [Body weight](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/pages/Weight.tsx): `frontend/src/pages/Weight.tsx`
- [Weight chart](https://github.com/moyshavondervals/trainingapp/blob/main/frontend/src/components/WeightChart.tsx): `frontend/src/components/WeightChart.tsx`
- [Shared controls](https://github.com/moyshavondervals/trainingapp/tree/main/frontend/src/components): `frontend/src/components`

### HTTP and domain

- [HTTP handlers](https://github.com/moyshavondervals/trainingapp/tree/main/internal/api): `internal/api`
- [Domain models](https://github.com/moyshavondervals/trainingapp/tree/main/internal): `internal`

### Persistence

- [SQL repositories](https://github.com/moyshavondervals/trainingapp/tree/main/internal/postgres): `internal/postgres`

### Authentication

- [JWT auth](https://github.com/moyshavondervals/trainingapp/blob/main/internal/auth/jwt.go): `internal/auth/jwt.go`

### Other components

- **Trainee**
- **PostgreSQL**

## Connections

- Trainee → App routing: uses
- App routing → Session context: provides session (evidence: `frontend/src/App.tsx`)
- App routing → Route guard: guards routes (evidence: `frontend/src/App.tsx`)
- App routing → Workout journal: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Set logging: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Exercise catalog: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Training statistics: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Body weight: routes to (evidence: `frontend/src/App.tsx`)
- App routing → Training plans: routes to (evidence: `frontend/src/App.tsx`)
- Session context → API client: calls (evidence: `frontend/src/auth/AuthContext.tsx`)
- Route guard → Session context: checks session (evidence: `frontend/src/auth/RequireAuth.tsx`)
- Workout journal → API client: requests data (evidence: `frontend/src/pages/Workouts.tsx`)
- Set logging → API client: logs sets (evidence: `frontend/src/pages/WorkoutDetail.tsx`)
- Exercise catalog → API client: manages catalog (evidence: `frontend/src/pages/Exercises.tsx`)
- Exercise catalog → Muscle picker: uses picker (evidence: `frontend/src/pages/Exercises.tsx`)
- Set logging → Muscle picker: renders summary (evidence: `frontend/src/pages/WorkoutDetail.tsx`)
- Training plans → API client: manages plans (evidence: `frontend/src/pages/Plans.tsx`)
- Training statistics → API client: loads statistics (evidence: `frontend/src/pages/Stats.tsx`)
- Body weight → API client: manages entries (evidence: `frontend/src/pages/Weight.tsx`)
- Body weight → Weight chart: renders trend (evidence: `frontend/src/pages/Weight.tsx`)
- Training plans → Shared controls: uses controls (evidence: `frontend/src/pages/Plans.tsx`)
- API client → HTTP handlers: sends API requests
- HTTP handlers → Domain models: validates domain data
- HTTP handlers → SQL repositories: calls repositories
- SQL repositories → PostgreSQL: queries
- HTTP handlers → JWT auth: authenticates requests
- Session context → API client: refreshes session (evidence: `frontend/src/auth/AuthContext.tsx`)
