Aller au contenu
Projets  /  Refonte d'un référentiel de 30 000 établissements

Refonte d'un référentiel de 30 000 établissements

Sortir un référentiel de 30 000 établissements du « tout dans les contacts », et cesser d'écraser l'historique d'un client qui revient.

Odoo 19Modèle de donnéesPythonArchitecture

Le problème

La base Contacts d'Odoo portait à elle seule le référentiel de près de 30 000 établissements de France, de Belgique et du Luxembourg — mais aussi les personnes physiques, les données de prospection, les caractéristiques techniques, l'état des contrats et l'historique des échanges. Tout dans res.partner.

Le symptôme qui a déclenché le chantier : un client qui résilie, puis revient un an plus tard. Fallait-il modifier la fiche existante, et perdre la trace du premier contrat ? En créer une seconde, et scinder l'historique ? Aucune des deux réponses n'était satisfaisante, parce que la question était mal posée — le modèle confondait l'établissement et la relation commerciale.

C'est le cas d'école du référentiel qui grossit sans architecture. Chaque besoin nouveau a ajouté un champ sur le contact, parce que c'était le chemin le plus court. Au bout de quelques années, l'objet porte huit rôles différents et plus personne ne sait lequel fait autorité.

La règle d'architecture

Le module remet chaque information sur l'objet dont elle relève. Une seule règle, tenue jusqu'au bout :

ObjetReprésente
Établissement modèle dédiéce que l'établissement est
Contact res.partnerles personnes et entités juridiques
Piste crm.leadce qu'on essaie de lui vendre
Vente sale.orderce qu'il achète
Projet project.projectcomment on le met en service
Installation modèle dédiéce qui est effectivement en service
Abonnement sale.order récurrentce qui est facturé dans la durée
Communication modèle dédiél'historique transverse

Conséquence directe sur le cas qui bloquait. Le client qui part et revient reste un seul enregistrement, avec deux installations et deux projets de mise en service successifs. Son historique n'est jamais écrasé, et l'on peut enfin répondre à « depuis quand ce client est-il chez nous, et avec quelles interruptions ? ».

Ce que contient le module

  • Un modèle Établissement avec ses onglets Identité, Organisation, Caractéristiques, Mise en œuvre, Installations, Ventes et Communication. Les listes liées y sont en consultation seule : on ne modifie jamais une vente depuis la fiche établissement, ce qui évite deux chemins d'écriture concurrents sur la même donnée.
  • Un modèle Installation : ce qui est en service chez le client sur une période donnée, avec les abonnements actifs qui s'y rattachent.
  • Un modèle Communication : la chronologie consolidée des échanges, tous canaux confondus.
  • Un référentiel technique des logiciels tiers avec lesquels la solution doit s'interfacer — donnée structurante pour l'intégration.

Sortir de Studio

Le point de départ était un prototype construit dans Odoo Studio sur l'instance de recette. Studio est excellent pour éprouver une idée ; il l'est beaucoup moins pour vivre trois ans : les champs y sont créés directement en base sans être versionnés, personne ne peut relire l'ensemble d'un coup d'œil, et une migration de version devient un travail d'archéologie.

La reprise sous forme de module versionné rend le référentiel relisible, testable et migrable. Le dépôt porte la documentation d'architecture à côté du code : la décision et son implémentation ne se séparent pas, et le prochain intervenant — moi ou quelqu'un d'autre — comprend pourquoi avant de comprendre comment.

Compétences mobilisées

DomaineMise en œuvre
Modélisationdécoupage d'un objet fourre-tout en modèles aux responsabilités distinctes
Odoonouveaux modèles, extensions du standard, vues et onglets, listes en lecture seule
Reprise de l'existantpassage d'un prototype Studio à un module versionné, sans perte
Volumétrieréférentiel de l'ordre de 30 000 enregistrements
Transmissiondocumentation d'architecture livrée avec le code

Projet mené pour un éditeur de solutions métier. Odoo 19, Python. Le module, sa documentation et les données restent la propriété du client et ne sont pas diffusés. Pour discuter d'un besoin comparable, écrivez-moi.