> For the complete documentation index, see [llms.txt](https://docs.uselessrobuk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uselessrobuk.com/projects/workshopos+.md).

# WorkshopOS+

WorkshopOS+ is a workshop management system designed for managing vehicle service jobs, appointments, mechanics, and workflow tracking.

***

## Getting Started

### Logging In

1. Open WorkshopOS+.
2. Enter your username and password.
3. Click **Sign In**.
4. Alternatively, use one of the demo accounts:
   * Manager
   * Front Desk
   * Supervisor
   * Mechanic (Alex)

***

## Main Dashboard Overview

After login, the system displays:

#### Sidebar

* User profile information
* Navigation menu
* System Events Log
* Sign Out button

#### Main Workspace

* Dashboard statistics
* Job workflow board
* Technician availability
* Search and actions area

***

## Creating a New Job

### Registering a Walk-In Vehicle

1. Select **Create Job**.
2. Complete the required fields:

| Field                | Description             |
| -------------------- | ----------------------- |
| Owner Name           | Vehicle owner's name    |
| Vehicle Registration | Registration plate      |
| Vehicle Model        | Vehicle make/model      |
| Vehicle Issue        | Customer-reported issue |
| Job Description      | Work required           |
| Priority             | Low, Medium, High       |
| Assign Mechanic      | Optional assignment     |

3. Click **Create Job**.

***

### Booking an Appointment

1. Open the Job Registration form.
2. Choose **Appointment** mode.
3. Enter:
   * Appointment Date
   * Appointment Time
4. Complete the remaining job details.
5. Save the booking.

***

## Managing Jobs

### Viewing Job Details

1. Select a job card from the workflow board.
2. The Job Details window opens showing:
   * Customer information
   * Vehicle details
   * Assigned technician
   * Parts required
   * Notes
   * MOT checklist
   * Current status

***

### Job Workflow Stages

Jobs move through three primary stages:

#### Incoming

Newly registered jobs awaiting action.

#### In Progress

Jobs currently being worked on by mechanics.

#### Completed

Finished jobs ready for customer collection.

#### Moving Jobs

Drag and drop job cards between workflow columns as work progresses.

***

## Assigning Mechanics

### Supervisor Assignment Process

1. Open the job.
2. Select **Assign Mechanic**.
3. Choose a technician from the dropdown list.
4. Click **Assign**.

#### Unassigned Jobs

Jobs may initially remain unassigned and await supervisor allocation.

***

## Monitoring Technicians

The technician panel shows:

* Technician name
* Current status
  * Available
  * Busy
  * On Break
* Current workload
* Active jobs assigned

#### Status Indicators

| Status | Meaning   |
| ------ | --------- |
| Green  | Available |
| Yellow | Busy      |
| Red    | On Break  |

***

## Using Notes

### Adding Job Notes

1. Open a job.
2. Locate the Notes section.
3. Enter a comment or update.
4. Save the note.

Notes are timestamped and stored against the job record.

***

## MOT Checklist

For MOT inspections:

1. Open the vehicle job.
2. Review the MOT Checklist section.
3. Tick completed inspection items.
4. Save progress.

***

## Monitoring System Activity

The **System Events Log** in the sidebar provides:

* Live operational updates
* User actions
* Workflow events
* Status changes

A live indicator shows the system is actively tracking events.

***

## Job Priorities

Jobs can be categorized as:

| Priority | Usage                  |
| -------- | ---------------------- |
| High     | Urgent repairs         |
| Medium   | Standard service work  |
| Low      | Non-urgent maintenance |

Priority badges help staff identify urgent work quickly.

***

## Logging Out

1. Click **Sign Out** in the sidebar.
2. The system returns to the login screen.

***

### Best Practices

* Assign high-priority jobs immediately.
* Keep technician statuses updated.
* Add notes regularly for repair progress.
* Move jobs through workflow stages promptly.
* Review the system event log throughout the day.
* Use appointment scheduling to balance workshop workload.

This workflow helps front desk staff, supervisors, and mechanics coordinate vehicle servicing efficiently.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.uselessrobuk.com/projects/workshopos+.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.