Thanks to visit codestin.com
Credit goes to github.com

Skip to content
/ kms Public

Web application for time tracking and invoicing.

License

philippks/kms

Repository files navigation

KMS logo

GitHub release License: GPL v3 Build Status

Web application for time tracking and invoicing.

Initially created for the Koster Consulting AG and since multiple years in productive use.

Features

  • Time & absences tracking
  • Time & invoice reports
  • Generate invoices based on tracked time
  • Send invoice by e-mail
  • Manage invoice payments
  • and many more...

Demo

Only available in German for now:

Getting Started

Prerequisites

  • ruby 2.5
  • bundler
  • yarn
  • Libreoffice (will be removed)
  • PostgreSQL

Install Dependencies

bundle
yarn install

Configuration

Basic configuration in .env file:

POSTGRES_HOST=localhost
POSTGRES_USER=postgres
POSTGRES_DATABASE="kms"
POSTGRES_PASSWORD=password
SECRET_KEY_BASE=xxx

Start Locally

bundle exec rails s

Access web application: http://localhost:3000

Run Tests

bundle exec rspec

Hints

Invoice Configuration

The invoice parameters are configured with env variables:

  • INVOICE_IBAN
  • INVOICE_VAT_NUMBER
  • INVOICE_SWIFT
  • INVOICE_MAIL_FOOTER (use \n for newlines)

To use a company template for the invoices, set the path to the corresponding PDF as INVOICE_COMPANY_TEMPLATE_PATH, e.g.

INVOICE_COMPANY_TEMPLATE_PATH='/home/kms/invoice_template.pdf'

Master Password

To set a master password which can login as each user, generate an encrypted password inside the rails console

Employee.new(password: 'mymasterpassword').encrypted_password

And save this value inside the .env file as ENCRYPTED_MASTER_PASSWORD, e.g.

ENCRYPTED_MASTER_PASSWORD='$2a$11$pwpCKdGI0fu7I1ISy19Uz.UCiVgJ03c/XN2nIylI952Qdvmbh89cu'

Questions?

For any questions drop me a mail: [email protected]

License

GPL-3.0

About

Web application for time tracking and invoicing.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors 5