How isharak7m/forge works
Forge is an AI fitness platform: users log workouts, meals, sleep, water, and weight, then review dashboards, trends, predictions, and recommendations. The React app routes authenticated users to feature pages and calls a Spring REST API; backend services process domain data and persist it through repositories. Documented AI capabilities include weight and workout predictions, plateau detection, adherence scoring, and recommendations. Source excerpts are selective, so links to unsampled domain implementations are shown only where documented or marked unverified.
Main entry points: repository Data repositories · DashboardService.java Dashboard aggregation · api API clients · AuthService.java Authentication
Components 22
Web application
- App routing
frontend/src/App.tsx - Feature pages
frontend/src/pages - API clients
frontend/src/api - Auth state
frontend/src/store/authStore.ts
API and identity
- Auth endpoints
src/main/java/com/forge/controller/AuthController.java - Authentication
src/main/java/com/forge/service/AuthService.java - JWT security
src/main/java/com/forge/security - Profile endpoints
src/main/java/com/forge/controller/UserController.java
Fitness tracking
- Tracking endpoints
src/main/java/com/forge/controller - Nutrition logging
src/main/java/com/forge/service/NutritionService.java - Workout tracking
src/main/java/com/forge/service/WorkoutService.java - Sleep water weight
src/main/java/com/forge/service - Dashboard endpoint
src/main/java/com/forge/controller/AnalyticsDashboardController.java - Dashboard aggregation
src/main/java/com/forge/service/DashboardService.java
AI and insights
- AI endpoints
src/main/java/com/forge/controller/AIController.java - Prediction and scoring
src/main/java/com/forge/ai/ml - Recommendations
src/main/java/com/forge/ai/recommendation/RecommendationService.java - AI tool execution
src/main/java/com/forge/ai/tool
Domain data
- User profile model
src/main/java/com/forge/entity/User.java - Data repositories
src/main/java/com/forge/repository
Other components
- Fitness user
- PostgreSQL
Connections 29
- Fitness user → App routing: uses
README.md - App routing → Feature pages: routes to
frontend/src/App.tsx - App routing → Auth state: checks session
frontend/src/App.tsx - Feature pages → API clients: requests data
frontend/src/pages/WorkoutsPage.tsx - API clients → Auth endpoints: calls API
- API clients → Tracking endpoints: calls API
- API clients → AI endpoints: calls API
- Auth endpoints → Authentication: delegates to
- Authentication → Data repositories: reads and saves
src/main/java/com/forge/service/AuthService.java - Authentication → JWT security: creates token
src/main/java/com/forge/service/AuthService.java - Authentication → User profile model: creates user
src/main/java/com/forge/service/AuthService.java - Profile endpoints → User profile model: serves profile
- Tracking endpoints → Nutrition logging: delegates nutrition
src/main/java/com/forge/controller/NutritionController.java - Tracking endpoints → Workout tracking: delegates workouts
src/main/java/com/forge/controller/WorkoutController.java - Tracking endpoints → Sleep water weight: delegates logs
src/main/java/com/forge/controller/NutritionController.java - Nutrition logging → Data repositories: reads and writes
src/main/java/com/forge/service/NutritionService.java - Workout tracking → Data repositories: reads and writes
src/main/java/com/forge/service/WorkoutService.java - Dashboard endpoint → Dashboard aggregation: delegates to
- Dashboard aggregation → Nutrition logging: aggregates nutrition
src/main/java/com/forge/service/DashboardService.java - Dashboard aggregation → Workout tracking: aggregates workouts
src/main/java/com/forge/service/DashboardService.java - Dashboard aggregation → Sleep water weight: aggregates logs
src/main/java/com/forge/service/DashboardService.java - Dashboard aggregation → Data repositories: reads summaries
src/main/java/com/forge/service/DashboardService.java - AI endpoints → Prediction and scoring: invokes models
src/main/java/com/forge/controller/AIController.java - AI endpoints → Recommendations: requests recommendations
src/main/java/com/forge/controller/AIController.java - AI endpoints → AI tool execution: dispatches tools
src/main/java/com/forge/controller/AIController.java - Prediction and scoring → Data repositories: reads history
src/main/java/com/forge/ai/ml/WorkoutPredictionService.java - Recommendations → Prediction and scoring: uses scores
src/main/java/com/forge/ai/recommendation/RecommendationService.java - Recommendations → Data repositories: reads activity
src/main/java/com/forge/ai/recommendation/RecommendationService.java - Data repositories → PostgreSQL: persists records