Aller au contenu
Retour aux réalisations

Réalisations

Migration d'un ERP d'entreprise d'Odoo 16 vers Odoo 19

Migration en solo d'un ERP utilisé par 20 utilisateurs internes directs, avec 16 modules personnalisés et des extensions tierces à adapter.

Synthèse de la réalisation

Cette synthèse donne les repères de lecture essentiels. Elle ne remplace pas l'étude de cas complète : faites défiler la page pour consulter le contexte détaillé, les étapes, les limites et le retour critique.

Contexte
À l'été 2025, l'ERP Odoo 16 de 1UP Distribution, utilisé par 20 utilisateurs internes, devait évoluer hors de sa période de support avec 16 modules sur mesure et des extensions tierces.
Enjeu
Faire évoluer un ERP central sans perdre les données, les règles métier et les intégrations dont dépendait l'activité quotidienne.
Mon rôle
J’ai piloté les trois migrations, les contrôles techniques et la bascule. J’ai coordonné la recette avec les équipes métier et traité les anomalies remontées après la mise en production.
Décision clé
Procéder par trois migrations successives, inventorier les personnalisations et stabiliser chaque usage métier après la bascule.
Résultat
L'ERP et les modules nécessaires ont été portés vers Odoo 19 en préservant les données, les fonctions métier utiles et la continuité de service recherchée.
Preuve
Des captures de migration et l'expérience associée apportent des éléments vérifiables, dans les limites imposées par la confidentialité de l'entreprise.Accéder aux éléments détaillés

Preuves visuelles

Captures et démonstrations issues des projets réels.

Média 1 sur 16

Validation de migration vers Odoo 17

Validation de migration vers Odoo 17

Étape intermédiaire de la migration Odoo.sh, utilisée pour isoler les incompatibilités avant la montée finale.

Voir la capture en taille réelle

01

Présentation

Chez 1UP Distribution, vingt personnes utilisaient Odoo 16 au quotidien pour la comptabilité, les ventes, les achats et les stocks. Le site B2B et plusieurs services externes échangeaient aussi des données avec cet ERP. Comme la version approchait de sa fin de support, j’ai préparé le passage à Odoo 19, avec seize modules internes, des extensions tierces et des personnalisations réalisées directement dans l’ERP avec Odoo Studio.

Les dépendances de l’ERP. Le site B2B échangeait les clients, les produits, les commandes et les stocks avec Odoo. Un hub d’intégration reliait aussi l’ERP aux marketplaces et à ShippingBo, qui centralise les commandes et leur préparation en entrepôt. Enfin, des outils de pilotage exploitaient les données Odoo pour produire des tableaux de bord. La recette devait donc couvrir aussi bien l’application elle-même que les échanges qui permettaient aux équipes et aux canaux de vente de reprendre leur activité.

Odoo Studio est un outil visuel qui permet de créer des champs de données, de modifier les écrans de l'ERP — appelés vues — ou d'ajouter des actions automatisées sans développer un module complet. Ces personnalisations sont utiles pour répondre rapidement à un besoin, mais elles sont principalement enregistrées dans la base de données plutôt que dans le dépôt de code. Un dépôt de code est un espace versionné qui conserve les fichiers du logiciel et l'historique de leurs modifications. Lorsque les personnalisations Studio deviennent nombreuses, il est donc plus difficile pour un développeur de les inventorier, de suivre leur évolution et de les adapter lors d'une migration.

J’ai pris en charge la préparation technique, les migrations intermédiaires et la bascule sur Odoo.sh. Les équipes métier ont vérifié les parcours dont elles avaient l’usage et ma responsable est intervenue dans les arbitrages concernant le périmètre et la mise en production.

02

Objectifs, contexte et enjeux

La comptabilité constituait le périmètre le plus sensible. L'ERP enregistre notamment les factures reçues des fournisseurs pour justifier les achats de l'entreprise. Dans Odoo, toutes les informations ne se trouvent pas uniquement dans la base PostgreSQL — les fichiers associés aux enregistrements sont conservés dans un espace distinct appelé filestore. Ce répertoire de stockage contient les pièces jointes et d'autres données binaires, c'est-à-dire des fichiers tels que des factures au format PDF, des images ou des documents importés. Une migration pouvait donc laisser visible l'écriture correspondant à un achat tout en rendant sa facture jointe indisponible si le filestore était incomplet ou mal rattaché à la base migrée. Une telle perte aurait diminué la traçabilité comptable et compliqué la justification de l'opération lors d'un contrôle comptable ou fiscal. Cet enjeu était d'autant plus important que les factures clients et fournisseurs sont des pièces justificatives que l'entreprise doit conserver pendant dix ans à compter de la clôture de l'exercice concerné.

