Difference between revisions of "Module 6"

From CSE330 Wiki
Jump to navigationJump to search
 
(43 intermediate revisions by 7 users not shown)
Line 8: Line 8:
 
* [[Node.JS]]
 
* [[Node.JS]]
 
* [[Socket.IO]]
 
* [[Socket.IO]]
* [[Pong Game]]
+
* [[FAQ - Mod 6]]
* [[Git]]
 
  
 
== Individual Assignments ==
 
== Individual Assignments ==
Line 22: Line 21:
  
 
# Copy the example code from the Node.JS guide into a file called ''static_server.js'' or something of that nature.  Save it on your EC2 instance (but not in a place that Apache can serve!).
 
# Copy the example code from the Node.JS guide into a file called ''static_server.js'' or something of that nature.  Save it on your EC2 instance (but not in a place that Apache can serve!).
#: Ensure that you understand what the static file server script is doing… this might show up on a quiz!
+
#: Ensure that you understand what the static file server script is doing…
 
# Make a directory parallel to ''static_server.js'' named ''static''.
 
# Make a directory parallel to ''static_server.js'' named ''static''.
 
# Change "<STATIC DIRECTORY NAME>" on line 11 of the static fileserver example code to reflect the name of the directory you just made.
 
# Change "<STATIC DIRECTORY NAME>" on line 11 of the static fileserver example code to reflect the name of the directory you just made.
Line 36: Line 35:
 
== Group Project ==
 
== Group Project ==
  
In the group portion of Module 6, you will be building a multiplayer, networked Pong game using Node.JS and Socket.IO. Your game must enable users to choose a nickname and play a game of Pong with others on your site ''without'' logging in (no need for a password or Open ID).
+
In the group portion of Module 6 you will create a multi-room chat server using Node.JS and Socket.IO. This project must be completed using Node.JS.
  
If you want to reminisce and play some Pong on the command line before building it in Node.JS, here is the command, assuming you have '''emacs''' installed:
+
This chat service will contain a main lobby where users sign on with a nickname and can communicate with each other.  Users may also create chat rooms for other to join.  The entire app should be displayed on a single webpage, listing the room you are in, all available rooms, and the users in the current room.
  
<source lang="bash">$ emacs -q --no-splash -f pong</source>
+
The single room chat server and client are provided here: [[Socket.IO]]
  
Press '''C-x C-c''' to exit emacs.
+
== Grading ==
 +
 
 +
We will be grading the following aspects of your work.  There are 75 points total.
  
Instructions on how to begin your group portion can be found here: [[Pong Game]]
+
'''Assignments (including code) must be committed to Github by the end of class on the due date (commit early and often). Failing to commit by the end of class on the due date will result in a 0. '''
  
== Grading ==
+
'''Additionally, for this module, the TA should be able to simply download your repo and start up your file server, without having to copy files or create additional subdirectories.  This applies to both the individual and the creative portion'''
  
We will be grading the following aspects of your work.  There are 80 points total.
+
_________
  
 
# '''Individual Portion (25 Points):'''
 
# '''Individual Portion (25 Points):'''
 
#* Node.JS is installed on your EC2 instance (5 points)
 
#* Node.JS is installed on your EC2 instance (5 points)
#* The ''hello.txt'', ''brookings.jpg'', and ''city.html'' files all load successfully (3 points each)
+
#*: ''Take a screenshot of your browser visiting your EC2 instance serving up the college.html web page on port 3456, make sure the URL is visible in the screenshot.''
#* Visiting a file that does not exist inside the ''static'' directory results in a 404 (3 points)
+
#* The ''hello.txt'', ''brookings.jpg'', and ''college.html'' files all load successfully (4 points each)
#* You can explain to the TA why ''phpinfo.php'' behaves the way it does when loaded through Node.JS (3 points)
+
#* Visiting a file that does not exist inside the ''static'' directory results in a 404 (4 points)
#* Using Git, push your node.js app to bitbucket and clone it on your ec2 instance (5 points)
+
#* Discuss in the README.md why ''phpinfo.php'' behaves the way it does when loaded through Node.JS (4 points)
# '''Pong Game (45 Points):'''
+
#* Make sure all of your individual portion files are pushed to Github (include your node.js files, hello.txt, brookings.jpg, college.html, and phpinfo.php)
#* '''''Matching Pairs of Players (10 Points):'''''
+
 
#** Players are able to specify a name for themselves (3 points)
+
# '''Multi-room Chat Server (50 Points):'''
#** Players are able to initiate a game on their own (4 points)
+
#* '''''Administration of user created chat rooms (25 Points):'''''
#** When a game is started, both players need to consent (3 points)
+
#** Users can create chat rooms with an arbitrary room name(5 points)
#* '''''Gameplay (10 Points):'''''
+
#** Users can join an arbitrary chat room (5 points)
#** The Pong game works (3 points)
+
#** The chat room displays all users currently in the room (5 points)
#** There is a pause between a player losing a round and the ball being launched for the next round (3 points)
+
#** A private room can be created that is password protected (5 points)
#** Victory condition is enforced (e.g., the first player to score 10 points wins the game) (4 points)
+
#** Creators of chat rooms can temporarily kick others out of the room (3 points)
#* '''''Socket.IO Communications (15 Points):'''''
+
#** Creators of chat rooms can permanently ban users from joining that particular room (2 points)
#** A mapping of players to their opponents exists on the server side (without this, you can't complete any other parts of the Socket.IO section) (3 points)
+
#* '''''Messaging (5 Points):'''''
#** ''Start Game and End Game'' is forwarded from one client to the other via Socket.IO (3 points)
+
#** A user's message shows their username and is sent to everyone in the room (1 point)
#** ''Paddle Moving'' is forwarded from one client to the other via Socket.IO (3 points)
+
#** Users can send private messages to another user in the same room (4 points)
#** ''Ball Hitting and Missing Paddle'' is forwarded from one client to the other via Socket.IO (3 points)
 
