Orders
The Orders page is the central production board: it shows all confirmed orders organised by status, lets you update progress, and gives access to documents and workshop tools.
How to access
- Menu: Orders
- Address:
/orders - Who can use it: Administrator and User
Interface
The page consists of a search bar at the top and a tabbed area.
Search bar
A text field that filters the board in real time by:
- order number
- order title
- client name
To clear the active filter, click the × on the right side of the field.
Tabs
| Tab | Content |
|---|---|
| Active | Kanban board with columns for each progress status. |
| Cancelled | Flat list of cancelled orders, sorted from most recent. The number next to the label shows how many orders there are. |
Kanban board (Active tab)
The board is divided into five columns, one for each progress status:
| Column | Status | Meaning |
|---|---|---|
| New | new | Order just created, awaiting production start. |
| In production | in_production | Workshop production started. |
| Ready | ready | Production complete, awaiting shipment or pick-up. |
| Shipped | shipped | Goods handed to courier or in transit. |
| Delivered | delivered | Final delivery confirmed. |
Each column shows the count of orders it contains. If orders exceed 20 per column, pagination appears at the bottom of the column (indicator current page / total pages with ‹ and › buttons).
Cancelled tab
Cancelled orders appear in a three-column grid (desktop). This tab also supports pagination beyond 20 items.
Payment panel (inline)
When the Payments panel is opened for an order (see Operations), a box appears above the board showing:
- the list of payments already recorded with amount, method, date and notes
- the total amount paid so far
- a form to add a new payment
Order card
Each order is represented by a card containing:
| Element | Description |
|---|---|
| Title | Order name. |
| Order number | Unique alphanumeric code (monospace font). |
| Client | Name of the associated client. |
| Payment badge | Unpaid (red) · Partial (orange) · Paid (green). |
| Priority badge | High (red) · Medium (orange) · Low (grey). Values 1–2 are High, 3–4 Medium, 5+ Low. |
| Total | Total order amount. |
| Amount owed | Remaining balance, shown only when greater than zero (in orange). |
| Delivery date | Expected date, shown only when set. |
| Status selector | Drop-down to change status directly from the card. |
| Expand/collapse button | Shows or hides additional actions (up/down arrow). |
Operations
Change an order's status
- Locate the order card.
- In the status selector at the bottom of the card, choose the new status from the drop-down.
- The card moves to the corresponding column instantly.
Available statuses: New, In production, Ready, Shipped, Delivered, Cancelled.
Change priority
- Click the expand button (down arrow) on the card.
- Use Priority up to increase priority (move toward the top of the column) or Priority down to lower it.
- The card reorders immediately within the column.
The "Priority up" button is disabled when the order is already first.
Record a payment
- Click expand on the order card.
- Click Payments (credit card icon).
- The Payments panel opens above the board, headed by the order title.
- To add a payment, fill in:
- Amount (in euros)
- Method — Cash, Bank Transfer, Card, Other
- Date
- Notes (optional)
- Click Add payment.
- To delete an existing payment click the bin icon on the row; a confirmation dialog appears. After confirming you have a few seconds to undo via the toast at the bottom.
- To close the panel click Close at the top right of the box.
Open the cutting plan
- Click expand on the order card.
- Click Optimise cutting (scissors icon), which opens the optimised cutting plan.
- The dedicated page
/orders/<id>/cutting-planopens.
Delete an order
- Click expand on the order card.
- Click Delete (bin icon).
- Confirm in the dialog.
- The order disappears from the board; you have 7 seconds to undo via the toast at the bottom.
Navigate between tabs
- Click Active or Cancelled in the tabs above the board.
- The URL updates automatically (
?tab=cancelled) so you can share or bookmark the Cancelled view directly.
Search for an order
- Type at least one word in the search field at the top of the page.
- The board filters in real time.
- To remove the filter click the × in the field.
Statuses and messages
| Situation | Message / behaviour |
|---|---|
| No orders | An empty state is shown with an "Open quotes" button to create orders from confirmed quotes. |
| No orders in column | Short text below the column heading. |
| No cancelled orders | Informational message in the Cancelled tab. |
| Deletion pending | Orange toast with timer and "Undo" button for 7 seconds. |
| Payment added | Green confirmation toast. |
| Payment add error | Red toast with error detail. |
| Payment deletion | Orange toast with timer and "Undo" button for 5 seconds. |
Notes and limits
- Orders are created from the Quotes page by confirming an existing quote; you cannot create an order directly from the board.
- Priority is an integer: values 1–2 correspond to High, 3–4 to Medium, 5 and above to Low.
- The payment badge is calculated automatically based on payments recorded against the order total.
- Status and priority changes are optimistic: the UI updates immediately while the request travels to the server; on error the state is rolled back.
- The Cutting Plan page is only accessible for orders that come from a quote with configured items.