# giorgiberuashvili4/fittrack architecture

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

- Interactive diagram: https://gitdiagram.com/giorgiberuashvili4/fittrack
- Repository: https://github.com/giorgiberuashvili4/fittrack

## Overview

FitTrack is an ASP.NET Core fitness-tracking API. Members register or sign in, then manage exercises, workout history, and body metrics; trainers can manage client relationships and view client workouts. The README also documents weekly statistics, exercise progress, and role-based access. The graph combines documented capabilities with sampled controller/service wiring; unsampled implementation details are represented only at their supported subsystem paths.

Main entry points: [`Data/Database.cs`](https://github.com/giorgiberuashvili4/fittrack/blob/main/Data/Database.cs) (EF Core data context), [`Program.cs`](https://github.com/giorgiberuashvili4/fittrack/blob/main/Program.cs) (API application), [`Services/Implementations/AuthService.cs`](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/AuthService.cs) (Auth service), [`Controllers/TrainerClientController.cs`](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/TrainerClientController.cs) (Trainer clients API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_application["API application<br/>[Program.cs]"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_authservice["Auth service<br/>[AuthService.cs]"]
end

subgraph group_training["Training catalog"]
  node_exerciseapi["Exercise API"]
  node_exercises["Exercise management<br/>[ExerciseService.cs]"]
  node_muscles["Muscle groups"]
  node_workoutapi["Workout API"]
  node_workouts["Workout management<br/>[WorkoutService.cs]"]
  node_trainerapi["Trainer clients API"]
  node_trainerclients["Trainer client management<br/>[TrainerService.cs]"]
end

subgraph group_tracking["Progress tracking"]
  node_metricsapi["Body metrics API"]
  node_metrics["Body metrics<br/>[MetricsService.cs]"]
  node_statsapi["Statistics API<br/>[StatsController.cs]"]
  node_stats["Progress statistics<br/>[StatsService.cs]"]
end

subgraph group_data["Persistence"]
  node_database[("EF Core data context<br/>[Database.cs]")]
  node_domain["Fitness domain entities"]
end

node_member(("Member"))
node_trainer(("Trainer"))
node_sql[("SQL Server")]

node_member -->|"uses API"| node_application
node_trainer -->|"uses API"| node_application
node_application -->|"maps controllers"| node_auth
node_application -->|"configures context"| node_database
node_application -->|"runs migrations"| node_database
node_auth -.->|"delegates to"| node_authservice
node_authservice -->|"reads and writes"| node_database
node_authservice -->|"requests token service"| node_application
node_member -->|"manages exercises"| node_exerciseapi
node_exerciseapi -->|"calls service"| node_exercises
node_exercises -->|"queries and saves"| node_database
node_member -->|"manages workouts"| node_workoutapi
node_workoutapi -->|"calls service"| node_workouts
node_workouts -->|"queries and saves"| node_database
node_trainer -->|"manages clients"| node_trainerapi
node_trainerapi -->|"delegates to"| node_trainerclients
node_trainerapi -->|"requests client workouts"| node_workouts
node_trainerclients -.->|"uses persistence"| node_database
node_member -->|"manages body metrics"| node_metricsapi
node_metricsapi -.->|"delegates to"| node_metrics
node_metrics -.->|"uses persistence"| node_database
node_member -->|"views progress"| node_statsapi
node_statsapi -->|"calls service"| node_stats
node_stats -.->|"uses persistence"| node_database
node_database -->|"maps entities"| node_domain
node_database -->|"stores data"| node_sql

click node_application "https://github.com/giorgiberuashvili4/fittrack/blob/main/Program.cs"
click node_auth "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/AuthController.cs"
click node_authservice "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/AuthService.cs"
click node_exerciseapi "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/ExerciseController.cs"
click node_exercises "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/ExerciseService.cs"
click node_muscles "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/MuscleGroupController.cs"
click node_workoutapi "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/WorkoutsController.cs"
click node_workouts "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/WorkoutService.cs"
click node_trainerapi "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/TrainerClientController.cs"
click node_trainerclients "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/TrainerService.cs"
click node_metricsapi "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/MetricsController.cs"
click node_metrics "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/MetricsService.cs"
click node_statsapi "https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/StatsController.cs"
click node_stats "https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/StatsService.cs"
click node_database "https://github.com/giorgiberuashvili4/fittrack/blob/main/Data/Database.cs"
click node_domain "https://github.com/giorgiberuashvili4/fittrack/tree/main/Entities"

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_application,node_auth,node_authservice toneBlue
class node_exerciseapi,node_exercises,node_muscles,node_workoutapi,node_workouts,node_trainerapi,node_trainerclients,node_sql toneAmber
class node_metricsapi,node_metrics,node_statsapi,node_stats toneMint
class node_database,node_domain toneRose
class node_member,node_trainer toneIndigo
```

## Components

### API and identity

- [API application](https://github.com/giorgiberuashvili4/fittrack/blob/main/Program.cs): `Program.cs`
- [Authentication](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/AuthController.cs): `Controllers/AuthController.cs`
- [Auth service](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/AuthService.cs): `Services/Implementations/AuthService.cs`

### Training catalog

- [Exercise API](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/ExerciseController.cs): `Controllers/ExerciseController.cs`
- [Exercise management](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/ExerciseService.cs): `Services/Implementations/ExerciseService.cs`
- [Muscle groups](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/MuscleGroupController.cs): `Controllers/MuscleGroupController.cs`
- [Workout API](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/WorkoutsController.cs): `Controllers/WorkoutsController.cs`
- [Workout management](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/WorkoutService.cs): `Services/Implementations/WorkoutService.cs`
- [Trainer clients API](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/TrainerClientController.cs): `Controllers/TrainerClientController.cs`
- [Trainer client management](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/TrainerService.cs): `Services/Implementations/TrainerService.cs`

### Progress tracking

- [Body metrics API](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/MetricsController.cs): `Controllers/MetricsController.cs`
- [Body metrics](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/MetricsService.cs): `Services/Implementations/MetricsService.cs`
- [Statistics API](https://github.com/giorgiberuashvili4/fittrack/blob/main/Controllers/StatsController.cs): `Controllers/StatsController.cs`
- [Progress statistics](https://github.com/giorgiberuashvili4/fittrack/blob/main/Services/Implementations/StatsService.cs): `Services/Implementations/StatsService.cs`

### Persistence

- [EF Core data context](https://github.com/giorgiberuashvili4/fittrack/blob/main/Data/Database.cs): `Data/Database.cs`
- [Fitness domain entities](https://github.com/giorgiberuashvili4/fittrack/tree/main/Entities): `Entities`

### Other components

- **Member**
- **Trainer**
- **SQL Server**

## Connections

- Member → API application: uses API (evidence: `README.md`)
- Trainer → API application: uses API (evidence: `README.md`)
- API application → Authentication: maps controllers (evidence: `Program.cs`)
- API application → EF Core data context: configures context (evidence: `Program.cs`)
- API application → EF Core data context: runs migrations (evidence: `Program.cs`)
- Authentication → Auth service: delegates to
- Auth service → EF Core data context: reads and writes (evidence: `Services/Implementations/AuthService.cs`)
- Auth service → API application: requests token service (evidence: `Services/Implementations/AuthService.cs`)
- Member → Exercise API: manages exercises (evidence: `README.md`)
- Exercise API → Exercise management: calls service (evidence: `Controllers/ExerciseController.cs`)
- Exercise management → EF Core data context: queries and saves (evidence: `Services/Implementations/ExerciseService.cs`)
- Member → Workout API: manages workouts (evidence: `README.md`)
- Workout API → Workout management: calls service (evidence: `Controllers/WorkoutsController.cs`)
- Workout management → EF Core data context: queries and saves (evidence: `Services/Implementations/WorkoutService.cs`)
- Trainer → Trainer clients API: manages clients (evidence: `README.md`)
- Trainer clients API → Trainer client management: delegates to (evidence: `Controllers/TrainerClientController.cs`)
- Trainer clients API → Workout management: requests client workouts (evidence: `Controllers/TrainerClientController.cs`)
- Trainer client management → EF Core data context: uses persistence
- Member → Body metrics API: manages body metrics (evidence: `README.md`)
- Body metrics API → Body metrics: delegates to
- Body metrics → EF Core data context: uses persistence
- Member → Statistics API: views progress (evidence: `README.md`)
- Statistics API → Progress statistics: calls service (evidence: `Controllers/StatsController.cs`)
- Progress statistics → EF Core data context: uses persistence
- EF Core data context → Fitness domain entities: maps entities (evidence: `Data/Database.cs`)
- EF Core data context → SQL Server: stores data (evidence: `README.md`)
