A web application to create and conduct surveys
- Survey - Collection of Questions
- Question - A specificaton for a piece of info that the survey designer wants to collect.
- Answer - A piece of information for a question
- Response - The set of a user's answers for a particular survey
- You need to set up a local database. Any of the databases supported by Rails will work, but PostgreSQL is recommended.
- Some tutorials are here and here. If you're on a mac, use Heroku's Postgres.app
- Make a copy of the
database.yml.sample
provided (in theconfig
directory); name itdatabase.yml
- Fill in the details for your database.
For example, the database.yml
will look something like this if you're using Postgres.app:
development:
adapter: postgresql
encoding: utf8
database: survey_web_dev
pool: 5
username:
password:
host: localhost
test:
adapter: postgresql
encoding: utf8
database: survey_web_test
pool: 5
username:
password:
host: localhost
production:
adapter: postgresql
encoding: utf8
database: survey_web_prod
pool: 5
username:
password:
- Navigate to the survey-web directory from a terminal.
- Type
rails server
- If the server starts up without complaining, your database is set up correctly.
- To install all the libraries required by this application, navigate to the survey-web directory from a terminal.
- Type
gem install bundler
and thenbundle install
This app works with an OAuth Provider that you'll need to set up as well. You can clone it at http://github.com/c42/user-owner
-
Login as super_admin in the user-owner app
-
Click on Add a new application
-
The redirect uri would be
http://SURVEY_WEB_URL/auth/user_owner/callback
(SURVEY_WEB_URL
is the URL where the survey-web app is hosted) -
You will then have the Application ID and the Secret.
-
Create a config/application.yml file in this (survey-web) app
-
Add the following to it:
OAUTH_ID: # Application ID of the OAuth provider.
OAUTH_SECRET: # Secret of the OAuth provider.
OAUTH_SERVER_URL: # URL where the OAuth Provider instance is hosted.
Start the survey-web app by typing rails server
from the console.
Please check the Troubleshooting section of the wiki, or create an issue if you need any help.
- We use Pivotal Tracker to manage our projects. You can have a look at the bugs and features that you could work on.
- If you need any help, mail us at
[email protected]
.
- If delayed_job workers aren't running, photos will stay on the app server, and will not be migrated to S3.
- Setup
Carrierwave
with your Amazon S3 credentials. - Start
delayed_job
workers usingscript/delayed_job
. Look here for documentation. - If you're deploying to EngineYard, a deploy hook is provided in
deploy/after_restart.rb
.
- Organizations can be (soft) deleted on user-owner
- Running
rake db:remove_deleted_organizations_data
on survey-web will delete all data (surveys, questions, responses etc.) belonging to any soft-deleted organisations - Run it in a cron job so that this cleanup doesn't have to happen manually (although it is delayed)
To include unicorn and nginx config files as well, follow the instructions provided by EngineYard to upload a custom recipe, but replace configure.rb with the contents of this gist.