Pierre's Bakery

Epicodus Coding School, Independent Project with C# & ASP.NET Core MVC Application, 12.18.2020

Description

Building upon a console application first built for Pierre's Bakery, this MVC application tracks the vendors that purchase baked goods from Pierre and the orders belonging to those vendors.

Vendors include properties for the vendor's name, a description of the vendor, a list of Orders belonging to the vendor. An Order includes properties like the title, the description, the price, and the date.

The homepage of the app at the root path (localhost:5000/) welcomes Pierre and provides him with a link to a Vendors page. Razor is used to display information to the user on each HTML page in the application.

From there, the vendors page contains a link to a page with a form that Pierre can fill out to create a new Vendor.

After the form is submitted, the new Vendor object is saved into a static List and Pierre should be routed back to the homepage. Pierre can then click a Vendor's name and go to a new page that will display all of that Vendor's orders. From there, Pierre can follow a link to a page that will present a form to create a new Order for that Vendor.

Technologies Used

Git
C# v 7.3
.NET Core v 2.2
dotnet script, REPL
Razor View Engine
ASP.NET Core MVC
RESTful Routing, CRUD, & HTTP
Bootstrap Library
CSHTML
Much green tea

Color Theme

Eggshell #F2EFE9
Warm tan #BFAC95
Soft brown #8C7974
Deep slate #524D59
Chestnut #403A3F

Installation Requirements

This project requires the technologies listed in the above 'Technologies Used' section. If you need to acquire any of the above technologies to access this project, please follow the instructions included below.

If you already have the necessary technologies on your local system, the commands necessary for running this console application and its tests will be found at the bottom of the instructions list.

Installing Git

For Mac Users

Access Terminal in your Finder, and open a new window. Install the package manager, Homebrew, on your device by entering this line of code in Terminal: $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".
Ensure Homebrew packages are run with this line of code: echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bash_profile.
Once homebrew is installed, install Git, a version control system for code writers, with this line of code brew install git.

For Windows Users

Open a new Command Prompt window by typing "Cmd" in your computer's search bar.
Determine whether you have 32-bit or 64-bit Windows by following these instructions.
Go to Git Bash, click on the "Download" button, and download the corresponding exe file from the Git for Windows site._
Follow the instructions in the set up menu.

For Both Mac & Windows systems

Once you have Git installed on your computer, go to this GitHub repository, click the "Fork" button in the upper right hand corner of the page.

Installing C#, .NET, dotnet script, & MySQL

Install C# and .Net according to your operating system below.

For Mac

Download this .NET Core SDK Software Development Kit. Clicking this link will prompt a .pkg file download from Microsoft.
Open the .pkg file. This will launch an installer which will walk you through installation steps. Use the default settings the installer suggests.
Confirm the installation is successful by opening your terminal and running the command $ dotnet --version, which should return something like: 2.2.105.

For Windows (10+)

Download either the the 64-bit .NET Core SDK Software Development Kit. Clicking these links will prompt a .exe file download from Microsoft.
Open the file and follow the steps provided by the installer for your OS.
Confirm the installation is successful by opening a new Windows PowerShell window and running the command dotnet --version. You should see something a response like this: 2.2.105.

For Mac & Windows Operating Systems

Install dotnet script with the following terminal command dotnet tool install -g dotnet-script.

Opening the Project on your Local System

Once the project has been cloned to your computer and you have all the necessary items on your local computer, open the project in the application of your choice (Visual Code Studio was used and is recommended by the application builder), and run the following...

Navigate to the project folder, PierresBakery.Solution, on your Terminal or CMD.
Move to the PierresBakery subfolder, and dotnet build will get bin/ and obj/ folders downloaded for the program to run.
Move to the PierresBakery.Tests subfolder via the terminal. Running dotnet restore will install other necessary packages listed in project's boilerplate.
When in the PierresBakery.Tests subfolder, dotnet test will allow you to run the test-driven-development tests for the project's Models.
In the main project folder, dotnet run will run the application in the console.

Specs

Spec	Input	Output
Welcome Page	User accesses localhost:5000	Output: "Welcome Message & Action List"
Create New Vendor	'Create new vendor' chosen	Output: "New vendor added"
View All Vendors	'View all vendors' chosen	Return: "All vendors"
Create New Order	'Create new order' chosen	Output: "New vendor added"
View All Orders	'View all orders' chosen	Return: "All orders"

Stretch Goals

Add pricing structure with algebraic formula for bread and pastry costs; add bread and pastry costs together for total invoice
Delete individual vendors, all vendors, all X vendor's orders, individual orders
InvoiceTotal = (algebraic formulas for) TotalBreadCost + TotalPastryCost;
Total invoice balance due per vendor
Add Javascript to form functionality
Retail vs wholesale pricing options

Known bugs

None known at this time.

viacheslavpopov / BakeryMVC