Module DoliCasta FR

From Dolibarr ERP CRM Wiki
Revision as of 12:01, 10 October 2026 by Proaudiogc (talk | contribs)
Jump to navigation Jump to search

DoliCasta

Présentation

DoliCasta est un module libre de gestion agricole, de traçabilité et de transformation pour Dolibarr ERP/CRM.

Développé à l'origine pour la castanéiculture en Corse, il permet de suivre l'ensemble du cycle de production agricole, depuis les parcelles et les campagnes jusqu'à la récolte, la constitution des lots, leur stockage et leur transformation.

Le module s'appuie autant que possible sur les fonctions natives de Dolibarr, notamment les produits, les stocks, les lots / numéros de série, les nomenclatures (BOM) et la GPAO / MRP.

Bien qu'initialement conçu pour une exploitation de châtaigniers, DoliCasta peut être utilisé ou adapté à d'autres cultures pérennes et exploitations agricoles.

Principales fonctionnalités

DoliCasta permet notamment de gérer :

  • Exploitations agricoles
  • Campagnes agricoles
  • Îlots et parcelles
  • Cultures et plans de culture
  • Interventions agricoles
  • Machines
  • Produits phytosanitaires
  • Estimation des coûts
  • Récoltes
  • Lots agricoles
  • Traçabilité
  • Stocks natifs Dolibarr
  • Transformation
  • Nomenclatures (BOM)
  • Ordres de fabrication / MRP
  • Lots consommés et lots produits
  • Météo
  • Historique météorologique
  • Statistiques
  • Rapports et documents PDF
  • Interface français / anglais

Organisation générale

DoliCasta organise les informations agricoles autour de plusieurs niveaux.

Exploitation

L'exploitation constitue le niveau principal de regroupement des données agricoles.

Elle permet notamment d'associer les campagnes, les parcelles et les différentes opérations réalisées sur l'exploitation.

Campagnes

Une campagne correspond à une période de production agricole.

Exemple :

CP-2026

Les campagnes permettent de regrouper les informations d'une même saison : cultures, interventions, récoltes, lots et transformations.

Îlots et parcelles

Les parcelles représentent les unités géographiques de production.

Elles peuvent être regroupées en îlots afin de faciliter l'organisation de l'exploitation.

Les parcelles servent notamment de référence pour :

  • les cultures ;
  • les interventions ;
  • les récoltes ;
  • l'historique de production.

Menus du module

Les fonctions de DoliCasta sont accessibles depuis le menu principal du module.

Exploitation

Cette partie regroupe les informations générales de l'exploitation :

  • Exploitations
  • Campagnes
  • Îlots
  • Parcelles

Culture

Le menu Culture permet de gérer le suivi agronomique :

  • Cultures
  • Plans de culture
  • Interventions
  • Produits phytosanitaires
  • Estimation des coûts

Les interventions peuvent être associées à une parcelle, une culture et une campagne.

Machines

Les machines et matériels agricoles peuvent être enregistrés afin de conserver un historique de leur utilisation dans les opérations agricoles.

Récoltes

Les récoltes permettent d'enregistrer les productions issues des différentes parcelles.

Une récolte peut notamment être associée à :

  • une campagne ;
  • une parcelle ;
  • une date ;
  • une quantité récoltée ;
  • un produit.

Les récoltes constituent le point d'entrée de la traçabilité des produits agricoles.

Traçabilité des lots

DoliCasta utilise le système natif de gestion des lots de Dolibarr afin de conserver une traçabilité compatible avec les stocks.

Les lots permettent de suivre le produit depuis sa récolte jusqu'à sa transformation.

Un lot peut être associé à une campagne agricole telle que :

CP-2026

Les mouvements de produits utilisent les fonctions natives de gestion de stock de Dolibarr.

Transformation

La transformation permet de gérer le passage d'un produit agricole brut vers un produit transformé.

Dans le cas de la castanéiculture, un cycle typique peut être :

Châtaignes récoltées
        ↓
Lots de châtaignes
        ↓
Séchage
        ↓
Décorticage
        ↓
Tri
        ↓
Mouture
        ↓
Farine de châtaigne

DoliCasta s'appuie sur les modules Nomenclatures (BOM) et GPAO / MRP de Dolibarr pour gérer les opérations de transformation.

Cela permet de conserver la relation entre :

  • les lots consommés ;
  • les quantités utilisées ;
  • les opérations de fabrication ;
  • les produits obtenus ;
  • les nouveaux lots produits.

La traçabilité peut ainsi être suivie depuis le produit fini jusqu'aux lots agricoles d'origine.

Stocks

DoliCasta utilise le module Stock natif de Dolibarr.

Les produits agricoles et les produits transformés peuvent ainsi bénéficier des fonctions standards de Dolibarr :

  • entrepôts ;
  • mouvements de stock ;
  • inventaires ;
  • lots ;
  • numéros de série ;
  • historique des mouvements.

Cette intégration évite de maintenir un système de stock spécifique au module.

Météo

