Architecture Dolibarr : fabrication pour mieux piloter

Dolibarr est un ERP (Enterprise Resource Planning) et CRM (Customer Relationship Management) open‑source très populaire dans le monde des PME et des artisans. Au cœur de sa puissance se trouve une architecture modulaire, pensée pour être à la fois simple à prendre en main et suffisamment extensible pour couvrir des besoins spécifiques, comme celui de la fabrication. Dans cet article, nous allons décortiquer l’architecture de Dolibarr et montrer comment elle peut être mise en œuvre pour piloter plus efficacement les processus de fabrication, de la conception du produit à la livraison finale.

1. Vision d’ensemble de l’architecture Dolibarr

Niveau Élément Rôle Principaux modules liés à la fabrication
Présentation Interface web (HTML/CSS/JS) Interaction utilisateur (navigateur) Dashboard, listes de produits, fiches techniques
Application Core PHP + moteur de plugins Gestion logique métier, workflow, base de données Manufacturing, Stock, Purchase, Sales, Projects
Données SGBD MySQL / MariaDB Stockage persistant (tables, index) Tables pl_products, pl_stock_movements, pl_crafts, pl_orders
Intégration API, hooks, événements Extension, communication externe (ERP, IoT) Webhooks, scripts externes, conecteurs OPC/SCADA
Déploiement Docker, serveur LAMP, VM Scalabilité et isolation Conteneurs Docker, backup, restauration rapide

  • Polarité modulaire : chaque fonctionnalité (ex. : production, stocks, achats) est implémentée comme un module qui peut être activé ou désactivé depuis l’admin.

  • API interne : les méthodes du core sont accessibles via des fonctions PHP ou des hooks, ce qui facilite la création de plugins ou d’intégrations spécifiques.

  • Persistance orientée objet (POO) : les entités (produits, stocks, lots, ordres de travail) sont représentées par des classes (Product, Stock, Craft) qui encapsulent la logique métier.

2. Le module « Fabrication » (Manufacturing)

2.1. Principales entités

Entité Description Relations Exemple d’utilisation
Produit (Product) Fiche centrale du produit fini ou semi‑fini product_main, product_lang, product_price Créer un produit « Chaise en bois » avec son prix de vente
Plan de travail (Work Order) Ordre de fabrication (OF) qui regroupe les étapes craft_orders → plusieurs craft_orders_line OF n° 1023 pour produire 500 pièces de vis
Ressource (Resource) Matériaux, machines, ateliers craft_resources, craft_resource_type Référence à un lot de bois ou à une fraiseuse CNC
Lot (Batch) Gestion de la traçabilité des lots de matière première craft_batches Lot de bois brut n° B20250401
Planification (Planning) Calendrier des OF, affectation des ressources craft_planning Gantt intégré du module Planning

Note : Le module Manufacturing n’est pas activé par défaut ; il se trouve sous le répertoire www/dolibarr/modules/manufacturing. Une fois installé, il expose des écrans spécifiques dans le menu Production.

2.2. Cycle de vie d’une Order Fabrication

  1. Création de l’OF

    • Depuis Production → Ordres de Fabrication → Create a new order.

    • Sélection du produit à fabriquer, quantité souhaitée.

    • Assignation du Batch de matière première (si applicable). 2. Définition des étapes (Operations)

    • Ajout d’opération (ex. : découpe, assemblage, peinture).

    • Chaque opération peut référencer :

      • Machine/Atelier (ressource) – Temps standard (minutage)

      • Outils (ex. : moule, caisse).

    • Les temps standards sont cumulés pour obtenir le temps total prévisionnel.

  2. Génération des consommations

    • Dolibarr calcule, à partir du Bill Of Materials (BOM), la quantité de chaque matière consommée.

    • Les consommations sont enregistrées dans craft_consumptions. – Si le produit a plusieurs BOM (variant de gamme), le système propose un choix dynamique.

  3. Lancement et suivi

    • L’opérateur démarre l’OF via le bouton “Start”.

    • Le temps réel est enregistré (début / fin) et comparé aux prévisions.

    • Les écarts sont visibles dans le tableau Production → Status (Bleu : planifié, Vert : en cours, Rouge : retard). 5. Clôture

    • Après validation de toutes les étapes, l’OF passe à l’état Closed. – La quantité produite est ajoutée automatiquement au stock de produits finis.

    • Des rapports de Coût de production sont générés (voir section 3).

