CS 257: Software Design

Web Application: finishing it up

Goals

• Finish a cool web application
• Feel proud of it
• Learn a bunch more random stuff

How I will grade the final product

• cd YOUR-REPO/webapp
• git checkout webapp-final
• Read your readme.txt
• psql -U jondich grading < data.sql
• Edit config.py to correspond to my user name and my "grading" database name
• python3 app.py localhost 5000
• Test everything in a browser, taking notes on usability and correctness
• Read through your app.py, api.py, *.js, *.html, and *.css files, and your database design, taking notes on code organization and quality
• Write down my main observations, and assign a grade based on this rubric:
  Score - (Weight) Category ======================== V/4 - (2) Correctness W/4 - (1) Feature Scope X/4 - (2) User Experience Y/4 - (4) Code Construction Z/4 - (1) Documentation score (40 possible) = V*2 + W*1 + X*2 + Y*4 + Z*1

Keep in mind a few things about this evaluation plan.

• The rubric is weighted to reflect the emphasis of this course as a whole: high quality code and the needs of the user are the focus, without ignoring the fact that functioning code ("correctness") is essential, too.
• I've included a lightly-weighted "Feature Scope" to give myself a way to reward ambitious work, without making fancy features a dominant part of the rubric. The idea here is that a very simple project with excellent code and excellent usability should be able to earn an A, but that extra awesomeness also deserves a small boost in score.
• Note that it is very important that your project run properly with just "python3 app.py localhost 5000". You can test this by cloning a fresh copy of your own repository, creating your own "grading" database ("CREATE DATABASE grading" in psql), and following the steps listed above.
• Follow the specs carefully. For example, if I tell you to create a readme.txt file, for example, don't call it README or README.txt or readme.md or readme.docx.
• Don't forget Mr. Krug's wisdom: don't make me think!
• Think positively, and have fun! When I see a fun and interesting web application, it's a real pleasure for me, and that is part of the subjective category of "user experience". I have loved working with all of you, and seeing the cool stuff you're creating is one of the great benefits of my job.

Your tasks

• Complete your project and test it thoroughly.
• Include a file webapp/readme.txt, structured like so:
  AUTHORS: [your names] DATA: [a one-sentence description of your data] [copyright info, plus a description of how I could get your raw data myself, including relevant links] STATUS: [a concise description of what works, what's not working yet, and any other information that might help me test and evaluate your work] NOTES: [(Optional) anything else you'd like to add]

• Dump your database into webapp/data.sql:

  pg_dump --no-owner --no-privileges -U YOURUSERNAME YOURDATABASE > data.sql
  This will, of course, overwrite your previous data.sql from the end-to-end assignment. That's just fine. If I ever wanted to run that earlier version, I could just do "git checkout end-to-end".

  NOTE: If your data.sql file is larger than 25MB, then don't add it to your repository. Instead, DM it to me via Slack.

• Tag your repository webapp-final. Commit, push, and "git push origin webapp-final".

Have fun, and keep those questions coming!