Le module dispose d'une partie dédiée à la météo.

Elle permet de consulter et de conserver des données météorologiques utiles au suivi de l'exploitation.

Selon la configuration du module, les informations peuvent notamment être exploitées sous forme :

  • de données météorologiques courantes ;
  • d'historique ;
  • de statistiques ;
  • de graphiques.

Ces informations permettent de rapprocher les conditions météorologiques des campagnes, cultures et interventions agricoles.

Rapports et PDF

DoliCasta peut générer différents documents et rapports à partir des informations enregistrées.

Ces documents peuvent notamment être utilisés pour :

  • le suivi d'une campagne ;
  • les récoltes ;
  • les lots ;
  • la traçabilité ;
  • la transformation ;
  • les statistiques de l'exploitation.

Exemple de cycle de travail

Un fonctionnement type peut être le suivant :

  1. Créer l'exploitation.
  2. Créer la campagne, par exemple CP-2026.
  3. Créer les îlots et les parcelles.
  4. Définir les cultures.
  5. Enregistrer les interventions réalisées durant la campagne.
  6. Enregistrer les récoltes.
  7. Créer ou alimenter les lots correspondants.
  8. Stocker les produits récoltés.
  9. Transformer les produits à l'aide des fonctions BOM / MRP.
  10. Enregistrer les lots consommés et produits.
  11. Consulter la traçabilité.
  12. Générer les rapports et documents de campagne.

Prérequis

DoliCasta est actuellement développé pour :

  • Dolibarr 24.x
  • PHP 8.2 ou PHP 8.3

Modules Dolibarr requis

Les modules suivants doivent être activés :

  • Tiers
  • Produits
  • Stocks
  • Lots / numéros de série
  • Nomenclatures (BOM)
  • GPAO / MRP

Le module Services est également recommandé.

Installation

Télécharger le package DoliCasta puis l'installer depuis :

Accueil → Configuration → Modules/Applications
        → Déployer/Installer un module externe

Il est également possible d'effectuer une installation manuelle.

Le dossier du module doit alors être placé dans :

htdocs/custom/dolicasta/

Une fois les fichiers installés :

  1. Se connecter à Dolibarr avec un compte administrateur.
  2. Ouvrir Accueil → Configuration → Modules/Applications.
  3. Rechercher DoliCasta.
  4. Activer le module.

Configuration

Après activation, ouvrir la page de configuration du module DoliCasta.

Cette page vérifie notamment la disponibilité des modules Dolibarr nécessaires au fonctionnement de DoliCasta.

Avant de commencer à utiliser le module, il est recommandé d'activer et de configurer :

  • Produits
  • Stocks
  • Lots / numéros de série
  • Nomenclatures
  • GPAO / MRP

Droits utilisateurs

DoliCasta utilise le système de permissions de Dolibarr.

Les administrateurs peuvent définir les droits des utilisateurs ou groupes d'utilisateurs sur les différentes fonctions du module.

Selon la configuration du module, les droits permettent notamment de contrôler l'accès aux :

  • exploitations ;
  • campagnes ;
  • parcelles ;
  • cultures ;
  • interventions ;
  • récoltes ;
  • opérations de transformation.

Philosophie du module

DoliCasta cherche à compléter Dolibarr plutôt qu'à remplacer ses fonctions natives.

Ainsi :

  • les produits restent des produits Dolibarr ;
  • les stocks restent des stocks Dolibarr ;
  • les lots restent des lots Dolibarr ;
  • la fabrication utilise BOM / MRP ;
  • les utilisateurs et les permissions utilisent le système Dolibarr.

DoliCasta ajoute principalement la couche métier agricole permettant de relier ces éléments aux campagnes, parcelles, cultures et récoltes.

Origine du projet

DoliCasta a été initialement développé pour une exploitation castanéicole située en Corse.

Le besoin initial était de disposer dans Dolibarr d'un outil permettant de suivre :

  • les parcelles de châtaigniers ;
  • les campagnes agricoles ;
  • les interventions ;
  • les récoltes ;
  • les lots ;
  • les stocks ;
  • la transformation des châtaignes ;
  • la production de farine de châtaigne ;
  • la traçabilité complète entre récolte et produit fini.

Le projet a ensuite été conçu de manière suffisamment générique pour pouvoir être adapté à d'autres exploitations agricoles.

Licence

DoliCasta est distribué sous licence :

GNU General Public License version 3 ou ultérieure (GPLv3+).

Éditeur

ProAudioGC

Version

Version actuelle :

1.0.0

Langues

Le module dispose actuellement des traductions :

  • Français
  • Anglais

Développement

DoliCasta est développé comme module externe Dolibarr et respecte autant que possible les API et conventions de développement de Dolibarr.

Les évolutions du module visent notamment à améliorer :

  • la traçabilité agricole ;
  • l'intégration avec les fonctions natives de Dolibarr ;
  • le suivi des campagnes ;
  • la transformation ;
  • les rapports ;
  • l'utilisation sur terminaux mobiles.