3. Piloter la production avec des indicateurs clés

Dolibarr fournit plusieurs outils de pilotage qui, lorsqu’ils sont combinés avec le module de fabrication, permettent d’obtenir une visibilité complète sur la chaîne de valeur.

Indicateur Où le trouver Méthode de mise à jour Exemple d’utilisation
Taux de remplissage des machines Production → Machines Entrée manuelle ou import CSV depuis un système MES Suivi de la capacité réelle d’une fraiseuse CNC
Temps moyen de cycle (Cycle Time) Rapport Production → OEE (Overall Equipment Effectiveness) Calcul automatique : (Temps réel de production / Temps idéal) x Disponibilité x Qualité Optimiser le paramétrage des paramètres de coupe
Coût unitaire de production Production → Costing Agrégation des consommations et des coûts de main‑d’œuvre Décider du prix de vente ou de la rentabilité d’un nouveau produit
Inventaire tournant (Stock) Stocks → Stocks du produit Mise à jour en temps réel via craft_stock_movements Réduire les ruptures de matières premières critiques
Lead‑time de fabrication Production → Planning Calcul des écarts entre date de début planifiée et réelle Améliorer les dates de livraison client

Astuce : Utilisez les rapports CSV du module Manufacturing pour les exporter vers un outil de BI (Power BI, Grafana) et créer des tableaux de bord interactifs. La plupart des paramètres de ces rapports sont configurables via les hooks de Dolibarr (hookModelPrepare, hookGetTotal, etc.), ce qui permet de filtrer, regrouper ou agréguer les données avant export.

4. Intégrations complémentaires pour un pilotage avancé ### 4.1. IoT et suivi de machine

  • Webhooks : chaque événement craft_order_status_change, craft_operation_start, craft_operation_end déclenche un appel HTTP configurable.

  • Connecteur OPC-UA : plugin disponible dans le dépôt Dolibarr (ou script externe) qui lit les tags de temps de fonctionnement depuis une passerelle OPC-UA et les enregistre dans la table craft_machine_stats. – Alertes : configurer des seuils dans le module Alerts (ex. : dépassement de 80 % du temps prévu) qui envoient des emails ou des SMS via le service de messagerie interne.

4.2. ERP externe (ex. : SAP, Odoo)

  • API REST : Dolibarr expose des routes REST (/dolibarr/api.php/v1/...) qui permettent de synchroniser les Bill Of Materials et les Orders avec un ERP tiers.

  • Mécanisme de Sync bidirectionnel : créez un plugin qui, à chaque clôture d’OF, envoie un payload JSON contenant les consommations et les quantités produites au système partenaire.

4.3. Gestion de la traçabilité (QR code, RFID)

  • QR code produit : le module Product permet d’imprimer un QR code contenant le rowid du produit. Scanné, ce code renvoie directement aux informations de fiche technique et aux historiques de production.

  • Traceability batch : chaque lot de matière première possède son propre QR code. L’opérateur peut le scanner au moment de la consommation pour valider la traçabilité et déclencher un event de mise à jour du stock.

5. Cas pratique : Optimiser la production d’un lot de pièces en série

Contexte

  • Entreprise : Manufacture de petites séries de pièces mécaniques (engrenages, ressorts).

  • Défi : Réduire les temps d’attente entre les étapes d’usinage et de contrôle qualité.

  • Solution Dolibarr

