# sakshiprogram/fitness-ai-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/sakshiprogram/fitness-ai-microservices
- Repository: https://github.com/sakshiprogram/fitness-ai-microservices

## Overview

This is a fitness-tracking application: users authenticate, record activities, and retrieve activity details; recorded activities are also published for AI recommendation processing. The code shows activity validation and persistence, a separate user service, and an AI integration with Gemini and recommendation storage/API. The frontend and backend are split across services, with gateway, service-discovery, and configuration-server modules present. Some asynchronous wiring and frontend HTTP routing are not shown in the excerpts, so those links are marked unverified or omitted.

Main entry points: [`fitness-app-frontend/src/App.jsx`](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/App.jsx) (Frontend app), [`activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java) (Activity service), [`fitness-app-frontend/src/services/api.js`](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/services/api.js) (API client), [`userservice/src/main/java/com/fitness/userservice/Controller/UserController.java`](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/userservice/src/main/java/com/fitness/userservice/Controller/UserController.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_app["Frontend app<br/>[App.jsx]"]
  node_auth["Auth state<br/>[authSlice.js]"]
  node_activity_form["Activity form<br/>[ActivityForm.jsx]"]
  node_activity_list["Activity list<br/>[ActivityList.jsx]"]
  node_activity_detail["Activity detail<br/>[ActivityDetail.jsx]"]
  node_frontend_api["API client<br/>[api.js]"]
end

subgraph group_identity["Gateway and identity"]
  node_gateway["API gateway"]
  node_security["Gateway security"]
  node_keycloak_sync["User sync filter"]
  node_gateway_user["Gateway user client<br/>[UserService.java]"]
  node_user_controller["User API"]
  node_user_service["User service<br/>[UserService.java]"]
  node_user_store[("User store")]
end

subgraph group_activity["Activity tracking"]
  node_activity_controller["Activity API"]
  node_activity_service["Activity service"]
  node_user_validation["User validation client"]
  node_activity_store[("Activity store")]
  node_activity_model["Activity record<br/>[Activity.java]"]
  node_event_queue["RabbitMQ"]
end

subgraph group_recommendations["AI recommendations"]
  node_message_listener["Activity message listener"]
  node_ai_service["Recommendation analysis"]
  node_gemini_service["Gemini client<br/>[GeminiService.java]"]
  node_recommendation_controller["Recommendation API"]
  node_recommendation_service["Recommendation service"]
  node_recommendation_store[("Recommendation store")]
end

subgraph group_platform["Service platform"]
  node_eureka["Service discovery"]
  node_config_server["Configuration server"]
end

node_user(("Fitness user"))
node_gemini(("Gemini API"))

node_user -->|"uses"| node_app
node_app -->|"updates"| node_auth
node_app -->|"renders"| node_activity_form
node_app -->|"renders"| node_activity_list
node_app -->|"routes to"| node_activity_detail
node_activity_form -->|"calls"| node_frontend_api
node_activity_list -->|"calls"| node_frontend_api
node_activity_detail -->|"calls"| node_frontend_api
node_frontend_api -.->|"sends requests"| node_gateway
node_gateway_user -->|"calls HTTP"| node_user_controller
node_keycloak_sync -->|"registers users"| node_gateway_user
node_user_controller -->|"delegates"| node_user_service
node_user_service -->|"reads and writes"| node_user_store
node_activity_controller -->|"delegates"| node_activity_service
node_activity_service -->|"validates user"| node_user_validation
node_user_validation -->|"calls HTTP"| node_user_controller
node_activity_service -->|"reads and writes"| node_activity_store
node_activity_store -->|"stores"| node_activity_model
node_activity_service -->|"publishes activity"| node_event_queue
node_event_queue -.->|"delivers activity"| node_message_listener
node_message_listener -.->|"dispatches analysis"| node_ai_service
node_ai_service -->|"requests analysis"| node_gemini_service
node_gemini_service -->|"sends prompt"| node_gemini
node_recommendation_controller -->|"delegates"| node_recommendation_service
node_recommendation_service -->|"queries"| node_recommendation_store

click node_app "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/App.jsx"
click node_auth "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/store/authSlice.js"
click node_activity_form "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityForm.jsx"
click node_activity_list "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityList.jsx"
click node_activity_detail "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityDetail.jsx"
click node_frontend_api "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/services/api.js"
click node_gateway "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/GatewayApplication.java"
click node_security "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/SecurityConfig.java"
click node_keycloak_sync "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/KeycloakUserSyncFilter.java"
click node_gateway_user "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/user/UserService.java"
click node_user_controller "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/userservice/src/main/java/com/fitness/userservice/Controller/UserController.java"
click node_user_service "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/userservice/src/main/java/com/fitness/userservice/service/UserService.java"
click node_user_store "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/userservice/src/main/java/com/fitness/userservice/repository/UserRepository.java"
click node_activity_controller "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java"
click node_activity_service "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java"
click node_user_validation "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java"
click node_activity_store "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/ActivityRepository.java"
click node_activity_model "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/model/Activity.java"
click node_message_listener "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java"
click node_ai_service "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityAIService.java"
click node_gemini_service "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java"
click node_recommendation_controller "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java"
click node_recommendation_service "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java"
click node_recommendation_store "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java"
click node_eureka "https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/eureka/src/main/java/com/server/eureka/EurekaApplication.java"
click node_config_server "https://github.com/sakshiprogram/fitness-ai-microservices/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_app,node_auth,node_activity_form,node_activity_list,node_activity_detail,node_frontend_api,node_user toneBlue
class node_gateway,node_security,node_keycloak_sync,node_gateway_user,node_user_controller,node_user_service,node_user_store toneAmber
class node_activity_controller,node_activity_service,node_user_validation,node_activity_store,node_activity_model,node_event_queue,node_gemini toneMint
class node_message_listener,node_ai_service,node_gemini_service,node_recommendation_controller,node_recommendation_service,node_recommendation_store toneRose
class node_eureka,node_config_server toneIndigo
```

## Components

### User interface

- [Frontend app](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/App.jsx): `fitness-app-frontend/src/App.jsx`
- [Auth state](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/store/authSlice.js): `fitness-app-frontend/src/store/authSlice.js`
- [Activity form](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityForm.jsx): `fitness-app-frontend/src/components/ActivityForm.jsx`
- [Activity list](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityList.jsx): `fitness-app-frontend/src/components/ActivityList.jsx`
- [Activity detail](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/components/ActivityDetail.jsx): `fitness-app-frontend/src/components/ActivityDetail.jsx`
- [API client](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/fitness-app-frontend/src/services/api.js): `fitness-app-frontend/src/services/api.js`

### Gateway and identity

- [API gateway](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/GatewayApplication.java): `gateway/src/main/java/com/fitness/gateway/GatewayApplication.java`
- [Gateway security](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/SecurityConfig.java): `gateway/src/main/java/com/fitness/gateway/SecurityConfig.java`
- [User sync filter](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/KeycloakUserSyncFilter.java): `gateway/src/main/java/com/fitness/gateway/KeycloakUserSyncFilter.java`
- [Gateway user client](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/gateway/src/main/java/com/fitness/gateway/user/UserService.java): `gateway/src/main/java/com/fitness/gateway/user/UserService.java`
- [User API](https://github.com/sakshiprogram/fitness-ai-microservices/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/sakshiprogram/fitness-ai-microservices/blob/main/userservice/src/main/java/com/fitness/userservice/service/UserService.java): `userservice/src/main/java/com/fitness/userservice/service/UserService.java`
- [User store](https://github.com/sakshiprogram/fitness-ai-microservices/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/sakshiprogram/fitness-ai-microservices/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/sakshiprogram/fitness-ai-microservices/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/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java): `activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java`
- [Activity store](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/ActivityRepository.java): `activityservice/src/main/java/com/fitness/activityservice/ActivityRepository.java`
- [Activity record](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/activityservice/src/main/java/com/fitness/activityservice/model/Activity.java): `activityservice/src/main/java/com/fitness/activityservice/model/Activity.java`
- **RabbitMQ**

### AI recommendations

- [Activity message listener](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java): `aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java`
- [Recommendation analysis](https://github.com/sakshiprogram/fitness-ai-microservices/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/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java): `aiservice/src/main/java/com/fitness/aiservice/service/GeminiService.java`
- [Recommendation API](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java): `aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java`
- [Recommendation service](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java): `aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java`
- [Recommendation store](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java): `aiservice/src/main/java/com/fitness/aiservice/repository/RecommendationRepository.java`

### Service platform

- [Service discovery](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/eureka/src/main/java/com/server/eureka/EurekaApplication.java): `eureka/src/main/java/com/server/eureka/EurekaApplication.java`
- [Configuration server](https://github.com/sakshiprogram/fitness-ai-microservices/blob/main/configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java): `configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java`

### Other components

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

## Connections

- Fitness user → Frontend app: uses (evidence: `fitness-app-frontend/src/App.jsx`)
- Frontend app → Auth state: updates (evidence: `fitness-app-frontend/src/App.jsx`)
- Frontend app → Activity form: renders (evidence: `fitness-app-frontend/src/App.jsx`)
- Frontend app → Activity list: renders (evidence: `fitness-app-frontend/src/App.jsx`)
- Frontend app → Activity detail: routes to (evidence: `fitness-app-frontend/src/App.jsx`)
- Activity form → API client: calls (evidence: `fitness-app-frontend/src/components/ActivityForm.jsx`)
- Activity list → API client: calls (evidence: `fitness-app-frontend/src/components/ActivityList.jsx`)
- Activity detail → API client: calls (evidence: `fitness-app-frontend/src/components/ActivityDetail.jsx`)
- API client → API gateway: sends requests
- Gateway user client → User API: calls HTTP (evidence: `gateway/src/main/java/com/fitness/gateway/user/UserService.java`)
- User sync filter → Gateway user client: registers users (evidence: `gateway/src/main/java/com/fitness/gateway/KeycloakUserSyncFilter.java`)
- User API → User service: delegates (evidence: `userservice/src/main/java/com/fitness/userservice/Controller/UserController.java`)
- User service → User store: reads and writes (evidence: `userservice/src/main/java/com/fitness/userservice/service/UserService.java`)
- Activity API → Activity service: delegates (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: calls HTTP (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java`)
- Activity service → Activity store: reads and writes (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`)
- Activity store → Activity record: stores (evidence: `activityservice/src/main/java/com/fitness/activityservice/ActivityRepository.java`)
- Activity service → RabbitMQ: publishes activity (evidence: `activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java`)
- RabbitMQ → Activity message listener: delivers activity
- Activity message listener → Recommendation analysis: dispatches analysis
- Recommendation 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`)
- Recommendation API → Recommendation service: delegates (evidence: `aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java`)
- Recommendation service → Recommendation store: queries (evidence: `aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java`)
