---
title: Purger un projet
slug: oip-next/wwMf-purge-des-documents
icon: {"lucideIcon":"📘"}
createdAt: 2025-11-27T16:18:17.000Z
---

# Vue d'ensemble

Le mécanisme de purge d'un projet s'inscrit dans le cadre de la RGPD.

Le service OIP Headless purge un projet lorsqu'un déclencheur est activé.

:::hint{type="warning"}
L’OIP, moteur d’orchestration de la suite FASST, permet de piloter tout ou partie du parcours de vente en assurance, selon les besoins de chaque assureur : qualification, offre, devis, souscription, signature, mise en gestion, etc.

À ce titre, il peut manipuler des données sensibles et intègre un dispositif complet de gouvernance des données, incluant des règles de conservation et de purge automatique conformes au RGPD.

Ces règles sont entièrement configurables afin de s’adapter aux politiques internes de chaque client. Une durée de conservation standard peut être appliquée par défaut, avec une purge automatique des données dès lors qu’elles ne sont plus nécessaires au workflow.
:::

# Enregistrement d'un déclencheur

Un déclencheur s'enregistre dans la table `settings` de la base de données associée au service OIP Headless.

La commande SQL à exécuter pour l'enregistrement d'un déclencheur est de la forme :

```sql
insert into settings (scope, key, value, application_id) values (100, 1000, '{ "type": "<ENTITY_NAME>", "after": <TRIGGER_AFTER>, "on": <TRIGGER_ON> }', <APPLICATION_ID>);
```

où :

- `TRIGGER_AFTER` est la période d'inactivité ; le format est `{ "after": { "value": DURATION_VALUE, "unit": "DURATION_UNIT" }}` où `DURATION_VALUE` est un entier naturel, et `DURATION_UNIT` est `year`, `month` ou `day`.
- `TRIGGER_ON` est optionnel et correspond à la propriété de l'entité sur laquelle s'applique la période d'inactivité ; le format est `{ "on": { "key": "PROPERTY_NAME", "value": "PROPERTY_VALUE" }}` où `PROPERTY_NAME` est le nom d'une propriété et `PROPERTY_VALUE` est la valeur de cette propriété.
- `APPLICATION_ID` : identifiant de votre application (colonne `id` de la table `applications`).

## Exemple

Ci-dessous un exemple de configuration afin d'exécuter une purge quand la propriété `status` d'une entité `Project` ne change pas pendant une période de 6 mois.

```shell
psql -U postgres -d oip_headless << EOF
insert into settings (scope, key, value, application_id) values (100, 1000, '{ "type": "Project", "after": { "value": 6, "unit": "month" }, "on": { "key": "status", "value": "SIGNED" }}', (select id from applications where name = 'MyApp'));
EOF
```

:::BlockQuote
**Info**
Veillez à remplacer `MyApp` par le nom réel de votre OAV.
:::

:::BlockQuote
**Info**
La commande SQL ci-dessous doit être exécutée depuis le container hébergeant la base de données PostgreSQL du service OIP Headless.
:::

# Réception de la trame projet avant purge

Avant la purge effective d'un projet, sa trame est envoyée via le protocole AMQP.

Veuillez vous référer à la [page dédiée](./Entités/Récupérer_une_trame_projet.md) pour la mise en place de sa réception.

Le type du message envoyé est :

```typescript
{ type: "snapshot_before_purge"; data: object }
```

La trame projet est alors accessible via la propriété `data`.
