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.
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 :
| Objet | Représente |
|---|---|
| Établissement modèle dédié | ce que l'établissement est |
Contact res.partner | les personnes et entités juridiques |
Piste crm.lead | ce qu'on essaie de lui vendre |
Vente sale.order | ce qu'il achète |
Projet project.project | comment on le met en service |
| Installation modèle dédié | ce qui est effectivement en service |
Abonnement sale.order récurrent | ce 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
| Domaine | Mise en œuvre |
|---|---|
| Modélisation | découpage d'un objet fourre-tout en modèles aux responsabilités distinctes |
| Odoo | nouveaux modèles, extensions du standard, vues et onglets, listes en lecture seule |
| Reprise de l'existant | passage d'un prototype Studio à un module versionné, sans perte |
| Volumétrie | référentiel de l'ordre de 30 000 enregistrements |
| Transmission | documentation 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.