# ramiz1337/fitness-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/ramiz1337/fitness-tracker
- Repository: https://github.com/ramiz1337/fitness-tracker

## Overview

Pulse Fit is a workout-planning application with a Next.js frontend and an ASP.NET Core API. Users can browse exercise and workout experiences, register or log in, and manage workouts; the API also supports workout use and comments. The backend persists users, exercises, workouts, and related records through EF Core and seeds exercise data at startup. The excerpts show backend routing and persistence, but no frontend API calls, so the connection between browser actions and API endpoints is not asserted.

Main entry points: [`Backend/Data/AppDbContext.cs`](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/AppDbContext.cs) (EF Core context), [`Backend/Program.cs`](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Program.cs) (ASP.NET API runtime), [`frontend/src/app/home/page.tsx`](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/home/page.tsx) (Home and discovery), [`Backend/Controllers/AuthController.cs`](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/AuthController.cs) (Register and login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experiences"]
  node_home["Home and discovery<br/>[page.tsx]"]
  node_exercises["Exercise library<br/>[page.tsx]"]
  node_calendar["Workout calendar<br/>[page.tsx]"]
  node_login["Login page<br/>[page.tsx]"]
  node_register["Registration page<br/>[page.tsx]"]
  node_homecards["Home cards<br/>[Card.tsx]"]
  node_headercard["Header cards<br/>[HeaderCard.tsx]"]
  node_personalcard["Personal cards<br/>[PersonalCard.tsx]"]
end

subgraph group_api["Backend API"]
  node_api_runtime["ASP.NET API runtime<br/>[Program.cs]"]
  node_workouts["Workout and comments API"]
  node_exercise_api["Exercise API"]
  node_user_api["User API<br/>[UserController.cs]"]
end

subgraph group_identity["Identity"]
  node_auth["Register and login<br/>[AuthController.cs]"]
  node_tokens["JWT tokens<br/>[TokenService.cs]"]
end

subgraph group_data["Persistence and domain"]
  node_dbcontext["EF Core context<br/>[AppDbContext.cs]"]
  node_store[("SQLite database")]
  node_domain_models["Workout and exercise records"]
  node_seeder["Exercise data seeding<br/>[DbSeeder.cs]"]
  node_exercise_seed["Exercise seed data<br/>[ExerciseSeed.cs]"]
end

node_user(("Fitness user"))

node_user -->|"views"| node_home
node_user -->|"browses"| node_exercises
node_user -.->|"tracks workouts"| node_calendar
node_user -.->|"signs in"| node_login
node_user -.->|"registers"| node_register
node_home -->|"renders"| node_homecards
node_home -->|"renders"| node_headercard
node_home -->|"renders"| node_personalcard
node_api_runtime -->|"routes requests"| node_auth
node_api_runtime -->|"routes requests"| node_workouts
node_api_runtime -->|"routes requests"| node_exercise_api
node_auth -->|"reads and writes"| node_dbcontext
node_auth -->|"creates token"| node_tokens
node_api_runtime -->|"registers service"| node_tokens
node_workouts -->|"reads and writes"| node_dbcontext
node_exercise_api -->|"queries exercises"| node_dbcontext
node_api_runtime -->|"configures SQLite"| node_dbcontext
node_dbcontext -->|"persists records"| node_store
node_dbcontext -->|"maps entities"| node_domain_models
node_api_runtime -->|"seeds at startup"| node_seeder
node_seeder -->|"populates database"| node_dbcontext
node_seeder -->|"loads exercise data"| node_exercise_seed

click node_home "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/home/page.tsx"
click node_exercises "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/exercises/page.tsx"
click node_calendar "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Calender/page.tsx"
click node_login "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/login/page.tsx"
click node_register "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/register/page.tsx"
click node_homecards "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/Card.tsx"
click node_headercard "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/HeaderCard.tsx"
click node_personalcard "https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/PersonalCard.tsx"
click node_api_runtime "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Program.cs"
click node_auth "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/AuthController.cs"
click node_tokens "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Services/TokenService.cs"
click node_workouts "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/WorkoutController.cs"
click node_exercise_api "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/ExerciseController.cs"
click node_user_api "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/UserController.cs"
click node_dbcontext "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/AppDbContext.cs"
click node_domain_models "https://github.com/ramiz1337/fitness-tracker/tree/master/Backend/Models"
click node_seeder "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/Seed/DbSeeder.cs"
click node_exercise_seed "https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/Seed/ExerciseSeed.cs"

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_home,node_exercises,node_calendar,node_login,node_register,node_homecards,node_headercard,node_personalcard,node_user toneBlue
class node_api_runtime,node_workouts,node_exercise_api,node_user_api toneAmber
class node_auth,node_tokens toneMint
class node_dbcontext,node_store,node_domain_models,node_seeder,node_exercise_seed toneRose
```

## Components

### Frontend experiences

- [Home and discovery](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/home/page.tsx): `frontend/src/app/home/page.tsx`
- [Exercise library](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/exercises/page.tsx): `frontend/src/app/exercises/page.tsx`
- [Workout calendar](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Calender/page.tsx): `frontend/src/app/Calender/page.tsx`
- [Login page](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/login/page.tsx): `frontend/src/app/login/page.tsx`
- [Registration page](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/register/page.tsx): `frontend/src/app/register/page.tsx`
- [Home cards](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/Card.tsx): `frontend/src/app/Components/Header/Card.tsx`
- [Header cards](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/HeaderCard.tsx): `frontend/src/app/Components/Header/HeaderCard.tsx`
- [Personal cards](https://github.com/ramiz1337/fitness-tracker/blob/master/frontend/src/app/Components/Header/PersonalCard.tsx): `frontend/src/app/Components/Header/PersonalCard.tsx`

### Backend API

- [ASP.NET API runtime](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Program.cs): `Backend/Program.cs`
- [Workout and comments API](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/WorkoutController.cs): `Backend/Controllers/WorkoutController.cs`
- [Exercise API](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/ExerciseController.cs): `Backend/Controllers/ExerciseController.cs`
- [User API](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/UserController.cs): `Backend/Controllers/UserController.cs`

### Identity

- [Register and login](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Controllers/AuthController.cs): `Backend/Controllers/AuthController.cs`
- [JWT tokens](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Services/TokenService.cs): `Backend/Services/TokenService.cs`

### Persistence and domain

- [EF Core context](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/AppDbContext.cs): `Backend/Data/AppDbContext.cs`
- **SQLite database**
- [Workout and exercise records](https://github.com/ramiz1337/fitness-tracker/tree/master/Backend/Models): `Backend/Models`
- [Exercise data seeding](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/Seed/DbSeeder.cs): `Backend/Data/Seed/DbSeeder.cs`
- [Exercise seed data](https://github.com/ramiz1337/fitness-tracker/blob/master/Backend/Data/Seed/ExerciseSeed.cs): `Backend/Data/Seed/ExerciseSeed.cs`

### Other components

- **Fitness user**

## Connections

- Fitness user → Home and discovery: views (evidence: `frontend/src/app/home/page.tsx`)
- Fitness user → Exercise library: browses
- Fitness user → Workout calendar: tracks workouts
- Fitness user → Login page: signs in
- Fitness user → Registration page: registers
- Home and discovery → Home cards: renders (evidence: `frontend/src/app/home/page.tsx`)
- Home and discovery → Header cards: renders (evidence: `frontend/src/app/home/page.tsx`)
- Home and discovery → Personal cards: renders (evidence: `frontend/src/app/home/page.tsx`)
- ASP.NET API runtime → Register and login: routes requests (evidence: `Backend/Program.cs`)
- ASP.NET API runtime → Workout and comments API: routes requests (evidence: `Backend/Program.cs`)
- ASP.NET API runtime → Exercise API: routes requests (evidence: `Backend/Program.cs`)
- Register and login → EF Core context: reads and writes (evidence: `Backend/Controllers/AuthController.cs`)
- Register and login → JWT tokens: creates token (evidence: `Backend/Controllers/AuthController.cs`)
- ASP.NET API runtime → JWT tokens: registers service (evidence: `Backend/Program.cs`)
- Workout and comments API → EF Core context: reads and writes (evidence: `Backend/Controllers/WorkoutController.cs`)
- Exercise API → EF Core context: queries exercises (evidence: `Backend/Controllers/ExerciseController.cs`)
- ASP.NET API runtime → EF Core context: configures SQLite (evidence: `Backend/Program.cs`)
- EF Core context → SQLite database: persists records
- EF Core context → Workout and exercise records: maps entities (evidence: `Backend/Data/AppDbContext.cs`)
- ASP.NET API runtime → Exercise data seeding: seeds at startup (evidence: `Backend/Program.cs`)
- Exercise data seeding → EF Core context: populates database (evidence: `Backend/Data/Seed/DbSeeder.cs`)
- Exercise data seeding → Exercise seed data: loads exercise data (evidence: `Backend/Data/Seed/DbSeeder.cs`)
