Body Tracker

Introduction

The Body Tracker project aims to create a powerful yet simple application designed to track body shape and provide suggestions for achieving the perfect body shape through calisthenics and gym exercises. This document outlines the system requirements for the Body Tracker app, including integration with pre-resolved API specifications.

System Overview

The Body Tracker app will serve as a comprehensive tool for users to monitor their body shape progress and receive personalized exercise suggestions. The app will leverage pre-resolved API specifications to enhance its functionality and provide a seamless user experience.

Functional Requirements as Story Points

• As a User, I should be able to track my body measurements over time.
• As a User, I should be able to log my calisthenics and gym exercises.
• As a User, I should receive personalized exercise suggestions based on my body shape goals.
• As a User, I should be able to view my progress through visual charts and graphs.
• As a User, I should be able to integrate with pre-resolved APIs for enhanced data tracking and analysis.
• As a User, I should receive notifications and reminders for my exercise schedule.
• As a User, I should be able to set and modify my body shape goals.

User Personas

• Regular User: Individuals who actively engage in calisthenics and gym exercises and wish to track their progress and receive personalized suggestions.
• Fitness Enthusiast: Users who are deeply involved in fitness activities and require detailed analytics and insights into their body shape and exercise routines.

Core User Flows

• User logs into the app -> Inputs initial body measurements -> Sets body shape goals -> Logs daily exercises -> Receives exercise suggestions -> Views progress charts -> Adjusts goals as needed.
• User receives a notification -> Opens the app -> Logs new exercise data -> Reviews updated progress -> Receives new suggestions based on recent activities.

Visuals Colors and Theme

• primary: #1E90FF (Dodger Blue)
• primary_light: #63B8FF (Light Sky Blue)
• secondary: #FF6347 (Tomato)
• accent: #32CD32 (Lime Green)
• highlight: #FFD700 (Gold)
• bg: #F5F5F5 (White Smoke)
• surface: rgba(255, 255, 255, 0.9)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Gray)
• border: rgba(200, 200, 200, 0.5)

Signature Design Concept

The Body Tracker app will feature an interactive 3D body model on the home page, allowing users to rotate and zoom into different body parts. This model will dynamically update to reflect the user's logged measurements and progress. Users can click on specific areas to receive targeted exercise suggestions and view detailed analytics. The 3D model will be powered by @react-three/fiber and @react-three/drei, providing a smooth and engaging experience.

Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, creating a layered depth effect as users scroll through the app. The 3D body model will be the focal point, with subtle animations triggered by user interactions, such as hovering over body parts or clicking for more information. Internal pages will maintain a "static" interaction model for clarity and ease of use.

Non-Functional Requirements

• The app must ensure data privacy and secure user information.
• The app should be responsive and perform well on both mobile and web platforms.
• The app must integrate seamlessly with pre-resolved API specifications.
• The app should support multiple languages, with a focus on English and Hindi for the Indian market.

Tech Stack

• Frontend: React for Web, React Native for mobile app
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The app will primarily target users in India, considering local preferences and language support.
• The integration with pre-resolved APIs is assumed to be straightforward and well-documented.
• The app will require internet connectivity for full functionality, especially for API interactions.

Glossary

• API: Application Programming Interface, a set of protocols for building and interacting with software applications.
• Calisthenics: A form of exercise consisting of a variety of movements that exercise large muscle groups.
• Body Measurements: Data points that track the size and shape of various parts of the body.
• 3D Model: A digital representation of a physical object in three dimensions.