Skip to content

Latest commit

 

History

History
63 lines (42 loc) · 2.02 KB

README.mdown

File metadata and controls

63 lines (42 loc) · 2.02 KB

TimeFlux

Timeflux is an hour reporting tool built around a normal workflow for a consultant company.

Users register worked hours on activities. For each month they also need to confirm that they are finished registering hours. Registrations on the vacation activity are publicly visible to all users in the vacation view.

Admins manage the activities a user can register on. Activities belong to a project, and projects belong to a customer. At the end of a month admins can view an overview over users to check that all registrations for the month are complete. They can then move on to the billing report where invoices are generated.

Features

For users:

  • Simple hour registration
  • Month overview
  • Public vacation overview

For admins:

  • Billing, user, companies and project reports
  • Simple and advanced search
  • Tagging of activities (for grouping purposes)
  • Easy management of project assignments
  • Easy management of project activities by templates

Install

On Ubuntu linux:

  1. Install git: sudo apt-get install git-core
  2. Install ruby: sudo apt-get install ruby-full build-essential
  3. Install Rubygems
    1. Download latest version of rubygems from rubyforge (http://rubyforge.org/frs/?group_id=126)
    2. Decompress into suitable directory and, in same directory, execute command: ruby setup.rb
    3. Create softlink: sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
    4. Verify installation: gem -v
  4. Install sqlite3 as your development database: sudo apt-get install sqlite3 libsqlite3-dev
  5. Install rails++: sudo gem install rails rake sqlite3-ruby prawn
  6. Clone the code from GitHub
  7. Install required dependencies (cd to TimeFlux root-directory): sudo rake gems:install
  8. Install test dependencies: sudo rake gems:install RAILS_ENV=test

Getting started

Before testing Timeflux you need to:

  1. Load initial data: rake db:setup
  2. Start the server: ruby script/server
  3. Go to url http://localhost:3000

The seeded data contains two users:

  • user=admin, password=admin
  • user=user, password=user