Damage-case workflow: statuses and allowed transitions
Published:
Updated:
This article is a reference for the damage-case (Schadenfall) lifecycle: the three statuses a case can hold and exactly which status changes are allowed.
The three statuses
A damage case is always in one of three canonical statuses. New cases start as open.
| Status | Meaning |
|---|---|
| open | The case has been recorded and is being worked. Core data (including the vehicle) can still be changed. |
| in_repair | The vehicle is undergoing repair. The case is active but the vehicle can no longer be changed. |
| closed | The case is finished. It is read-only and cannot be reopened. |
Allowed transitions
The workflow is enforced by a state machine, so only the moves below are possible. Any other move is rejected as an invalid transition.
| From | You can move to |
|---|---|
| open | in_repair, closed |
| in_repair | open, closed |
| closed | — (nothing; closed is final) |
A few consequences follow from this table:
- You can send a case straight from open to closed without ever marking it in repair — useful when no repair is needed.
- You can move a case back from in_repair to open, for example if a repair was queued in error.
- closed is terminal. There is no transition out of it, so a closed case can never be reopened or moved again.
Warning: Because closing is irreversible, treat the move to closed as final. Confirm the classification, driver, and financial data are correct before you close.
What the status controls
The status does more than label a case — it gates what you can edit:
- The vehicle can only be changed while the case is open.
- A closed case is fully read-only: core data, classification, and financial line items can no longer be changed.
- Closing has its own prerequisites (see the article on closing a case).
Note: Status values are stored in lower-case canonical form —open,in_repair,closed— and every change is written to the case's status history so you keep a full audit trail.
Who can change status
Performing any transition requires the damage-management:transition permission, held by SystemAdmin and FleetManager by default. Viewing the status only requires damage-management:view.
Related
- Move a damage case through the workflow
- Close a damage case
- Who can change a case's status (permissions)
- Read a damage case in the detail view
AH
