# peterbakhit/microservices-fitness-app architecture

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

- Interactive diagram: https://gitdiagram.com/peterbakhit/microservices-fitness-app
- Repository: https://github.com/peterbakhit/microservices-fitness-app

## Overview

Fitness Microservices App lets users register or log in, record activities, and view activity and AI-generated recommendations through a frontend and API gateway. The main activity path validates the user, stores the activity, and publishes it for AI processing; the AI service can generate and persist recommendations. The tree also shows recommendation retrieval, service discovery, and centralized configuration. RabbitMQ listener wiring and several cross-service routes were not excerpted, so uncertain runtime links are omitted; frontend-to-gateway routing is shown as unverified.

Main entry points: [`api-gateway/src/main/java/com/fitness/api_gateway/SecurityGlobalFilter.java`](https://github.com/peterbakhit/microservices-fitness-app/blob/main/api-gateway/src/main/java/com/fitness/api_gateway/SecurityGlobalFilter.java) (API gateway), [`activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`](https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java) (Activity service), [`userservice/src/main/java/com/fitness/userservice/service/UserService.java`](https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/service/UserService.java) (User service), [`aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java`](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java) (Activity analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client Access"]
  node_frontend["Fitness frontend<br/>[app.js]"]
  node_gateway["API gateway"]
end

subgraph group_identity["User Identity"]
  node_user_api["User API"]
  node_user_logic["User service<br/>[UserService.java]"]
  node_token["Token service<br/>[TokenService.java]"]
  node_user_store[("User repository")]
end

subgraph group_activity["Activity Tracking"]
  node_activity_api["Activity API"]
  node_activity_logic["Activity service"]
  node_user_validation["User validation client"]
  node_activity_store[("Activity repository")]
end

subgraph group_ai["AI Recommendations"]
  node_ai_listener["Activity listener"]
  node_ai_logic["Activity analysis"]
  node_gemini_client["Gemini client<br/>[GeminiService.java]"]
  node_recommendation_logic["Recommendation service"]
  node_recommendation_api["Recommendation API"]
  node_recommendation_store[("Recommendation repository")]
end

subgraph group_platform["Service Platform"]
  node_eureka["Eureka server"]
  node_config_server["Config server"]
end

node_user(("Fitness user"))
node_rabbit["RabbitMQ"]
node_gemini["Gemini API"]

node_user -.->|"uses"| node_frontend
node_frontend -.->|"sends requests"| node_gateway
node_gateway -.->|"forwards identity requests"| node_user_api
node_gateway -.->|"forwards activity requests"| node_activity_api
node_gateway -.->|"forwards recommendation requests"| node_recommendation_api
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -->|"reads and writes"| node_user_store
node_user_logic -->|"creates token"| node_token
node_activity_api -->|"delegates to"| node_activity_logic
node_activity_logic -->|"validates user"| node_user_validation
node_user_validation -->|"checks user"| node_user_api
node_activity_logic -->|"stores and reads"| node_activity_store
node_activity_logic -->|"publishes activity"| node_rabbit
node_rabbit -.->|"delivers activity"| node_ai_listener
node_ai_listener -.->|"dispatches analysis"| node_ai_logic
node_ai_logic -->|"requests analysis"| node_gemini_client
node_gemini_client -->|"sends prompt"| node_gemini
node_ai_logic -.->|"persists result"| node_recommendation_store
node_recommendation_api -->|"delegates to"| node_recommendation_logic
node_recommendation_logic -->|"retrieves results"| node_recommendation_store

click node_frontend "https://github.com/peterbakhit/microservices-fitness-app/blob/main/frontend/app.js"
click node_gateway "https://github.com/peterbakhit/microservices-fitness-app/blob/main/api-gateway/src/main/java/com/fitness/api_gateway/SecurityGlobalFilter.java"
click node_user_api "https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/controller/UserController.java"
click node_user_logic "https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/service/UserService.java"
click node_token "https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/service/TokenService.java"
click node_user_store "https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/repository/UserRepository.java"
click node_activity_api "https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java"
click node_activity_logic "https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java"
click node_user_validation "https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java"
click node_activity_store "https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/repository/ActivityRepository.java"
click node_ai_listener "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java"
click node_ai_logic "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java"
click node_gemini_client "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java"
click node_recommendation_logic "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java"
click node_recommendation_api "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java"
click node_recommendation_store "https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java"
click node_eureka "https://github.com/peterbakhit/microservices-fitness-app/blob/main/eurekaserver/src/main/java/com/fitness/eurekaserver/EurekaserverApplication.java"
click node_config_server "https://github.com/peterbakhit/microservices-fitness-app/blob/main/configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java"

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_frontend,node_gateway,node_user toneBlue
class node_user_api,node_user_logic,node_token,node_user_store toneAmber
class node_activity_api,node_activity_logic,node_user_validation,node_activity_store,node_gemini toneMint
class node_ai_listener,node_ai_logic,node_gemini_client,node_recommendation_logic,node_recommendation_api,node_recommendation_store toneRose
class node_eureka,node_config_server,node_rabbit toneIndigo
```

## Components

### Client Access

- [Fitness frontend](https://github.com/peterbakhit/microservices-fitness-app/blob/main/frontend/app.js): `frontend/app.js`
- [API gateway](https://github.com/peterbakhit/microservices-fitness-app/blob/main/api-gateway/src/main/java/com/fitness/api_gateway/SecurityGlobalFilter.java): `api-gateway/src/main/java/com/fitness/api_gateway/SecurityGlobalFilter.java`

### User Identity

- [User API](https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/controller/UserController.java): `userservice/src/main/java/com/fitness/userservice/controller/UserController.java`
- [User service](https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/service/UserService.java): `userservice/src/main/java/com/fitness/userservice/service/UserService.java`
- [Token service](https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/service/TokenService.java): `userservice/src/main/java/com/fitness/userservice/service/TokenService.java`
- [User repository](https://github.com/peterbakhit/microservices-fitness-app/blob/main/userservice/src/main/java/com/fitness/userservice/repository/UserRepository.java): `userservice/src/main/java/com/fitness/userservice/repository/UserRepository.java`

### Activity Tracking

- [Activity API](https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java): `activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java`
- [Activity service](https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java): `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`
- [User validation client](https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java): `activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java`
- [Activity repository](https://github.com/peterbakhit/microservices-fitness-app/blob/main/activityservice/src/main/java/com/fitness/activityservice/repository/ActivityRepository.java): `activityservice/src/main/java/com/fitness/activityservice/repository/ActivityRepository.java`

### AI Recommendations

- [Activity listener](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java): `aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java`
- [Activity analysis](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java): `aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java`
- [Gemini client](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java): `aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java`
- [Recommendation service](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java): `aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java`
- [Recommendation API](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java): `aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java`
- [Recommendation repository](https://github.com/peterbakhit/microservices-fitness-app/blob/main/aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java): `aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java`

### Service Platform

- [Eureka server](https://github.com/peterbakhit/microservices-fitness-app/blob/main/eurekaserver/src/main/java/com/fitness/eurekaserver/EurekaserverApplication.java): `eurekaserver/src/main/java/com/fitness/eurekaserver/EurekaserverApplication.java`
- [Config server](https://github.com/peterbakhit/microservices-fitness-app/blob/main/configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java): `configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java`

### Other components

- **Fitness user**
- **RabbitMQ**
- **Gemini API**

## Connections

- Fitness user → Fitness frontend: uses (evidence: `README.md`)
- Fitness frontend → API gateway: sends requests
- API gateway → User API: forwards identity requests (evidence: `README.md`)
- API gateway → Activity API: forwards activity requests (evidence: `README.md`)
- API gateway → Recommendation API: forwards recommendation requests
- User API → User service: delegates to (evidence: `userservice/src/main/java/com/fitness/userservice/controller/UserController.java`)
- User service → User repository: reads and writes (evidence: `userservice/src/main/java/com/fitness/userservice/service/UserService.java`)
- User service → Token service: creates token (evidence: `userservice/src/main/java/com/fitness/userservice/service/UserService.java`)
- Activity API → Activity service: delegates to (evidence: `activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java`)
- Activity service → User validation client: validates user (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`)
- User validation client → User API: checks user (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java`)
- Activity service → Activity repository: stores and reads (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`)
- Activity service → RabbitMQ: publishes activity (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`)
- RabbitMQ → Activity listener: delivers activity
- Activity listener → Activity analysis: dispatches analysis (evidence: `aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java`)
- Activity analysis → Gemini client: requests analysis (evidence: `aiservice/src/main/java/com/fitness/aiservice/service/ActivityAiService.java`)
- Gemini client → Gemini API: sends prompt (evidence: `aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java`)
- Activity analysis → Recommendation repository: persists result
- Recommendation API → Recommendation service: delegates to (evidence: `aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java`)
- Recommendation service → Recommendation repository: retrieves results (evidence: `aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java`)
