Node.js & MySQL

bamazonDatabase

For this assignment, we were instructed to create a Bamazon shopping application using Node and SQL. The purpose of the assignment is as follows:

Customer Portal:

• When the user runs the Bamazon application and chooses to run the customer view of the application, they will be prompted with two choices:

1. Browse the inventory: which will display a chart of all the inventory available for purchase in the store.

• The inventory is organized by the productID, the name, the department in which the item is located, the price per product, and the quantity of that item.

2. Shop: The user will be asked to input the id of the specific item they would like to purchase and how many of that item they would like to buy.

• Once they input that information, the customer will be shown a "Bill of Sale" that shows the total price to the customer and the specific item they chose and shows the amount of stock left in the store.
• If the customer chooses to buy an amount of an item when there is not enough stock to complete the purchase. The user will be told, that the sale could not be completed becuase of insufficient product stock.

• To watch a demonstration of the customer portion of the assignment, click https://nelizafraz.tinytake.com/sf/MjAzMTQzMl82NDA5NjQ5

Manager Portal:

• When the user runs the Bamazon application and chooses the manager view of the application, they will be prompted with four choices:

1. View products for sale - This function essentially displays a chart that shows all the items in the store, like the one displayed in the Browse Inventory portion of the customer portal.
2. View low inventory - This choice displays a chart of all the inventory in the store with a stock quantity less than 5.
3. Add quantity to existing inventory - With this option the user can add more stock to an already existing product. The manager will need to enter the ID of the product they are referencing and how many they would like to the already existing quantity.
4. Add a new product to the store - This fourth option allows the manager to add an entirely new product to the Bamazon store.

• To watch a demonstration of the manager portion of the assignment, click https://nelizafraz.tinytake.com/sf/MjAzMTMxNV82NDA5MjQy

Node.js & MySQL

Overview

In this activity, you'll be creating an Amazon-like storefront with the MySQL skills you learned this week. The app will take in orders from customers and deplete stock from the store's inventory. As a bonus task, you can program your app to track product sales across your store's departments and then provide a summary of the highest-grossing departments in the store.

Make sure you save and require the MySQL and Inquirer npm packages in your homework files--your app will need them for data input and storage.

Submission Guide

Make sure you use the normal GitHub. Because this is a CLI App, there will be no need to deploy it to Heroku. This time, though, you need to include screenshots, a gif, and/or a video showing us that you got the app working with no bugs. You can include these screenshots or a link to a video in a README.md file.

• Include screenshots (or a video) of typical user flows through your application (for the customer and if relevant the manager/supervisor). This includes views of the prompts and the responses after their selection (for the different selection options).

• Include any other screenshots you deem necessary to help someone who has never been introduced to your application understand the purpose and function of it. This is how you will communicate to potential employers/other developers in the future what you built and why, and to show how it works.

• Because screenshots (and well-written READMEs) are extremely important in the context of GitHub, this will be part of the grading.

If you haven't written a markdown file yet, click here for a rundown, or just take a look at the raw file of these instructions.

Instructions

Challenge #1: Customer View (Minimum Requirement)

1. Create a MySQL Database called bamazon.

2. Then create a Table inside of that database called products.

3. The products table should have each of the following columns:

   • item_id (unique id for each product)

   • product_name (Name of product)

   • department_name

   • price (cost to customer)

   • stock_quantity (how much of the product is available in stores)

4. Populate this database with around 10 different products. (i.e. Insert "mock" data rows into this database and table).

5. Then create a Node application called bamazonCustomer.js. Running this application will first display all of the items available for sale. Include the ids, names, and prices of products for sale.

6. The app should then prompt users with two messages.

   • The first should ask them the ID of the product they would like to buy.
   • The second message should ask how many units of the product they would like to buy.

7. Once the customer has placed the order, your application should check if your store has enough of the product to meet the customer's request.

   • If not, the app should log a phrase like Insufficient quantity!, and then prevent the order from going through.

8. However, if your store does have enough of the product, you should fulfill the customer's order.

   • This means updating the SQL database to reflect the remaining quantity.
   • Once the update goes through, show the customer the total cost of their purchase.

---

• If this activity took you between 8-10 hours, then you've put enough time into this assignment. Feel free to stop here -- unless you want to take on the next challenge.

---

Challenge #2: Manager View (Next Level)

• Create a new Node application called bamazonManager.js. Running this application will:

  • List a set of menu options:

    • View Products for Sale

    • View Low Inventory

    • Add to Inventory

    • Add New Product

  • If a manager selects View Products for Sale, the app should list every available item: the item IDs, names, prices, and quantities.

  • If a manager selects View Low Inventory, then it should list all items with an inventory count lower than five.

  • If a manager selects Add to Inventory, your app should display a prompt that will let the manager "add more" of any item currently in the store.

  • If a manager selects Add New Product, it should allow the manager to add a completely new product to the store.

---

• If you finished Challenge #2 and put in all the hours you were willing to spend on this activity, then rest easy! Otherwise continue to the next and final challenge.

---

Challenge #3: Supervisor View (Final Level)

1. Create a new MySQL table called departments. Your table should include the following columns:

   • department_id

   • department_name

   • over_head_costs (A dummy number you set for each department)

2. Modify the products table so that there's a product_sales column and modify the bamazonCustomer.js app so that this value is updated with each individual products total revenue from each sale.

3. Modify your bamazonCustomer.js app so that when a customer purchases anything from the store, the price of the product multiplied by the quantity purchased is added to the product's product_sales column.

   • Make sure your app still updates the inventory listed in the products column.

4. Create another Node app called bamazonSupervisor.js. Running this application will list a set of menu options:

   • View Product Sales by Department

   • Create New Department

5. When a supervisor selects View Product Sales by Department, the app should display a summarized table in their terminal/bash window. Use the table below as a guide.

department_id	department_name	over_head_costs	product_sales	total_profit
01	Electronics	10000	20000	10000
02	Clothing	60000	100000	40000

6. The total_profit column should be calculated on the fly using the difference between over_head_costs and product_sales. total_profit should not be stored in any database. You should use a custom alias.

7. If you can't get the table to display properly after a few hours, then feel free to go back and just add total_profit to the departments table.

   • Hint: You may need to look into aliases in MySQL.

   • Hint: You may need to look into GROUP BYs.

   • Hint: You may need to look into JOINS.

   • HINT: There may be an NPM package that can log the table to the console. What's is it? Good question :)

---

Minimum Requirements

Attempt to complete homework assignment as described in instructions. If unable to complete certain portions, please pseudocode these portions to describe what remains to be completed.

---

One More Thing

If you have any questions about this project or the material we have covered, please post them in the community channels in slack so that your fellow developers can help you! If you're still having trouble, you can come to office hours for assistance from your instructor and TAs.

Good Luck!

Copyright

Coding Boot Camp (C) 2016. All Rights Reserved.