La disponibilité de l'outil représentait un autre objectif majeur. Comme l'ERP soutient le travail quotidien de la majorité des employés, une interruption de plusieurs jours n'était pas acceptable. Les migrations et les corrections devaient donc être testées à l'avance dans les environnements Odoo.sh afin que la mise en production se concentre sur l'application d'un processus déjà vérifié. Lors de la bascule, Odoo.sh devait reconstruire l'environnement de production, c'est-à-dire recréer l'application à partir de la base migrée et de la version validée du code, puis la remettre à disposition des utilisateurs avec une interruption aussi courte que possible. Une indisponibilité temporaire du site B2B pouvait être tolérée, car son propre code devait lui aussi être adapté à la nouvelle version de l'ERP. La priorité restait toutefois le redémarrage rapide d'Odoo, dont dépendaient davantage de processus internes.

03

Risques et mesures de maîtrise

Perte ou altération des données structurées. Une migration de base ne doit pas seulement conserver le nombre global d'enregistrements. Elle doit aussi préserver leurs valeurs, leurs relations et leur historique. Une facture encore présente mais rattachée au mauvais fournisseur, une commande dont certaines lignes auraient disparu ou un paiement ayant perdu son lien comptable auraient constitué des pertes fonctionnelles, même si la base démarrait correctement. La mesure de maîtrise consistait à travailler sur des copies réalistes de la production, à examiner les erreurs produites à chaque changement de version et à vérifier les enregistrements indispensables, des commandes aux factures et aux mouvements de stock.

Échec de la bascule et retour arrière. Si Odoo était devenu indisponible ou si une anomalie critique avait empêché la reprise de l'activité, le scénario de secours était un retour arrière. Cette opération, parfois appelée rollback, consiste à abandonner la version nouvellement déployée et à restaurer le dernier état stable connu. Dans ce projet, le point de reprise était la sauvegarde complète réalisée juste avant la migration de la production. Le retour à cet état aurait limité la perte de données, car la période située entre la sauvegarde et la tentative de bascule devait rester aussi courte que possible. Les commandes éventuellement restées en attente sur les canaux externes auraient ensuite dû être contrôlées et resynchronisées afin d'éviter les doublons ou les oublis.

04

Les étapes — ce que j'ai fait

Inventaire initial et stratégie pour chaque module. J'ai commencé par relever la version de chacun des modules installés afin de décider de son traitement. Les extensions dont la dernière version disponible était antérieure à Odoo 16 étaient considérées comme des modules legacy, c'est-à-dire du code ancien qui n'était plus maintenu pour les versions récentes de l'ERP. Leur migration ne consistait pas à les conserver à tout prix — il fallait préparer leur suppression propre, donc retirer leur code et leurs dépendances sans laisser de références incohérentes dans la base ni casser les données encore utiles. Pour les autres modules tiers, j'ai recherché une version compatible avec les versions d'Odoo suivantes. J'ai téléchargé les extensions gratuites et acheté les nouvelles versions des extensions payantes, puis je les ai intégrées une par une aux essais de migration. La présence d'une version récente ne garantissait pas son fonctionnement — certains modules comportaient encore des erreurs que j'ai dû corriger. Dans d'autres cas, le nouveau code fonctionnait mais ne contenait plus les personnalisations ajoutées au-dessus de la version précédente. J'ai alors réintégré ces adaptations métier dans la nouvelle base de code.

Trois paliers de migration. J’ai adapté le code pour passer de la version 16 à la 17, puis à la 18 et à la 19. À chaque palier, Odoo.sh reconstruisait l’environnement avec la base convertie et la branche correspondante. Je relançais les contrôles après les corrections. Cette progression permettait d’attribuer une erreur à un changement de version précis et de vérifier les modules avant d’engager le palier suivant.

