This repository has been archived by the owner. It is now read-only.
A simple web app that lets students in computer labs file help tickets for their teachers to review.
Ruby HTML CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bin
config
db
lib
log
public
test
vendor/assets
.gitignore
.travis.yml
Gemfile
Gemfile.lock
README.md
Rakefile
config.ru

README.md

Deprecated

Development has stopped and this is no longer supported.

Tickets

Build Status Dependency Status Code Climate

A simple web app that lets students in computer labs file help tickets for their teachers to review.

Installation

Please note that these instructions are for setting up and running an instance of Tickets in the development environment, and not for deploying it. Tickets is designed to be deployed to Heroku.

  1. Make sure you have Ruby 1.9.3, RubyGems, and Git installed and up to date with your package manager of choice. Alternatively, download the Rails Installer (Windows/Mac only) and follow the first two numbered bullets of step 2 from their website.

  2. In your terminal, run:

git clone https://github.com/nicolasmccurdy/tickets.git
cd tickets
bundle install
rake db:setup
rails server

If execjs gives you a Could not find a JavaScript runtime error, try installing Node.js.

  1. Visit http://localhost:3000/ in your web browser to start using your instance of Tickets.

Requirements

Tickets

  • Tickets are stored in a persistent database, which does not need to store any other data
  • Tickets are destroyed when they are resolved, and cannot be modified
  • Tickets have the following attributes, which are all required to be existent and non-empty:
    • name (string): the name of the person who created the ticket
    • computer (integer, unique): the number of the computer that the ticket was created for
    • reason (string): the reason for the ticket, chosen via two submit buttons (reason must be either "help" or "lab completed")
    • created_at (time): the time the ticket was created

Permissions

  • Any user can see/create/destroy their own tickets
  • There may only be one ticket open per computer (as a result, there should be only one ticket open per user)
  • Authentication is required for the ticket list page, which lets admins see and destroy all tickets
  • The username and password of the admin account are specified via a config file

UI

  • Two main views
    • New ticket (all users)
    • Ticket list (admin only)
  • Let users know their positions on the queue
  • Remember data about users between page visits
  • Update both views with live data via AJAX so that HTTP requests are only required when switching pages and creating/destroying tickets
  • Provide documentation for server maintainers and admins