An open API service indexing awesome lists of open source software.

https://github.com/nens/trs

Time Registration System (company-internal)
https://github.com/nens/trs

adviseurwebsite

Last synced: 20 days ago
JSON representation

Time Registration System (company-internal)

Awesome Lists containing this project

README

        

Time registration system ("TRS")
==========================================

.. image:: https://travis-ci.org/nens/trs.png?branch=master
:target: https://travis-ci.org/nens/trs

.. image:: https://coveralls.io/repos/nens/trs/badge.png?branch=master
:target: https://coveralls.io/r/nens/trs?branch=master

`Nelen & Schuurmans `_-internal tool for,
basically, booking our hours and managing projects.

Local development installation
------------------------------

Grab the sqlite db from the server::

$ scp the.server.name:/srv/trs.nelen-schuurmans.nl/var/db/trs.db var/db/

Add a ``.env`` with the nens-auth-client cognito settings for localhost.

Some commands::

$ make install
$ make test
$ pre-commit run --all

Keep the python version in sync between the ``Dockerfile`` and the ``pyproject.toml``
(``requires-python`` and ``target-version``).

To test the docker setup::

$ docker compose build
$ docker compose up

Server installation
-------------------

For a production installation, see the private
https://github.com/nens/trs-site repo.

Weeks
-----

A ``YearWeek`` is the core time object in the site: every year+week
combination has its own database object for easy filtering. They must be
created with a management command::

$ bin/python manage.py update_weeks

It is safe to run this command more than once. In case this site is still used
after 2028: adjust the ``TRS_END_YEAR`` setting and run the command again :-)