Module 1 Capstone - Vending Machine Software

Hello World

You're developing an application for the newest vending machine distributor, Umbrella Corp. They've released a new vending machine, Vendo-Matic 600.

Application requirements

1. The vending machine dispenses beverages, candy, chips, and gum.
   • Each vending machine item has a Name and a Price.
2. A main menu must display when the software runs, presenting the following options:

   (1) Display Vending Machine Items
   (2) Purchase
   (3) Exit
   

3. The vending machine reads its inventory from an input file when the vending machine starts. (It should not reread the file again, until the program shuts down and restart)
4. The vending machine is automatically restocked each time the application runs.
5. When the customer selects "(1) Display Vending Machine Items", they're presented with a list of all items in the vending machine with its quantity remaining:
   • Each vending machine product has a slot identifier and a purchase price.
   • Each slot in the vending machine has enough room for 10 of that product.
   • Every product is initially stocked to the maximum amount.
   • A product that has run out must indicate that it's "SOLD OUT". Display should not show '0' as qty remaining.
6. When the customer selects "(2) Purchase", they are taken to a new purchasing menu:

   
   (1) Feed Money
   (2) Select Product
   (3) Finish Transaction
   
   Current Money Provided: $2.00
   
   

7. The purchase process flow is as follows:
   1. Selecting "(1) Feed Money" allows the customer to add money the machine in whole dollar amounts (only whole dollar amounts between 1-10, for example, 1,2,3,4,5,6,7,8,9,10 are valid).
      • The "Current Money Provided" indicates how much money the customer has fed into the machine.
   2. Selecting "(2) Select Product" allows the customer to select a product to purchase.
      • Show the list of products available and ask the customer to enter a code to select an item and the quantity that they would like to purchase.
      • If the product code doesn't exist, the vending machine informs the customer and returns them to the Purchase menu.
      • If a product is currently sold out, or there is not enough quantity left in the machine, the vending machine informs the customer and returns them to the Purchase menu.
      • If a customer selects a valid product and there is enough quantity available, it's dispensed to the customer.
      • Dispensing an item prints the quantity selected, item name, cost,and the money remaining. Dispensing also returns a message:
        • All chip items print "Crunch Crunch, Yum!"
        • All candy items print "Munch Munch, Yum!"
        • All drink items print "Glug Glug, Yum!"
        • All gum items print "Chew Chew, Yum!"
      • After the machine dispenses the product, the machine must update its balance accordingly and return the customer to the Purchase menu.
   3. Selecting "(3) Finish Transaction" allows the customer to complete the transaction and receive any remaining change.
      • The machine returns the customer's money using only nickels, dimes, and quarters (using the smallest amount of coins possible).
      • The machine's current balance updates to $0 remaining.
   4. After completing their purchase, the user returns to the "Main" menu to continue using the vending machine.
8. The vending machine logs all transactions to prevent theft from the vending machine.
   • Each purchase must generate a line in a file called Log.txt.
   • The lines must follow the format shown in the following example.
     • The first dollar amount is the amount deposited, spent, or given as change.
     • The second dollar amount is the new balance.

     01/01/2019 12:00:00 PM FEED MONEY: $5.00 $5.00 
     01/01/2019 12:00:15 PM FEED MONEY: $5.00 $10.00 
     01/01/2019 12:00:20 PM Crunchie B4 $1.75 $8.25 
     01/01/2019 12:01:25 PM Cowtales B2 $1.50 $6.75 
     01/01/2019 12:01:35 PM GIVE CHANGE: $6.75 $0.00
     

9. Create as many of your classes as possible to be "testable" classes. Limit console input and output to as few classes as possible.
10. Sales Report
    • Provide a "Hidden" menu option on the main menu ("4") that writes to a sales report that shows the total sales since the machine started. The name of the file must include the date and time so each sales report is uniquely named.
    • An example of the output format appears at the end of this file.
11. Provide unit tests demonstrating that your code works correctly.

---

Vending machine data file

The input file that stocks the vending machine products is a pipe | delimited file. Each line is a separate product in the file and follows this format:

Column Name	Description
Slot Location	The slot location in the vending machine containing the product.
Product Name	The display name of the vending machine product.
Price	The purchase price for the product.
Type	The product type for this row.

For example:

A1|Potato Crisps|3.05|Chip
B1|Moonpie|1.80|Candy
B2|Cowtales|1.50|Candy
C1|Cola|1.25|Drink

An input file is in your repository: vendingmachine.csv.

---

Sales report

The output sales report file is also pipe-delimited for consistency. Each line is a separate product with the number of sales for the applicable product. At the end of the report is a blank line followed by the TOTAL SALES dollar amount indicating the gross sales from the vending machine.

For example:

Potato Crisps|0
Stackers|1
Grain Waves|0
Cloud Popcorn|0
Moonpie|3
Cowtales|0
Wonka Bar|0
Crunchie|0
Cola|2
Dr. Salt|0
Mountain Melter|0
Heavy|0
U-Chews|0
Little League Chew|1
Chiclets|1
Triplemint|0

**TOTAL SALES** $11.05