{"id":19773323,"url":"https://github.com/aimedidierm/employee-management-api","last_synced_at":"2025-06-22T20:37:06.144Z","repository":{"id":224000303,"uuid":"762056616","full_name":"aimedidierm/employee-management-api","owner":"aimedidierm","description":null,"archived":false,"fork":false,"pushed_at":"2024-02-23T21:52:14.000Z","size":110,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T11:45:25.340Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aimedidierm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-02-23T02:00:29.000Z","updated_at":"2024-02-23T05:29:59.000Z","dependencies_parsed_at":"2025-01-11T01:12:16.691Z","dependency_job_id":"a90ba460-0164-406a-a979-0417af43490f","html_url":"https://github.com/aimedidierm/employee-management-api","commit_stats":null,"previous_names":["aimedidierm/employee-management-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aimedidierm/employee-management-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aimedidierm%2Femployee-management-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aimedidierm%2Femployee-management-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aimedidierm%2Femployee-management-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aimedidierm%2Femployee-management-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aimedidierm","download_url":"https://codeload.github.com/aimedidierm/employee-management-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aimedidierm%2Femployee-management-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261364486,"owners_count":23147774,"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":[],"created_at":"2024-11-12T05:09:21.783Z","updated_at":"2025-06-22T20:37:01.131Z","avatar_url":"https://github.com/aimedidierm.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Employee Management Software\n\nThis is a Laravel-based employee management software designed as a technical assignment to showcase various skills including PHP 8.0 syntax, proper code structure, design patterns, and comprehensive test coverage.\n\n## Description\n\nThe project is an API for managing employees with advanced features implemented to demonstrate proficiency in the Laravel framework.\n\n## Stack/Tools\n\n-   Laravel 10\n-   PHPUnitfor tests\n-   Laravel Sanctum for authentication\n-   laravel-snappy (for PDF reports)\n-   Laravel Excel (for Excel reports)\n-   Mailpit\n-   OpenAPI Specification (v3) for documenting endpoints\n\n## Features\n\n-   Full authentication system using Sanctum (Register, Login, Logout, Forgot password, Password reset)\n-   Employee CRUD operations\n-   Attendance management to record employee arrivals and departures\n-   Automated email notifications to employees upon attendance record creation\n-   Attendance report generation in PDF and Excel formats with daily attendance data\n\n## Requirements\n\n-   PHP 8.1\n-   laravel-snappy 1.0\n-   guzzlehttp/guzzle 7.2\n-   laravel/framework 10.10\n-   laravel/sanctum 3.3\n-   laravel/tinker 2.8\n-   maatwebsite/excel 3.1\n\n### Development Requirements\n\n-   fakerphp/faker 1.9.1\n-   laravel/pint 1.0\n-   laravel/sail 1.18\n-   mockery/mockery 1.4.4\n-   nunomaduro/collision 7.0\n-   phpunit/phpunit 10.1\n-   spatie/laravel-ignition 2.0\n\n## Installation\n\n1. Clone this repository to your local machine.\n2. Install PHP dependencies using Composer:\n\n```bash\ncomposer install\n```\n\n3. Copy the .env.example file to .env and configure your environment variables, including database connection settings.\n4. Generate a new application key:\n\n```bash\nphp artisan key:generate\n```\n\n5. Migrate the database and seeds\n\n```bash\nphp artisan migrate --seed\n```\n\n## Bonus Points\n\n1. GitHub Actions for running tests on PR events.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faimedidierm%2Femployee-management-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faimedidierm%2Femployee-management-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faimedidierm%2Femployee-management-api/lists"}