search

berkmancenter / bookanook

14 stars 18 forks source link

readme

Code Climate Test Coverage

Book-a-Nook

Description

Book-a-Nook is an online platform where a user can look up for available community spaces like libraries and make reservation requests to the admin. The admin checks for the conflicts and sends the corresponding confirmations. Check full features and entities involved on the wiki home page.

Code Repository

The code is housed in a GitHub Repository.

Requirements

  1. Rails 4.2.5
  2. RVM and Ruby >2.0.0 (tested on 2.2.1)
  3. PostgreSQL (Dev, Test)

Tested Configurations

Works well with:

  1. Ubuntu 14.04 + Ruby (2.2.2) + Rails 4.2.5
  2. MacOS X 10.9 + Ruby (2.2.2) + Rails 4.2.5

Setup

  1. Clone the repository

git clone https://github.com/berkmancenter/bookanook.git

Or clone down from your own fork of the repository.

  1. Go to the application's root directory in terminal: cd bookanook

  2. If you are using RVM, create gemset for this application: rvm gemset create bookanook

  3. Use the gemset: rvm gemset use bookanook

  4. Install gems from Gemfile: bundle install

    Notes:

    • You may need to run gem install bundle first.
    • If you're having issues installing gems with bundle install, try running bundle update first.

  5. Make necessary changes (postgresql username and password) in config/database.yml

    Here's a resource to help setup a username and password for PostgreSQL on your machine.

  6. Run cp config/social_keys.yml.sample config/social_keys.yml. Add your own key and secret for Google authentication by setting up OAuth for your environment here.

  7. Create database: rake db:create

  8. Run migrations: rake db:migrate

  9. Seed database with initial data: rake db:seed

  10. Start the server: rails s

    Note: If you're having issues starting the server, try running bundle exec rails server.

  11. Visit the application at localhost:3000

Running Tests

Tests are run using RSpec, by simply running rspec in your terminal.

If you receive an issue about "Web Console is activated in the test environment" that is preventing your tests from running, remove the following gem from your Gemfile:

gem 'web-console', '~> 2.0'

Then in your terminal, run the following:

$ gem install bundler
$ bundle install --without production

Issue Tracker

Please Log issues on GitHub.

Contributors

The full list of contributors is available at https://github.com/berkmancenter/bookanook/graphs/contributors

Contributing

  1. Create/Pick a relevant Issue: https://github.com/berkmancenter/bookanook/issues
  2. Code away!
  3. Send in a Pull Request.

NOTE: Will be posting a Contributing Guidelines Document soon.

Contact

Contact the following people if you get stuck:

Copyright

Copyright © 2017 President and Fellows of Harvard College