{"id":26051977,"url":"https://github.com/destripador/employees","last_synced_at":"2025-04-10T22:23:28.812Z","repository":{"id":246947591,"uuid":"824671532","full_name":"Destripador/employees","owner":"Destripador","description":"🚀 Employees Management Module for Nextcloud A complete employee management solution for Nextcloud, enabling businesses to efficiently handle employee records, roles, payroll, attendance, and document storage—all within their Nextcloud environment.","archived":false,"fork":false,"pushed_at":"2025-04-07T23:19:02.000Z","size":691,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T23:23:12.673Z","etag":null,"topics":["attendance-tracking","document-storage","employee-directory","employee-management","hrm","nextcloud","payroll","workforce-management"],"latest_commit_sha":null,"homepage":"https://gossler-torreon.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Destripador.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-07-05T16:45:52.000Z","updated_at":"2025-04-07T23:19:05.000Z","dependencies_parsed_at":"2025-03-27T20:24:23.045Z","dependency_job_id":"3c91e4e4-a988-4efc-a7a3-46c1609837a8","html_url":"https://github.com/Destripador/employees","commit_stats":null,"previous_names":["destripador/empleados","destripador/employees"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Destripador%2Femployees","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Destripador%2Femployees/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Destripador%2Femployees/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Destripador%2Femployees/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Destripador","download_url":"https://codeload.github.com/Destripador/employees/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248307127,"owners_count":21081788,"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":["attendance-tracking","document-storage","employee-directory","employee-management","hrm","nextcloud","payroll","workforce-management"],"created_at":"2025-03-08T05:46:59.175Z","updated_at":"2025-04-10T22:23:28.778Z","avatar_url":"https://github.com/Destripador.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Employee Management Module for Nextcloud (ON DEV)\n\n## 📌 Description\n\nThe **Employee Module** is an administrative solution designed for **employee management and information handling**. This module seamlessly integrates with Nextcloud to provide businesses and organizations with an **efficient and secure** way to manage employees, roles, and records within their existing Nextcloud infrastructure.\n\n\n\n![alt text](https://raw.githubusercontent.com/Destripador/employees/refs/heads/main/img/image1.png)\n\n\n## 🎯 Features\n\n✔ **Employee Directory** – Maintain a structured and easily searchable list.  \n✔ **Role and Department Management** – Assign employees to departments and define roles.  \n✔ **User Authentication Integration** – Sync with Nextcloud users.  \n✔ **Contract and Payroll Management** – Store key employee contract information.  \n✔ **Attendance and Leave Tracking** – Monitor working hours and absences.  \n✔ **Hierarchical Organization Chart** – Visualize employee reporting structures.  \n✔ **Secure Document Storage** – Upload and manage employee-related files.  \n✔ **Performance Evaluation** – Track employee reviews and assessments.  \n✔ **Notifications and Alerts** – Get updates on employee-related actions.  \n✔ **Admin Dashboard** – Intuitive interface for efficient employee management.  \n\n---\n\n## 📂 Installation\n\nYou can install this module in your Nextcloud instance manually or using `occ` commands.\n\n### **Using the Nextcloud App Store**\n1. Go to the **Nextcloud App Store**.\n2. Search for `\"Employee Management\"`.\n3. Click **Install** and enable the app from the Nextcloud Admin Panel.\n\n### **Manual Installation**\n1. Navigate to the Nextcloud apps directory:\n   ```sh\n   cd /path/to/nextcloud/apps\n   ```\n2. Clone the repository:\n   ```sh\n   git clone https://github.com/Destripador/employees.git employee_management\n   ```\n\n---\n\n## 🏗 Building the App\n\nIf you are developing and need to build the app, follow these steps:\n\n1. Install dependencies:\n   ```sh\n   npm install\n   ```\n2. Build the frontend assets:\n   ```sh\n   npm run build\n   ```\n3. Clear Nextcloud's cache:\n   ```sh\n   sudo -u www-data php occ maintenance:repair\n   ```\n4. Enable the app (if not enabled):\n   ```sh\n   sudo -u www-data php occ app:enable employee_management\n   ```\n\n---\n\n## 🧪 Running Tests\n\nTo run unit tests, ensure you have PHPUnit installed:\n\n```sh\nphp vendor/bin/phpunit tests\n```\n\nTo run JavaScript tests:\n\n```sh\nnpm run test\n```\n\nFor linting and code style checks:\n\n```sh\nnpm run lint\n```\n\n---\n\n## 🤝 How to Contribute\n\nWe welcome contributions! Follow these steps to submit a Pull Request:\n\n### **How to Create a Pull Request**\n1. **Fork** this repository on GitHub.\n2. **Clone** your fork locally:\n   ```sh\n   git clone https://github.com/Destripador/employees.git\n   ```\n3. Create a **feature branch**:\n   ```sh\n   git checkout -b feature/my-new-feature\n   ```\n4. Make your changes, commit them, and push the branch:\n   ```sh\n   git add .\n   git commit -m \"Add new feature XYZ\"\n   git push origin feature/my-new-feature\n   ```\n5. Open a **Pull Request** on GitHub.\n\n---\n\n## 🌟 Code of Conduct\n\nWe expect all contributors to follow our **Code of Conduct**:\n\n1. Be respectful to others.\n2. Provide constructive feedback.\n3. Follow Nextcloud’s security and privacy guidelines.\n4. Ensure your contributions align with the project's goals.\n\nFor details, refer to [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** – see the [LICENSE](LICENSE) file for more details.\n\n---\n\n### 🌟 If you find this project useful, don't forget to give ⭐ to the repository!\n\n---\n\n## 🔗 Resources\n- [Nextcloud Developer Documentation](https://nextcloud.com/developer/)\n- [Nextcloud App Store](https://apps.nextcloud.com/)\n- [Nextcloud Forum](https://help.nextcloud.com/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdestripador%2Femployees","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdestripador%2Femployees","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdestripador%2Femployees/lists"}