PromoExchange

Batman is the main application for PromoExchange's promotional products auction platform. It houses product, auction, and user information.

Requirements

• Homebrew
• Ruby Version Manager (rvm)
• Git
• Ruby 2.2.3
• Bundler 1+
• Rails 4.2.2
• Postgres 9+
• Redis

Windows Installation

** N.B. Windows development environment is not really supported **

The following installation links are for a Microsoft Windows Environment. N.B. These are untested as I do not have access to a Windows machine

• Git CLI Installation. This also includes a bash prompt.
• Github UI Installation. The official GIT github UI.
• Redis
• Ruby
• Postgres
• Bundler
• node N.B. Select 'include NPM' in the installation options.
• Bower

Installation

1. git clone git@github.com:PromoExchange/batman.git
2. bundle install
3. bower install
4. Take a copy of the heroku database and install locally. See below for instructions.

Exporting from Heroku and importing locally

1. heroku pg:backups capture --app px-batman

2. heroku pg:backups download --app px-batman (to latest.dump). NOTE: Rename or delete the previously downloaded latest.dump file.

3. pg_restore --verbose --clean --no-acl --no-owner -h localhost -U postgres -d batman_dev latest.dump

See: Heroku export/import

Moving databases between apps

1. Backup target: heroku pg:backups capture -a <preview app>
2. Copy Database: heroku pg:copy px-batman-stage::HEROKU_POSTGRESQL_PINK_URL HEROKU_POSTGRESQL_WHITE_URL -a <preview app>

Running the App

1. Ensure postgres and redis-server are running
2. bundle exec rake resque:work QUEUE=* in one command
3. bundle exec rails s in another command
4. Navigate to http://localhost:3000 in your browser

Post Installation

1. Sign in as spree@example.com/spree123
2. Navigate to http://localhost:3000/admin
3. Under general configuration set the site url to http://localhost:3000

Running specs

• bundle exec rspec from the root directory of the application

Documentation

• Documentation is available via the project wiki

Issues

Open a bug on Pivotal Tracker

Contributing

• Fork repo
• Submit pull requests to the development branch

License

This application and all code herein belongs to Promobidz LLC.