Difference between revisions of "Mean Stack"

From CSE330 Wiki
Jump to: navigation, search
(Grading)
m (moved Module 7 to Mean Stack)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
+
 
  
 
This module introduces MEAN, a fullstack web framework that uses '''M'''ongoDB, '''E'''xpress, '''A'''ngularJS and '''N'''ode.js. <br/>
 
This module introduces MEAN, a fullstack web framework that uses '''M'''ongoDB, '''E'''xpress, '''A'''ngularJS and '''N'''ode.js. <br/>
Line 13: Line 13:
 
*[[Getting MEAN]]
 
*[[Getting MEAN]]
 
* [[Git]]
 
* [[Git]]
 +
*[[Angular]]
  
== Individual Assignments ==
+
== Further Reading ==
  
 
=== Tutorials ===
 
=== Tutorials ===
  
Make sure you go through tutorials for both MongoDB and AngularJS, and understand how Express works.
+
It may be a good idea to go through tutorials for both MongoDB and AngularJS, and understand how Express works.
  
 
=== Install MEAN ===
 
=== Install MEAN ===
  
Follow the steps and install MEAN on your machine, initialize an app and type grunt in your terminal to start the server (make sure your mongoDB server is connected and running).
+
The individual assignment for this module only require AngularJS (version 1.3.15) and completing the tutorial
 +
