jcrawfordor / nmticpc

A quick-and-very-dirty web service for running an ICPC practice event at NMT

NMTICPC

The retrospectively stupidly named competition framework

NMTICPC is a Django-based web application for running manually-judged computer programming competitions in the style of the ACM International Collegiate Programming Competition.

It has several features:

1. Live scoreboard with live elapsed/remaining time display
2. Solution submission interface that shows submission history and a problem status overview
3. Django admin configured for easy use by judges

And several limitations:

1. Problems are expected to be distributed on paper or by other means, right now NMTICPC isn't set up to host the actual problem descriptions
2. The scoreboard doesn't do any kind of tie resolution, this will need to be done by hand if necessary
3. Judges just use the django admin interface, which is not the most polished way to do things
4. The whole thing was put together pretty quickly, so YMMV

NMTICPC was originally developed by Jesse B. Crawford ([email protected]) for the New Mexico Tech Programming Club's ICPC practice events. It was intended for one-time use only, but then got posted on github and reused.

Setup

• Obviously, you'll need an environment to run Django. NMTICPC was developed for Django 1.4 on Ubuntu 12.04 served via Apache. It should work on other environments as well.
• In nmticpc/, edit settings.py for your database environment (you made a database already, right?) and run ./manage.py syncdb. When asked to create a superuser account, do so.
• Run ./manage.py check_permissions to add proper Userena permissions to the superuser account.
• Make a directory <reporoot>/static and run ./manage.py collectstatic to accumulate static files there
• Make a directory <reporoot>/media and ensure that the webserver can write it
• Apache (or whatever server you use) should be configured to serve /static/ from <reporoot>/static and /media/ from <reporoot>/media (if you change the relative path to these directories, change it in settings.py)
• Start up your webserver, go to /admin, and log in. Create a problem object for each problem.
• Set the competition start and end times appropriately at the bottom of settings.py.

Usage

• Have teams or competitors register accounts before the event.
• Then, teams can submit solutions fairly intuitively (via the Problems tab and then clicking on individual problems).
• Judges log in to the admin interface and select Submissions. Click on each submission and click on the file name to download it, then check "Valid" if it's correct and "Reviewed" either way (so that you know it's been scored already). Add a comment if you'd like and then save your changes to the object.
• And that's basically it.

nmticpc's Issues

more scoring options

First submission bonus in a better way, for example. Also only solution bonus.

linebreaks in comment field

it's a pain to provide test cases right now! also probably put comments BELOW metadata for more width.

Check authentication-required decorators, clean up views

I should tidy up several things about the views before this gets looked at by too many other people.

Time Elapsed and Time Remaining don't sum to total time

Problem values aren't used

It always uses the number of problems solved as the score, it does not account for the point value of problems. This should be fixed.

Set up virtenv scripts for easier deployment

This'd be easier to deploy to machines other than jbcrawford.us (with debian-pony or whatever whacky environment it has) if there was a virtenv setup.

Automated problem creation

Create problems numbered 1..n automatically to save tedium.

Javascript timers herp the derp

Javascript timers will loop over to 24:00:00 when they hit 00:00:00. This has the amusing effect that between the timers hitting zero and the page reloading (so that you get a version with the timers disabled), the timers will read like 23:59:30 remaining.

Host problem manual online

Just let the admin upload a PDF and link to it from Submissions or something.

First administrator account has no profile

So when they log in via the main Login link, they get an internal server error when they try to view their profile. Maybe just change it so that it handles this error instead of 500ing.

problem names

Keep names for problems as well as numbers