---
title: Présentation
slug: oip-next/v4/reference/headless-api/entity
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-09T13:12:06.000Z
---

Une entité est un objet représentant une donnée métier ou technique de l'OAV.

Une entité est représentée par un identifiant et un dictionnaire de clé/valeur. Par exemple : `{ id: 1, data: { "firstName": "Foo", "lastName": "Bar" } }`.

L'ensemble des entités utilisées par un OAV forme un graphe orienté.

## Journalisation

Toute opération d'écriture sur une entité est consignée. L'objectif est double :

- disposer de l'historique complet ;
- permettre de revenir à un état précédent.

## Intégrité des données

Toutes les opérations d'écriture sur les entités sont exécutées dans des transactions PostgreSQL.
