A small Sinatra app for reading and voting on event CFP submissions. Developed for use with the Monitorama conferences.
The traditional for reviewing and sorting through conference CFP submissions is a tedious and thankless task. Most conference organizers recognize this as a largely manual effort, using some combination of spreadsheets and dead trees. Judy aims to streamline the process, with the ultimate goal of having the abstract review process as enjoyable as reading stories on Instapaper within your favorite tablet device.
Judy's design goals are straightforward:
- Collecting abstracts should be easy.
- Reading abstracts should be enjoyable.
- Interpreting the results should be simple.
- The interface should fulfill all of the above requirements, particularly on mobile devices, with as few clicks as possible.
Judy has helped numerous users review thousands of submissions for a variety of events. For our own events, it enabled us to bring in a larger team of volunteers to review and judge papers than would have previously been possible, increasing diversity and helping to float the very best talks to the top of the stack.
Judy stores all of its relational data in PostgreSQL. It is assumed you have a local PostgreSQL server available for development.
All environment variables can be set from the command-line, although it's suggested to use .env instead. This file will automatically be picked up by foreman, which is also helpful when debugging (e.g. foreman run pry). This file will not be committed (unless you remove or modify .gitignore) so you shouldn't have to worry about accidentally leaking credentials.
DATABASE_URL(required)JUDY_AUTH(required)JUDY_ADMIN(optional)JUDY_CHAIR(optional)FORCE_HTTPS(optional)POSTMARK_API_TOKEN(optional)POSTMARK_TEMPLATE_ID(optional)MAIL_FROM_ADDRESS(optional)
The Judy UI is protected by Basic Authentication. Credentials should be set using the JUDY_AUTH environment variable as colon-delimited credential pairs. Multiple pairs should be delimited with commas. For example:
JUDY_AUTH=user1:foo,user2:bar,user3:baz
Users with administrative privileges should have their username(s) added to the JUDY_ADMIN environment variable. From the previous example, if user1 and user3 are allowed to edit abstracts, your variable should look like this:
JUDY_ADMIN=user1,user3
Administrators are able to edit and delete abstracts from the abstract view.
Users listed in the JUDY_CHAIR environment variable have access to per-reviewer scores and comments on the scores page. Any users already specified in JUDY_ADMIN inherit this functionality.
JUDY_CHAIR=user2
Judy supports email acknowledgement of abstract submission via the Postmark email delivery API. This feature is an optional but helpful way to notify prospective speakers that their form submission was received. This feature makes use of Postmark's Templates feature. You should include variables for the abstract title and body values; currently these are the only variables passed through Postmark's template_model.
Thank you for your submission!
Title: {{ title }}
Abstract: {{ body }}
Best wishes,
The Event Organizers
The related environment variables must be set for this feature to be enabled. If any of these variables are unset, email acknowledgement will not be attempted. Note that you will almost certainly want to create a Postmark Sender Signature to match your MAIL_FROM_ADDRESS.
POSTMARK_API_TOKEN=12345678-abcd-1234-5678-abcd12345678
POSTMARK_TEMPLATE_ID=1234567
MAIL_FROM_ADDRESS=Event 2018 <foo@bar.com>
Judy uses the Sinatra web framework under Ruby 1.9. Anyone wishing to run Judy as a local service should be familiar with common Ruby packaging and dependency management utilities such as RVM and Bundler. If you are installing a new Ruby version with RVM, make sure that you have the appropriate OpenSSL development libraries installed before compiling Ruby.
$ rvm use 1.9.3
$ bundle install
$ createdb judy
$ cp .env.example .env
$ $EDITOR .env
$ export DATABASE_URL=... # needed for rake task
$ bundle exec rake db:migrate:up
$ foreman start
$ open http://127.0.0.1:5000
Or, to deploy manually:
$ heroku create
$ git push heroku master
$ heroku run bundle exec rake db:migrate:up
$ heroku config:set JUDY_AUTH=user:pass
$ heroku config:set FORCE_HTTPS=true
$ heroku openDatabase upgrades (or downgrades) should use the built-in rake migration targets. For upgrading to the newest version in your development or non-Heroku production environment:
$ bundle exec rake db:migrate:upIf for some reason you need to downgrade to a previous migration target, make sure to set the VERSION number:
$ bundle exec VERSION=3 rake db:migrate:toIf you're running on Heroku, simply prefix the aforementioned commands with heroku run (and any other relevant options).
Judy is distributed under the MIT license. Third-party software libraries included with this project are distributed under their respective licenses.