---
title: Principes de conception
slug: oip-next/stQf-principes-de-conception
icon: {"lucideIcon":"📘"}
createdAt: 2026-03-19T09:15:06.000Z
---

## Une signature commune pour toutes les features

L’un des principes fondamentaux de OIP Features est que toutes les features doivent partager la même structure d’initialisation.

Cette homogénéité permet :

- de simplifier l’apprentissage&#x20;
- de faciliter l’intégration&#x20;
- d’éviter les implémentations ad hoc selon les projets&#x20;
- de garantir une expérience développeur cohérente&#x20;

## Une logique centrée sur l’entité Project

La feature travaille toujours à partir de l’entité Project, qui constitue l’objet central manipulé dans OIP.

Le contrat est simple :

1. la feature reçoit un Project&#x20;
2. elle exécute sa logique métier ou technique&#x20;
3. elle retourne ce Project, modifié ou non&#x20;
4. elle peut retourner des métadonnées supplémentaires si nécessaire&#x20;

Ce principe permet de garder un mode d’intégration stable d’une feature à l’autre.

## Une séparation claire entre initialisation et exécution

Une feature est d’abord initialisée avec des options de configuration. Cette étape prépare les handlers nécessaires, comme la mise à jour de task ou l’émission de messages.

Ensuite, les fonctions métier exposées par la feature peuvent être appelées avec leur contexte d’exécution propre :

- projectEntity&#x20;
- args&#x20;
- taskState&#x20;

Cette séparation améliore la lisibilité et rend les features plus faciles à tester et à réutiliser.

## Des conventions explicites

Pour renforcer la cohérence de l’écosystème, plusieurs conventions s’appliquent :

- le nom d’une feature est suffixé par Feature&#x20;
- les APIs exposées doivent suivre un contrat homogène&#x20;
- les données spécifiques à l’appel passent dans args&#x20;
- les statuts de task sont transmis via taskState lorsqu’on est dans un contexte de task&#x20;

Ces conventions sont essentielles pour faire de OIP Features une vraie bibliothèque industrielle et non une collection hétérogène de modules.&#x20;