Étape Action mise en place Résultat attendu
1. BOM centralisée Crée un BOM commun pour les trois modèles d’engrenages. Uniformisation des quantités de matière et évite les incohérences.
2. Planning automatisé Utilise le module Planning avec un algorithme de first‑fit qui place les OFs en fonction de la disponibilité des machines. Réduction du temps d’attente de 30 % entre deux opérations.
3. Suivi temps réel Installe des capteurs IoT sur les CNC et configure des webhooks vers Dolibarr. Capture instantanée du OEE (disponibilité, performance, qualité).
4. Alertes de dépassement Crée une alerte « Temps de cycle > 10 min » qui envoie un email au responsable d’atelier. Intervention proactive évitant les retards.
5. Reporting OEE Dashboard PowerBI se connecte à la table craft_machine_stats via un point d’accès SQL. Visibilité instantanée sur la capacité réelle des machines.
6. Amélioration continue Analyse mensuelle des écarts temps‑standard / temps réel → ajustement des temps standards dans le module Manufacturing. Réduction continue du temps moyen de cycle de 5 % par trimestre.

Retour sur investissement : En un an, l’entreprise a diminué ses coûts de production de 7 % et a pu livrer 15 % de pièces supplémentaires sans augmenter les effectifs.

6. Bonnes pratiques pour maximiser le pilotage de la fabrication

  1. Activer le module Manufacturing dès le départ et désactiver les modules inutiles afin de réduire la surcharge de la base de données.

  2. Uniformiser les unités de mesure (mm, kg, pièces) dans les fiches produits pour éviter les incohérences lors de la génération des consommations.

  3. Utiliser les Batches pour la traçabilité – chaque lot de matière première doit être lié à un numéro de lot, ce qui facilite les rappels et audits.

  4. Mettre en place des seuils de réapprovisionnement automatiques (ex. : stock de sécurité = 1,5 × consommation moyenne sur 30 jours).

  5. Personnaliser les champs via le module Object Settings pour ajouter des informations propres à la chaîne de production (ex. : numéro de série de la machine, opérateur responsable).

  6. Documenter les processus directement dans Dolibarr : utilisez les notes libres ou les pièces jointes pour décrire les instructions d’opération (SOP).

  7. Automatiser les tests de régression avec les hooks hookInvoiceAddLine et hookOrderAdd afin que tout changement de paramètres de BOM déclenche une validation avant mise en production.

7. Conclusion

L’architecture de Dolibarr est conçue autour d’une modularité souple et d’une API interne très riche. Lorsqu’on l’active dans le domaine de la fabrication, on obtient :

  • Une centralisation totale des données produit, matière première, ordres de fabrication et stocks.

  • Un pilotage en temps réel grâce aux rapports OEE, au coût de production et aux indicateurs de performance.

  • Une extensibilité qui permet d’intégrer IoT, ERP externes ou tout autre système de suivi de production.

En suivant les bonnes pratiques présentées (organisation des BOM, gestion des batches, alertes OEE, reporting BI), les entreprises peuvent transformer Dolibarr d’un simple ERP comptable en un véritable Centro de Production piloté. La mise en œuvre d’une architecture « fabrication‑orientée » libère le potentiel de Dolibarr : décisions plus rapides, réduction des coûts et amélioration continue de la chaîne de valeur.

En résumé, si votre objectif est de mieux piloter votre processus de fabrication tout en conservant la simplicité et la transparence de Dolibarr, misez sur :
1️⃣ l’activation du module Manufacturing ;
2️⃣ la structuration des BOM et des Work Orders ;
3️⃣ l’utilisation des rapports OEE et des tableaux de bord ;
4️⃣ les intégrations IoT et ERP lorsqu’elles sont pertinentes ; > 5️⃣ la mise en place d’un cycle d’amélioration continue basé sur les données collectées. Vous disposerez ainsi d’un système complet, modulaire et évolutif, capable de répondre aux exigences d’une production moderne et compétitive.

Publications similaires