[https://code.angularjs.org/1.3.15/docs/tutorial here]. We provide installation instructions for the entire MEAN stack using MEAN.IO as a reference. You do not need to install the MEAN stack for this module (but it is recommended to really understand all of pieces involved).
 +
 
 +
To install MEAN on your machine, initialize an app and type grunt in your terminal to start the server (make sure your mongoDB server is connected and running).
 
Open up the app in your browser (localhost:3000), and understand what the default app does.
 
Open up the app in your browser (localhost:3000), and understand what the default app does.
  
 +
== Group Project ==
 +
* Extended the AngularJS tutorial with additional features.
 +
 +
In the group portion of this module, you will extended the AngularJS tutorial with two additional features.  The first is a side-by-side comparison page displaying two products.  In the second, you will provide four additional sorting methods for displaying devices on the main product page. 
 +
 +
In the side-by-side comparison page, a user will be able to select two devices and view all of their features in a table.  This table will consist of three columns.  The first column simply lists all of the features of either device (battery, camera, connectivity, hardware, etc ) .  The second and third columns will display the information associated with that category for a particular pair of devices, allowing a user to easily compare the same feature across different devices.
 +
 +
The second feature is simply allowing users to sort the devices on additional metrics (in addition to Alphabetical and Newest).  Select four different attributes that you want to include to the drop down list on the main page. For example, I may want to sort by by weight or size of battery. 
  
== Group Project ==
+
For each feature, create a separate Git branch.  Name the first branch SideBySide and the second branch AdditionalSorting.  After you complete a feature, merge the branch back to the master branch.
* Make an e-commerce site using the MEAN stack.
+
 
 +
 
 +
<!-- * Make an e-commerce site using the MEAN stack.
  
  
Line 35: Line 49:
 
You may use phone models provided by the Angular Phone Catalog app as your products. Review the MongoDB section on how to import JSON data into MongoDB.
 
You may use phone models provided by the Angular Phone Catalog app as your products. Review the MongoDB section on how to import JSON data into MongoDB.
  
==== Tips ====
+
==== Tips on Installing MEAN ====
  
Review the "Getting MEAN" section to understand the file system so you know how components work with each other.
+
Review the "Getting MEAN" section to understand the file system so you know how components work with each other.
Keep in mind that you don't have to understand what every line of code does. Whenever in doubt, refer to the default app.
+
Keep in mind that you don't have to understand what every line of code does. Whenever in doubt, refer to the default app.
  
 
You will be making changes on both the server side (the /server directory of your app) and the client side (in the /public directory)
 
You will be making changes on both the server side (the /server directory of your app) and the client side (in the /public directory)
Line 50: Line 64:
 
View: (/public/views directory) views are .html files. Each view that requires data from the server side should be tied to a controller, inside the controller, you can specify methods to update/save/delete objects in the DB,  the view and routing section gives an example
 
View: (/public/views directory) views are .html files. Each view that requires data from the server side should be tied to a controller, inside the controller, you can specify methods to update/save/delete objects in the DB,  the view and routing section gives an example
 
Controller: add controller files to /public/controllers. Easy once you go through the AngularJS tutorial. You may need to add multiple services in the /public/services directory (tutorial part 11, and the default MEAN app) to use data received from the back end and persist data across views (look up ngCookie, $cookieStore or the HTML 5 localStorage solution).
 
Controller: add controller files to /public/controllers. Easy once you go through the AngularJS tutorial. You may need to add multiple services in the /public/services directory (tutorial part 11, and the default MEAN app) to use data received from the back end and persist data across views (look up ngCookie, $cookieStore or the HTML 5 localStorage solution).
Routing: /public/routes directory of your app. Add entries for all views you will use, and specify their urls and templates (stored in /public/views).
+
Routing: /public/routes directory of your app. Add entries for all views you will use, and specify their urls and templates (stored in /public/views). -->
  
 
== Grading ==
 
== Grading ==
  
We will be grading the following aspects of your work.  There are 100 points total.
+
We will be grading the following aspects of your work.  There are 50 points total where 18/50 are extra credit points. To complete this module you must do either the Side-By-Side comparison feature or the Additional Sorting feature. You will receive the points according to the rubric below, and any points over 32/50 will be extra credit.
 
 
# '''Working E-commerce Site (75 points)'''
 
#* MEAN installed and set up correctly (10 points).
 
#* Models set up correctly (15 points).
 
#*: ''including products, orders, and adding payment and shipping address to the user model, you don't have to use phones from the Angular tutorial but you are responsible for populating your products table''
 
#* Can display a list of all products, can search, can view details (15 points).
 
#* Can add to cart, view cart, cart sustains (data can be accessed across views and shouldn't be lost when page is refreshed) (20 points).
 
#* Can check out (5 points).
 
#*: ''A user can check out if she has a payment option and a shipping address, on a successful checkout, the cart should be emptied''
 
#* Can view orders, delete orders (10 points).
 
#*: ''An order is associated to a user and should contain at least four fields: date, total, number of products, shipped to''
 
# '''Design and Misc (5 Points):'''
 
#* Site is overall user friendly and utilizes Bootstrap (3 points).
 
#* App passes JShint with no errors (2 points)
 
# '''Creative Portion (20 Points):'''
 
  
[[Category:Module 7]]
+
# '''Completed AngularJS Tutorial (6 Points)'''
[[Category:Modules]]
+
# '''Completed Side-By-Side comparison feature (18 points)'''
 +
#* Users can select two different devices and view all of their attributes in a table format.
 +
#* If information for a particular category is not available on one device, display "Not available" in the table
 +
# '''Completed Additional Sorting feature (8 points)'''
 +
#* Users can sort devices based on four different attributes and the attribute values are displayed on the main device list page.  (2 points per attribute).
 +
# '''Git Repo (8 points)'''
 +
#* Two branches are created, one for each feature (4 points).
 +
#* Both branches are merged back to the master branch (4 points).
 +
# '''Creative Portion (10 Points)'''

Latest revision as of 10:44, 19 August 2015


This module introduces MEAN, a fullstack web framework that uses MongoDB, Express, AngularJS and Node.js.
You have already learned (some things) about Node.js. In this module, you will be introduced to other three new technologies. Don’t frown yet, the goal of this module is to expose you to the concept of web frameworks and prepare you for the creative project. You are not required to be an expert in all of these technologies, however, it’s important to understand the basics of each and how they work together. Follow along the tutorials and complete exercises to learn how things work, and you will be ready to create your own web applications using the MEAN stack very soon!


Reading

The following articles on the online class wiki textbook contain information that will help you complete the assignment.

Further Reading

Tutorials

It may be a good idea to go through tutorials for both MongoDB and AngularJS, and understand how Express works.

Install MEAN

The individual assignment for this module only require AngularJS (version 1.3.15) and completing the tutorial here. We provide installation instructions for the entire MEAN stack using MEAN.IO as a reference. You do not need to install the MEAN stack for this module (but it is recommended to really understand all of pieces involved).

To install MEAN on your machine, initialize an app and type grunt in your terminal to start the server (make sure your mongoDB server is connected and running). Open up the app in your browser (localhost:3000), and understand what the default app does.

Group Project

  • Extended the AngularJS tutorial with additional features.

In the group portion of this module, you will extended the AngularJS tutorial with two additional features. The first is a side-by-side comparison page displaying two products. In the second, you will provide four additional sorting methods for displaying devices on the main product page.

In the side-by-side comparison page, a user will be able to select two devices and view all of their features in a table. This table will consist of three columns. The first column simply lists all of the features of either device (battery, camera, connectivity, hardware, etc ) . The second and third columns will display the information associated with that category for a particular pair of devices, allowing a user to easily compare the same feature across different devices.

The second feature is simply allowing users to sort the devices on additional metrics (in addition to Alphabetical and Newest). Select four different attributes that you want to include to the drop down list on the main page. For example, I may want to sort by by weight or size of battery.

For each feature, create a separate Git branch. Name the first branch SideBySide and the second branch AdditionalSorting. After you complete a feature, merge the branch back to the master branch.


Grading

We will be grading the following aspects of your work. There are 50 points total where 18/50 are extra credit points. To complete this module you must do either the Side-By-Side comparison feature or the Additional Sorting feature. You will receive the points according to the rubric below, and any points over 32/50 will be extra credit.

  1. Completed AngularJS Tutorial (6 Points)
  2. Completed Side-By-Side comparison feature (18 points)
    • Users can select two different devices and view all of their attributes in a table format.
    • If information for a particular category is not available on one device, display "Not available" in the table
  3. Completed Additional Sorting feature (8 points)
    • Users can sort devices based on four different attributes and the attribute values are displayed on the main device list page. (2 points per attribute).
  4. Git Repo (8 points)
    • Two branches are created, one for each feature (4 points).
    • Both branches are merged back to the master branch (4 points).
  5. Creative Portion (10 Points)