Project One: Ice Cream Shop :emoji:

:information_source: Project Overview Difficulty Level: Beginner
Estimated Time: 3-4 hours
Skills Practiced:

• Working with lists and data structures
• Implementing user input and output
• Using conditional statements (if/elif/else)
• Creating loops for repetitive tasks
• Calculating prices and handling basic math
• Building interactive programs

Project Roadmap :emoji:️

┌─────────────────────┐
│   Phase 1: Setup    │
│  • Create menu lists│
│  • Display welcome  │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│ Phase 2: Take Order │
│  • Get user input   │
│  • Start order loop │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│Phase 3: Process Order│
│  • Validate choices │
│  • Update quantities│
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│ Phase 4: Summarize  │
│  • Show order recap │
│  • Calculate total  │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│   Bonus Features    │
│  • Add tax/charges  │
│  • Promo codes      │
└─────────────────────┘

Overview

In this project, you will create a simple Ice Cream Shop program that allows customers to interact with the system by selecting ice cream flavors, adding toppings, and calculating the total price of their order. The project will focus on strengthening your understanding of basic programming concepts such as print statements, user input, lists, conditional statements, and loops. You'll be encouraged to use your creativity to design the functionality and flow of the Ice Cream Shop.

Project Components

This project involves coding the functionality for an interactive Ice Cream Shop system, and submitting a video demonstration. There is no report for this project.

Project Requirements

One. Code Implementation

• Platform: Any Python IDE (e.g., Google Colab, Jupyter Notebook, or local Python setup)
• Requirements:
  • Use of Lists: Maintain lists for available ice cream flavors and toppings.
  • User Interaction:
    • Prompt users for their choice of ice cream flavor.
    • Allow users to select optional toppings from a list.
    • Display the price of each selected item and calculate the total price based on user selections.
  • Conditional Statements: Use conditional statements to handle different types of inputs and ensure valid selections (e.g., handle incorrect inputs).
  • Loops: Allow the user to add multiple toppings, and keep prompting until they are done.
  • Output: Display the final order summary with the total cost.

Example Features:

• Ice cream flavor selection (e.g., Vanilla, Chocolate, Strawberry).
• Toppings selection (e.g., Sprinkles, Nuts, Chocolate Syrup).
• Price calculation based on selected flavors and toppings.
• Exit condition when the user is done with their order.

2. Video Submission

• Duration: 2-3 minutes
• Requirements:
  • Record a short video demonstrating your Ice Cream Shop program.
  • Show the program running, including input from the user, order processing, and final output (order summary with price).
  • Explain the key features of your code, including how you handled user input, calculations, and displayed the results.
  • Discuss any enhancements or features you added to the project based on your creativity.

Evaluation Criteria

Your project will be evaluated based on the following criteria:

1. Code Functionality (50%)

   • Proper use of lists, loops, and conditional statements
   • Correctly implements user interactions and price calculations
   • Handles edge cases and invalid inputs gracefully

2. Code Quality (25%)

   • Code is clean, well-organized, and easy to understand
   • Includes clear comments to explain the logic and key parts of the code

3. Creativity and Features (15%)

   • Additional features or enhancements beyond the basic requirements (e.g., custom price structure, more interactive options)

4. Video Submission (10%)

   • Clear and concise explanation of the project
   • Demonstrates the project running smoothly and effectively

Submission Requirements

Final submission should include:

1. Python code file (e.g., .py or notebook)
2. 2-3 minute video showing the project and explanation

Project Submission

Make sure to double-check your project before submitting. Ensure you have included the Python code file and the video explanation as required.

:link: Submit your project here

Ice Cream Shop Program Guideline :computer:

In this project, you need to create a program for customers to order ice cream from this shop using lists, conditional statements, and loops.

:warning: Critical Setup Instructions Before you start coding:

1. Click the link here
2. Make a copy of the Colab Notebook to your Google Drive (File -> Save a copy in Drive)
3. Rename your copy to include your name (e.g., "IceCreamShop_YourName")
4. Check that you can edit and run cells in your copy