Recherche de la cause réelle d'une erreur. La plupart des tracebacks indiquaient suffisamment clairement le module, le fichier ou la méthode à examiner. Lorsqu'ils n'étaient pas explicites, je devais reconstruire les conditions exactes de déclenchement. Je croisais alors le code exécuté, les données concernées, les changements apportés par la nouvelle version d’Odoo et les transformations du script de migration. Cette mise en relation était nécessaire, car une erreur apparemment située dans le code standard pouvait être déclenchée uniquement par une ancienne donnée, par une personnalisation ou par un champ qui n'avait pas été transformé comme prévu. Je cherchais donc la cause racine, c'est-à-dire le premier défaut expliquant réellement la chaîne d'erreurs, plutôt que de corriger uniquement le dernier message affiché. Cette méthode évitait les correctifs superficiels qui auraient seulement déplacé le problème vers le rebuild suivant.

Recette technique et fonctionnelle. Une fois un build capable de démarrer, la validation ne s'arrêtait pas à l'absence d'erreur dans les logs. J'ai effectué une recette, c'est-à-dire une série de vérifications destinées à comparer le comportement obtenu avec le fonctionnement attendu par l'entreprise. Elle couvrait les parcours de vente, d'achat, de comptabilité, d'inventaire et d'administration des ventes, ainsi que les échanges avec le site B2B et les autres systèmes connectés. J'ai également parcouru les vues recensées, une vue étant un écran de consultation ou de saisie dans Odoo, les automatisations, les actions planifiées et les paramètres de configuration. Il fallait vérifier à la fois qu'un écran s'affichait, que les données présentées étaient correctes et que l'action réalisée produisait le bon résultat. Les essais avec différents profils permettaient enfin de repérer une fonctionnalité disponible pour un administrateur mais inaccessible à l'utilisateur qui devait réellement l'employer.

Bascule de la production le 6 février 2026. Lorsque les migrations successives et la recette nous ont donné suffisamment de confiance, nous avons créé plusieurs sauvegardes de la production avant de lancer l'opération définitive sur Odoo.sh. Ces sauvegardes constituaient les points de retour disponibles si la nouvelle version empêchait la reprise de l'activité. La plateforme a ensuite exécuté la migration et reconstruit l'environnement de production avec le code compatible Odoo 19. L'opération a temporairement rendu l'ERP indisponible. Dès son redémarrage, nous avons effectué une nouvelle série de tests sur les processus les plus critiques afin de prendre une décision de go/no-go — conserver la nouvelle version si elle permettait de travailler sans anomalie critique, ou déclencher le rollback vers la sauvegarde si un problème suffisamment grave menaçait les données ou bloquait l'activité. Aucune anomalie détectée à ce stade n'a imposé ce retour arrière. La production a donc été maintenue sur Odoo 19 et la phase de stabilisation a commencé.

05

Les acteurs — les interactions

Responsabilité technique et responsabilité fonctionnelle. J'ai pris en charge seul l'ensemble du volet technique — analyse du code, adaptation des modules, migrations successives, diagnostic des erreurs, préparation de la production et corrections après la bascule. L'assistante de direction constituait ma principale interlocutrice fonctionnelle. Sa connaissance transversale lui permettait de valider les processus métier, de confirmer quelles personnalisations restaient nécessaires et de décider lesquelles pouvaient être supprimées parce qu'elles ne correspondaient plus à un usage utile.

Tests guidés par l'expérience des utilisateurs. Je n'ai pas demandé aux équipes de se limiter à vérifier si l'application s'ouvrait. Je leur ai demandé de reproduire tout ce qu'elles effectuaient au quotidien puis de me signaler les différences, les blocages et les comportements inattendus. Cette démarche correspond à un test exploratoire métier. L'utilisateur s'appuie sur sa connaissance du travail réel pour parcourir les situations qu'il juge importantes, plutôt que de suivre uniquement un scénario technique écrit par le développeur. Les utilisateurs connaissaient mieux que quiconque leurs propres processus et pouvaient repérer des détails invisibles pour moi, par exemple un champ manquant, une étape devenue plus longue, un calcul différent ou une information qui n'apparaissait plus au bon endroit.

06

Les résultats

