4.42. Editor - Delete an equipment
| Id | 4.42. |
| Description |
As an Editor,
I want to be able to delete an equipment that was created by mistake or has been decommissioned,
So that I can improve the quality and reliability of the register. |
| Priority | High |
| Actors | Editor |
| API Calls | DELETE /equipments/<equipment-id> |
| Linked Processes | |
| Status | Implemented |
Preconditions
- The User must be authenticated and have the Editor role.
- The User has a equipment id that he wants to delete
- The User has a valid reason to delete the equipment
Postconditions
- The system returns a confirmation that the equipment has been marked as “to be deleted”.
Main flow
- The Editor uses an API call to delete a specific equipment by ID (DELETE).
- The system validates the input parameters.
- The system marks the equipment as “to be deleted”. WARNING: If the equipment is already used somewhere else in the system, the equipment is marked as deleted but is kept in the database.
- The system returns a confirmation that the equipment has been marked as “to be deleted”.
Exceptions
[400 Bad Request] Invalid input:
If mandatory fields are missing or invalid, the system returns an error message.
[404 Not Found] Equipment not found
Error returned by the system if the given equipment does not exist.
[500 Internal Server Error] System Error
If the system fails to save changes due to an internal error, it displays an appropriate message and logs the error for further investigation.