Quick Rate Web Application

This wiki page is a work in progress for specifying the quick rate prototype.

Goals

Make it easy and convenient to rate information already in the system. Could take the form of a web app, a mobile app, a facebook app, a phone app.

User Interface Sketches

Alternate game UI details are on the QuickRate iPhone page.

System Design

The quick rate web application presents users with a single (top-level) review. The primary goal is for users to rate the review on a particular interest, at which point he or she is presented with another random review to rate.

A review has the following properties:

• title
• created by user
• created by time and date
• description
• associated interest(s)
• associated node(s)

Users rate reviews for a particular interest. These ratings are averaged to give the review+interest an average rating.

The current web application attempts to populate all of these properties when the review is created (except for ratings), and currently does not permit editing after creating time.

This is a design decision, not a requirement. A system that gathered reviews by scraping the web might present partial reviews--eg title, created by and description--to users for the selection of interests and nodes. A system might attempt to determine nodes or interests automatically, but permit user editing, as well.

URLS, views, templates

Select interest web page

• URL: /quickrate/select_interest/P<review_id>
• view: /trunk/web/quickrate/views/main.py select_interest(request, review_id)
• template: /trunk/web/quickrate/templates/select_interest.html
• if the review already has an interest selected, call rate(request, review_id, interest_name).

Rate review web page

• URL: /quickrate/rate/P<review_id>/P<interest_name>
• view: /trunk/web/quickrate/views/main.py select_interest(request, review_id, interest_name)
• form: form submits with three fields: review(id), interest(name), rating
• post: after submitting the form, redirect to default web page
• template: /trunk/web/quickrate/templates/select_interest.html

Default web page

• URL: /quickrate
• view: /trunk/web/quickrate/views/main.py select_interest(request)
• randomly (for now) selects a review that the user has not yet rated and calls select_interest(request, review_id).

ToDo?:

• create a page for introduction and explanation
• create pages for points_awarded.html and save_progress.html and issues.html
• create a process that allows users to create an account and then continue working on quickrate (should they have to reply to an email to continue?)
• when they click on "details" they should be taken to the browse page in a new tab. that browse page should be the review discussion thread that they were rating
• when they click on "respond" they should be taken to the page to write a review in response to the review (this function doesn't work yet though - so for now they're given an error message?)
• when they click on skip it should pull up another review to rate