Skip to content
Time registration that doesn't suck
Ruby CSS HTML CoffeeScript JavaScript Shell Dockerfile
Branch: development
Clone or download

Latest commit

jurre Merge pull request #554 from DefactoSoftware/dependabot/bundler/nokog…
…iri-1.10.8

Bump nokogiri from 1.10.7 to 1.10.8
Latest commit 0079036 Feb 24, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
bin enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
config enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
db enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
lib enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
public
spec enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
vendor/assets clean up entry select styling, remove unused selectize dependencies Feb 26, 2015
.gitignore initial commit Feb 24, 2014
.hound.yml split entries to represent either hours or mileage Mar 23, 2015
.rspec Use `--require spec_helper` option on rspec Sep 13, 2015
.rubocop.yml enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
.ruby-gemset Add ability to switch to single tenant mode Jan 9, 2015
.ruby-version update ruby and rails Dec 12, 2017
.sample.env add the TLD_LENGTH env var Jan 4, 2019
.travis.yml Set up xvfb on travis Jan 22, 2020
CONTRIBUTING.md Declare maintenance mode in README and CONTRIBUTING.md Jan 30, 2020
Dockerfile update ruby and rails Dec 12, 2017
Gemfile Remove kgio dependency Jan 30, 2020
Gemfile.lock Bump nokogiri from 1.10.7 to 1.10.8 Feb 24, 2020
LICENSE
Procfile
README.md
Rakefile enforce double quote style and run rubocop on the project with --safe… Jan 25, 2020
app.json Remove pgbackups as it's depricated Oct 7, 2015
config.ru
docker-compose.yml Add documentation for getting set up to use Docker Oct 18, 2016

README.md

Hours

Build Status Code Climate Reviewed by Hound

Deploy

Maintenance mode

This project is now in maintenance mode. We will not accept new feature development or contributions other than dependency updates, security fixes and major bug fixes.

Hours is a dead simple project based time tracking application that we use for internal time-tracking. It allows users to register how many hours they've worked on a project with a certain category (think design, software development, testing for software teams) and add any tag they like to it. This gives us a lot of insight on how we spend our time on different projects.

It looks like this:

Projects overview

Single project

Entries

Audit Log

Entry

Roadmap

As we're using Hours we're constantly thinking of ways to improve it and we'd love to hear your thoughts!

System Dependencies

  • Ruby 2.4.2 (install with rbenv)
  • Rubygems
  • Bundler (gem install bundler)
  • PostgreSQL
  • qmake (brew install qt) or read extensive instructions here
  • memcached (brew install memcached, an older version ships with OSX)(optional)
  • imagemagick (brew install imagemagick)

Getting Started

This repository comes equipped with a self-setup script:

% ./bin/setup

After setting up, you can run the application using foreman:

% foreman start

Since we're using subdomains to point to accounts, you can't run the app on localhost. If you have pow set up or if you use linux an alternative is prax, it will be automatically configured by the setup script, otherwise you need to point apache/nginx to the port foreman is running the app on (7000 by default). With pow/prax the app will run on http://hours.dev

In order to activate caching in development you can add CACHE_DEVELOPMENT="anything" to your .env. Make sure to run $ memcached when you do need this.

Getting Started with Docker

This repository comes equipped to be run within Docker, but this requires a few more local dependencies. For instructions on installing and getting started with Docker go here. You'll also need docker-compose, but it will be installed for you through Docker for Mac or Windows.

This repository comes equipped with a self-setup script for using Docker:

% ./bin/docker_setup

On first boot you'll also need to create your database, for that use:

% docker-compose run --rm app rake db:create db:migrate

After setting up, you can run the application and dependencies using [docker-compose]:

% docker-compose up -d

If your Docker host is running on localhost then you should be able to use pow/prax, otherwise you'll need to connect to it via:

http://DOCKER_IP:7000

Feature Flags

Description:

Single Tenant Mode: Initialize application in single tenant mode. Disabled by default.

Usage:

To use the single tenant mode, you can add SINGLE_TENANT_MODE to your enviroment variables with the value true. On development you can set this in your .env with SINGLE_TENANT_MODE=true and restart foreman. On heroku it's under the Config Variables. The first user in single tenant mode can be created by a rake task rake create_user. We'll ask you for your credentials.

Guidelines

  • Pull requests are welcome! If you aren't able to contribute code please open an issue on Github.
  • Write specs!
  • Develop features on dedicated feature branches, feel free to open a PR while it's still WIP
  • Please adhere to the Thoughtbot ruby styleguide
  • All code and commit messages should be in English
  • Commit messages are written in the imperative with a short, descriptive title. Good => Return a 204 when updating a question, bad => Changed http response or I updated the http response on the update action in the QuestionController because we're not showing any data there. The first line should always be 50 characters or less and that it should be followed by a blank line.
  • Please localize all strings and add i18n keys to the locale files sorted by key in ascending order

License

Hours is distributed under the MIT license.

You can’t perform that action at this time.