Self-hosted application to manage project reporting.
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.
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
- Gin web framework
- Gorm (with PostgreSQL or MySQL persistence)
- Logrus, Cobra, Viper, Now, lumberjackrus, Cron