Local Incident Management System - This is used for tracking resources for Local Emergency Management
The project was inspired by Sandi Metz's call for programmers to aid their communities. This project, in particular, looks to lessons learned in response to emergencies that inspired the National ICS program. It has often been found that there are plentiful equipment and personnel, but not the organization to know what was available nor the ability to manage it.
The goal of Ready Responder is to offer volunteer groups a program that allows them to track their resources and personnel, especially during emergencies or multi-day events. This application might be used by volunteer firefighters, auxiliary police, Medical Reserve Corp (MRC), CERT organizations, amateur radio operators (ARES/RACES), church based relief groups, shelter managers or even science-fiction conventions.
The program is currently in production, getting live feedback.
We have a Slack channel at readyresponder.slack.com to give help if you need it.
This is a Rails project that is configured to run on Ruby 2, and on a Postgres database.
Things you'll need to install before running ReadyResponder locally are:
bundler
gemFor ruby, you can find a detailed list of options on the official Ruby website. The most common applications used to manage your ruby version are:
The exact version of Ruby that ReadyResponder is using is specified in the .ruby-version file.
After setting up ruby on your system, install the bundler
gem with gem install bundler
.
Below you will find instructions on installing the remaining dependencies for Mac OS and Ubuntu.
Ensure you have the Homebrew package manager. Run brew update
before you install the dependencies. You can also use other package
managers, such as MacPorts, but the
following instructions assume you're using Homebrew.
Install PostgreSQL
$ brew install postgres
Install ImageMagick
$ brew install imagemagick@6
Install for OSX version 10.15, Catalina, and above.
Run apt-get update
before you install the dependencies.
Install PostgreSQL
$ apt-get install postgresql libpq-dev
Install ImageMagick
$ apt-get install libmagickwand-dev
Feel free to ask for help!
We also have a Vagrant + Ansible setup so you can start quickly. See Vagrant + Ansible
Get the project code locally and set it up:
cd ReadyResponder
bundle install
$ pg_ctl -D /usr/local/var/postgres start
$ sudo -i -u postgres
$ createuser -P --interactive <database-username>
$ exit
Enter a password and answer the prompts, you will have a user (role)
named $ cp config/database.example.yml config/database.yml
host: localhost
. Edit both the development
and test
keysdb/schema.rb
$ bundle exec rake db:create
$ bundle exec rake db:schema:load
$ bundle exec rake db:seed
You should note the output of the db:seed, as it will spit out the password at the end.
At this point you should be able to run the rails server via bundle exec rails s
, the rails console via bundle exec rails c
, and the tests via bundle exec rspec spec/
.
$ bundle exec rake db:test:prepare
Note: The testing framework will run much faster over time if you run it via Spring. When running rake enter
bin/rake
to execute via Spring pre-loader.
See the wiki!
We have a Code of Conduct to set clear expectations for community participation. We want your participation in ReadyResponder to be safe, fun, and respectful. We've adopted the "Contributor Covenant" model for our code of conduct, which is the same model that the Rails project itself uses. (Other projects that use a Code of Conduct of this type include RSpec, Jenkins, and RubyGems.)
Please read the Code of Conduct. By participating in this project you agree to abide by its terms.