Skip to content

valasek/timesheet

Repository files navigation

GitHub release GitHub issues Code Climate Go Report Card Build Status

Simple Timesheet

NOTE: At the moment project is not actively maintained - which might change if there will be a need for it.

User-friendly, fast, and reliable web application for weekly / monthly reporting. Report consulting hours on selected projects with further segmentation via rates.

Screencast

License

All source code in this repository is released under the CC BY‑NC 4.0 license.

  • Commercial use is not permitted
  • 🔒 No patent rights are granted
  • 📝 Attribution and copyright notice must be included
  • ⚠️ No liability and no warranty

If you'd like to use this software commercially, please contact me to discuss a commercial license.

Documentation

Read full documentation.

Rationale

Reporting and billing process includes three separated steps with well-defined data which flows in between:

  • Time reporting - all consultants
    • covered by this app - data are safe, eliminates manual errors, shows important data for consultants, data entry is as easy as possible
  • Billing preparation (confirming/editing reported hours for billing) - project manager or administrative person
    • covered partially by this app. If you bill 1:1 with your reporting then it has all you need
    • data are available in the DB which can be exported by this app read or exported by any DB tool
  • Exporting reported and billed hours in the internal accounting system for the invoicing to the clients and consultants - salaries
    • not covered by this app
    • data are available in the DB which can be exported by this app read or exported by any DB tool

Contributing

I would love your help! Before submitting a PR, please read over the Contributing guide.

To help you to get started you can read how to run the Timesheet from the source.

Here's a couple of areas that need some love:

  • Import/Export plugins - do you like functionality but want to integrate with your company billing SW? Create an issue and if you can submit PR.
  • Javascripts - I'm no JS wizz, I'm sure the Javascript code in ui/src could be improved/simplified/tested. * Documentation - Typo? Does something not make sense? Could it be worded better? Please help!
  • Test Coverage - Would love to get coverage over 80%, fontend and backend.

Standing on the shoulders of giants

Go, Gin web framework, Vue, Quasar, PostgreSQL and MySQL

Go Backend

JavaScript Frontend

Sponsor this project

 

Packages

No packages published

Contributors 5