5/05/2015
General Information:
TrialTrackr: A Tabulation App
Original project developed by Macalester College students: Elliott Averett, Gozong Lor, Cara Cheng, and Amy Nguyen
TrialTrackr is a convenient way to pair teams at mock trial tournaments, adhering to the tabulation manual set by American Mock Trial Association.
Support:
TrialTrackr currently supports 4-round tournaments paired in accordance with the AMTA tabulation manual, including Bye Teams.
TrialTrackr does not support power-protected pairing (of the kind used at AMTA regionals and ORCs), weighted partial ballot, or bracket-based pairing methods at this time.
Framework:
Javascript and Angular JS (back-end)
CSS, HTML, Bootstrap (front-end)
Mongoose (server) for local testing, Amazon S3 for deployment.
File Structure:
js/controllers - has all of our screen controllers.
js - libraries, model, and other js files.
templates - has all our html screen templates.
resources - css, img, fonts.
main root - index.html
Getting Started:
To simply run the deployed application online, visit www.trialtrackr.com.
To run the application locally, clone and fork this github repository. It contains all the files needed to run this application on your local machine except for Mongoose, which can be found here:
http://cesanta.com/mongoose.shtml
We used NotePad++ to edit code, but any text editor or IDE should work.
For our UI, we used a Bootstrap template: http://startbootstrap.com/template-overviews/landing-page/
Libraries Used:
thenBy.JS Microlibrary
https://github.com/Teun/thenBy.js/tree/master
Underscore.js
Testing:
For our testing purposes, we took previous tournament results in the form of tabulation summaries and input that data into our application to see if TrialTrackr is pairing the teams properly.
TrialTrackr has been successfully paired the following tournaments:
- The 2015 Emerald City Open hosted by the University of Washington
Staging and Production Environments:
In our development environment, we used a Mongoose server to store our files.
Download the Mongoose Free edition to the folder in which the repository is located on your computer: http://cesanta.com/mongoose.shtml
To run the app in the development environment, click on the Mongoose icon in the TrialTrackr folder and it should open your web browser and direct it to a locally stored version of TrialTrackr.
Our live site is hosted using Amazon S3, which is an online static web hosting service offered by Amazon Web Services.