Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eporsche/daybreak
Simple timesheets and vacation management for small businesses.
https://github.com/eporsche/daybreak
hrm laravel livewire timesheet vacation
Last synced: 5 days ago
JSON representation
Simple timesheets and vacation management for small businesses.
- Host: GitHub
- URL: https://github.com/eporsche/daybreak
- Owner: eporsche
- License: mit
- Created: 2021-04-05T10:37:14.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-02-09T08:57:45.000Z (almost 2 years ago)
- Last Synced: 2024-10-01T09:23:07.736Z (about 2 months ago)
- Topics: hrm, laravel, livewire, timesheet, vacation
- Language: PHP
- Homepage:
- Size: 6.36 MB
- Stars: 128
- Watchers: 13
- Forks: 38
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## About Daybreak
Daybreak is a very simplistic timesheet and vacation planning program for small businesses. It was created because I needed something I could host myself and integrate better into our local IT enviornment. Other open sourced programs like [smalltime](https://www.small.li/) or [kimai](https://www.kimai.org/) didn't work out for me, since they did not comply to C-55/18 EuGH or where not easily extendable.
This program is inspired by papershift. If you are looking for something more robust and/or more enterprise ready, I suggest you test and use their service at [papershift.com](https://papershift.com).
## Open Todos
- [ ] Documentation
- [x] Add automatic pause times after "x" working hours
- [ ] Include holiday importer for other countries
- [ ] Make timezone of location configurable and make use of it
- [ ] Add more absence times calculators
- [x] Add extended datatables and disable employee switcher
- [ ] More Tests
## Installation instruction to setup a development environment
### Requirements
**Ubuntu/Debian**
```bash
apt-get update
apt-get install php7.4 php7.4-common php7.4-bcmath openssl php7.4-json php7.4-mbstring php7.4-xml
```
Install [docker](https://docs.docker.com/get-docker/) and [composer](https://getcomposer.org/download/) on you system.
### Clone repository
```bash
git clone https://github.com/eporsche/daybreak.git && cd daybreak
```
### Setup repository
```bash
# Restore PHP packages
composer install
# Create .env file
# By default port :80 will be used. To change the port, put `APP_PORT=` into the .env config file
cp .env.example .env
```
### Start application
```bash
# Start the application
./vendor/bin/sail up -d
# Generate app key
./vendor/bin/sail artisan key:generate
# Migrate database
./vendor/bin/sail artisan migrate
```
By default, the application is available at: http://localhost
### Mails
In the default installation the sending of mails is simulated with mailhog, you can view them via your browser at http://localhost:8025
## A small video preview of the application
[](https://user-images.githubusercontent.com/3265129/114863596-34e3fa80-9df0-11eb-9ef1-2e424680a67b.mp4)
## Demo Installation
The application can be tested via heroku.
https://demo-daybreak.herokuapp.com/
User: [email protected]
Password: admin1234
Limitation:
- No Emails will be send from the demo instance, therefore user invitations won't work
- Application will be reset to defaults every 24h
## Security Vulnerabilities
If you discover a security vulnerability within Laravel, please send an e-mail to Erik Porsche via [[email protected]](mailto:[email protected]). All security vulnerabilities will be promptly addressed.
## License
Copyright (c) Erik Porsche
Daybreak is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
Icons made by [Freepik](https://www.freepik.com) from [www.flaticon.com](https://www.flaticon.com/)