# Workflow & Task States

Workflows and tasks in the WorkLyft system have two layers of statuses:

1. Technical statuses – managed automatically by the workflow engine.
2. Business statuses – user-facing, configurable by administrators.

This distinction ensures the engine can reliably track process execution, while users see business-friendly labels that make sense in daily operations.

### Workflow Technical Statuses

| Status    | Description                                                                  |
| --------- | ---------------------------------------------------------------------------- |
| running   | Workflow is active, at least one task created and is in progress.            |
| done      | Workflow completed successfully (all tasks finished, skipped, or cancelled). |
| cancelled | Workflow was cancelled.                                                      |
| error     | Workflow ended due to at least one task finishing with error.                |

### Task Technical Statuses

| Status    | Description                                                             |
| --------- | ----------------------------------------------------------------------- |
| active    | Task created and is currently in progress (manual or system execution). |
| done      | Task finished successfully.                                             |
| skipped   | Task was bypassed (e.g. condition not met, activation policy).          |
| cancelled | Task was cancelled manually                                             |
| error     | Task failed (e.g. script error).                                        |

### Business Statuses

* Business statuses are configurable by administrators through General Settings -> Workflows in Admin Dashboard
* They represent states meaningful to end-users (e.g. *“In review”*, *“To sign”*, *“Approved”*).
* Business statuses are mapped to technical statuses, but allow organizations to adapt terminology to their processes.

Example mapping:

* Technical: *active* → Business: *“In review”*
* Technical: *done* → Business: *“Approved”*

### How Statuses Interact

* The workflow engine drives technical statuses automatically.
* Users update business statuses in manual tasks.
* Administrators define available business statuses per category, including which are *ending statuses* (used to determine process completion).