---
title: Introduction
slug: oip-next/v3/core/crud/introduction
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-13T13:37:27.000Z
---

L'entité `Project`, en tant que racine de l'arbre des entités, est un cas particulier.

# CRUD

Les opérations de manipulation `create`, `read`, `update`, et `delete` ont un comportement différent selon l'entité à laquelle elles sont appliquées. Ces différences sont présentées dans les pages dédiées à ces quatre opérations.

# Autres opérations

L'entité `Project`, en tant que racine de l'arbre des entités, possède des opérations spécifiques.

## Duplicate

L'entité `Project` offre une fonction `duplicate` pour créer une nouvelle entité `Project` à partir d'une existante. Un nouvel arbre d'entités est ainsi créé et chacune des nouvelles entités créées aura un identifiant unique.

Signature : `<T>({ id: string }) => Promise<{ T | null }>`

```javascript
const duplicate = await Entities('Project').duplicate({ id });
```

## Exist

L'entité `Project` offre une fonction `exist` pour déterminer l'existence d'un projet.

Signature : `(args: { companySiret?: unknown; projectId?: unknown; userNetwork?: unknown }) => Promise<boolean>`

```javascript
const exist = await Entities('Project').exist({
  companySiret: '1234',
  projectId: { $ne: '1' },
  userNetwork: { $ne: 'network' }
});
```

## Purge

L'entité `Project` offre une fonction `purge` pour supprimer des propriétés dans l'arbre des entités.

Signature : `<T>(project: T, options: object) => Promise<T>`

```javascript
await Entities('Project').purge(project, {
  Project: {
    Offer: {
      delete: ['price'],
      Pack: {
        keep: ['externalId']
      }
    }
  }
});
```

### Options

La configuration de la purge à réaliser se fait via l'objet `options` :

- La structure de l'arbre des entités doit être respectée ; `options` est ainsi de la forme : `{ Project: { [...] } }`.
- Les clés autorisées sont de deux types :
  - Le nom d'une entité (la casse doit être respectée).
  - Le littéral `keep` ou `delete` ; `keep` définit la liste des propriétés d'une entité à conserver et à l'inverse `delete` définit la liste des propriétés d'une entité à ne pas conserver.

***Si à la fois les clés&#x20;***`keep`***&#x20;et&#x20;***`delete`***&#x20;sont spécifiées pour une entité alors seule la clé&#x20;***`keep`***&#x20;est utilisée.***

***Pour toutes les entités, certaines propriétés ne peuvent être supprimées :&#x20;***`id`***,&#x20;***`createdAt`***,&#x20;***`updatedAt`***.***

***Pour l'entités Project, les propriétés&#x20;***`status`***&#x20;et&#x20;***`statusHistory`***&#x20;ne peuvent également pas être supprimées.***

# *Hooks On Save*

Deux *hooks* peuvent être rattachés à la sauvegarde de l'entité `Project`. Le premier s'exécute avant la sauvegarde de la nouvelle entité `Project`. Le second s'exécute après la sauvegarde de la nouvelle entité `Project`.
