Personal Trainer Tool

Personal Trainer Tool is an app created for professional who works at the health environment, can it being a personal trainer, nutritionist, whoever.

This app analyzes client's health and creates diets for them, according to their goals.

Click here to visit the deployed site.

Here is the link to the Google Spreadsheet, to see the updates made.

Table of contents

1. Project Goals
2. User Goals
3. Structure
   1. Initial Screen
   2. New Client
   3. Existing Client
4. Features
5. Technologies Used
   1. Languages
   2. Applications and Platforms
6. Validation
7. Testing
   1. Testing new client
   2. Testing existing client
8. Deployment
   1. Heroku
   2. Google API
9. Credits

Project Goals

The project goals are:

• Create an app for health professionals to check client health and weight status
• Create an app for health professionals to track their clients and help them to achieve their goals
• Create an app that calculates BMI ( Body Mass Index), BMR (Basal Metabolic Rate)
• Create an app that creates diets for specific objective (maintain, loss or gain weight)
• Create and update a worksheet for the professionals to track their clients easily
• Automate calculations

User Goals

The user goals are:

• Input client details and get their BMI ( Body Mass Index), BMR (Basal Metabolic Rate)
• Creat diets for their clients
• Save client details into a worksheet
• Update client details and get new diets
• Check client health and weight status
• Track their clients

Back to Table of contents

Structure

Flowchart

Below is a flowchart describing the structure of the application, created with Lucidchart.

Click here to view it.

Initial Screen

At the Initial Screen, user has two options: navigate to new client, or to existing client. This welcomes the user, and give them some instructions.

Click here to view the screenshot.

New Client

At the new client section, user will be asked many details to calculate Body Mass Index (BMI), Basal Metabolic Rate (BMR), and create diets. At the end inserting all the data into the worksheet.

Click here to view the screenshots

Existing Client

At the existing client section, user will be able to consult a client that was already created before, by their ID. If wanted, user can update the client details, and create new diets.

Click here to view the screenshots.

Back to Table of contents

Features

• Calculate Body Mass Index (BMI)
• Calculate Basal Metabolic Rate (BMR)
• Create diet to loss weight
• Create diet to gain weight
• Create diet to mantain weight
• Save data into a worksheet
• Update existing client and create new diets
• User can have several clients at the same time

Future Features

• User can delete a client
• User can save new details without deleting the old ones, being possible to do a future comparison
• Create diets specifying the number of carbohydrates, fat, and protein depending on client goal.

Back to Table of contents

Technologies Used

Languages

• Python 3 - Was used solely to create this project.

Applications and Platforms

• Git - Version control system used to commit and push to Github via Gitpod.
• Github - The projects repository and all its branches were commited, pushed and deployed to Github.
• Gitpod - All code was written and tested using the Gitpod web-based IDE.
• Heroku - Used to deploy the application.
• Lucidchart - Lucidchart was used to create the flowchart of the project.
• Google Sheets - The users input data creates and edits content on Google Sheets
• Google Cloud Platform - All data send and received with the help of the Google API, through the Google Cloud Platform

Third Party Libraries

• googleapiclient.discovery: needed to work with the Google API
• google.oauth2.service_account: So the application can access the account that the sheet are on with the credentials
• gspread: so the application can read Google Spreadsheets

Back to Table of contents

Validation

All Python files passed the PEP8 tests with 0 errors. Click here to view them.

Testing

Testing new client

"I would like to register a new client and create diets to them"

• Actions:
  • User hits "n" to add new client
  • User enters "1" to agree on the application logging the patient data
  • User enters client name
  • User enters client last name
  • User enters client gender
  • User enters client height
  • User enters client weight
  • User enters client age
  • User enters client activite level
  • User enters "n" to continue
  • BMI is calculated"
  • User enters "n" to continue
  • BMR is calculated
  • User enters "n" to continue
  • Diet is calculated and saved

• Expected result: To create a successful client and their diets

• Actual result: Works as intended

Back to Table of contents

Testing existing client

"I would like to update a existing client details and process new diets

• Actions:
  • User hits "e" to access existing client
  • User enters "1" to consult client
  • User enters client id
  • User get clients details and diets
  • User enters 1 to update client details
  • User enters client height
  • User enters client weight
  • User enters client age
  • User enters client activite level
  • User enters "n" to continue
  • BMI is calculated"
  • User enters "n" to continue
  • BMR is calculated
  • User enters "n" to continue
  • New diet is calculated and updated

• Expected result: To update a client details and their diets

• Actual result: Works as intended

Back to Table of contents

Deployment

Heroku

This application has been deployed from Github using Heroku. Here's how:

1. Create an account at heroku.com
2. Create a new app, add app name and your region
3. Click on create app
4. Go to "Settings"
5. Under Config Vars, add your sensitive data (creds.json for example)
6. For this project, I set buildpacks to and in that order.
7. Go to "Deploy" and at "Deployment method", click on "Connect to Github"
8. Enter your repository name and click on it when it shows below
9. Choose the branch you want to buid your app from
10. If desired, click on "Enable Automatic Deploys", which keeps the app up to date with your Github repository
11. All done!

Google API

Here's how you can set up your own API:

1. Login or create a Google account and navigate to https://console.cloud.google.com/
2. Create a new Project by clicking on the New Project icon
3. Add Project name and details
4. Under API's and services, enable the relevant API for your project (in this case Google Drive, Sheets)
5. IF the API requires, create a credential (service account in this case) for your project
6. Download the credential and upload it to your workspace as creds.json file
7. Under API's and services, enable the relevant API for your project (in this case Google Drive, Sheets)
8. Add them to your code.

Back to Table of contents

Credits

• Youtube video clarifying GSPREAD
• Formula to calculate BMR
• Formula to calculate BMI in Python
• A similiar app that helps me to construct an project idea here
• GITPOD template from Code Institute

Back to Table of contents