Skip to content

Compliance defects

Faults found by checks — by truck and worst first — and moving each one through acknowledged, in repair, deferred and closed.

Compliance → Defects (/operations/compliance/defects) shows what checks found wrong and which trucks are carrying it.

The tiles count Units blocked, Critical open and Open defects.

By unit lists each truck with open faults, worst first, with counts of Critical, Major and Minor. Its status is either Should not be dispatched or Serviceable.

A unit should not be dispatched while it has a critical defect that is open, acknowledged or in repair. Onyx refuses to release, accept or start a run on it, on the dispatch board and in the driver app.

Narrow the list with Open only, Any severity and Any status. Each row shows the severity, the fault, the unit, when it was raised and its status.

The row buttons are:

  • Ack: someone has seen it.
  • Repair: it is being fixed.
  • Close: it is fixed.
  • Reopen: shown on a closed defect.

Each opens a short dialog with a Note (“What was done about it?”). Click Confirm.

  • Closing a critical defect needs a note. Onyx refuses it without one.
  • A defect is never deleted. It is closed or deferred, and its history stays.
  • Onyx refuses a move to the status a defect already has. That usually means someone else just updated it, so refresh.

The statuses are open, acknowledged, in_repair, deferred and closed. A deferred critical defect no longer grounds the truck: someone has looked at it and judged it can wait.

Faults from vehicle checks can also be dealt with from the workshop side, in Fleet → Maintenance (/operations/fleet/maintenance), on the Defects inbox tab. See Maintenance.

  1. On the vehicle’s card, tick the defects one repair fixes. If you tick none, all of that vehicle’s defects are included.
  2. Click Create repair. The Create repair from defects drawer opens with the defects listed.
  3. Leave Work is done — close the defects ticked if the job is finished, or untick it if the repair is only booked.
  4. Click Save.

The defects move on by themselves, each with a note naming the repair:

  • Work done: each defect is closed with the note Repaired — maintenance #N.
  • Only booked: each defect moves to in_repair with the note Booked for repair — maintenance #N. It stays in the inbox marked booked on repair #N. Click Mark repaired when the work is done to close them.

A defect can be on only one repair, and only defects from the same vehicle go on one repair.