Download the PHP package ikay/j-rh without Composer
On this page you can find all versions of the php package ikay/j-rh. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package j-rh
Short Description Employee HR module for Filament v4 - Manage employees, salaries, and advances
License proprietary
Informations about the package j-rh
J-RH - Employee HR Module for Filament
A reusable Laravel Filament v4 package for managing employees, salaries, and advances. Designed to replace direct User-based salary/advance tracking with a dedicated Employee model.
Features
- Employee Management - Full CRUD with auto-generated IDs (EMP-0001), extended HR fields (position, department, contract type, etc.)
- Salary Management - Monthly salary processing with base salary, primes, advance deductions, and net salary calculation
- Advance Management - Employee advance requests with approval workflow and automatic outstanding balance tracking
- PDF Salary Bulletins - Generate downloadable salary bulletins via DomPDF
- Filament Shield Compatible - Permissions auto-register with
BezhanSalleh/FilamentShield - Multi-language - French and Arabic translations included
- User Linking - Optionally link employees to app users for authentication
Requirements
- PHP 8.2+
- Laravel 12+
- Filament v4
- barryvdh/laravel-dompdf ^3.1
Installation
As a Composer Package
As a Local Package
Add the path repository to your composer.json:
Then require it:
Run Migrations
Setup
1. Register the Filament Plugin
In your AdminPanelProvider.php:
2. Add Navigation Group (optional)
3. Add the HasEmployees Trait to Your User Model
4. Regenerate Shield Permissions
Configuration
Publish the config file:
Publishing Assets
Data Migration
If you are migrating from a User-based salary/advance system, the package includes migrations that:
- Create the
employeestable - Auto-create Employee records from existing User references in
salaries - Auto-create Employee records from existing User references in
advances - Re-link
salaries.user_idandadvances.user_idtoemployees.employee_id
These migrations are safe to run on fresh databases (they skip if user_id columns don't exist).
Employee Model Fields
| Field | Type | Description |
|---|---|---|
| employee_id | string | Auto-generated (EMP-0001) |
| name | string | Full name |
| string | Contact email | |
| phone | string | Phone number |
| position | string | Job title |
| department | string | Department |
| hired_at | date | Hire date |
| date_of_birth | date | Date of birth |
| gender | enum | Male / Female |
| address | text | Address |
| salary | decimal | Base salary |
| national_id | string | National ID number |
| emergency_contact | string | Emergency contact |
| bank_account | string | Bank account number |
| contract_type | enum | Permanent / Temporary / Freelance / Intern |
| contract_end_date | date | Contract end date |
| marital_status | enum | Single / Married / Divorced / Widowed |
| nationality | string | Nationality |
| status | enum | Active / Inactive / Suspended / OnLeave |
| photo | string | Photo path |
| user_id | FK | Optional link to User |
Testing
The package includes factories for all models. In your test files:
Run the package tests:
License
Proprietary - All rights reserved.
All versions of j-rh with dependencies
filament/filament Version ^4.0|^5.0
illuminate/support Version ^12.0|^13.0
barryvdh/laravel-dompdf Version ^3.1