cloudxtreme/micropurchase

18F's micro-purchase threshold experiment management app.

Micropurchase

This app will be used to manage bids for 18F's micro-purchase threshold experiment. Vendors will be able to view open issues and bid on them, given they have GitHub accounts and are registered on SAM.gov.

This is a Ruby/Rails application using ActiveRecord and PostgreSQL.

Local Development

The application is running Ruby 2.2.3 and Rails 4.2.4. Libraries are all available via gems.

• bundle to get your gem dependencies installed
• Talk to someone of the team to get the authentication secret and key for the github account we are using for authentication. You will want to put these variables in your environment: export GITHUB_KEY=the-magic-key-given-you and export GITHUB_SECRET=another-magic-key.
• create your test and development databases: bundle exec rake db:create:all db:migrate db:test:prepare
• start the local server with bundle exec rails s

Testing

bundle exec rspec

or

rake spec

Deployment

This application is deployed on the cloud.gov PaaS which runs on Cloud Foundry. The following instructions are 18F-specific, but could easily be adapted for other Cloud Foundry instances or other web hosts.

Create the app (it's ok if the deploy fails):

$ cf push

Create the database service:

$ cf create-service rds shared-psql micropurchase

Set environment variables with cf set-env:

$ cf set-env micropurchase MPT_3500_GITHUB_KEY [the key]
$ cf set-env micropurchase MPT_3500_GITHUB_SECRET [the secret]

Set up the database:

$ cf-ssh
$~ bundle exec rake db:migrate
$~ bundle exec rake db:seed

Restage the app:

cf restage micropurchase

Manual Deployment

cf push

Automated Deployment

Pull requests merged into the master branch will be automatically deployed to https://micropurchase.18f.gov.

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.