#** ''Ball Launching'' is forwarded from one client to the other via Socket.IO (3 points)
 
 
#* '''''Best Practices (5 Points):'''''
 
#* '''''Best Practices (5 Points):'''''
#** Code is well formatted and easy to read (2 points)
+
#** Code is well formatted and easy to read, with proper commenting (2 points)
#** There are no XSS vulnerabilities (3 points)
+
#** Code passes HTML validation (2 points)
#** ''Extra Credit:'' Your ''client.js'' code passes [http://jshint.com/ JSHint], a JavaScript validator (+2 bonus points)
+
#** node_modules folder is ignored by version control (1 points)
#** ''Extra Credit:'' Your ''app.js'' code passes [http://jshint.com/ JSHint], a JavaScript validator (+2 bonus points)
 
 
#* '''''Usability (5 Points):'''''
 
#* '''''Usability (5 Points):'''''
#** Finding friends on the Pong interface is easy and intuitive (4 points)
+
#** Communicating with others and joining rooms is easy and intuitive (4 points)
 
#** Site is visually appealing (1 point)
 
#** Site is visually appealing (1 point)
# '''Creative Portion (10 Points)'''
+
#* '''Creative Portion (10 Points)'''
 +
<!-- #** Make sure to create a README.md file pointing to your server -->
  
 
[[Category:Module 6]]
 
[[Category:Module 6]]
 
[[Category:Modules]]
 
[[Category:Modules]]

Latest revision as of 15:41, 21 December 2020

Module 6 builds upon the JavaScript skills you learned in Module 5.

Reading

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

Individual Assignments

Install Node.JS

Install Node.JS from Apt or Yum according to the instructions in the Node.JS guide.

Static File Server in Node.JS

The individual portion of Module 6 is short in order to give you enough time to complete the group portion.

  1. Copy the example code from the Node.JS guide into a file called static_server.js or something of that nature. Save it on your EC2 instance (but not in a place that Apache can serve!).
    Ensure that you understand what the static file server script is doing…
  2. Make a directory parallel to static_server.js named static.
  3. Change "<STATIC DIRECTORY NAME>" on line 11 of the static fileserver example code to reflect the name of the directory you just made.
  4. Save the following files in your static directory:
    <?php   phpinfo();   ?>
    
  5. Boot up your Node.JS static fileserver, and from your browser, load all four of the files you created in step 4.
    Which ones work and which ones don't? Why might this be the case?

Group Project

In the group portion of Module 6 you will create a multi-room chat server using Node.JS and Socket.IO. This project must be completed using Node.JS.

This chat service will contain a main lobby where users sign on with a nickname and can communicate with each other. Users may also create chat rooms for other to join. The entire app should be displayed on a single webpage, listing the room you are in, all available rooms, and the users in the current room.

The single room chat server and client are provided here: Socket.IO

Grading

We will be grading the following aspects of your work. There are 75 points total.

Assignments (including code) must be committed to Github by the end of class on the due date (commit early and often). Failing to commit by the end of class on the due date will result in a 0.

Additionally, for this module, the TA should be able to simply download your repo and start up your file server, without having to copy files or create additional subdirectories. This applies to both the individual and the creative portion

_________

  1. Individual Portion (25 Points):
    • Node.JS is installed on your EC2 instance (5 points)
      Take a screenshot of your browser visiting your EC2 instance serving up the college.html web page on port 3456, make sure the URL is visible in the screenshot.
    • The hello.txt, brookings.jpg, and college.html files all load successfully (4 points each)
    • Visiting a file that does not exist inside the static directory results in a 404 (4 points)
    • Discuss in the README.md why phpinfo.php behaves the way it does when loaded through Node.JS (4 points)
    • Make sure all of your individual portion files are pushed to Github (include your node.js files, hello.txt, brookings.jpg, college.html, and phpinfo.php)
  1. Multi-room Chat Server (50 Points):
    • Administration of user created chat rooms (25 Points):
      • Users can create chat rooms with an arbitrary room name(5 points)
      • Users can join an arbitrary chat room (5 points)
      • The chat room displays all users currently in the room (5 points)
      • A private room can be created that is password protected (5 points)
      • Creators of chat rooms can temporarily kick others out of the room (3 points)
      • Creators of chat rooms can permanently ban users from joining that particular room (2 points)
    • Messaging (5 Points):
      • A user's message shows their username and is sent to everyone in the room (1 point)
      • Users can send private messages to another user in the same room (4 points)
    • Best Practices (5 Points):
      • Code is well formatted and easy to read, with proper commenting (2 points)
      • Code passes HTML validation (2 points)
      • node_modules folder is ignored by version control (1 points)
    • Usability (5 Points):
      • Communicating with others and joining rooms is easy and intuitive (4 points)
      • Site is visually appealing (1 point)
    • Creative Portion (10 Points)