Module GRH (Personnel)

Lien isolé Accueil docs Formation
Modules métier

Employés, présences, congés, paie — permissions et add-ons GRH.

Module GRH — ShopManager Pro

Vue d'ensemble

Module multi-boutiques (shop_id + trait HasShop) couvrant organisation, employés, contrats, présences, congés, paie, talent et rapports.

Features (add-ons)

Clé Description
hr.core Socle GRH (dashboard, employés, org)
hr.scheduling Plannings / shifts
hr.attendance Présences et pointage
hr.leave Congés et absences
hr.payroll Paie et avances

Activation via l'écran Fonctionnalités ou Feature::enable('hr.core', $shopId).

Routes web principales

Préfixe /hr/*, middleware feature.enabled:hr.core + permissions granulaires (hr.employees.view, hr.payroll.validate, etc.).

API mobile

Sous /api/mobile/hr/* (auth Sanctum) :

  • GET employees, GET employees/{id}
  • GET departments
  • GET dashboard

Services métier

  • HrMatriculeService — matricule EMP-{shop}-{YYYY}-{seq}
  • HrAttendanceCalculator — heures, retards, heures sup
  • HrLeaveBalanceService — soldes congés
  • HrPayrollEngine — génération paie (CNSS/INPP/impôts via hr_settings)

Jobs planifiés

  • ContractExpiryNotificationJob — alertes J-90/J-30/J-7 (notifications internes + email)

Fichiers employés

storage/app/hr/{shop_id}/employees/{id}/

Tests

php artisan test --filter=HrModuleTest
npm run build

Migrations

  • 2026_06_08_000001_create_hr_grh_module_tables.php
  • 2026_06_08_000002_expand_employees_for_grh.php

Seeder types de congés : php artisan db:seed --class=HrLeaveTypesSeeder