:warning: Common Error: If you can't edit the notebook, you're still viewing the original. Make sure to create your own copy!

Phase One: Welcome to the shop and show menu :emoji:

:bulb: Milestone Checkpoint 1 By the end of Phase 1, you should have:

• :white_check_mark: Three lists containing flavor categories
• :white_check_mark: A welcome message displayed
• :white_check_mark: Menu with prices shown clearly
• :white_check_mark: Counter variables initialized

1. Create three lists named Basic, Fruit, and Premium to prepare a menu for all the flavors according to categories.

Basic = ["Vanilla", "Chocolate", "Corn"]
Fruit = ["Strawberry", "Mango", "Banana"]
Premium = ["Oreo", "Caramel", "Durian"]

:memo: Why use lists? Lists help us organize similar items together. In a real ice cream shop, you'd have different categories with different prices - just like our Basic, Fruit, and Premium lists!

2. By using print(), say the welcoming speech and show the menu with the price as follows:

Welcome to Telebort Ice Cream!

The Menu for ice cream flavours with price is as follows:

Basic(RM3): ['Vanilla', 'Chocolate', 'Corn']

Fruit(RM4): ['Strawberry', 'Mango', 'Banana']

Premium(RM5): ['Oreo', 'Caramel', 'Durian']

3. Initialize the number of each flavor to 0.

num_basic = 0
num_fruit = 0
num_premium = 0

:bulb: Debugging Tip If your menu doesn't display correctly, check:

• Are your list names spelled correctly?
• Did you use the correct syntax for print()?
• Are the prices clearly shown for each category?

Phase 2: Ask the customer to start order :emoji:

:bulb: Milestone Checkpoint 2 By the end of Phase 2, you should have:

• :white_check_mark: Asked the customer if they want to order
• :white_check_mark: Stored their response in the order variable
• :white_check_mark: Program ready to proceed based on their answer

1. By using input(), ask the customer to make an order and store the customer's answer in variable order.

order = input("\n\nDo you want to make an order? \nType 'yes' to proceed, or 'no' to stop: ")

Expected output:

Do you want to make an order?
Type 'yes' to proceed, or 'no' to stop: yes

:warning: Common Input Errors

• Problem: User types "Yes" or "YES" instead of "yes"
• Solution: Consider using .lower() to handle different cases
• Example: order = input("...").lower()

Phase 3: Ask and receive the customer's order :memo:

:bulb: Milestone Checkpoint 3 By the end of Phase 3, you should have:

• :white_check_mark: A working while loop that continues based on user input
• :white_check_mark: Conditional statements checking flavor categories
• :white_check_mark: Counters updating for each order
• :white_check_mark: A way for customers to exit the ordering process

1. Create a while loop, with the condition order is equal to 'yes', and keep asking the customer "Which flavor of ice cream do you want?" until the order is "no". In the while loop:

   a. By using input(), ask the customer which flavor of ice cream they want and store the customer's answer in variable ans.

   python

   ans = input("\nWhich flavor of ice cream do you want? ")
   

   b. According to the customer's answer, use conditional statements to check if the ans in the lists and reply to the customer's order (flavors may change depending on the answer)

   • Basic: "You have choose Basic flavor: Vanilla"
   • Fruit: "You have choose Fruit flavor: Strawberry"
   • Premium: "You have choose Premium flavor: Oreo"
   • Others: "The choice is not available"

   Example:

   python

   if ans in Basic:
       print("You have choose Basic flavor:", ans)
   

   :warning: Debugging Common Errors

Error: "The choice is not available" even when typing a valid flavor

Possible causes:

• Case sensitivity (typing "vanilla" instead of "Vanilla")
• Extra spaces in input
• Misspelling the flavor name

Fix: Consider using .strip() and .title() on the input

c. Update variables num_basic, num_fruit, and num_premium according to the conditions in (b).

Example:

python

if ans in Basic:
    print("You have choose Basic flavor:", ans)
    num_basic = num_basic + 1

:memo: Pro Tip Instead of num_basic = num_basic + 1, you can use the shorter form: num_basic += 1

