Workflow Configuration

Summary

The Workflow Settings page lets owners configure the work order statuses that drive the Workshop Kanban board. Each status has a name, colour, sort order, and type flags (initial, workable, terminal). You can add, edit, reorder, and delete statuses to match your garage’s process. This page also controls vehicle mileage recording requirements.

Prerequisites

• You are signed in with the settings.access capability. By default, the Owner role has this.
• Navigate to Settings in the sidebar.

Permissions

This page requires the settings.access capability. Users without it are redirected to /dashboard.

Steps

1. Open Workflow Settings

Go to Settings > Workflow. The page is at /settings/workflow.

The page header shows the title Workflow Settings and the subtitle “Configure work order statuses and workflow”. The Add Status button sits at the top right.

2. Understand status types

The page includes an information card explaining the three status type flags:

• Initial Status - the default status for new work orders. Only one status can be marked as initial at a time. Setting a new status as initial automatically removes the flag from the previous one.
• Workable Status - statuses where technicians can actively work on the vehicle (e.g. “In Progress”). These appear as active columns on the Workshop Kanban.
• Terminal Status - end states that mark the job as complete or cancelled. At least one terminal status is required.

3. Review existing statuses

The Work Order Statuses card shows all configured statuses. The card description reads “X statuses configured. Drag to reorder the workflow sequence.” Each status row displays:

• A drag handle (grip icon) for reordering.
• A position number (1, 2, 3…).
• A colour dot showing the status colour.
• The status name.
• Type badges: “Initial” (with play icon), “Workable” (amber, with flag icon), “Terminal” (green, with tick icon).
• An edit button (pencil icon).
• A delete button (bin icon).

4. Add a new status

1. Click the Add Status button.
2. The Add New Status dialog opens with the description “Create a new work order status for your workflow”.
3. Fill in the fields:
   • Status Name - required, max 50 characters. For example: “Quality Check”, “In Progress”, “Awaiting Parts”.
   • Status Color - choose from preset swatches or enter a custom hex code. Presets include:
     • Gray (#6B7280) - Neutral / Pending
     • Blue (#3B82F6) - Scheduled / Active
     • Amber (#F59E0B) - In Progress
     • Green (#10B981) - Complete / Success
     • Red (#EF4444) - Cancelled / Error
     • Purple (#8B5CF6) - Special / QC
     • Pink (#EC4899) - Awaiting / Hold
     • Cyan (#06B6D4) - Ready / Available
   • Initial Status checkbox - tick if new work orders should start with this status.
   • Workable Status checkbox - tick if technicians can work on vehicles in this status.
   • Terminal Status checkbox - tick if this status marks a job as finished.
4. Click Create Status.

A success toast confirms “[name] has been added to your workflow”. The new status appears at the end of the list.

5. Edit an existing status

1. Click the pencil icon on a status row.
2. The Edit Status dialog opens with the current values pre-filled.
3. Modify the name, colour, or type flags as needed.
4. Click Update Status.

A success toast confirms “[name] has been updated”.

6. Reorder statuses

Drag a status row by its grip handle and drop it in the desired position. The sort order is saved automatically. The position numbers update to reflect the new order.

The sort order determines the column sequence on the Workshop Kanban board and the order in status dropdowns throughout Torqueflow.

7. Delete a status

1. Click the bin icon on a status row.
2. A confirmation dialog appears.
3. Click Delete to confirm, or Cancel to abort.

A success toast confirms deletion.

Deletion is blocked when:

• The status is the only initial status. Error: “Cannot delete the only initial status. Set another status as initial first.”
• The status is the only terminal status. Error: “Cannot delete the only terminal status. Set another status as terminal first.”
• Work orders or appointments use this status. Error: “Cannot delete status in use. X work orders and Y appointments use this status.”

8. Configure vehicle mileage settings

Below the status list, the Vehicle Mileage card controls mileage recording requirements.

• Require mileage before work completion toggle - when enabled, mechanics must record the vehicle’s odometer reading before completing their job.
• Grace period field - appears when the toggle is on. Enter the number of days (0-365) within which a previously recorded mileage reading is still accepted. Default is 7 days. The value saves automatically when you leave the field.

The toggle saves immediately when switched. A success toast confirms the change.

Expected Outcome

Your workflow statuses are configured to match your garage’s process. The Workshop Kanban board at /workshop reflects these statuses as columns, using the configured colours and sort order. New work orders are created with the initial status. Terminal statuses mark jobs as complete. The mileage setting enforces odometer recording before job completion if enabled.

Troubleshooting

Problem	Cause	Fix
Page redirects to /dashboard	Your account lacks the settings.access capability	Ask the Owner to grant settings access via Roles
”A status with this name already exists” error	Another status in your organisation has the same name	Choose a different name
Cannot delete a status	It is the only initial or terminal status, or work orders/appointments use it	Set another status as initial/terminal first, or reassign existing work orders
Colour looks different on Kanban	Browser colour rendering varies	The hex code is applied exactly. Check the hex value matches what you intended
Drag and drop does not work	Browser compatibility issue	Ensure you are using a modern browser. Try refreshing the page
Grace period does not save	The value is outside 0-365 or not a number	Enter a whole number between 0 and 365
Status name field rejects input	Name exceeds 50 characters	Shorten the status name
Kanban columns do not update	Page cache	The Workshop and My Jobs pages are revalidated after changes. Refresh if needed

Notes

• Status names must be unique within your organisation.
• The colour hex code must be exactly 6 digits with a # prefix (e.g. #3B82F6). The colour picker validates this format.
• Changes to statuses revalidate the Workshop Kanban (/workshop) and My Jobs (/my-jobs) pages automatically.
• Only one status can be the initial status. Setting a new initial status removes the flag from the previous one.
• At least one terminal status must exist at all times.