# Workshop Dashboard

<figure><img src="/files/sIFpaayn7oDsdOidN3Al" alt=""><figcaption></figcaption></figure>

The Workshop Dashboard is the landing page for the Workshop module. It shows live counts of the work that matters today, quick links to each Workshop area, and a seven-day preview of bookings.

> **Permissions:** Access to the Workshop Dashboard is granted by the standard Workshop permissions. Administrators, Fleet Managers, and Workshop Users typically have this permission.

> **Note:** Day boundaries on this page use UTC server time. A booking scheduled at 23:30 local time the previous day may appear in the next day's column when your local time zone is east of UTC, or in the previous day's column when you are west of UTC. The detail diary uses the same UTC keys.

## What you can do

* See live counts for the workshop's most-used metrics.
* Jump to **Diary**, **Bookings**, **Job Cards**, or **Workshop Settings** with a single click.
* See a one-glance preview of the current week's bookings without leaving the page.
* Click any preview day to open the diary on that day.

## Opening the Workshop Dashboard

To open the dashboard, click **Workshop** in the sidebar, or navigate directly to `/workshop`. The dashboard is the default page for the module.

## KPI widgets

Six widgets across the top of the page show the current state of the workshop. Each value comes from the workshop dashboard service; if the call fails, the widget shows a dash (`-`) instead of a number so the rest of the page still works.

| Widget             | What it counts                                                                                      | Click behaviour        |
| ------------------ | --------------------------------------------------------------------------------------------------- | ---------------------- |
| Open Job Cards     | Job cards that are still in an open status (any non-closed bucket).                                 | Opens **Job Cards**.   |
| VOR Vehicles       | Vehicles flagged as Vehicle Off Road. The widget uses a red accent so VOR is hard to miss.          | Opens **Job Cards**.   |
| Today Bookings     | Bookings scheduled to start during today's UTC day.                                                 | Opens **Diary**.       |
| Active Technicians | Technicians currently set as active in Workshop Settings.                                           | No-op (informational). |
| Closed Today       | Job cards that closed during today's UTC day. The widget uses a green accent.                       | No-op (informational). |
| Revenue This Month | Total revenue from closed job cards in the current calendar month, formatted to two decimal places. | No-op (informational). |

> **Note:** Revenue is shown without a currency symbol; formatting follows your tenant's locale settings.

## Quick links

Below the widgets, four large cards link to each Workshop area:

* **Workshop Diary** - open the booking calendar.
* **Workshop Bookings** - open the bookings list.
* **Workshop Job Cards** - open the job cards list.
* **Workshop Settings** - open the settings hub for bays, parts, statuses, technicians, and more.

These mirror the items in the Workshop sub-menu - use whichever entry point you prefer.

## Diary preview (this week)

The lower section of the page shows a seven-column strip covering the current week (Monday to Sunday). Each column contains:

* The day's short name and number; today is highlighted in blue.
* One chip per booking on that day, showing the **Vehicle Registration** (drawn as a yellow number plate) and the **Booking Type** as a coloured pill.
* A dash (`-`) when the day has no bookings.

Click any day to open the [Workshop Diary](/documentation/workshop/workshop-ops/diary.md) directly. The chip colours match the colours configured for each booking type in Workshop Settings.

> **Tip:** If the chips look empty, check that the booking types you use have a colour set under **Workshop Settings > Booking Types**.

## How the data is loaded

When you open the page, the dashboard fires three calls in parallel:

* A summary call for the six KPI widgets.
* A booking-types call so the chips can be coloured.
* A bookings call covering the current week (Monday 00:00 UTC to Sunday 23:59 UTC).

If any of the calls fail, the rest of the page still renders. Widgets fall back to `-`, the preview falls back to empty columns, and the quick links remain usable.

## Related articles

* [Workshop overview](/documentation/workshop/workshop-ops.md)
* [Workshop Diary](/documentation/workshop/workshop-ops/diary.md)
* [Bookings](/documentation/workshop/workshop-ops/bookings.md)
* [Job Cards](/documentation/workshop/workshop-ops/job-cards.md)
* [Workshop Settings](/documentation/workshop/workshop-ops/workshop-settings.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/workshop/workshop-ops/workshop-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.