d. Update the order value by asking the customer to add another order or stop.

python

order = input("\nDo you want to make another order? \nType 'yes' to proceed, or 'no' to stop: ")

Phase 4: Summary of orders :bar_chart:

tip Milestone Checkpoint 4 By the end of Phase 4, you should have:

• :white_check_mark: An order summary showing quantities
• :white_check_mark: Clear display of what was ordered
• :white_check_mark: Proper exit from the ordering loop

1. Use else statements to summarize the customer's order if they don't want to make the order anymore. By updating variables in respective statements in Phase 3, we can get the summary of orders after the end of the order.

The expected output is as follows:

You have ordered
Basic: 1
Fruit: 1
Premium: 2

:memo: Best Practice Only show categories that have been ordered (where ``quantity > 0``). This makes the receipt cleaner and more professional!

Phase 5: Total price :emoji:

:bulb: Milestone Checkpoint 5 By the end of Phase 5, you should have:

• :white_check_mark: Calculated the total price correctly
• :white_check_mark: Displayed the price in a clear format
• :white_check_mark: A complete working ice cream ordering system!

1. Create a variable to store the total price.
2. To get the total price, there are 2 ways to do:
   • By updating variables in respective statements.
   • By calculation with the number of respective orders.

what flavour of ice cream do you want to eat?0
You have ordered
Basic: 1
Fruit: 1
Premium: 1
The total price is: 12

:warning: Price Calculation Tips Remember the prices:

• Basic: RM3 each
• Fruit: RM4 each
• Premium: RM5 each

Formula: total = (num_basic × 3) + (num_fruit × 4) + (num_premium × 5)

BONUS CHALLENGE: Extension Features :rocket:

There are few more features you can add-on for this program:

Level 1 Extensions (Choose 1-2)

• Tax Calculator: Add 10% service charge and 6% SST to the final price
• Promo Codes: Implement discount codes (e.g., "STUDENT10" for 10% off)
• Quantity Orders: Allow customers to order multiple scoops of the same flavor

Level 2 Extensions (For advanced students)

• Toppings System:
  • Create a toppings list with prices
  • Allow customers to add toppings to each ice cream
  • Calculate the new total with toppings
• Order History: Keep track of all orders in a session
• Size Options: Add Small/Medium/Large with different prices

Level 3 Extensions (Challenge yourself!)

• Customer Database: Save customer names and their favorite orders
• Inventory Management: Track how many of each flavor is available
• Receipt Generator: Create a formatted receipt with date and time

:bulb: Implementation Ideas Start with Level 1 extensions and work your way up. Each extension teaches you new programming concepts:

• Tax calculation -> Math operations
• Promo codes -> String comparison and dictionaries
• Toppings -> Nested data structures

Debugging Tips & Common Errors :bug:

:warning: Common Issues and Solutions

One. Infinite Loop

• Problem: Program keeps asking for orders forever
• Solution: Check your while loop condition and make sure order variable updates correctly

2. Price Calculation Wrong

• Problem: Total price doesn't match expected value
• Solution: Print each component (num_basic x 3, etc.) separately to debug

3. Flavor Not Found

• Problem: Valid flavors show as "not available"
• Solution: Check spelling and capitalization in your lists

4. Program Crashes on Input

• Problem: Error when user enters unexpected input
• Solution: Add error handling with try/except blocks

AI Prompt Helper :emoji:

Code with AI: Try using AI to help with project functions. Here are some sample prompts you can use:

Basic Prompts:

• "Help me create a Python function to calculate the total price of an ice cream order based on different flavors and toppings."
• "How can I implement a loop to keep asking for ice cream flavors until the customer is done ordering?"
• "Show me how to check if a customer's flavor choice is in my list of available flavors."
• "Write a function to display an ice cream shop menu with prices."

Advanced Prompts:

• "How can I handle case-insensitive input in my ice cream ordering system?"
• "Show me how to implement a promo code system with different discount percentages."
• "Help me create a function that validates user input and handles errors gracefully."
• "How can I format the final receipt to look professional with aligned prices?"