---
title: Vue d'ensemble
slug: oip-next/aSyW-vue
icon: {"lucideIcon":"📘"}
createdAt: 2025-12-10T10:58:36.000Z
---

# Objectif

Cette documentation présente les changements majeurs introduits avec **OIP v4** par rapport à la **version 3** :

- structure et logique de fonctionnement,
- conventions de nommage,
- outils et API côté client,
- gestion des entités, vues, tâches et contexte.

L’objectif est de **faciliter la migration** des projets existants et de **clarifier les nouvelles bonnes pratiques de développement**.

# Principaux thèmes d’évolution

Les évolutions sont détaillées dans les pages suivantes :

:::Heading{depth="3" indent="1"}
**Conventions & outils**
:::

:::Paragraph{listStyleType="disc" indent="2"}
Nouvelles conventions de nommage kebab-case (ex. `envVars.yml` → `env-vars.yml`)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Mise à jour des environnements (Node.js LTS)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Évolutions de l’API client `@fasstech/oip-starter-utils` (exports, Router, erreurs, contexte, etc.)
:::

:::Heading{depth="3" indent="1"}
**Nouvelles fonctionnalités**
:::

:::Paragraph{listStyleType="disc" indent="2"}
Commandes `views:gen` et `views:build`
:::

:::Paragraph{listStyleType="disc" indent="2"}
Refonte du Data Collector piloté côté back-end
:::

:::Paragraph{listStyleType="disc" indent="2"}
Workflows de tâches configurables
:::

:::Paragraph{listStyleType="disc" indent="2"}
Unification des mécanismes de contexte (`ctx`)
:::

:::Heading{depth="3" indent="1"}
**Breaking changes**
:::

:::Paragraph{listStyleType="disc" indent="2"}
Setters immutables (ex. `setProjectCode`)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Nouvelles signatures des CRUD entités (`updateX`, `deleteX`)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Migration `SESSION_CHECKING_DISABLED` → `SECURE_SESSION`
:::

:::Paragraph{listStyleType="disc" indent="2"}
Migration `businessRoute` → `routes`
:::

:::Paragraph{listStyleType="disc" indent="2"}
Changement de signature de `useProcess` et des handlers (`onNext`, `onPrev`)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Modifications du fragment `ProcessFragment` (`metadata` → `viewData`)
:::

:::Paragraph{listStyleType="disc" indent="2"}
Suppression de `Tokens` dans `@fasstech/oip-starter-utils/app`
:::

# Navigation suggérée

1. Commencer par **Conventions & outils** pour aligner l’environnement et les points transverses.
2. Consulter **Nouvelles fonctionnalités** pour tirer parti des apports de v4.
3. Examiner attentivement **Breaking changes** avant de migrer un projet v3 existant.
