# grigxy/fitness-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/grigxy/fitness-assistant
- Repository: https://github.com/grigxy/fitness-assistant

## Overview

Fitness Assistant is a REST-backed fitness tracker for nutrition, hydration, workouts, progress, and motivation, with a built-in static browser frontend. The user workflow is browser/API use through controllers into domain use cases, with persistence behind repository ports. The README documents additional capabilities such as targets, favorites, sharing, admin management, and JWT authentication. Source excerpts are limited to the frontend API helper, so implementation links beyond its shown requests are omitted or marked unverified.

Main entry points: [`src/main/java/com/example/fitness_assistant/web/controller`](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/web/controller) (REST controllers), [`src/main/java/com/example/fitness_assistant/core/repository`](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/core/repository) (Repository ports), [`src/main/resources/static/js/api.js`](https://github.com/grigxy/fitness-assistant/blob/main/src/main/resources/static/js/api.js) (API client), [`src/main/java/com/example/fitness_assistant/application/service/user`](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/user) (Accounts and profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["Browser frontend"]
  node_api_js["API client<br/>[api.js]"]
  node_browser(("Browser"))
end

subgraph group_web["HTTP and security"]
  node_auth["Authentication"]
  node_controllers["REST controllers"]
  node_jwt["JWT security"]
end

subgraph group_domain["Fitness workflows"]
  node_users["Accounts and profiles"]
  node_targets["Targets and streaks"]
  node_nutrition["Food and meals"]
  node_hydration["Hydration log"]
  node_bodyweight["Weight tracking"]
  node_workouts["Workout plans"]
  node_sessions["Workout sessions"]
  node_catalogs["Exercise catalog"]
  node_sharing["Workout sharing"]
  node_favorites["Favorites"]
end

subgraph group_data["Persistence"]
  node_ports["Repository ports"]
  node_adapters["JPA adapters"]
  node_database[("PostgreSQL data")]
end

node_user(("Fitness user"))

node_user -.->|"uses"| node_browser
node_browser -.->|"loads"| node_api_js
node_api_js -->|"calls API"| node_controllers
node_api_js -->|"deletes account"| node_auth
node_controllers -.->|"dispatches"| node_users
node_controllers -.->|"dispatches"| node_targets
node_controllers -.->|"dispatches"| node_nutrition
node_controllers -.->|"dispatches"| node_hydration
node_controllers -.->|"dispatches"| node_bodyweight
node_controllers -.->|"dispatches"| node_workouts
node_controllers -.->|"dispatches"| node_sessions
node_controllers -.->|"dispatches"| node_catalogs
node_controllers -.->|"dispatches"| node_sharing
node_controllers -.->|"dispatches"| node_favorites
node_auth -.->|"authenticates"| node_users
node_jwt -.->|"secures"| node_controllers
node_users -.->|"uses"| node_ports
node_targets -.->|"uses"| node_ports
node_nutrition -.->|"uses"| node_ports
node_hydration -.->|"uses"| node_ports
node_bodyweight -.->|"uses"| node_ports
node_workouts -.->|"uses"| node_ports
node_sessions -.->|"uses"| node_ports
node_catalogs -.->|"uses"| node_ports
node_sharing -.->|"uses"| node_ports
node_favorites -.->|"uses"| node_ports
node_adapters -.->|"implements"| node_ports
node_adapters -.->|"persists"| node_database

click node_api_js "https://github.com/grigxy/fitness-assistant/blob/main/src/main/resources/static/js/api.js"
click node_auth "https://github.com/grigxy/fitness-assistant/blob/main/src/main/java/com/example/fitness_assistant/web/controller/AuthController.java"
click node_controllers "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/web/controller"
click node_jwt "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/security"
click node_users "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/user"
click node_targets "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/targets"
click node_nutrition "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/food"
click node_hydration "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/hydration"
click node_bodyweight "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/bodyweight"
click node_workouts "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workout"
click node_sessions "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workoutsession"
click node_catalogs "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/exercise"
click node_sharing "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workoutaccess"
click node_favorites "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/favoritefood"
click node_ports "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/core/repository"
click node_adapters "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/adapter"
click node_database "https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/persistence"

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_api_js,node_browser,node_user toneBlue
class node_auth,node_controllers,node_jwt toneAmber
class node_users,node_targets,node_nutrition,node_hydration,node_bodyweight,node_workouts,node_sessions,node_catalogs,node_sharing,node_favorites toneMint
class node_ports,node_adapters,node_database toneRose
```

## Components

### Browser frontend

- [API client](https://github.com/grigxy/fitness-assistant/blob/main/src/main/resources/static/js/api.js): `src/main/resources/static/js/api.js`
- **Browser**

### HTTP and security

- [Authentication](https://github.com/grigxy/fitness-assistant/blob/main/src/main/java/com/example/fitness_assistant/web/controller/AuthController.java): `src/main/java/com/example/fitness_assistant/web/controller/AuthController.java`
- [REST controllers](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/web/controller): `src/main/java/com/example/fitness_assistant/web/controller`
- [JWT security](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/security): `src/main/java/com/example/fitness_assistant/infrastructure/security`

### Fitness workflows

- [Accounts and profiles](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/user): `src/main/java/com/example/fitness_assistant/application/service/user`
- [Targets and streaks](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/targets): `src/main/java/com/example/fitness_assistant/application/service/targets`
- [Food and meals](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/food): `src/main/java/com/example/fitness_assistant/application/service/food`
- [Hydration log](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/hydration): `src/main/java/com/example/fitness_assistant/application/service/hydration`
- [Weight tracking](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/bodyweight): `src/main/java/com/example/fitness_assistant/application/service/bodyweight`
- [Workout plans](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workout): `src/main/java/com/example/fitness_assistant/application/service/workout`
- [Workout sessions](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workoutsession): `src/main/java/com/example/fitness_assistant/application/service/workoutsession`
- [Exercise catalog](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/exercise): `src/main/java/com/example/fitness_assistant/application/service/exercise`
- [Workout sharing](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/workoutaccess): `src/main/java/com/example/fitness_assistant/application/service/workoutaccess`
- [Favorites](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/application/service/favoritefood): `src/main/java/com/example/fitness_assistant/application/service/favoritefood`

### Persistence

- [Repository ports](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/core/repository): `src/main/java/com/example/fitness_assistant/core/repository`
- [JPA adapters](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/adapter): `src/main/java/com/example/fitness_assistant/infrastructure/adapter`
- [PostgreSQL data](https://github.com/grigxy/fitness-assistant/tree/main/src/main/java/com/example/fitness_assistant/infrastructure/persistence): `src/main/java/com/example/fitness_assistant/infrastructure/persistence`

### Other components

- **Fitness user**

## Connections

- Fitness user → Browser: uses (evidence: `README.md`)
- Browser → API client: loads (evidence: `README.md`)
- API client → REST controllers: calls API (evidence: `src/main/resources/static/js/api.js`)
- API client → Authentication: deletes account (evidence: `src/main/resources/static/js/api.js`)
- REST controllers → Accounts and profiles: dispatches (evidence: `README.md`)
- REST controllers → Targets and streaks: dispatches (evidence: `README.md`)
- REST controllers → Food and meals: dispatches (evidence: `README.md`)
- REST controllers → Hydration log: dispatches (evidence: `README.md`)
- REST controllers → Weight tracking: dispatches (evidence: `README.md`)
- REST controllers → Workout plans: dispatches (evidence: `README.md`)
- REST controllers → Workout sessions: dispatches (evidence: `README.md`)
- REST controllers → Exercise catalog: dispatches (evidence: `README.md`)
- REST controllers → Workout sharing: dispatches (evidence: `README.md`)
- REST controllers → Favorites: dispatches (evidence: `README.md`)
- Authentication → Accounts and profiles: authenticates (evidence: `README.md`)
- JWT security → REST controllers: secures (evidence: `README.md`)
- Accounts and profiles → Repository ports: uses (evidence: `README.md`)
- Targets and streaks → Repository ports: uses (evidence: `README.md`)
- Food and meals → Repository ports: uses (evidence: `README.md`)
- Hydration log → Repository ports: uses (evidence: `README.md`)
- Weight tracking → Repository ports: uses (evidence: `README.md`)
- Workout plans → Repository ports: uses (evidence: `README.md`)
- Workout sessions → Repository ports: uses (evidence: `README.md`)
- Exercise catalog → Repository ports: uses (evidence: `README.md`)
- Workout sharing → Repository ports: uses (evidence: `README.md`)
- Favorites → Repository ports: uses (evidence: `README.md`)
- JPA adapters → Repository ports: implements (evidence: `README.md`)
- JPA adapters → PostgreSQL data: persists (evidence: `README.md`)
