daguar / procure-io

Procurement software for the 21st century.

Procure.io

Procurement software for the 21st century.

Setting up your development environment

1. git clone the repo
2. bundle install
3. copy config/database.yml.example to config/database.yml and configure it as needed
4. rake db:setup
5. rake db:seed:example
6. rails server or run with your choice of server (we like pow)

You'll all set to develop Procure.io. Login as an officer with [e-mail]/password, or as a vendor with [e-mail]/password.

Deploying to Heroku

1. heroku create YOUR_APP_NAME
2. heroku labs:enable user-env-compile
3. git push heroku master
4. heroku run rake db:migrate
5. heroku run rake db:seed
6. Create your first officer with admin permissions: heroku run rake create_admin[[e-mail],password]

A couple notes:

1. Procure.io uses delayed_job to run tasks asynchronously. Running a worker dyno costs $34.50/month, so if you want to avoid this charge, you'll have to disable the worker in the Procfile, and configure delayed_job with Delayed::Worker.delay_jobs = false.
2. Procure.io is configured to use AWS for storing file uploads. You'll need to set environment variables for this too (specified in /.powenv.example), or change your application configuration to use another storage provider. Note that you can't use :file storage on Heroku, as the filesystem is not permanently writable.

Contributing

Procure.io is very early-stage alpha software, but if you're interested in getting your hands dirty, contributions are more than welcome. Your workflow should look something like this:

1. Fork the repo
2. Write some sweet code
3. Write some tests (unit & acceptance, currently) that cover the functionality you added
4. Create a pull request

Copyright

Released under the GNU GPLv3 license. Neither the name of the Department of Better Technology nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.