Aller au contenu

Congés — administration

À quoi ça sert

Ce module permet à un administrateur RH de définir les types de congés, les politiques associées (droits annuels, ancienneté, périodes bloquées, préavis minimum), de suivre et corriger les soldes de tous les employés, et de traiter en direct n'importe quelle demande de congé de la société.

Prérequis

Prérequis

  • Modules sous licence : LEAVE
  • Permissions : leave.manage, leave.approve, leave.create, config.manage
  • Rôles : MANAGER, HR_MANAGER, ORG_ADMIN

Comment ça marche

1. Créer un type de congé

  1. Ouvrez Administration → Congés (/dashboard/admin/leave).
  2. Dans l'onglet types, cliquez sur Ajouter un type.
  3. Renseignez le code, le nom, une couleur (utilisée dans les calendriers), si le congé est payé, s'il nécessite une approbation, s'il nécessite un justificatif.

  4. Choisissez le mode d'acquisition (accrualMode) :

    Mode Signification
    ANNUAL Droits accordés en une fois en début d'année
    MONTHLY_208 2,08 jours acquis par mois travaillé (standard légal français)
    PRORATED Prorata du temps de présence
    SENIORITY_BONUS Jours bonus basés sur l'ancienneté

  5. Un type de congé peut être désactivé (soft-delete) sans être supprimé, pour ne pas casser l'historique des demandes déjà posées.

2. Définir une politique de congé

  1. Toujours dans Administration → Congés, ouvrez l'onglet politiques.
  2. Créez ou mettez à jour une politique pour un type de congé donné : droits annuels (annualAllowance), règles de report (carryOverRules), préavis minimum en jours, nombre maximum de jours consécutifs, pourcentage minimum de couverture d'équipe, périodes bloquées (blackoutPeriods, ex. clôture comptable), et le workflow d'approbation à appliquer (voir Workflows d'approbation).
  3. Chaque modification crée une nouvelle version de la politique (version, isCurrent) — l'historique complet reste consultable et un retour à une version antérieure est possible (rollback).
  4. Une politique peut être dérivée d'un modèle de convention collective (conventionCode) ; un écran de diff permet de comparer la politique en vigueur avec le modèle de convention pour repérer les écarts.

3. Exporter / importer une configuration de congés

Depuis Administration → Congés → Configuration, exportez l'ensemble de la configuration (types, politiques) au format JSON, pour la dupliquer vers un autre tenant ou la versionner en dehors de Jigi ; l'import réciproque recrée les types et politiques à partir d'un tel export.

4. Suivre et corriger les soldes de congés

  1. Ouvrez la liste des soldes (par année, filtrable par employé).
  2. Pour ajuster manuellement le solde d'un employé sur un type de congé (erreur de calcul, reprise d'ancienneté, régularisation) : +/- un delta avec un motif obligatoire — chaque ajustement est tracé (LeaveBalanceAdjustment).
  3. En fin de période, utilisez Reporter les soldes (rollover) pour faire glisser les soldes non consommés de l'année N vers l'année N+1, selon les règles de report définies par politique.

5. Traiter directement une demande de congé (dérogation)

Sur la liste globale des demandes de congé (tous employés, filtrable par statut/employé/type/dates), un administrateur peut surclasser (override) la décision d'approbation normale — utile en cas d'urgence ou de blocage du workflow — en approuvant, rejetant ou annulant directement, avec un commentaire obligatoire.

Qui peut faire quoi

Permission requise Rôles concernés
leave.manage MANAGER, HR_MANAGER, ORG_ADMIN
leave.approve MANAGER, HR_MANAGER, ORG_ADMIN
leave.create MANAGER, HR_MANAGER, ORG_ADMIN
config.manage MANAGER, HR_MANAGER, ORG_ADMIN
Permission Donne accès à
leave.manage Voir/surclasser toutes les demandes de congé, gérer types, politiques, soldes, rollover
leave.approve Approuver/rejeter les demandes de congé de son équipe (voir Approbations)
leave.create Poser une demande de congé pour soi-même
config.manage Export/import de configuration, versioning des politiques, diff avec les conventions collectives
Rôle système Accès
ORG_ADMIN Toutes les actions (permission globale)
HR_MANAGER leave.manage, leave.approve, leave.create
MANAGER leave.approve, leave.create (limité à son équipe)
Détails techniques

Entités : LeaveType, LeavePolicy (versionnée, is_current/version), LeaveBalance, LeaveBalanceAdjustment, LeaveRequest (schéma hr).

Endpoints (LeaveAdminController, base /admin) :

  • GET /admin/leaves, PUT /admin/leaves/{id}/override
  • GET/POST/PUT/DELETE /admin/leave-types[/{id}]
  • GET/POST/PUT/DELETE /admin/leave-policies[/{id}]
  • GET/PUT /admin/leave-balances, /admin/employees/{id}/leave-balances[/{typeId}]
  • POST /admin/leave-balances/rollover

Endpoints de configuration (LeaveConfigController, base /admin/leave-config) : /export, /import, /policies/{id}/versions, /policies/{id}/rollback/{versionId}, /diff/{conventionCode}.

Workflow : chaque LeavePolicy référence un workflow_definition_id — c'est ce qui détermine le circuit d'approbation appliqué à une demande de congé de ce type (entité de workflow LEAVE_REQUEST, voir Workflows d'approbation).

Jours fériés : FrenchPublicHolidayCalendar (implémentation de PublicHolidayCalendar) exclut automatiquement les jours fériés français du décompte des jours de congé posés.

Cas d'erreur et FAQ

Pourquoi ne puis-je pas supprimer un type de congé déjà utilisé ? Il est désactivé plutôt que supprimé, pour préserver l'historique des demandes déjà posées avec ce type.

Comment gérer une convention collective qui change chaque année ? Créez la politique à partir d'un modèle de convention (conventionCode), puis utilisez l'écran de diff pour visualiser les écarts après une mise à jour du modèle, avant de décider de mettre à jour ou non la politique du tenant.

Un ajustement manuel de solde est-il tracé ? Oui, chaque ajustement (LeaveBalanceAdjustment) conserve le delta, le motif et l'auteur, consultable dans l'audit (voir Import en masse & audit).

Que se passe-t-il si je surclasse une demande déjà en cours de workflow ? La décision de l'administrateur prime : le statut de la demande est mis à jour directement, sans attendre les étapes d'approbation restantes.

Comment reporter les soldes en fin d'année ? Utilisez Reporter les soldes, qui applique automatiquement les règles de report (carryOverRules) définies par politique pour chaque employé.

Voir aussi