Voice of the Consumer (VOC) is a pair of Rails applications collectively capable of first generating and presenting surveys, then collecting and analyzing the results.
This (Public) application is responsible for presenting surveys and collecting responses.
The Admin application is concerned with the administration interface, including site setup, survey creation and versioning, and results processing.
VOC currently works on Rails 3.0.13 and either MRI Ruby 1.9.3-p194 (Linux only) or the Win32 version of JRuby 1.7.1.
Both versions rely on a database in MySQL 5.1 or greater, shared between Admin and Public applications.
Note: These instructions presume Ruby/JRuby dependencies have already been met and walk through running a development environment only; setting up to run in production requires additional configuration.
More information is provided in the Admin Wiki.
Run bundle install to satisfy gem dependencies.
Check the config/ directory for examples of the YAML configuration files which
need to be in place and generate appropriately. The database is set up in the
Admin application; as such, the database.yml settings should be identical.
In one command window, start webrick:
rails s webrick -p XXXX
Navigate to the configured port to view a list of surveys which have been published from the administration interface.
Follow steps for MRI Ruby, but prepend jruby -S to all rake and
rails commands.
Windows batch scripts have been provided for use with Tomcat (or other Java Servlet container.)