Skip to content
This repository

Animal Management Software for Rescue / Shelters

README.markdown

Hospitium

Build Status Code Climate Dependency Status Coverage Status

https://hospitium.co/

Created By: Travis Berry, Apple Wood Rescue

Hospitium is Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php

RoR, Twitter Bootstrap, and others licensed under their respective licenses.

Overview:

Hospitium is the brain child of Apple Wood Rescue, a small animal rescue in Denver Colorado. Developed to fit the needs of the rescue, it has since been open sourced for anyone to use.

This program is completely free. You can modify it all you want and you can share it with anyone.

You can support the project by:

Install:

There are several dependencies on other apps/services.

Setup env variables. Good how to here. To use dotenv copy .env.example to .env and update any configs

Clone repo

git clone git://github.com/ninetwentyfour/Hospitium.git

cd Hospitium

bundle install

create a database called animal_development, or change db connection in /config/database.yml

rake db:create

rake db:migrate

rake db:seed

rails s

Visit http://localhost:3000

Sign in with

  • Login: admin
  • Password: pleasechange

Dashboard can be found at http://localhost:3000/admin.

Please change your admin password and the organization name if you so choose.

Todo:

  • post to pet finder and other animal sites (adopt-a-pet)

  • click to call integration with twilio (be able to call vets, contacts, etc from computer with mic or bridge call)

  • create graphs of info and stats like average time in shelter etc

  • add current location to animal (like address of foster home or vet)

  • user docs (started at https://hospitium.tenderapp.com/kb)

  • add more descriptions to labels in create and edit of all models

  • lots of testing

  • make adopt list random or cycle through entries

  • do public adopt pages grouped by organization - make embedable with code to copy in view

  • add search to adopt list (search by location and species)

  • add image to organization and contacts

  • mailchimp email list integration

  • create check for memcached server being up or available, if not, kick to db sessions

  • import animals from other sites in both batches and api style

  • add aviary support to allow users to edit photos of animals

  • make public animal list a queue that is moderated by super admins (not yet - wait to see spam levels)

  • seo

  • send facebook to pages or groups

  • add label warning and make model strip any part of weight that isn't an integer (assumed grams)

  • remove and move to env variables all api keys

  • make weights decimals and make suffix user configurable

  • graph of animal ages

  • do some cake thing on dashboard for animals birthdays

  • let organizations add donate links to public pages

  • mark what fields are public

  • donations and fundraising MVC

  • maybe work with something like this http://www.petdetect.com/

  • create cancel account mechanism and job that deletes info in 30 days

  • track vet visits over time w/ notes

  • calculate most adopted species and do percentages of it

  • calculate average time from intake to adoption/death

  • switch notifications and use in all text area fields redcarpet

  • add note in add wordpress/adopt a pet accounts that they should create accounts for this, with unique usernames and strong passwords, with as little permissions as possible (not admin - just post ability)

  • Add better back button support for animal cards view. (return to the spot in the infinite scroll)

Contributing:

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.