Vue d'ensemble
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 :
Conventions & outils
- Nouvelles conventions de nommage kebab-case (ex. envVars.yml → env-vars.yml)
- Mise à jour des environnements (Node.js LTS)
- Évolutions de l’API client @fasstech/oip-starter-utils (exports, Router, erreurs, contexte, etc.)
Nouvelles fonctionnalités
- Commandes views:gen et views:build
- Refonte du Data Collector piloté côté back-end
- Workflows de tâches configurables
- Unification des mécanismes de contexte (ctx)
Breaking changes
- Setters immutables (ex. setProjectCode)
- Nouvelles signatures des CRUD entités (updateX, deleteX)
- Migration SESSION_CHECKING_DISABLED → SECURE_SESSION
- Migration businessRoute → routes
- Changement de signature de useProcess et des handlers (onNext, onPrev)
- Modifications du fragment ProcessFragment (metadata → viewData)
- Suppression de Tokens dans @fasstech/oip-starter-utils/app
Navigation suggérée
- Commencer par Conventions & outils pour aligner l’environnement et les points transverses.
- Consulter Nouvelles fonctionnalités pour tirer parti des apports de v4.
- Examiner attentivement Breaking changes avant de migrer un projet v3 existant.