Milestone 9 Requirements (Spring 2022)

General requirements:

• You will need to follow the style laid out in the C# Coding Conventions

• You will need to comment your code using XML comments

• You will need to update your UML to reflect your current code

• You will need to write appropriate unit tests for your code

Assignment requirements:

• Create a new ASP.NET Core Web project named Website using the Razor Pages option

• Update the Layout, Privacy Page, and About page following the details laid out below

• Create a static Menu class in your Data project

• Update the Index page to dynamically list the full menu provided by the Data library

• Update your UML Class Diagrams for:

  • Data Project
  • Website Project

(You don’t need to create a UML of your test project, though you can if you like)

Purpose:

This assignment is to get you started on creating a ASP.NET project, and using razor pages to implement a website.

Assignment Details

Begin by creating a new Razor Pages app named “Website” within your project. Then implement the requirements listed below.

Beyond these core requirements, you may add features and elements as you see fit. Moreover, you are encouraged to style the site using CSS.

Privacy Page

Modify the Razor page named Privacy.cshtml to meet the following guidelines. An example of what this might look like:

It should:

1. Set the page title to “Privacy Policy”
2. Render a <h1> tag with the text “Fried Piper Website Privacy Policy” or something similar.
3. Render the following privacy policy in a <p> tag:

Fried Piper respects the privacy of our diners. This site does not collect your data. This site does not use cookies. This site only offers information about Fried Piper restaurant and its menu selection.

About Page

Create a new Razor page named About.cshtml. It should meet the following guidelines. An example of what this might look like:

1. Set the page title to “About”
2. Render a <h1> tag with the text “About Fried Piper”
3. Render the following description in a <p> tag:

Founded in 2023 by students of the CIS 400 course, Fried Piper offers the finest and fastest of fried confectioneries for your gastronomical delight.

Layout

Modify the existing (created by the template) _Shared/Layout.cshtml to (at a minimum):

1. Set the page title to what is provided by the page with the string “- Fried Piper” concatenated to the end
2. Provide a navigation link to the new About page, as well as the Privacy page, and the Treats, Poppers, and Platters on the index page.
3. Change the copyright statement to “(c) 2022 - Fried Piper LLC.”

The navigation bar should look something like:

Create a static Menu class

In your Data project you should create a static class named Menu declared in the file Menu.cs which contains the following static properties:

• Treats which returns an IEnumerable<IMenuItem> containing an instance of all available fried treats (Fried Pie, Fried Ice Cream, Fried Candy Bars, Fried Twinkies). For treats with flavor, filling, or candy bar choices, you must include all the available options.
• Poppers which returns an IEnumerable<IMenuItem> containing an instance of all available poppers. As each popper has 3 different sizes, this collection should contain a small, medium, and large instance of each. You should also include both glazed and unglazed options for each.
• Platters which returns an IEnumerable<IMenuItem> containing all available platters. It should contain one instance of every combination of items possible in a Piper Platter. It should also contain every combination of popper plater (small, medium, and large as both glazed and unglazed).
• FullMenu should return an IEnumerable<IMenuItem> containing all of the items on the menu (one of each of the items found in the categories above).

Index Page

Modify the existing Index.cshtml page to display the full menu of Fried Piper according to the guidelines that follow. An example of what this might look like:

Welcome Message

Add a first-level header (<h1>) identifying the page as “Fried Piper”.

Under that, add a section greeting the customer with the message:

The finest of fried delights!

List the Menu Categories

List the three categories of menu items (Treats, Poppers, and Platters)

List the Menu Items

Below each of the menu category headers, list the items in that category. Each item should be placed in a <div> with a class of "menu-item". The <div> should include, nested inside, the name of the item, its price, and its calories. If an item comes in multiple sizes, you will need to list the price and calories for each size.

You may use additional HTML elements to organize and present this information, and use CSS to style it as you see fit.

You should use the methods from your Menu class in the Data project to determine the entrees, sides, and drinks to display. This will mean using the Menu class in the model class for the index page, Index.cshtml.cs.

Testing

Testing continues to be a critical part of writing our project. You will need to write tests for all of your code in the Data project. We will introduce testing a Razor Page app in a future module, so you don’t need to test it yet.

Testing the Menu Class

You should test your Menu class to ensure that your properties are returning all the appropriate menu items. Some strategies you may want to employ:

1. Checking the count of items in a category matches your expectation (i.e. the poppers category contains 4 poppers, each can be 3 sizes, and 2 values for glazed, for a total of 4x3x2 combinations, or a total of 24 items)
2. Checking that each unique combination exists in the category. This can be done with the Assert.Contains() or Assert.Collection() [Collection Assertions](<ref “/1-object-orientation/04-testing/05-xunit-assertions#collection-assertions”>}})
3. As there are a lot of possible combinations, this is one time you may need to include additional logic in your tests (i.e. loops).

Updating your UML

Data Project UML

Your UML Diagram needs to be updated to reflect any changes you made in this milestone, including adding the Menu class.

Web Project UML

You will need to add a UML class diagram for your new project. You can either combine this with your existing UML (if you do this, clearly indicate which classes belong to which project), or create a second diagram.

A Razor Page is composed of two parts - the CSHTML rendering template and the CS file containing the page’s model class. Only the class needs to appear in a UML diagram document. It is handled the same way as any class.

Submitting the Assignment

Once your project is complete, merge your feature branch back into the main branch and create a release tagged v0.9.0 with name "Milestone 9". Copy the URL for the release page and submit it to the Canvas assignment.

Grading Rubric

The grading rubric for this assignment will be:

15% Structure Did you implement the structure as laid out in the specification? Are the correct names used for classes, enums, properties, methods, events, etc? Do classes inherit from expected base classes?

15% Documentation Does every class, method, property, and field use the correct XML-style documentation? Does every XML comment tag contain explanatory text?

15% Design Are you appropriately using C# to create reasonably efficient, secure, and usable software? Does your code contain bugs that will cause issues at runtime?

15% UML Diagrams Does your UML diagram reflect the code actually in your release? Are all classes, enums, etc. included? Are associations correctly identified?

20% Functionality Does the program do what the assignment asks? Do properties return the expected values? Do methods perform the expected actions?

20% Testing Do you have unit tests for all classes? Do your unit tests cover all the functionality of those classes? Do you have a written test plan for your GUI? Do you have a record of employing the test plan in your release?