Release Note
14 min
- Type : mineur
- Services concernés : OIP Core, OIP Tools, OIP Headless, OIP Starter Utils
- Action attendue : migration
- Breaking change : non
- Impact : fort
- Recommandation : prioritaire
Résumé
OIP v4.2026.Q2 officialise la V4 en version stable et aligne les composants principaux sur une nouvelle version majeure. Cette release introduit plusieurs évolutions structurantes sur les trames projet, les données d’audit, la purge de projets et les outils de génération, avec une migration à préparer côté intégration et exploitation.
Actions rapides
- Vérifier la compatibilité de vos projets avec les packages et services OIP en V4.
- Tester séparément les flux liés aux trames projet, aux informations d’audit et à la purge de projets.
- Mettre à jour les outils et environnements avant généralisation en production.
Détail par service
OIP Headless v1.0.0
- Changement : ajout d’une nouvelle route POST /entities/:id/tree pour demander l’envoi d’une trame projet.
- Impact : moyen. Cette évolution ajoute une nouvelle capacité d’appel pour les intégrations qui manipulent les trames projet.
- Action : mise à jour simple. Tester la nouvelle route et vérifier son intégration dans les flux existants.
- Changement : mise à jour des routes de récupération d’une ou plusieurs entités avec ajout d’un paramètre permettant de remonter les informations d’audit.
- Impact : moyen. Les consommateurs API peuvent désormais enrichir leurs usages avec des données d’audit, ce qui peut faire évoluer les traitements ou affichages existants.
- Action : mise à jour simple. Identifier les appels concernés et valider le comportement attendu avec ou sans audit.
- Changement : prise en charge de la purge effective d’un projet avec l'ajout d’une fonction de purge de projets avec définition manuelle de déclencheurs dans OIP Headless selon la valeur d’une propriété ou une durée d’inactivité en jours, mois ou années.
- Impact : fort. Cette évolution touche directement au cycle de vie des projets et nécessite un cadrage précis pour éviter une suppression non souhaitée.
- Action : migration. Définir les règles de purge avec la solution architect, sécuriser les critères de déclenchement et tester les scénarios de purge.
- Changement : suppression d’une race condition entre le commit d’une transaction SQL et l’envoi d’une trame projet.
- Impact : moyen. Cette correction améliore la fiabilité des traitements et réduit le risque d’incohérence dans les flux projet.
- Action : rien. Contrôler simplement le bon fonctionnement sur les cas critiques.
- Changement : mise à jour de l’image Docker.
- Impact : faible. Évolution d’alignement technique et de maintenance.
- Action : mise à jour simple. Rebuilder et redéployer les environnements concernés.
OIP Core v4.0.0
- Changement : ajout de la fonction requestEntitySnapshot pour demander l’envoi d’une trame projet.
- Impact : moyen. Cette capacité complète les usages autour des trames projet côté socle.
- Action : mise à jour simple. Vérifier les usages applicatifs qui doivent appeler cette fonction.
- Changement : mise à jour des fonctions de récupération d’une ou plusieurs entités avec ajout d’un paramètre pour récupérer les informations d’audit.
- Impact : moyen. Les développements existants peuvent être enrichis par de nouvelles données sans remettre en cause le socle fonctionnel.
- Action : mise à jour simple. Valider les contrats d’appel et les besoins de restitution des données d’audit.
- Changement : ajout de la fonction normalizeEntitySnapshot pour normaliser et appliquer des transformations à une trame projet.
- Impact : moyen à fort. Cette évolution peut modifier la manière de préparer ou exploiter les snapshots projet dans les flux techniques.
- Action : migration. Identifier les traitements concernés et tester la compatibilité avec les snapshots existants.
- Changement : mise à jour des dépendances.
- Impact : faible. Maintenance technique sans impact métier direct identifié.
- Action : rien.
OIP Tools v4.0.0
- Changement : ajout de l’option --oas-config à la commande entities generate pour générer les fichiers de manipulation des entités et les scripts de migration du modèle de données à partir d’un fichier Open API.
- Impact : moyen à fort. Cette évolution change la manière de produire les artefacts projet et peut faire évoluer les pratiques d’outillage.
- Action : migration. Vérifier les usages de génération existants et tester les sorties produites avec le nouveau mode.
- Changement : résolution dynamique des variables d’environnement OAV_ID et OIP_API_KEY dans les scripts de migration du modèle de données du projet.
- Impact : moyen. Les pipelines deviennent plus souples mais doivent être validés dans chaque environnement.
- Action : mise à jour simple. Contrôler le paramétrage CI/CD et les variables injectées.
- Changement : ajout de la prise en charge des informations d’audit dans les fichiers de manipulation des entités.
- Impact : moyen. Les artefacts générés s’enrichissent et peuvent nécessiter une adaptation des usages aval.
- Action : mise à jour simple. Vérifier les fichiers générés et les traitements consommateurs.
- Changement : suppression du suffixe Query du nom des fichiers générés (hooks) pour la gestion des mutations GQL.
- Impact : moyen. Le nom des hooks générés pour la gestion des mutations GQL peut changer.
- Action : mise à jour simple. Exécuter le script de migration dédié.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité.
- Action : rien.
OIP Starter Utils v4.0.0
- Changement : ajout de l’option routerBasename à la fonction start de l’API client pour définir la propriété basename du router interne.
- Impact : moyen. Cette évolution améliore la configurabilité des applications clientes intégrées dans des contextes d’URL spécifiques.
- _Action _: mise à jour simple. Vérifier si vos applications ont besoin de configurer un basename.
- Changement : le paramètre graphql.security.armorConfig de la fonction start de l’API serveur est désormais correctement interprété.
- Impact : moyen. Cette correction peut modifier le comportement effectif de la configuration serveur attendue.
- Action : mise à jour simple. Revalider la configuration GraphQL côté serveur.
- Changement : mise à jour de la dépendance partagée Vite JS de v7 vers v8.
- Impact : moyen. Cette montée de version peut avoir des effets sur le build et le démarrage des projets.
- Action : migration. Tester le build, le run local et les pipelines après mise à jour.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité.
- Action : rien.
Template du Project Starter v4
- Changement : mise à jour des dépendances OIP.
- Impact : faible à moyen. Le template s’aligne sur la V4 et facilite les nouveaux démarrages de projet.
- Action : mise à jour simple. Utiliser le template à jour pour les nouveaux socles ou les réalignements.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance technique.
- Action : rien.
OIP Data v3.9.0
- Changement : refonte graphique de la gestion des versions du projet dans la vue projet.
- Impact : faible. Amélioration d’ergonomie pour les utilisateurs de la gestion de versions.
- Action : rien.
- Changement : refonte graphique du résumé du projet dans la vue projet.
- Impact : faible. Amélioration visuelle sans changement métier structurant.
- Action : rien.
- Changement : augmentation de la limite de caractères de l’input « fonction personnalisée » dans le formulaire des règles de validation d’une propriété, avec un maximum de 8000 caractères.
- Impact : faible à moyen. Cette évolution facilite les usages avancés de validation personnalisée.
- Action : rien. Vérifier uniquement les cas d’usage qui atteignaient la limite précédente.
- Changement : mise à jour des dépendances pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité.
- Action : rien.