Leaves / Holidays module
The HtkDoli Leaves module allows you to consult, create, modify and track your leave and absence requests, all synchronized with your Dolibarr environment.
Interface and Features
The module interface is designed to be simple and efficient, offering a clear view of the status of your requests.
Consultation and Management
- Leave list: Browse your leave history with an overview including the request reference (e.g. H2025-001), dates, and a visual badge indicating the current status. Requests are grouped by month for better readability.
- Filtering and Sorting: You can filter the list by status (Draft, Validated, Approved, Refused, Cancelled) and search for a request by its reference or description. Sorting options allow you to display leave by date (newest or oldest) or by status.
- Detailed sheet: Each leave has a detailed view presenting the exact dates, the period (full day, half day), the duration calculated in days, the type of leave, as well as the description and any private notes.
- Document management: From the detailed file, it is possible to consult the documents attached to the request (e.g. medical proof) or add new ones directly from your device.
Actions on Leave
Depending on the status of the request and your permissions, different actions are possible from the detailed file or via context menus in the list:
- Validate: Submit a draft leave for validation.
- Approve: Accept a leave request (for managers/approvers).
- Refuse: Reject a request (future feature).
- Delete: Delete a leave (only possible if the leave is in Draft status).
Creation and Modification (Offline-First)
The HtkDoli application integrates an Offline-First approach for creating and modifying leave.
- Complete entry: When creating a request, you can enter the type of leave, the user concerned, the desired approver, the start and end dates, as well as the fine management of half-days (start in the afternoon, end in the morning).
- Local Save and Synchronization: When you create or modify a leave, the changes are immediately saved locally on your device. If you do not have an internet connection, a task (
PendingModification) is queued. The application will be responsible for synchronizing this data with your Dolibarr server (POST request for a creation, PUT for a modification) as soon as the connection is reestablished.
Business Behavior and Dolibarr
The module respects the standard life cycle of leave in Dolibarr.
Leave Statuses
A leave goes through several stages, represented by specific codes in the database:
- 0 - Draft: The request is being drafted, it has not yet been submitted. (Color: Gray/Secondary)
- 1 - Validated: The request is submitted and awaiting approval. (Color: Orange)
- 2 - Approved: The request is accepted by a manager. (Color: Green)
- 3 - Canceled: The request has been canceled. (Color: Red)
- 4 - Refused: The request was refused by the manager. (Color: Red)
Periods and Half-days
The system natively manages half-days to allow precise counts. The interface allows you to indicate whether the leave begins in the afternoon or ends in the morning, translating these choices into Dolibarr codes (1 = Start Afternoon, 2 = End Morning, 3 = Start PM / End AM).