Skip to content

Latest commit

 

History

History
182 lines (149 loc) · 7.72 KB

File metadata and controls

182 lines (149 loc) · 7.72 KB

TECHCareers Capstone Project

Project Name: Yummy

Team Name: Puddlejumpers

Team Members:

  • Krisztina Pap
  • Aaron Barthel
  • Kenji Au
  • Lindsey Graham
  • Tosin Olaniyi

Problem Statement

  • Deciding on what to eat or what meal to serve the family three times a day can be a source of significant stress for many. We aim to provide our users with a convenient and easy-to-use repository for their favourite recipes and a way to organize them into daily or weekly meal plans. This could save them a lot of last minute decision-making, headaches about what ingredients they do or do not have on hand, and most importantly those energy- and time-consuming last minute trips to pick up that crucial missing ingredient.

How Yummy solves the problem:

  • Yummy enables users to keep a collection of their favourite recipes in a private user profile
  • It simplifies users’ lives by enabling them to plan their meals for the next day or week in advance. By doing so, it reduces stress, decision-fatigue, and cuts down on last-minute grocery store trips.

Project Documents and Reports

DEMO USER LOGIN INFORMATION:

Stack Used

  • .NET Core
  • React
  • MariaDB
  • TailwindCSS

Project Scope

In-scope features

  • Adding a recipe
  • Viewing a recipe
  • Editing/updating a recipe
  • Deleting a recipe
  • Viewing meal plan
  • Making/editing meal plan
  • Adding a user profile
  • Editing a user profile (updating name/password)

Out-of-scope features

  • Password email flow
  • Deleting user profiles

User Manual/Quick Start Guide

Yummy allows users to plan their meals in advance, therefore saving them time and last-minute runs to the grocery store.

To properly install the application, please follow the steps described in the Installation Instructions section below or in the Yummy Installation Manual.

Main Yummy Features:

  • Site Navigation
  • User Profiles
  • Meal Plan
  • Recipes List
  • Recipe Details
  • Instructions/About Page

Yummy has a pop-out Site Navigation menu that can be accessed from any of the site’s pages by simply clicking on the button with the three horizontal lines (the “hamburger menu”) in the top left corner of the screen.

Yummy features an easy-to-use user profile management component and requires users to log in to ensure that recipes and meal plans stay private.

For ease-of-use, the Meal Plan screen serves a dual purpose. It shows what is already scheduled and allows users to edit their plans.

The Recipes page displays all the user’s recipes for easy browsing. Clicking on a title or picture will bring up the details of that recipe. Clicking on the trash can icon will delete that recipe.

In the spirit of maximum user-friendliness and transparency, the Yummy landing page includes information on both the application and the team who built it.

For detailed user information please see the Yummy User Manual

Installation Instructions

Requirements

This is a Windows OS (Windows 10) application.

Installation Instructions

  1. Download repository from GitHub.
  2. Turn on XAMPP server
  3. Create env file
  • Open the “.env.sample” file located in the project root folder
  • Update the database server information to match your local setup
  • Save and rename the sample file to “.env”
  1. Open up command prompt, then:
  • Navigate to project folder
  • Run the command: “npm run install:all” (If you get prompted to install a certificate, click ‘yes’.)
  • Run the command: “npm run db:setup”
  • Run the command: “npm run start:all”
  1. Open a browser and navigate to “https://localhost:5001/”

For detailed installation instructions please see the Yummy Installation Manual

Testing Instructions

DEMO USER LOGIN INFORMATION:

Testing Prerequisites

  • Yummy currently only supports Windows OS
  • Internet access
  • A web browser such as Google Chrome, Firefox, or Microsoft Edge
  • Database/server must be running
  • Must have DOTNET Core 3 installed
  • Must have node.js installed

Endpoint Testing via Postman

Backend Testing

For detailed testing instructions please see the Yummy Testing Manual

Citations: