How falkendev/grindify works
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: services API services · admin.controller.ts Admin management · pages Fitness UI · workoutSession.service.ts Workout sessions
Components 21
Fitness application
- Fitness UI
frontend/src/pages - API services
frontend/src/services
Fitness API
- Authentication
backend/src/v1/auth/auth.service.ts - User accounts
backend/src/v1/user/user.service.ts - Workout routines
backend/src/v1/workout/workout.service.ts - Workout sessions
backend/src/v1/workoutSession/workoutSession.service.ts - Session scheduling
backend/src/v1/scheduledSession/scheduledSession.service.ts - Exercise library
backend/src/v1/exercise/exercise.service.ts - Activity tracking
backend/src/v1/activity/activity.service.ts - Activity logs
backend/src/v1/activityLog/activityLog.service.ts - Progress analytics
backend/src/v1/statistics/statistics.service.ts - Weight logs
backend/src/v1/weightLog - Progress photos
backend/src/v1/progressPhoto - Muscle groups
backend/src/v1/muscleGroup - Version history
backend/src/v1/releases
Administration
- Admin panel
adminpanel/src/views - Admin API client
adminpanel/src/services/adminApi.ts - Admin management
backend/src/v1/admin/admin.controller.ts
Persistence and media
- PostgreSQL
- Uploaded media
backend/src/v1/upload/upload.service.ts
Other components
- Athlete
Connections 26
- Athlete → Fitness UI: plans and logs
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
backend/src/v1/admin/admin.controller.ts - Admin management → Activity tracking: manages global
backend/src/v1/admin/admin.controller.ts - Admin management → Muscle groups: manages
backend/src/v1/admin/admin.controller.ts - Admin management → Uploaded media: processes uploads
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
backend/src/v1/workoutSession/workoutSession.service.ts