"Grocery Galore Survey Data Analysis" is a programme designed to manage the data of a fruit store using a "Google spreadsheet".
This programme was built for a company which sells fruits. It will allow the user to input the daily sales data and the daily waste data of a specific fruit and add it to a google spreadsheet. The programme will also calculate the new stock levels of the fruits and calculate restock recommendations. Different validation methods are also present throughtout this programme to check whether the data being inputted is valid.
Spreadsheets are a great way to store data for companies because it allows them to organise and perform calculations on the data. This enables them to make important predictions and decisions, which on a whole will benefit them.
This programme was built using knowledge gained from Python modules, for the purpose of completing my third Milestone Project for the Code Institute's full stack developer course. This programme is easy to navigate and easy to read, with a clear goal and aim.
-
As a first time user I want:
- To be able to understand the aim of the programme and how it works.
- To be able to use the programme in relation to my business.
- The programme to function correctly.
As a frequent user I want:
- The programme to be fluent and easy to use.
- The programme to positively affect my business.
- The programme to function correctly.
As the developer I want:
- To provide a useful programme that fufills it's aims.
- To have the programme run smoothly without crashing.
-
The data model for this code would be a Google Sheets document called "Grocery_Galore" with four worksheets: "Dailysales", "Dailywastechart", "Stocklevels", and "Dailyrestock". The worksheets contain data on daily sales, daily waste, stock levels, and daily restock levels for 7 different types of grocery items: Apples, Oranges, Bananas, Avocado, Pears, Grapes, Mangos. The data is updated through user inputs and calculations done in the code.
-
- This feature allows the user to input data that they have for the weekly sales of the different fruits.
-
- This feature allows the code to validate the data that has been inputted for the weekly sales. The validation makes sure that only seven numerical entries are inputed.
-
- This feature allows the code to update the sales worksheet with the inputted sales data.
-
- This feature allows the user to input data that they have for the weekly waste of the different fruits.
-
- This feature allows the code to validate the data that has been inputted for the weekly waste figures. The validation makes sure that only seven numerical entries are inputed.
-
- This feature allows the code to update the waste worksheet with the inputted waste data.
-
- This feature allows the code to calculate a suitable restock ammount and then print that ammount to the terminal. Thhis restock aamount is found by calculating the average over seven days and then multiplying that figure by 110%.
-
- This feature allows the code to update the restock worksheet with the calculated restock data.
-
- This feature allows the code to calculate a the new stock level ammount by subtracting the sales and waste data from the stock ammount from the day before and then adding the restock data. This ammount is then printed to the terminal.
-
- This feature allows the code to update the stock level worksheet with the new stock data.
-
- This feature allows the code to ask the user if they want to run the whole program again and add the data for another day or end it.
-
- I have manually tested the code by doing the following:
- Passed the code through a Pep8 Validator.
- Given invalid inputs, to test the validation.
- Tested code in local terminal and the Code Institute Heroku terminal.
- This test was done to make sure that no less than 7 values can be inputted.
- This test was done to make sure that no more than 7 values can be inputted.
- This test was done to make sure that only numerical values were inputted.
- These tests were done to make sure that only "Y" or "N" were inputted when asking if the program should restart.
- I have manually tested the code by doing the following:
-
-
- A "Pep8 python checker" from code institute was used to validate my code and no errors were returned.
-
-
-
- When trying to write the function to calculate the restock data, I had to add the sales column to the waste column. When trying to do this it didnt do the addition of the two columns properly as they were strings. Therefore I had to convert the columns from strings into integers before the addition was done.
- If the spreadsheet is accessed too frequently then Google throws an error.
-
- Git
- Allowed me to add commit and push my code to github for version control.
- Gitpod
- The programme used to code my website.
- Github
- Allowed me to store my repository and files pushed from Gitpod.
- Chrome developer tools
- Allowed me to troubleshoot and edit my code.
-
This code was deployed using Code Institute's mock terminal for Heroku.
- In the top right corner of the page click on the fork button.
- The next page will show a forked version of my project.
- Create a new Heroku app.
- Set the buildbacks to Python and NodeJS in that order.
- Link the Heroku app to the repository.
- Click on deploy.
- Stack Overflow for the use of helping me clear the terminal - https://stackoverflow.com/questions/19596750/is-there-a-way-to-clear-your-printed-text-in-python
- Code Institutes Love Sandwiches project
- The online tutors that Code Institute provides.
- Code institute for the deployment terminal.
- My mentor Ben Kav for helping me when I was stuck.
- Everybody on slack, for their advice.