Disaster Remote Response

Winner of Hack 'N Jill Hacksgiving Hackathon 2012 in NYC

Disaster Remote Response a remote disaster response platform where remote volunteers could provide helpful information to people pre/during/post a disaster via a live volunteer backed phone and text message support line in realtime.

Pre-requisites

TWILIO API Keys With Twilio Phone number Sign up, its SUPER easy!
PUSHER APP API Keys Sign up, its SUPER easy TOO!
Ruby 1.9. Use RVM to manage your Ruby installations. It's good.
Rubygems
Git
The Bundler gem. Install with 'gem install bundler'.

When you log into your twilio account, you have to set the Voice and SMS callback urls on the twilio number that you bought and you also have to set the Voice callback url on the twilio TWIML app that you create here. Here is the url you should set it to with respect to your domain:

Twilio Number Voice URL: http://yourdomain.com/twiml/voice
Twilio Number SMS URL: http://yourdomain.com/twiml/sms
Twilio TWIML App Voice URL: http://yourdomain.com/twiml/volunteer_voice

Installation and usage

Use Bundler to install project dependencies for you:

$ bundle install

This will install gems and various other dependencies if not already on your system. It will also create a Gemfile.lock file which will ensure that dependencies do not change unless you explicitly rerun bundle install again.

Configure

Make sure the following environemnt variables are set in your bash/zsh environemnt somehwere like so:

$ export TWILIO_SID="youraccountsid"
$ export TWILIO_AUTH_TOKEN="yourauthtoken"
$ export TWILIO_APP_SID="yourtwilioappsid"

$ export PUSHER_APP_ID="yourpusherappid"
$ export PUSHER_KEY="yourpusherkey"
$ export PUSHER_SECRET="yourpushersecret"

Create local database and run migrations

Edit config/database.yml. You can then create the database and respective tables like so:

$ bundle exec rake db:create && rake db:migrate

Run locally

To run the application:

$ bundle exec rails s

The app will be viewable at http://localhost:3000

Screenshots

Created By

Haris Amin - Github: hamin, Twitter: harisamin

Raquel Hernandez - Github: maggit, Twitter: maggit

Powered By

License

(The MIT License)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

hamin/hacksgiving2012