# wyze69-sys/fitsync architecture

> Architecture diagram of the GitHub repository wyze69-sys/fitsync, 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/wyze69-sys/fitsync
- Repository: https://github.com/wyze69-sys/fitsync

## Overview

FitSync is a fitness-tracking web app whose main user workflow runs from account access through workout logging and nutrition/weight tracking to progress and gamification feedback. React pages call a central API client; Express routes dispatch requests to domain logic backed by MySQL. The README also documents weekly AI insights and a broad admin portal. Some domain implementations were not sampled, so those branches are represented at subsystem level and only linked where the README or source index supports the relationship.

Main entry points: [`backend/src/routes/routes.js`](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/routes.js) (API route registry), [`backend/src/services/workoutService.js`](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/workoutService.js) (Workout logging), [`client/src/services`](https://github.com/wyze69-sys/fitsync/tree/main/client/src/services) (API services), [`backend/src/config/db.js`](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/config/db.js) (MySQL persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Auth context<br/>[AuthContext.jsx]"]
  node_pages["Fitness pages"]
  node_clientservices["API services"]
  node_apiclient["API client<br/>[apiClient.js]"]
end

subgraph group_api["API and access"]
  node_express["Express API<br/>[app.js]"]
  node_api_routes["API route registry<br/>[routes.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_logic["Authentication<br/>[authService.js]"]
  node_access["JWT access control<br/>[authMiddleware.js]"]
end

subgraph group_fitness["Fitness domains"]
  node_workouts["Workout logging<br/>[workoutService.js]"]
  node_nutrition["Nutrition planning"]
  node_weight["Weight progress"]
end

subgraph group_engagement["Progress and engagement"]
  node_gamification["Streaks and badges"]
  node_insights["Weekly insights<br/>[aiService.js]"]
end

subgraph group_operations["Platform operations"]
  node_admin["Admin portal<br/>[adminRoutes.js]"]
  node_mysql[("MySQL persistence<br/>[db.js]")]
end

node_member(("Member"))
node_gemini["Google Gemini"]

node_member -->|"uses"| node_app
node_app -->|"routes to"| node_pages
node_member -->|"signs in"| node_authui
node_authui -->|"requests auth"| node_clientservices
node_clientservices -->|"uses"| node_apiclient
node_apiclient -->|"sends API requests"| node_express
node_express -->|"mounts"| node_api_routes
node_api_routes -->|"dispatches auth"| node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_logic
node_auth_logic -->|"reads and writes users"| node_mysql
node_api_routes -.->|"routes workout requests"| node_workouts
node_api_routes -->|"routes nutrition requests"| node_nutrition
node_api_routes -->|"routes weight requests"| node_weight
node_api_routes -->|"routes gamification requests"| node_gamification
node_api_routes -->|"routes AI requests"| node_insights
node_api_routes -->|"routes admin requests"| node_admin
node_admin -->|"requires authentication"| node_access
node_access -->|"checks user"| node_mysql
node_workouts -->|"persists workouts"| node_mysql
node_workouts -->|"updates rewards"| node_gamification
node_insights -.->|"generates insights"| node_gemini
node_pages -.->|"loads fitness data"| node_clientservices

click node_app "https://github.com/wyze69-sys/fitsync/blob/main/client/src/App.jsx"
click node_authui "https://github.com/wyze69-sys/fitsync/blob/main/client/src/context/AuthContext.jsx"
click node_pages "https://github.com/wyze69-sys/fitsync/tree/main/client/src/pages"
click node_clientservices "https://github.com/wyze69-sys/fitsync/tree/main/client/src/services"
click node_apiclient "https://github.com/wyze69-sys/fitsync/blob/main/client/src/services/apiClient.js"
click node_express "https://github.com/wyze69-sys/fitsync/blob/main/backend/app.js"
click node_api_routes "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/routes.js"
click node_auth_routes "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/authRoutes.js"
click node_auth_logic "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/authService.js"
click node_access "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/middleware/authMiddleware.js"
click node_workouts "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/workoutService.js"
click node_nutrition "https://github.com/wyze69-sys/fitsync/tree/main/backend/src"
click node_weight "https://github.com/wyze69-sys/fitsync/tree/main/backend/src"
click node_gamification "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/gamificationService.js"
click node_insights "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/aiService.js"
click node_admin "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/adminRoutes.js"
click node_mysql "https://github.com/wyze69-sys/fitsync/blob/main/backend/src/config/db.js"

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_app,node_authui,node_pages,node_clientservices,node_apiclient toneBlue
class node_express,node_api_routes,node_auth_routes,node_auth_logic,node_access toneAmber
class node_workouts,node_nutrition,node_weight toneMint
class node_gamification,node_insights toneRose
class node_admin,node_mysql,node_member,node_gemini toneIndigo
```

## Components

### React client

- [App routing](https://github.com/wyze69-sys/fitsync/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Auth context](https://github.com/wyze69-sys/fitsync/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Fitness pages](https://github.com/wyze69-sys/fitsync/tree/main/client/src/pages): `client/src/pages`
- [API services](https://github.com/wyze69-sys/fitsync/tree/main/client/src/services): `client/src/services`
- [API client](https://github.com/wyze69-sys/fitsync/blob/main/client/src/services/apiClient.js): `client/src/services/apiClient.js`

### API and access

- [Express API](https://github.com/wyze69-sys/fitsync/blob/main/backend/app.js): `backend/app.js`
- [API route registry](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/routes.js): `backend/src/routes/routes.js`
- [Auth routes](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Authentication](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [JWT access control](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`

### Fitness domains

- [Workout logging](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/workoutService.js): `backend/src/services/workoutService.js`
- [Nutrition planning](https://github.com/wyze69-sys/fitsync/tree/main/backend/src): `backend/src`
- [Weight progress](https://github.com/wyze69-sys/fitsync/tree/main/backend/src): `backend/src`

### Progress and engagement

- [Streaks and badges](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/gamificationService.js): `backend/src/services/gamificationService.js`
- [Weekly insights](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/services/aiService.js): `backend/src/services/aiService.js`

### Platform operations

- [Admin portal](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/routes/adminRoutes.js): `backend/src/routes/adminRoutes.js`
- [MySQL persistence](https://github.com/wyze69-sys/fitsync/blob/main/backend/src/config/db.js): `backend/src/config/db.js`

### Other components

- **Member**
- **Google Gemini**

## Connections

- Member → App routing: uses (evidence: `README.md`)
- App routing → Fitness pages: routes to (evidence: `client/src/App.jsx`)
- Member → Auth context: signs in (evidence: `README.md`)
- Auth context → API services: requests auth (evidence: `client/src/context/AuthContext.jsx`)
- API services → API client: uses (evidence: `client/src/services/authService.js`)
- API client → Express API: sends API requests (evidence: `client/src/services/apiClient.js`)
- Express API → API route registry: mounts (evidence: `backend/app.js`)
- API route registry → Auth routes: dispatches auth (evidence: `backend/src/routes/routes.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Authentication → MySQL persistence: reads and writes users
- API route registry → Workout logging: routes workout requests
- API route registry → Nutrition planning: routes nutrition requests (evidence: `backend/src/routes/routes.js`)
- API route registry → Weight progress: routes weight requests (evidence: `backend/src/routes/routes.js`)
- API route registry → Streaks and badges: routes gamification requests (evidence: `backend/src/routes/routes.js`)
- API route registry → Weekly insights: routes AI requests (evidence: `backend/src/routes/routes.js`)
- API route registry → Admin portal: routes admin requests (evidence: `backend/src/routes/routes.js`)
- Admin portal → JWT access control: requires authentication (evidence: `backend/src/routes/adminRoutes.js`)
- JWT access control → MySQL persistence: checks user (evidence: `backend/src/middleware/authMiddleware.js`)
- Workout logging → MySQL persistence: persists workouts (evidence: `backend/src/services/workoutService.js`)
- Workout logging → Streaks and badges: updates rewards (evidence: `backend/src/services/workoutService.js`)
- Weekly insights → Google Gemini: generates insights (evidence: `README.md`)
- Fitness pages → API services: loads fitness data (evidence: `README.md`)
