{"id":27193422,"url":"https://github.com/amattu2/payroll-management-system","last_synced_at":"2025-04-09T18:55:53.507Z","repository":{"id":121256283,"uuid":"499936862","full_name":"amattu2/payroll-management-system","owner":"amattu2","description":"A Laravel 9 and Bootstrap 5 employee payroll and timekeeping system. Oriented towards a single-tenant deployment.","archived":false,"fork":false,"pushed_at":"2024-08-11T14:08:39.000Z","size":6181,"stargazers_count":8,"open_issues_count":3,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-12T14:38:04.375Z","etag":null,"topics":["bootstrap","laravel","payroll","php"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amattu2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-04T21:07:42.000Z","updated_at":"2024-08-11T14:08:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"c93806fc-81b5-4353-8639-592d636421c6","html_url":"https://github.com/amattu2/payroll-management-system","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"amattu2/project-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amattu2%2Fpayroll-management-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amattu2%2Fpayroll-management-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amattu2%2Fpayroll-management-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amattu2%2Fpayroll-management-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amattu2","download_url":"https://codeload.github.com/amattu2/payroll-management-system/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248094063,"owners_count":21046762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","laravel","payroll","php"],"created_at":"2025-04-09T18:55:52.531Z","updated_at":"2025-04-09T18:55:53.493Z","avatar_url":"https://github.com/amattu2.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduction\n\nA comprehensive HR employee management and timekeeping system. Digitize timesheets, handle time-off requests, and automate standard onboarding procedures.\n\nAbbreviated list of functionality:\n\n- Employee management\n- Linked employee accounts\n- Track clock-in/clock-out times\n- Finalize timesheets with automated notifications\n- Manage leave/time-off requests\n\nComing Soon:\n\n- Automate onboarding procedures with push notifications of hired/terminated employees\n- Pre-built reports and employee insights\n- Company/department closures and scheduling with notifications\n- Supervisor/Department tracking\n\n# Getting Started\n\nInstall both Composer and NPM dependencies.\n\n```bash\ncomposer install\nnpm install\n```\n\nCreate a copy of the `.env.example` file and rename it to `.env`. Update the database credentials and application key.\n\n```bash\ncp .env.example .env\n```\n\nRun the database migrations and seeder.\n\n```bash\nphp artisan migrate --seed\nphp artisan run:factories # Optional: Seed the database with dummy data\nphp artisan cache:clear # Clear the temporary DB cache\n```\n\nBuild frontend the assets\n\n```bash\nnpm run dev\n```\n\nRun the backend service\n\n```bash\nphp artisan serve\n```\n\nOpen your browser and navigate to [http://localhost:8000](http://localhost:8000). You can log in with the following credentials (default):\n\n- Email: `admin@example.com`\n- Password: `password`\n\n# Previews\n\n## Overview Page\n\n![overview page](./screenshot/overview.png)\n\n## Employees Page\n\n![employee listing](./screenshot/employees.png)\n\n![employee](./screenshot/employee.png)\n\n## Timesheets\n\n![timesheet timecards](./screenshot/timesheet.png)\n\n![timesheet pdf](./screenshot/timesheet-pdf.jpg)\n\n\n## Leave/PTO Page\n\n![leaves time off page](./screenshot/leaves.png)\n\n# To-Do\n\n## App\n\n- [ ] App Settings and Controls\n- [ ] Navigation search bar (e.g. Employees, Timesheets, ...)\n\n## Employees\n\n- [ ] Create a user account for a employee\n- [ ] Department assignments\n- [ ] Supervisor tracking (e.g. Joan reports to Barry)\n- [X] Internal comments / Notes\n- [X] Profile picture display\n- [ ] PTO cap and limit tracking\n- [X] General profile editing\n- [X] Employee Communication (e.g. Timesheets, Free form emails, PTO Rejections)\n- [X] Time-Off Tracking / Requests\n\n## Payroll / Timesheets\n\n- [X] Editing timesheet options (e.g. Period/Pay type)\n- [X] Time card tracking\n- [ ] Time unit calculation by Day/Hours (including 1/4, 1/2, 3/4 days)\n- [X] Exporting (PDF/Email)\n\n## Reports\n\n- [ ] Report Center\n- [ ] Statistics/Graphs on pages\n- [ ] Employee Statistics\n- [ ] Overview Statistics\n\n## Other\n\n- [X] Block a user from logging in if their associated employee is not active\n- [X] Heavy query caching (i.e. employees, timesheets)\n- [X] Fix factories for tables with unique constraints (Timesheets, Timesheet Days)\n- [X] Implement lang file for long/duplicated messages\n- [X] When employees are terminated, reject all open PTO requests\n\n# Requirements \u0026 Dependencies\n\n- PHP 8+\n- Laravel 9.X+\n- MySQL\n- Bootstrap 5.X+\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famattu2%2Fpayroll-management-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famattu2%2Fpayroll-management-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famattu2%2Fpayroll-management-system/lists"}