Overview Dashboard
The Production module's landing screen — an at-a-glance, read-only snapshot of every Manufacturing Order broken down by status, your master-data totals, and the ten most recent orders. It is where a supervisor starts the day.
production/Production (also reachable as production or
production/Production/index). This is the base dashboard only — the date-range
reporting hub is documented separately in Production Reports.
Who can open it
Access to the Overview is gated by two things — both must be true:
| Requirement | Meaning | Required | Notes |
|---|---|---|---|
module_production setting |
The Production module must be enabled in Settings → Manage Modules. | Required | Checked by with_module('production'). If off, the sidebar group disappears. |
production permission |
The master permission for the Production module base — gates this dashboard controller and both dashboard widgets. | Required | Category Production: Manufacturing Orders. Missing it redirects you away. See Permissions & Roles. |
production permission, while
Production Reports is gated by a separate
production_report permission. A user can hold one without the other.
The two rows of stat cards
The top of the dashboard is eight KPI tiles arranged in two rows of four. Row one is all about Manufacturing Order (MO) counts; row two mixes master-data totals with the remaining status counts. The example figures below are illustrative — your instance shows live numbers.
Row 1 — Manufacturing Order status counts
Row 2 — Master data totals & remaining statuses
What each card counts
| Card | What it counts | Required | Notes |
|---|---|---|---|
| Manufacturing Orders | Total number of non-deleted MOs across all statuses. | Read-only | Teal / brand number (#1d97a6). Equals the sum of every status count. |
| Open Manufacturing Orders | MOs whose work is not yet finished or cancelled — draft + confirmed + in_progress. |
Read-only | Amber number (#f0ad4e). Same definition as the Open MOs widget. |
| Manufacturing In Progress | MOs currently being manufactured (status in_progress). |
Read-only | Blue number (#5bc0de). |
| Done | Completed MOs (status done). |
Read-only | Green number (#5cb85c). |
| Bills of Materials | Total number of non-deleted BOM records. | Read-only | Neutral / black number. A count only — no status breakdown. |
| Work Centers | Total number of non-deleted Work Center records. | Read-only | Neutral / black number. A count only. |
| Cancelled | Cancelled MOs (status cancelled). |
Read-only | Red number (#d9534f). Excluded from the Open count. |
| Draft | MOs still in draft (status draft). |
Read-only | Grey number (#777). Also included inside the Open count. |
Card colour legend
The numbers on the cards are colour-coded so you can read the board at a glance. These are the
inline card colours defined in overview.php:
#1d97a6 — all non-deleted MOs (the grand total).#f0ad4e — draft + confirmed + in progress.#5bc0de — currently being manufactured.#5cb85c — completed orders.#d9534f — cancelled orders.#777 — created, not yet confirmed.get_manufacturing_order_status_label()), so a status can look slightly different
as a card number versus a table badge. Both are documented in
Glossary & Legends.
Manufacturing Order statuses
Six of the eight cards are just counts of one MO lifecycle state. The states themselves are governed by the Manufacturing Orders controller, not this dashboard — the Overview only displays the current state. The full lifecycle, left to right:
Status legend
draft + confirmed + in_progress
everywhere in the module — the Open card here and the Open MOs widget both use it. Done and
Cancelled are never “open”.
Recent Manufacturing Orders panel
Below the cards is a bordered panel titled Recent Manufacturing Orders. It lists the ten most recently created MOs so you can see what just landed on the shop floor without opening the full list.
Panel columns
| Column | Meaning | Required | Notes |
|---|---|---|---|
reference — Reference |
Human-readable MO reference (e.g. MO-00001). |
Read-only | A hyperlink to the MO detail view (production/Manufacturing_orders/view/{id}). If the reference text is empty it falls back to #{id}. |
item_title — Finished Good |
Title of the finished-good item the MO produces. | Read-only | Resolved from the item's default variant title. Shows - when there is no linked item / variant. |
quantity_planned — Quantity to Produce |
The planned output quantity, with its unit of measure appended. | Read-only | Decimal-formatted (convert_number_to_decimal) + unit_title. |
status — Status |
The MO's current lifecycle state. | Read-only | Rendered as a coloured status label via get_manufacturing_order_status_label(). |
planned_start_date — Planned Start |
The MO's scheduled start date. | Read-only | Shows - when empty or 0000-00-00; otherwise formatted via format_to_date(). |
How the list behaves
- Ordering
- Sorted by
iddescending — i.e. most recently created first, not by planned date or priority. - Row cap
- Capped at 10 rows. Older orders do not appear here — use the full list for those.
- Reference link
- Clicking a Reference opens that order's detail view. Everything else in the row is display-only text.
The “Manufacturing Orders →” button
At the top-right of the Recent MOs panel sits a Manufacturing Orders → button. It simply
navigates to the full order list at production/Manufacturing_orders — there is no
filter or state carried over; it is a plain link.
Open the full MO list to create, confirm, start, complete, or cancel orders.
Date-range status summary, output by period, and component consumption.
SOP — daily supervisor check-in
Use the Overview as your morning stand-up board. The whole routine is read-only, so you can run it freely.
-
Open the Overview
Precondition: you have the
productionpermission and the Production module is enabled. Click Production in the sidebar (or go toproduction/Production). -
Read the top row
Check the total, Open, In Progress, and Done counts. Confirm the Open and In Progress figures match what you expect for the day.
-
Read the second row
Note the Bills of Materials and Work Centers totals (master data), then the Cancelled and Draft counts for anything that stalled.
-
Scan Recent Manufacturing Orders
Look down the latest ten orders and their statuses. Open any that need attention by clicking its Reference link.
-
Triage the backlog if needed
If Open or Draft looks high, click Manufacturing Orders → to work the full list in Manufacturing Orders.
Dashboard widgets
The module also ships two small tiles you can place on your main company dashboard (the home screen), so production status is visible without opening the module at all. Both are read-only, live counts, and both are shown by default when the module is enabled.
What each widget counts
| Widget | Counts | Required | Notes |
|---|---|---|---|
Open Manufacturing Ordersproduction_open_mos |
Live count of open MOs — draft + confirmed + in_progress. |
Read-only | Cogs icon (fa-cogs). Count = count_by_statuses('draft,confirmed,in_progress'). The whole tile links to the MO list. |
Manufacturing In Progressproduction_in_progress_mos |
Live count of MOs currently in progress (in_progress). |
Read-only | Spinner icon (fa-spinner). Count = count_by_statuses('in_progress'). The whole tile links to the MO list. |
How the widgets behave
- Where they render
- On the main company dashboard, not inside the Production module. They are registered in the module's widget config and rendered by the module's widget helper.
- Click target
- The entire tile is a link to the Manufacturing Orders list (
production/Manufacturing_orders) — clicking anywhere on it opens the list. - When they appear
- They require the
module_productionsetting to be enabled and theproductionpermission. Both are shown by default once those are satisfied.
FIND_IN_SET on a comma-separated status list, which is why the
Open widget can total several statuses in one figure.
SOP — put the widgets on your dashboard
-
Confirm access
Make sure the Production module is enabled and you hold the
productionpermission. -
Enable the tiles
On the main company dashboard, add / enable the Open Manufacturing Orders and Manufacturing In Progress widgets. Both are shown by default, so they usually appear automatically.
-
Read and drill in
Read the live counts at a glance; click either tile to jump into the Manufacturing Orders list.
Things to keep in mind
| Gotcha | Why it matters |
|---|---|
| Overview is all-time | The cards and the BOM / Work Center totals have no date filter. For a period view, use Production Reports. |
| “Open” is a fixed set | Open always means draft + confirmed + in_progress — cancelled and done are never open. |
| Recent list = newest 10 by id | Sorted by id DESC (most recently created), capped at 10 — not by planned date or priority. |
| Name comes from the default variant | Finished Good is read from item.default_variant_id. If an item has no default variant, it shows - even though the MO is valid. |
| Blank / zero dates render as “-” | A planned_start_date of 0000-00-00 or empty shows as - in the Recent MOs table. |
| Two permissions, two screens | The Overview and widgets need production; the Reports page needs the separate production_report. A user may have one but not the other. |
| Everything here is read-only | No create / edit / delete happens on the Overview or widgets. Actions live in Manufacturing Orders. |