L’ERP et les fonctions essentielles ont repris sur Odoo 19, sans perte définitive de données signalée. L’interruption pendant la bascule n’a pas fait l’objet d’une mesure publiable. La galerie présente des validations intermédiaires et des extraits de l’historique des corrections.

Les personnalisations conservées. Les seize modules internes ont été adaptés à Odoo 19. Quatre modules tiers devenus inutiles ont été retirés. Nous avons gardé environ 15 % des personnalisations Studio, notamment des filtres de recherche utilisés au quotidien. Les autres n’ont pas été reportées après examen de leur utilité et des fonctions disponibles dans la nouvelle version. À la fin de la stabilisation décrite ici, aucun besoin métier lié à ces retraits n’avait été identifié comme restant à réintroduire.

Reprise des intégrations après la bascule. L’ERP a redémarré en premier. J’ai ensuite adapté les appels que je maintenais, notamment ceux du site B2B, puis vérifié les échanges dans les deux sens. La plupart des intégrations reprises sont passées de JSON-RPC à JSON-2, ce qui a impliqué de revoir les appels et leur authentification par clé d’API. Les principaux échanges ont repris progressivement dans les jours qui ont suivi. Une mise à jour dépendait encore du prestataire qui maintenait l’intégration concernée.

Un rapprochement bancaire plus réactif. La comptabilité a constaté un affichage plus rapide des écrans de lettrage. Les comptables ouvraient ces écrans plusieurs fois par jour pour rapprocher les mouvements bancaires des factures et des paiements. Il s’agit d’un résultat qualitatif issu de l’usage, sans chronométrage comparable entre les deux versions. Le rapprochement restait plus lent que la plupart des autres vues de l’ERP, ce qui en faisait encore un bon candidat à une mesure ciblée.

07

Les lendemains du projet

Après la mise en service, les incidents de migration ont rejoint le suivi habituel des demandes ERP. Certaines intégrations ont pu être adaptées en interne. Pour l’une d’elles, la mise à niveau dépendait encore du prestataire qui détenait le code. Les retours d’usage ont aussi servi à distinguer les anomalies à traiter des personnalisations anciennes qu’il n’était plus nécessaire de réintroduire.

Une architecture moins dépendante de Studio et des extensions externes. À moyen terme, je souhaite continuer à limiter les personnalisations Studio et les modules tiers lorsque leur usage rend le comportement difficile à suivre ou dépend d'un éditeur peu réactif. L'objectif n'est pas de tout redévelopper en interne — une extension externe maintenue et bien documentée peut rester le meilleur choix. En revanche, les adaptations propres à l'entreprise gagnent à être placées dans des modules internes versionnés. Leur code et l'historique de leurs changements sont alors visibles dans le dépôt GitHub, testables en préproduction et plus faciles à relire lors d'une future migration. Cette orientation augmente la maîtrise du système sans renoncer aux composants externes réellement utiles.

08

Mon regard critique

J’ai commencé l’inventaire des personnalisations Studio trop tard. Certaines règles invisibles dans le dépôt ont donc été découvertes pendant la migration. J’ai aussi consacré trop de temps à corriger les erreurs une par une avant de formaliser les vérifications récurrentes. Une fois l’inventaire structuré, il est devenu plus simple de décider quoi porter, remplacer ou retirer.

Des erreurs d'automatisation qui auraient pu être détectées avant la production. Certaines petites anomalies apparues après la bascule concernaient des actions automatisées. Elles n'étaient pas nécessairement visibles en ouvrant une vue ou en exécutant une seule fois un parcours métier. Une automatisation doit être testée avec son événement déclencheur, ses conditions d'entrée, les données qu'elle modifie et les effets qu'elle ne doit pas produire. Ma recette couvrait un grand nombre d'usages, mais elle ne formalisait pas systématiquement toutes ces dimensions pour chaque action. Une matrice de tests associant à chaque automatisation un cas nominal, un cas où elle ne doit pas se déclencher et un contrôle du résultat aurait permis de détecter davantage de ces erreurs avant la mise en production.

Je garderais les étapes intermédiaires et la validation par les métiers. J’ajouterais dès le départ un inventaire des automatisations, des scénarios reproductibles pour les actions planifiées et un relevé de la durée des répétitions. Cela donnerait aux responsables une base plus précise pour décider de la fenêtre de bascule.