Congés

Les demandes de congés et d'absences de l'équipe : chacun pose sa demande, le décompte en jours ouvrés est calculé automatiquement, un responsable approuve ou refuse, et le solde annuel se met à jour tout seul.

/leaves /api/leaves leaves.view leaves.request leaves.approve leaves.manage

À quoi sert ce module

Le module Congés remplace les échanges d'e-mails et les tableurs d'absences. Il gère les types d'absence (congés payés, RTT, maladie…), les soldes annuels de chaque salarié, le circuit demande → décision et un planning d'équipe mensuel où chacun voit qui est absent.

Il s'adresse à tous les salariés (pour poser leurs demandes), aux responsables (pour les valider) et aux RH (pour les soldes et les types). Le motif d'une demande reste confidentiel : seuls le demandeur et les validateurs le voient.

Mise en service

Le module s'installe puis s'active depuis Paramètres → Modules (disponible → installé → activé). Il n'a aucun prérequis et apparaît dans la section Interne de la navigation. Si le module Calendrier est actif, chaque congé approuvé y crée un événement « Congé : <Nom> » sur toute la période.

Vue d'ensemble de l'écran

L'onglet Mes demandes : au-dessus de la liste, une carte par type décompté indique vos jours disponibles de l'année en cours (acquis, pris, en attente). Les onglets À valider (validateurs), Soldes et Types (gestionnaires) n'apparaissent qu'avec la permission correspondante.

Poser une demande

Avec leaves.request, cliquez sur Nouvelle demande.

1. Type d'absence — parmi les types actifs.
2. Du / Au — dates incluses. Cochez Débute l'après-midi ou Se termine le matin pour une demi-journée en début ou en fin de période. Le nombre de jours décomptés s'affiche aussitôt.
3. Motif — facultatif, visible uniquement des validateurs.
4. Envoyer la demande — elle passe En attente et les validateurs sont prévenus par e-mail.

La demande est refusée si la période ne contient aucun jour ouvré, si elle chevauche une autre de vos demandes en attente ou approuvée, ou si le type est décompté sur un solde et que celui-ci est insuffisant.

Décompte en jours ouvrés

La durée est toujours calculée par le serveur : seuls les jours ouvrés comptent, c'est-à-dire du lundi au vendredi, hors jours fériés français de métropole (1^er janvier, lundi de Pâques, 1^er et 8 mai, Ascension, lundi de Pentecôte, 14 juillet, 15 août, 1^er et 11 novembre, 25 décembre). Chaque demi-journée cochée retire 0,5 jour, à condition que le jour concerné soit lui-même ouvré.

Valider les demandes

L'onglet À valider (permission leaves.approve ou leaves.manage) liste les demandes en attente avec l'employé, le type, la période, le nombre de jours, le solde disponible et le motif. Ouvrez une demande, ajoutez si besoin une note pour le demandeur, puis Approuver ou Refuser.

1. Approuver — le solde est revérifié (les droits ont pu changer depuis la demande), les jours sont ajoutés aux jours pris et, si le Calendrier est actif, l'événement est créé.
2. Refuser — la demande est close sans effet sur le solde.
3. Dans les deux cas, le demandeur reçoit un e-mail avec la décision et la note.

Annuler une demande

Le bouton Annuler de Mes demandes clôt une demande En attente à tout moment, ou une demande Approuvée tant que son premier jour n'est pas arrivé. Annuler un congé approuvé restitue les jours au solde et supprime l'événement du Calendrier. Un gestionnaire peut annuler toute demande, même commencée.

Planning d'équipe

L'onglet Planning affiche un mois complet : une ligne par salarié actif, une colonne par jour. Les week-ends et jours fériés sont grisés ; une case hachurée signale une demande encore en attente. Naviguez avec les flèches Mois précédent / Mois suivant ou revenez à Aujourd'hui. Les collègues n'y voient que le type et la durée des absences, jamais le motif.

Soldes

L'onglet Soldes (leaves.manage) affiche, pour un employé et une année, une ligne par type actif. Les droits acquis et l'ajustement (report, régularisation) se saisissent directement dans le tableau, ligne par ligne, avec Enregistrer.

Une demande est rattachée à l'année de son premier jour. Les soldes peuvent aussi être initialisés en masse depuis Import / Export.

Types d'absence

L'onglet Types (leaves.manage) gère la liste proposée dans le formulaire. Cinq types sont créés à l'installation :

Chaque type a un code unique (1 à 10 caractères : lettres, chiffres, _), un libellé, une couleur, et deux cases : Absence rémunérée et Décomptée sur un solde annuel. Seuls les types avec solde sont contrôlés à la demande et à l'approbation. Un type se désactive (il n'est plus proposé) mais ne se supprime pas : il reste visible dans l'historique.

Notifications

Les e-mails partent immédiatement, sans tâche planifiée : nouvelle demande vers les validateurs (comptes ayant leaves.approve ou tous les droits, hors demandeur), décision vers le demandeur. Ils nécessitent un envoi d'e-mails configuré dans Paramètres ; à défaut, rien n'est envoyé mais le circuit fonctionne. L'entrée « Congés » de la barre latérale est aussi mise en évidence pour les demandes à valider, et pour vos demandes décidées dans les 14 derniers jours.

Permissions

À l'installation, le rôle Employé reçoit leaves.view et leaves.request. Les données RH étant sensibles, leaves.approve et leaves.manage sont à attribuer via un rôle dédié. Voir Rôles & permissions.

Liens utiles

• Calendrier — les congés approuvés y apparaissent.
• Import / Export — initialiser les soldes, exporter les demandes.
• Rôles & permissions — qui valide les congés.