# falkendev/grindify architecture

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

- Interactive diagram: https://gitdiagram.com/falkendev/grindify
- Repository: https://github.com/falkendev/grindify

## Overview

Grindify is a self-hosted fitness tracker: users plan routines, log workouts and activities, and review progress. Its Vue app and separate admin panel use a NestJS API backed by PostgreSQL. The graph retains documented scheduling, body metrics, exercise-library, analytics, and administration capabilities. Several UI-to-store and API-to-database links are not evidenced by sampled calls, so those relationships are omitted or marked unverified rather than presented as inspected.

Main entry points: [`frontend/src/services`](https://github.com/falkendev/grindify/tree/main/frontend/src/services) (API services), [`backend/src/v1/admin/admin.controller.ts`](https://github.com/falkendev/grindify/blob/main/backend/src/v1/admin/admin.controller.ts) (Admin management), [`frontend/src/pages`](https://github.com/falkendev/grindify/tree/main/frontend/src/pages) (Fitness UI), [`backend/src/v1/workoutSession/workoutSession.service.ts`](https://github.com/falkendev/grindify/blob/main/backend/src/v1/workoutSession/workoutSession.service.ts) (Workout sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_app["Fitness application"]
  node_fitness_ui["Fitness UI"]
  node_fitness_services["API services"]
end

subgraph group_api_domain["Fitness API"]
  node_auth_api["Authentication<br/>[auth.service.ts]"]
  node_user_domain["User accounts<br/>[user.service.ts]"]
  node_workouts["Workout routines<br/>[workout.service.ts]"]
  node_sessions["Workout sessions"]
  node_scheduling["Session scheduling"]
  node_exercise_library["Exercise library"]
  node_activity_tracking["Activity tracking"]
  node_activity_logs["Activity logs"]
  node_analytics["Progress analytics"]
  node_weight_logs["Weight logs"]
  node_progress_photos["Progress photos"]
  node_muscle_groups["Muscle groups"]
  node_releases["Version history"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin panel"]
  node_admin_api_client["Admin API client<br/>[adminApi.ts]"]
  node_admin_management["Admin management"]
end

subgraph group_data["Persistence and media"]
  node_postgres[("PostgreSQL")]
  node_media_storage[("Uploaded media<br/>[upload.service.ts]")]
end

node_athlete(("Athlete"))

node_athlete -->|"plans and logs"| node_fitness_ui
node_fitness_ui -.->|"requests data"| node_fitness_services
node_fitness_services -.->|"calls API"| node_auth_api
node_fitness_services -.->|"calls API"| node_workouts
node_fitness_services -.->|"calls API"| node_sessions
node_fitness_services -.->|"calls API"| node_scheduling
node_fitness_services -.->|"calls API"| node_exercise_library
node_fitness_services -.->|"calls API"| node_activity_tracking
node_fitness_services -.->|"calls API"| node_activity_logs
node_fitness_services -.->|"calls API"| node_analytics
node_fitness_services -.->|"calls API"| node_weight_logs
node_fitness_services -.->|"calls API"| node_progress_photos
node_fitness_ui -.->|"separate interface"| node_admin_ui
node_admin_ui -.->|"requests data"| node_admin_api_client
node_admin_api_client -.->|"calls API"| node_admin_management
node_admin_management -->|"manages global"| node_exercise_library
node_admin_management -->|"manages global"| node_activity_tracking
node_admin_management -->|"manages"| node_muscle_groups
node_admin_management -->|"processes uploads"| node_media_storage
node_admin_management -.->|"exposes history"| node_releases
node_workouts -.->|"persists routines"| node_postgres
node_sessions -.->|"persists sessions"| node_postgres
node_scheduling -.->|"reads and writes"| node_postgres
node_analytics -.->|"reads history"| node_postgres
node_media_storage -.->|"stores media files"| node_postgres
node_sessions -->|"requests statistics"| node_analytics

click node_fitness_ui "https://github.com/falkendev/grindify/tree/main/frontend/src/pages"
click node_fitness_services "https://github.com/falkendev/grindify/tree/main/frontend/src/services"
click node_admin_ui "https://github.com/falkendev/grindify/tree/main/adminpanel/src/views"
click node_admin_api_client "https://github.com/falkendev/grindify/blob/main/adminpanel/src/services/adminApi.ts"
click node_auth_api "https://github.com/falkendev/grindify/blob/main/backend/src/v1/auth/auth.service.ts"
click node_user_domain "https://github.com/falkendev/grindify/blob/main/backend/src/v1/user/user.service.ts"
click node_workouts "https://github.com/falkendev/grindify/blob/main/backend/src/v1/workout/workout.service.ts"
click node_sessions "https://github.com/falkendev/grindify/blob/main/backend/src/v1/workoutSession/workoutSession.service.ts"
click node_scheduling "https://github.com/falkendev/grindify/blob/main/backend/src/v1/scheduledSession/scheduledSession.service.ts"
click node_exercise_library "https://github.com/falkendev/grindify/blob/main/backend/src/v1/exercise/exercise.service.ts"
click node_activity_tracking "https://github.com/falkendev/grindify/blob/main/backend/src/v1/activity/activity.service.ts"
click node_activity_logs "https://github.com/falkendev/grindify/blob/main/backend/src/v1/activityLog/activityLog.service.ts"
click node_analytics "https://github.com/falkendev/grindify/blob/main/backend/src/v1/statistics/statistics.service.ts"
click node_weight_logs "https://github.com/falkendev/grindify/tree/main/backend/src/v1/weightLog"
click node_progress_photos "https://github.com/falkendev/grindify/tree/main/backend/src/v1/progressPhoto"
click node_media_storage "https://github.com/falkendev/grindify/blob/main/backend/src/v1/upload/upload.service.ts"
click node_admin_management "https://github.com/falkendev/grindify/blob/main/backend/src/v1/admin/admin.controller.ts"
click node_muscle_groups "https://github.com/falkendev/grindify/tree/main/backend/src/v1/muscleGroup"
click node_releases "https://github.com/falkendev/grindify/tree/main/backend/src/v1/releases"

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_fitness_ui,node_fitness_services toneBlue
class node_auth_api,node_user_domain,node_workouts,node_sessions,node_scheduling,node_exercise_library,node_activity_tracking,node_activity_logs,node_analytics,node_weight_logs,node_progress_photos,node_muscle_groups,node_releases toneAmber
class node_admin_ui,node_admin_api_client,node_admin_management toneMint
class node_postgres,node_media_storage toneRose
class node_athlete toneIndigo
```

## Components

### Fitness application

- [Fitness UI](https://github.com/falkendev/grindify/tree/main/frontend/src/pages): `frontend/src/pages`
- [API services](https://github.com/falkendev/grindify/tree/main/frontend/src/services): `frontend/src/services`

### Fitness API

- [Authentication](https://github.com/falkendev/grindify/blob/main/backend/src/v1/auth/auth.service.ts): `backend/src/v1/auth/auth.service.ts`
- [User accounts](https://github.com/falkendev/grindify/blob/main/backend/src/v1/user/user.service.ts): `backend/src/v1/user/user.service.ts`
- [Workout routines](https://github.com/falkendev/grindify/blob/main/backend/src/v1/workout/workout.service.ts): `backend/src/v1/workout/workout.service.ts`
- [Workout sessions](https://github.com/falkendev/grindify/blob/main/backend/src/v1/workoutSession/workoutSession.service.ts): `backend/src/v1/workoutSession/workoutSession.service.ts`
- [Session scheduling](https://github.com/falkendev/grindify/blob/main/backend/src/v1/scheduledSession/scheduledSession.service.ts): `backend/src/v1/scheduledSession/scheduledSession.service.ts`
- [Exercise library](https://github.com/falkendev/grindify/blob/main/backend/src/v1/exercise/exercise.service.ts): `backend/src/v1/exercise/exercise.service.ts`
- [Activity tracking](https://github.com/falkendev/grindify/blob/main/backend/src/v1/activity/activity.service.ts): `backend/src/v1/activity/activity.service.ts`
- [Activity logs](https://github.com/falkendev/grindify/blob/main/backend/src/v1/activityLog/activityLog.service.ts): `backend/src/v1/activityLog/activityLog.service.ts`
- [Progress analytics](https://github.com/falkendev/grindify/blob/main/backend/src/v1/statistics/statistics.service.ts): `backend/src/v1/statistics/statistics.service.ts`
- [Weight logs](https://github.com/falkendev/grindify/tree/main/backend/src/v1/weightLog): `backend/src/v1/weightLog`
- [Progress photos](https://github.com/falkendev/grindify/tree/main/backend/src/v1/progressPhoto): `backend/src/v1/progressPhoto`
- [Muscle groups](https://github.com/falkendev/grindify/tree/main/backend/src/v1/muscleGroup): `backend/src/v1/muscleGroup`
- [Version history](https://github.com/falkendev/grindify/tree/main/backend/src/v1/releases): `backend/src/v1/releases`

### Administration

- [Admin panel](https://github.com/falkendev/grindify/tree/main/adminpanel/src/views): `adminpanel/src/views`
- [Admin API client](https://github.com/falkendev/grindify/blob/main/adminpanel/src/services/adminApi.ts): `adminpanel/src/services/adminApi.ts`
- [Admin management](https://github.com/falkendev/grindify/blob/main/backend/src/v1/admin/admin.controller.ts): `backend/src/v1/admin/admin.controller.ts`

### Persistence and media

- **PostgreSQL**
- [Uploaded media](https://github.com/falkendev/grindify/blob/main/backend/src/v1/upload/upload.service.ts): `backend/src/v1/upload/upload.service.ts`

### Other components

- **Athlete**

## Connections

- Athlete → Fitness UI: plans and logs (evidence: `README.md`)
- Fitness UI → API services: requests data
- API services → Authentication: calls API
- API services → Workout routines: calls API
- API services → Workout sessions: calls API
- API services → Session scheduling: calls API
- API services → Exercise library: calls API
- API services → Activity tracking: calls API
- API services → Activity logs: calls API
- API services → Progress analytics: calls API
- API services → Weight logs: calls API
- API services → Progress photos: calls API
- Fitness UI → Admin panel: separate interface
- Admin panel → Admin API client: requests data
- Admin API client → Admin management: calls API
- Admin management → Exercise library: manages global (evidence: `backend/src/v1/admin/admin.controller.ts`)
- Admin management → Activity tracking: manages global (evidence: `backend/src/v1/admin/admin.controller.ts`)
- Admin management → Muscle groups: manages (evidence: `backend/src/v1/admin/admin.controller.ts`)
- Admin management → Uploaded media: processes uploads (evidence: `backend/src/v1/admin/admin.controller.ts`)
- Admin management → Version history: exposes history
- Workout routines → PostgreSQL: persists routines
- Workout sessions → PostgreSQL: persists sessions
- Session scheduling → PostgreSQL: reads and writes
- Progress analytics → PostgreSQL: reads history
- Uploaded media → PostgreSQL: stores media files
- Workout sessions → Progress analytics: requests statistics (evidence: `backend/src/v1/workoutSession/workoutSession.service.ts`)
