Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Application to easily track shifts, reports, and payforms for employees.
Ruby HTML Cucumber CSS JavaScript
Failed to load latest commit information.
app remove comments
config updated travis yml file
db setting stats mailer address by default in seed script
doc Move shifts_erd diagram to doc/
features_old rack_session_access instead of cas filter, move cucumber tests featur…
lib use payform_ids
public Changed application.css
script .gitignore now works
setup
spec fixed number in shifts scheduling test
spec_old Merged master into 367_integration_testing
test Replace all of the hashes with sublime
vendor/assets/javascripts refactored js away
.gitattributes Merge branch 'rails-3.2'
.gitignore Removed .rspec from .gitignore and added colors to .rspec
.rspec using Fuubar
.ruby-version upgrade to ruby 2.1.2, resolves #258, #288, and #289
.travis.yml Configure test coverage
Capfile line endings
Gemfile merged master back
Gemfile.lock merged master back
Guardfile guard watcher for factories.rb triggers spec command
LICENSE update to an actual open source license (MIT)
README.md Add Travis badge to Readme
Rakefile removed old js assets, added jquery-rails, moved libs to vendor/assets
config.ru rails 3; basic changes

README.md

Welcome to Shifts

Build Status Code Climate Dependency Status Test Coverage Inline docs

The old README.md is stored on the wiki and the website.


Shifts is a program that allows the easy tracking of employees who work scheduled (and even unscheduled) hours in various locations and times. It also offers payform features, allowing automatic logging of when employees work shifts, with the option for adding additional hours worked outside of shifts.

There are two sections of the application, one for employees who work shifts, and another for administrators, who manage these employees (Note: administrators can use the application as both administrators and employees, allowing them to perform administrative duties on top of using payforms, shifts, etc.)

Getting Started

There are two mains steps to setting up Shifts: setting up a deployment server and installing the Shifts application.

Prerequisites

You'll need the following to run Shifts:

Installation

First, checkout a copy of Shifts using git:

cd /your/code/directory
git clone https://github.com/YaleSTC/shifts.git
cd shifts

Shifts uses Bundler to manage dependencies, so if you don't have it, get it, then install dependencies:

gem install bundler
bundle install

Create config/database.yml - you'll need this to be able to connect to your database. Configure it with the correct username and password. Make a copy of the config/database.yml.example and rename it to config/database.yml to start.

cp config/database.example.yml config/database.yml

Then, create the database and run migrations to build the structure:

rake db:create
rake db:schema:load

Finally, start the app locally:

rails server

Just point your browser to localhost:3000 to use Shifts.

Deploying to a Server

Shifts is built using Ruby on Rails, and can be set up (deployed) like most Rails apps. You'll need a server running with the following software:

  • Ruby 2.1.2
  • database server (MySQL is preferred, but any database supported by Rails should work, including PostgreSQL)
  • web server (apache or nginx both work well)
  • Rails application server (we recommend Phusion Passenger)

For a general guide to setting up your web and application servers, including hosting providers, see the Rails Deployment Guide.

Further Documentation

  • System administrators and end-users may like to review our help documentation.
  • Developers interested in getting involved with Shifts can find information on our project wiki

Suggestions and Issues

If you have any suggestions, or would like to report an issue, please either:

Something went wrong with that request. Please try again.