|
|
| Line 3: |
Line 3: |
| ==Présentation== | | ==Présentation== |
|
| |
|
| '''DoliCasta''' est un module libre de gestion agricole, de traçabilité et de transformation pour [[Dolibarr ERP/CRM]].
| | DoliCasta est un module gratuit et open source de gestion agricole, de traçabilité et de transformation pour Dolibarr. |
|
| |
|
| 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. | | Développé à l’origine pour la castanéiculture en Corse, il peut également accompagner d’autres activités agricoles nécessitant un suivi par parcelles, campagnes et lots : arboriculture, oléiculture, viticulture et autres cultures pérennes. |
|
| |
|
| 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. | | Le module s’appuie sur les fonctions natives de Dolibarr : tiers, produits, entrepôts, stocks, lots, nomenclatures, ordres de fabrication et agenda. |
|
| |
|
| 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.
| | ==Fonctionnalités== |
|
| |
|
| ==Principales fonctionnalités== | | ===Gestion agricole=== |
|
| |
|
| DoliCasta permet notamment de gérer<span> </span>:
| | * Gestion des exploitations et campagnes agricoles. |
| | * Gestion des îlots et parcelles. |
| | * Gestion des cultures et des plans de culture regroupant une ou plusieurs parcelles. |
| | * Suivi des interventions et des parcelles concernées. |
| | * Gestion des machines et équipements. |
| | * Suivi des produits phytosanitaires. |
| | * Estimation des temps et coûts standards. |
| | * Documents PDF des îlots, parcelles, interventions et récoltes. |
| | * Synchronisation des interventions avec l’agenda Dolibarr. |
|
| |
|
| *Exploitations agricoles
| | ===Import TelePAC et cartographie=== |
| *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==
| | * Import de fichiers XML TelePAC avec aperçu avant confirmation. |
| | * Création ou mise à jour des îlots, parcelles, contours et surfaces. |
| | * Reprise des informations communales et biologiques disponibles dans le fichier. |
| | * Affichage des couches SNA — surfaces non agricoles — et ZDH — zones de densité homogène — lorsqu’elles sont présentes. |
| | * Archivage des fichiers XML sources et journalisation des modifications. |
| | * Annulation du dernier import compatible pour revenir à la campagne précédente. |
|
| |
|
| DoliCasta organise les informations agricoles autour de plusieurs niveaux.
| | L’annulation est soumise à des contrôles de cohérence et nécessite une campagne précédente. Elle est indisponible lorsque le dernier import a créé des îlots ou des parcelles. |
|
| |
|
| ===Exploitation===
| | '''L’export vers TelePAC n’est pas inclus.''' |
|
| |
|
| L'exploitation constitue le niveau principal de regroupement des données agricoles.
| | ===Récoltes, stocks et traçabilité=== |
|
| |
|
| Elle permet notamment d'associer les campagnes, les parcelles et les différentes opérations réalisées sur l'exploitation.
| | * Gestion des récoltes et identification des parcelles d’origine. |
| | * Création et suivi des lots de récolte. |
| | * Mouvements de stock natifs Dolibarr. |
| | * Traçabilité par produit et numéro de lot. |
| | * Remontée des produits transformés vers les récoltes et parcelles d’origine. |
| | * Rapports de traçabilité et documents PDF. |
| | * QR code donnant accès à la fiche de traçabilité, selon les droits de l’utilisateur. |
|
| |
|
| ===Campagnes=== | | ===Transformation=== |
|
| |
|
| Une campagne correspond à une période de production agricole.
| | * Utilisation des nomenclatures (BOM) et ordres de fabrication (MRP). |
| | * Suivi des lots consommés et des produits obtenus. |
| | * Gestion des étapes de transformation et de conditionnement. |
| | * Suivi des quantités et des mouvements de stock associés. |
| | * Documents PDF de transformation. |
|
| |
|
| Exemple<span> </span>:
| | ===Météo et prise en main=== |
|
| |
|
| <pre>
| | * Consultation de la météo, de l’historique et des statistiques. |
| CP-2026
| | * Configuration de la localisation météo avec un droit dédié. |
| </pre>
| | * Collecte météo automatique avec les travaux planifiés Dolibarr correctement configurés. |
| | | * Guides Culture et Transformation intégrés. |
| Les campagnes permettent de regrouper les informations d'une même saison<span> </span>: cultures, interventions, récoltes, lots et transformations.
| | * Démonstration anonymisée facultative, avec installation et nettoyage depuis la configuration. |
| | | * Interface et traductions en français et en anglais. |
| ===Î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<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| *Exploitations
| |
| *Campagnes
| |
| *Îlots
| |
| *Parcelles
| |
| | |
| ===Culture===
| |
| | |
| Le menu Culture permet de gérer le suivi agronomique<span> </span>:
| |
| | |
| *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 à<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| <pre>
| |
| CP-2026
| |
| </pre>
| |
| | |
| 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<span> </span>:
| |
| | |
| <pre>
| |
| Châtaignes récoltées
| |
| ↓
| |
| Lots de châtaignes
| |
| ↓
| |
| Séchage
| |
| ↓
| |
| Décorticage
| |
| ↓
| |
| Tri
| |
| ↓
| |
| Mouture
| |
| ↓
| |
| Farine de châtaigne
| |
| </pre>
| |
| | |
| 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<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| #Créer l'exploitation.
| |
| #Créer la campagne, par exemple '''CP-2026'''.
| |
| #Créer les îlots et les parcelles.
| |
| #Définir les cultures.
| |
| #Enregistrer les interventions réalisées durant la campagne.
| |
| #Enregistrer les récoltes.
| |
| #Créer ou alimenter les lots correspondants.
| |
| #Stocker les produits récoltés.
| |
| #Transformer les produits à l'aide des fonctions BOM / MRP.
| |
| #Enregistrer les lots consommés et produits.
| |
| #Consulter la traçabilité.
| |
| #Générer les rapports et documents de campagne.
| |
|
| |
|
| ==Prérequis== | | ==Prérequis== |
|
| |
|
| DoliCasta est actuellement développé pour<span> </span>:
| | * Dolibarr 24.x ; environnement de référence testé : Dolibarr 24.0.2. |
| | * PHP 8.3 avec les extensions nécessaires à Dolibarr, notamment DOM/XML, JSON, mbstring et cURL. |
| | * MariaDB 10.11 avec tables InnoDB et encodage utf8mb4. |
| | * Répertoire de documents accessible en écriture au serveur web. |
|
| |
|
| *'''Dolibarr 24.x'''
| | PostgreSQL n’est pas pris en charge par les migrations du module. La compatibilité MySQL n’a pas été validée. |
| *'''PHP 8.2 ou PHP 8.3'''
| |
|
| |
|
| ===Modules Dolibarr requis=== | | ===Modules Dolibarr requis=== |
|
| |
|
| Les modules suivants doivent être activés<span> </span>:
| | * Tiers. |
| | * Produits. |
| | * Catégories. |
| | * Stocks. |
| | * Lots / numéros de série. |
| | * Agenda. |
| | * Nomenclatures (BOM). |
| | * Ordres de fabrication (MRP). |
| | * Services. |
|
| |
|
| *Tiers
| | Les dépendances supplémentaires de ces modules sont gérées par Dolibarr. |
| *Produits
| |
| *Stocks
| |
| *Lots / numéros de série
| |
| *Nomenclatures (BOM)
| |
| *GPAO / MRP
| |
|
| |
|
| Le module '''Services''' est également recommandé. | | Le module '''Travaux planifiés''' est facultatif ; il est nécessaire pour automatiser la collecte météo. Les fonctions météo et cartographiques nécessitent un accès internet aux services utilisés. |
|
| |
|
| ==Installation== | | ==Installation== |
|
| |
|
| Télécharger le package DoliCasta puis l'installer depuis<span> </span>: | | Télécharger le paquet '''module_dolicasta-1.2.0.zip''', puis l’installer depuis : |
|
| |
|
| <pre>
| | Accueil → Configuration → Modules/Applications → Déployer un module externe |
| Accueil → Configuration → Modules/Applications | |
| → Déployer/Installer un module externe
| |
| </pre>
| |
|
| |
|
| Il est également possible d'effectuer une installation manuelle. | | Il est également possible d’extraire manuellement le dossier du module dans : |
|
| |
|
| Le dossier du module doit alors être placé dans<span> </span>:
| | htdocs/custom/dolicasta/ |
|
| |
|
| <pre>
| | Activer les dépendances nécessaires, puis le module DoliCasta. |
| htdocs/custom/dolicasta/
| |
| </pre>
| |
|
| |
|
| Une fois les fichiers installés<span> </span>:
| | L’activation initialise les tables, dictionnaires, catégories et produits agricoles standards. Elle active également l’utilisation des unités sur les produits via le paramètre '''PRODUCT_USE_UNITS'''. |
|
| |
|
| #Se connecter à Dolibarr avec un compte administrateur.
| | Aucune démonstration, récolte ou opération de stock n’est créée automatiquement. |
| #Ouvrir '''Accueil → Configuration → Modules/Applications'''.
| |
| #Rechercher '''DoliCasta'''.
| |
| #Activer le module.
| |
|
| |
|
| ==Configuration== | | ==Configuration== |
|
| |
|
| Après activation, ouvrir la page de configuration du module DoliCasta. | | Après activation, ouvrir la page de configuration DoliCasta afin de vérifier les prérequis et de préparer les éléments utilisés par le module. |
| | |
| 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<span> </span>:
| | * Contrôler les modules nécessaires et la section TelePAC. |
| | * Configurer les entrepôts, les produits et la gestion des lots. |
| | * Préparer les services standards complémentaires si nécessaire. |
| | * Définir la localisation météo. |
| | * Attribuer les permissions aux utilisateurs ou groupes. |
|
| |
|
| *Produits
| | L’import et l’annulation TelePAC nécessitent le droit dédié '''Importer / annuler un import TelePAC''' ainsi que la lecture des parcelles. |
| *Stocks
| |
| *Lots / numéros de série
| |
| *Nomenclatures
| |
| *GPAO / MRP
| |
|
| |
|
| ==Droits utilisateurs==
| | La modification de la localisation météo partagée nécessite le droit '''Configurer la localisation météo commune au module''' ou un administrateur interne. |
|
| |
|
| DoliCasta utilise le système de permissions de Dolibarr.
| | Après modification des permissions, les utilisateurs concernés doivent se déconnecter puis se reconnecter. |
|
| |
|
| Les administrateurs peuvent définir les droits des utilisateurs ou groupes d'utilisateurs sur les différentes fonctions du module.
| | ===Données de démonstration=== |
|
| |
|
| Selon la configuration du module, les droits permettent notamment de contrôler l'accès aux<span> </span>:
| | La configuration propose deux actions réservées à un administrateur interne : |
|
| |
|
| *exploitations ; | | * Installer les données de démonstration. |
| *campagnes ;
| | * Supprimer les données de démonstration. |
| *parcelles ;
| |
| *cultures ;
| |
| *interventions ;
| |
| *récoltes ;
| |
| *opérations de transformation. | |
|
| |
|
| ==Philosophie du module==
| | Le scénario utilise des noms et contours fictifs. Son nettoyage concerne uniquement les données répertoriées comme appartenant à la démonstration ; il peut refuser des données modifiées ou utilisées par d’autres objets. |
|
| |
|
| DoliCasta cherche à compléter Dolibarr plutôt qu'à remplacer ses fonctions natives.
| | ==Mise à jour== |
|
| |
|
| Ainsi<span> </span>:
| | Avant toute mise à jour, sauvegarder la base de données, les documents et les sources du module. |
|
| |
|
| *les produits restent des produits Dolibarr ;
| | Remplacer les fichiers, puis suivre les instructions de mise à jour fournies avec la version. Contrôler ensuite les permissions et les principaux parcours métier. |
| *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.
| | Les migrations ne réinitialisent pas les compteurs d’identifiants. La désactivation du module conserve les tables et les documents. |
|
| |
|
| ==Origine du projet== | | ==Origine du projet== |
|
| |
|
| DoliCasta a été initialement développé pour une exploitation castanéicole située en Corse. | | DoliCasta a été initialement développé pour une exploitation castanéicole en Corse, afin de suivre les parcelles de châtaigniers, les récoltes, les lots et leur transformation en farine de châtaigne. |
| | |
| Le besoin initial était de disposer dans Dolibarr d'un outil permettant de suivre<span> </span>:
| |
| | |
| *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<span> </span>:
| |
| | |
| '''GNU General Public License version 3 ou ultérieure (GPLv3+).'''
| |
| | |
| ==Éditeur==
| |
| | |
| '''ProAudioGC'''
| |
| | |
| ==Version==
| |
| | |
| Version actuelle<span> </span>:
| |
|
| |
|
| '''1.0.0'''
| | Cette expérience métier a guidé sa conception, tout en conservant une organisation utilisable dans d’autres activités agricoles. |
|
| |
|
| ==Langues== | | ==Licence et prix== |
|
| |
|
| Le module dispose actuellement des traductions<span> </span>:
| | '''Gratuit et open source.''' |
|
| |
|
| *Français
| | Licence GNU GPL version 3 ou ultérieure. |
| *Anglais
| |
|
| |
|
| ==Développement== | | ==Auteur et éditeur== |
|
| |
|
| DoliCasta est développé comme module externe Dolibarr et respecte autant que possible les API et conventions de développement de Dolibarr.
| | * Auteur : '''Gilles Claret'''. |
| | * Éditeur : '''ProAudioGC'''. |
|
| |
|
| Les évolutions du module visent notamment à améliorer<span> </span>:
| | ==Version et identifiant== |
|
| |
|
| *la traçabilité agricole ; | | * Version : '''1.2.0'''. |
| *l'intégration avec les fonctions natives de Dolibarr ; | | * Identifiant du module : '''438300'''. |
| *le suivi des campagnes ;
| |
| *la transformation ;
| |
| *les rapports ;
| |
| *l'utilisation sur terminaux mobiles.
| |
|
| |
|
| [[Category:Modules complémentaires]] | | [[Category:Modules complémentaires]] |