Tasks Module

The HtkDoli Tasks module lets you consult, create, edit and track the progress of tasks linked to your Dolibarr projects. Every task is mandatorily attached to a project.

Task List

The main screen displays the list of all your tasks, grouped by month/year or by letter depending on the chosen sort.

Search, Sort and Filters

Search bar: search by task reference or label.
Sort:
- Date (Newest → Oldest)
- Date (Oldest → Newest)
- Reference (A-Z)
- Reference (Z-A)
Date sorting is based on the task's start date.
Progress filters (each entry shows a counter):
- All
- To do: progress at 0%
- In progress: progress between 1% and 99%
- Completed: progress ≥ 100%
Floating index bubble: while scrolling, a bubble shows the current letter (reference sort) or the current month (date sort).

Information displayed (Task cards)

Each row shows:

A circular progress indicator:
- Empty grey circle if the task has not started (0%).
- Percentage in blue if the task is in progress.
- Green checkmark if the task is completed (≥ 100%).
The label (or the reference if no label).
The end date if set (in red if overdue and the task is not completed).
The Dolibarr reference.
The parent project identifier ("Projet #ID").

Quick actions on the list

Swipe from the left edge: Edit the task, and Finish (if progress is < 100%).
Swipe from the right edge: Delete the task.
Context menu (long press): offers the same actions (Edit, Finish if < 100%, Delete).
Floating "+" button at the bottom right: creates a new task.

Pagination and States

Paginated synchronization in batches of 50 tasks, with a "Load more" button.
Pull-to-refresh to resynchronize the list.
Refresh state indicator (up to date / stale / loading / success / failure).
Clear empty-list message, differentiated by search, filter or absence of data.

Detail / Creation / Edit Sheet

The detail screen also serves for creating and editing a task. It is organized into cards.

Dynamic title: "New task" or "Edit task", with contextual help text.

On an existing task, the ••• menu of the top bar offers Mark as done (as long as it is not), Log time and Delete; the pencil opens editing.

Information

Title of the task (required field).
Description (multiline text area).

Notes

Public note (visible in some exports / to everyone).
Private note (internal use).

Planning

Start date: enabled via a toggle, with a date + time picker.
End date: enabled the same way.

Progress

Progress slider from 0% to 100%, in steps of 5%.

Details

Priority: Low, Normal, High (with color code: green / orange / red).
Expected load: entry of the estimated duration in hours and minutes (converted to seconds for Dolibarr).

Project link

Project picker among your existing projects. A project must be selected to save the task.
When opened from a project, the parent project is pre-selected.
Warning message when no project is selected: "A project is required to create a task."
If no project is available, the picker shows "No project available".

Assigned users (existing task only)

When consulting an existing task, an "Assigned users" card is displayed:

List of assigned users: avatar with initials, full name and job title (falls back to the login when no job is set).
Long-press a row to reveal the "Unlink" action: the user is immediately unassigned, then the list refreshes.
"Add a user" button at the bottom of the card: opens the picker sheet, which lists active users. The list reloads automatically once the sheet is dismissed.
Message "No user assigned to this task." when the list is empty.
Add/remove actions are gated by the right to create/edit projects in Dolibarr. Without this right, the card remains visible but the actions are hidden.
Every action (assignment, unassignment, error) triggers an informative toast.

Validation and saving

The Save button is disabled while the title is empty or no project is selected.
On error, an error card is shown in the sheet.

Time Tracking

From a task's record, the ••• menu offers "Log time": the screen lets you record working time on the task:

Date of the entry (default: today; date + time picker).
Duration in hours (0 to 23) and minutes (0 to 59).
Descriptive note of the work done (optional).
The Save button is enabled only when the duration is greater than 0.
The entry is placed in the synchronization queue and sent to Dolibarr on the next cycle, on behalf of the logged-in user.

"Time spent" card

As soon as at least one time entry exists on the task, a "Time spent" card (followed by the total) appears in the record, between the notes and the assigned users. Each row shows the date, the note and the author, with the duration on the right; the title carries the total. An entry logged from the app shows up once the synchronization queue has run, without reopening the record. The card is absent while no time exists.

Business Behavior and Dolibarr

Progress cycle

A task's progress is an integer from 0 to 100. HtkDoli interprets:

0% → To do
1 to 99% → In progress
100% → Completed

The visual badge in the list and the progress filter follow this logic automatically.

Creation and Modification (offline "Offline-First" mode)

Creation: the task is first saved locally with a provisional reference (e.g. (PROV)-A1B2C3) and a progress of 0%, then added to the synchronization queue.
Modification: your changes are reflected immediately on screen then queued.
Finish (from the list): progress is set to 100% locally and sent; on failure, the previous progress is restored.

Rights and Permissions

Read: read permission on the Tasks/Projects module required.
Creation ("+" button in the top bar): right to create/edit projects in Dolibarr.
Managing assigned users: same right.

Dolibarr business note: Task management is closely tied to project management. To create or modify tasks via HtkDoli, your Dolibarr user must have write rights on the Projects module.

Synchronization

List paginated in batches of 50.
Creation, modification and time entries all go through the local synchronization queue. Nothing is sent in blocking synchronous mode.

Screenshots

2 screenshots — click to enlarge