Passa al contenuto principale

Soft delete a vehicle from the fleet

DELETE 
/company/vehicles/:id

Contrassegna un veicolo come eliminato (eliminazione soft) dalla flotta aziendale.

Obiettivo​

Consentire alle aziende di rimuovere i veicoli dall'uso attivo mantenendo una traccia di audit e l'integrità dei dati storici.

Casi d'Uso​

  • Rimuovere veicoli venduti o dismessi dalla flotta attiva
  • Archiviare veicoli obsoleti preservando i record storici
  • Pulire l'elenco veicoli senza perdere dati

Comportamento dell'Eliminazione Soft​

Questo endpoint esegue un'eliminazione soft utilizzando il plugin mongoose-delete:

  • Il veicolo NON viene eliminato permanentemente dal database
  • Il campo deleted viene impostato su true
  • Il campo deletedAt viene impostato con il timestamp corrente
  • Il veicolo viene rimosso dall'array dei veicoli dell'azienda
  • I dati rimangono nel database per scopi di audit e recupero

IMPORTANTE: Questa NON è un'eliminazione permanente. Il veicolo può potenzialmente essere recuperato dagli amministratori del database se necessario.

Effetti Collaterali​

  • Aggiorna il modello aziendale per rimuovere il riferimento al veicolo dall'array dei veicoli
  • Il veicolo non apparirà più negli elenchi della flotta

Nota: Attualmente non è presente alcuna validazione della proprietà in questo endpoint. Qualsiasi utente autenticato può eliminare qualsiasi veicolo se ne conosce l'ID. Questo potrebbe rappresentare un problema di sicurezza.

Request​

Responses​

Veicolo eliminato con successo (eliminazione soft).

Response Headers