Module Congés (Leaves / Holidays)

Le module Congés de HtkDoli vous permet de consulter, de créer, de modifier et de suivre vos demandes de congés et d’absences, le tout synchronisé avec votre environnement Dolibarr.

Interface et Fonctionnalités

L’interface du module est pensée pour être simple et efficace, offrant une vue claire sur l’état de vos demandes.

Consultation et Gestion

Liste des congés : Parcourez l’historique de vos congés avec une vue d’ensemble incluant la référence de la demande (ex: H2025-001), les dates, et un badge visuel indiquant le statut actuel. Les demandes sont regroupées par mois pour une meilleure lisibilité.
Filtrage et Tri : Vous pouvez filtrer la liste par statut (Brouillon, Validée, Approuvée, Refusée, Annulée) et rechercher une demande par sa référence ou sa description. Les options de tri permettent d’afficher les congés par date (plus récents ou plus anciens) ou par statut.
Fiche détaillée : Chaque congé dispose d’une vue détaillée présentant les dates exactes, la période (journée entière, demi-journée), la durée calculée en jours, le type de congé, ainsi que la description et les notes privées éventuelles.
Gestion des documents : Depuis la fiche détaillée, il est possible de consulter les documents joints à la demande (ex: justificatif médical) ou d’en ajouter de nouveaux directement depuis votre appareil.

Actions sur les Congés

Selon le statut de la demande et vos permissions, différentes actions sont possibles depuis la fiche détaillée ou via des menus contextuels dans la liste :

Valider : Soumettre un congé en brouillon à la validation.
Approuver : Accepter une demande de congé (pour les managers/approbateurs).
Refuser : Rejeter une demande (fonctionnalité à venir).
Supprimer : Supprimer un congé (uniquement possible si le congé est en statut Brouillon).

Création et Modification (Offline-First)

L’application HtkDoli intègre une approche Offline-First (fonctionnement hors ligne) pour la création et la modification des congés.

Saisie complète : Lors de la création d’une demande, vous pouvez renseigner le type de congé, l’utilisateur concerné, l’approbateur souhaité, les dates de début et de fin, ainsi que la gestion fine des demi-journées (début l’après-midi, fin le matin).
Sauvegarde locale et Synchronisation : Lorsque vous créez ou modifiez un congé, les modifications sont immédiatement enregistrées localement sur votre appareil. Si vous n’avez pas de connexion internet, une tâche (PendingModification) est placée en file d’attente. L’application se chargera de synchroniser ces données avec votre serveur Dolibarr (requête POST pour une création, PUT pour une modification) dès que la connexion sera rétablie.

Comportement Métier et Dolibarr

Le module respecte le cycle de vie standard des congés dans Dolibarr.

Statuts des Congés

Un congé passe par plusieurs étapes, représentées par des codes spécifiques dans la base de données :

0 - Brouillon : La demande est en cours de rédaction, elle n’est pas encore soumise. (Couleur: Gris/Secondaire)
1 - Validé : La demande est soumise et en attente d’approbation. (Couleur: Orange)
2 - Approuvé : La demande est acceptée par un manager. (Couleur: Vert)
3 - Annulé : La demande a été annulée. (Couleur: Rouge)
4 - Refusé : La demande a été refusée par le manager. (Couleur: Rouge)

Périodes et Demi-journées

Le système gère nativement les demi-journées pour permettre des décomptes précis. L’interface vous permet d’indiquer si le congé commence l’après-midi ou se termine le matin, traduisant ces choix en codes Dolibarr (1 = Début Après-midi, 2 = Fin Matin, 3 = Début PM / Fin AM).