How iwrite3/fittrack works
FitTrack accepts workout entries through its React client, routes requests through an authenticated gateway, validates users and stores activities, then asynchronously generates and serves AI coaching recommendations. User profiles supply biometrics for calorie estimates; the client polls for results and displays activity history and statistics. The map includes the documented service-discovery/configuration role and Keycloak authentication. Some service links are documented rather than visible in sampled call sites; those edges cite the README.
Main entry points: App.jsx FitTrack app · RouteConfig.java API gateway · ActivityService.java Activity tracking · UserController.java User API
Components 26
Fitness client
- FitTrack app
fitness-app-frontend/src/App.jsx - Activity views
fitness-app-frontend/src/components/ActivityDetail.jsx - API client
fitness-app-frontend/src/services/api.js - Activity statistics
fitness-app-frontend/src/utils/stats.js
Identity and gateway
- Keycloak
- API gateway
gateway/src/main/java/com/fitness/gateway/RouteConfig.java - User sync
gateway/src/main/java/com/fitness/gateway/KeycloakUserSyncFilter.java - Service discovery
eureka/src/main/java/com/server/eureka/EurekaApplication.java - Configuration service
configserver/src/main/java/com/fitness/configserver/ConfigserverApplication.java
User accounts
- User API
userservice/src/main/java/com/fitness/userservice/controller/UserController.java - User management
userservice/src/main/java/com/fitness/userservice/service/UserService.java - User records
userservice/src/main/java/com/fitness/userservice/repository/UserRepository.java
Activity tracking
- Activity API
activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java - Activity tracking
activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java - User validation
activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java - Activity records
activityservice/src/main/java/com/fitness/activityservice/ActivityRepository.java
AI coaching
- Activity listener
aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java - AI analysis
aiservice/src/main/java/com/fitness/aiservice/service/ActivityAIService.java - Recommendation API
aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java - Recommendation queries
aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java - Recommendations
aiservice/src/main/java/com/fitness/aiservice/controller/repository/RecommendationRepository.java
Other components
- Athlete
- PostgreSQL
- MongoDB
- RabbitMQ
- OpenRouter
Connections 30
- Athlete → FitTrack app: logs workouts
README.md - FitTrack app → Keycloak: authenticates with
README.md - FitTrack app → Activity views: renders
fitness-app-frontend/src/App.jsx - FitTrack app → API client: requests data
fitness-app-frontend/src/App.jsx - FitTrack app → Activity statistics: calculates summaries
fitness-app-frontend/src/App.jsx - FitTrack app → API gateway: sends API requests
README.md - API gateway → User API: routes requests
README.md - API gateway → Activity API: routes requests
README.md - API gateway → Recommendation API: routes requests
README.md - Keycloak → User sync: provides identity
README.md - User sync → User API: synchronizes users
- User API → User management: delegates to
userservice/src/main/java/com/fitness/userservice/controller/UserController.java - User management → User records: reads and writes
userservice/src/main/java/com/fitness/userservice/service/UserService.java - User records → PostgreSQL: persists users
README.md - Activity API → Activity tracking: delegates to
activityservice/src/main/java/com/fitness/activityservice/controller/ActivityController.java - Activity tracking → User validation: validates and loads profile
activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java - User validation → User API: requests user data
activityservice/src/main/java/com/fitness/activityservice/service/UserValidationService.java - Activity tracking → Activity records: saves and queries
activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java - Activity records → MongoDB: persists activities
README.md - Activity tracking → RabbitMQ: publishes activity event
activityservice/src/main/java/com/fitness/activityservice/service/ActivityService.java - RabbitMQ → Activity listener: delivers event
README.md - Activity listener → AI analysis: processes activity
aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java - AI analysis → OpenRouter: requests analysis
- Activity listener → Recommendations: stores recommendation
aiservice/src/main/java/com/fitness/aiservice/service/ActivityMessageListener.java - Recommendation API → Recommendation queries: delegates to
aiservice/src/main/java/com/fitness/aiservice/controller/RecommendationController.java - Recommendation queries → Recommendations: queries recommendations
aiservice/src/main/java/com/fitness/aiservice/service/RecommendationService.java - Recommendations → MongoDB: persists results
README.md - FitTrack app → Recommendation API: polls for results
fitness-app-frontend/src/App.jsx - Service discovery → API gateway: supports discovery
- Configuration service → API gateway: supplies configuration