# Suppression réversible et restauration

Supprimer un enregistrement est **non destructif par défaut** : la ligne est marquée comme supprimée (`deletedAt`/`deletedBy` estampillés) et disparaît des requêtes normales, mais reste récupérable. Cela protège contre les suppressions accidentelles, prend en charge un flux corbeille/annulation et conserve une piste d'audit. La suppression définitive (irréversible) est une opération distincte, régulée par permission, pour les cas qui exigent un effacement irréversible.

| Méthode et chemin                                              | Description                                                 |
| -------------------------------------------------------------- | ----------------------------------------------------------- |
| `DELETE /api/tables/:tableId/records/:recordId`                | Supprimer (réversible) un enregistrement                    |
| `DELETE /api/tables/:tableId/records/:recordId?permanent=true` | Supprimer définitivement un enregistrement                  |
| `GET /api/tables/:tableId/trash`                               | Parcourir les enregistrements supprimés de façon réversible |
| `POST /api/tables/:tableId/records/:recordId/restore`          | Restaurer un enregistrement supprimé de façon réversible    |
| `POST /api/tables/:tableId/records/batch/restore`              | Restaurer plusieurs enregistrements                         |

## Suppression réversible

```
DELETE /api/tables/orders/records/123
```

Ceci renseigne `deletedAt` avec l'heure courante et `deletedBy` avec l'utilisateur agissant, puis exclut la ligne des réponses de liste et de lecture par défaut. L'opération est consignée dans l'[historique des modifications](record-history) de l'enregistrement.

## Suppression définitive (irréversible)

```
DELETE /api/tables/orders/records/123?permanent=true
```

La suppression définitive retire la ligne de façon irréversible et requiert la permission `permanentDelete`. Lorsque la suppression forcée n'est pas autorisée pour une table, le point de terminaison renvoie `404` (anti-énumération) plutôt que `403`.

:::callout
**La suppression définitive est optionnelle et réservée aux administrateurs.** Réservez `?permanent=true` aux véritables besoins d'effacement — par ex. le droit à l'effacement RGPD sur des données personnelles. Les registres financiers et les tables proches de l'audit ne devraient s'appuyer que sur la suppression réversible. La suppression définitive est une opération irréversible : il n'y a pas de restauration.
:::

## Comportement en cascade sur les enregistrements associés

Lorsqu'un enregistrement est supprimé, les enregistrements associés sont traités selon la politique `onDelete` du champ de relation. Configurez-la sur le [champ relationnel](relational-fields).

```yaml
tables:
  - id: 1
    name: orders
    permissions:
      delete: ['admin', 'member']
      permanentDelete: ['admin'] # Permanent delete requires admin role
    fields:
      - id: 1
        name: customer_id
        type: relationship
        relatedTable: customers
        onDelete: cascade # cascade | set-null | restrict
```

| `onDelete` | Effet lorsque le parent est supprimé                         |
| ---------- | ------------------------------------------------------------ |
| `cascade`  | Supprimer également les enregistrements dépendants (enfants) |
| `set-null` | Effacer la référence de clé étrangère sur les dépendants     |
| `restrict` | Bloquer la suppression tant que des dépendants existent      |

## Vue corbeille

`GET /api/tables/:tableId/trash` liste les enregistrements supprimés de façon réversible afin qu'une interface puisse présenter une corbeille récupérable. Le même résultat est disponible sur le point de terminaison de liste via `includeDeleted=only`.

## Restauration

```
POST /api/tables/orders/records/123/restore
```

La restauration efface `deletedAt` (ramenant la ligne aux requêtes normales), estampille un `restored_at`, capture l'utilisateur restaurant et consigne l'opération dans l'historique.

```json
{
  "id": 123,
  "deleted_at": null,
  "restored_at": "2025-01-15T11:00:00Z"
}
```

| Statut             | Signification                                    |
| ------------------ | ------------------------------------------------ |
| `200 OK`           | Enregistrement restauré                          |
| `400 Bad Request`  | L'enregistrement n'est pas actuellement supprimé |
| `401 Unauthorized` | Aucune session active                            |
| `404 Not Found`    | Enregistrement absent ou non visible             |

### Restauration en lot

Récupérez plusieurs enregistrements en une seule transaction. Les enregistrements qui ne sont pas actuellement supprimés sont ignorés ; un `id` manquant annule l'ensemble du lot (`404`). Voir [Opérations en lot](records-batch).

```json
POST /api/tables/orders/records/batch/restore
{
  "ids": ["123", "124", "125"]
}
```

## Interroger les enregistrements supprimés

Par défaut, les lignes supprimées de façon réversible sont exclues des réponses de liste et de lecture. Remplacez ce comportement avec le paramètre de requête `includeDeleted` :

| Valeur   | Comportement                                                                             |
| -------- | ---------------------------------------------------------------------------------------- |
| _(omis)_ | Enregistrements actifs uniquement (défaut)                                               |
| `true`   | Enregistrements actifs **et** supprimés                                                  |
| `only`   | Enregistrements supprimés de façon réversible uniquement (équivalent à la vue corbeille) |

```
GET /api/tables/orders/records?includeDeleted=true
GET /api/tables/orders/records?includeDeleted=only
```

## Résumé des permissions

| Opération              | Permission                                                                               |
| ---------------------- | ---------------------------------------------------------------------------------------- |
| Suppression réversible | `delete` (selon les [permissions de table](table-permissions) + [RBAC](auth-roles-rbac)) |
| Suppression définitive | `permanentDelete` (généralement réservé aux administrateurs)                             |
| Restauration           | attribution `delete` / restauration pour le rôle                                         |

## Pages associées

- [Vue d'ensemble des enregistrements](records-overview) — auteur `deletedBy`/`deletedAt`
- [CRUD et upsert](records-crud) — le point de terminaison de suppression d'un enregistrement unique
- [Opérations en lot](records-batch) — suppression et restauration en lot
- [Champs relationnels](relational-fields) — configuration de la cascade `onDelete`
- [Historique et commentaires des enregistrements](record-history) — les suppressions et restaurations sont consignées