General Assembly SEI19 Unit 3 Project
Developed by Frederick Ku, Malcolm Low, Shirley Tan
FoodSpan was created purposefully to tackle food wastage problem in Singapore.
Statistics released by the NEA (National Environment Agency) showed that Singapore generated more than 750k tonnes of food waste year on year.
Surveys conducted by NEA and AVA reported that consumers most likely to waste food at home compared to dining out as most will brought more than they actually consumed.
Top 3 reasons for thrown food are food that have expired and food that look mouldy or smell bad.
Most of SG citizens are awared of the food waste problem and willing to address the food waste problem so as to reduce cost on food purchase, provided they are better informed on meal plans and storage.
Help home-makers/consumers to reduce food wastage and cost by providing a informative platform which helps managing food purchases and storage effectively.
who are the target audience: home-makers what are the objectives: to reduce food waste and cost how to achieve the objective: a informative platform which helps managing food purchases and storage effectively
- Able to keep tracks of food expiry
- Catered to home-makers users experience flow, manages food from wish-list to home-fridge
- Visualisations on food data to give information to user the consumption and wastage
-
Go to Project link: https://github.com/shirleytwl/foodspan and clone the project
-
Installs all the dependencies of the project
bundle install -
create and run database with the following commands:
rails db:create rails db:migrate
Note: the seeds.rb file contains data for test run
4a. Not run the app without the seed data, simply proceed to run rails server
rails server
4b i. To test run with the seed data, run the application and create a user account before seeding.
rails server
4b ii. To test run with the seed data, run the application and create a user account before seeding.
rails db:seed
Note: App screen is designed as an mobile app at the moment. change screen resolution to mobile settings for best experience.
-
User will see root page of the app upon opening sucessfully on broswer.
-
The home page will give an introduction the app and its key features.
-
For new users, click the sign up or join now button to register into the app.
-
For signed up users, click on login button to login.
-
After user have signed up/logged in successfully, user will be directed to his/her dashboard.
-
For testers, open up the terminal and run the seed command.
-
New users dashboard will be empty. User can click on the top right corner to open up the navigation menu.
-
Users have choose the following options:
a. Open up shopping list to add ingredient/s to buy
b. Open up storage page to add ingredient/s bought and stored.
- The consumption and wastage percentage with "All Time" as default.
- The 6 months average of total food wastage bar chart.
- Top 3 expired food in the user storage.
- Top 3 food in the user shopping list.
- Click on "Add to List" and open up the "Add Ingredient" window.
- Input the name, amount and unit of the ingredient and "Save Ingredient" to the shopping list.
- Click the green circle to check the ingredient.
- Click "Move to Storage" button.
Alternatively, user can edit using the "Edit Ingredient" and delete with "red rubbish bin" icon.
- Click on "Add to Storage" and open up the "Add Ingredient" window.
- Input all the info of the ingredient and "Save Ingredient" to storage.
- Click on the "Update Quantity" to open up the "Update Quantity" window.
- Click on the "Update Quantity" to update the remaining quantity after consumed.
- Click on "Remove From Storage" to remove.
- Click on "Edit Ingredient" to make changes.
- Click the top left drop-down menu to choose the desired time span.
- Click the top right drop-down menu to choose the wastage in ascending or descending order.
- Click
- Click on the "detail" text to navigate to individual report.