Module DoliCasta FR

DoliCasta

Présentation

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 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 sur les fonctions natives de Dolibarr : tiers, produits, entrepôts, stocks, lots, nomenclatures, ordres de fabrication et agenda.

Fonctionnalités

Gestion agricole

• 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.

Import TelePAC et cartographie

• 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.

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.

L’export vers TelePAC n’est pas inclus.

Récoltes, stocks et traçabilité

• 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.

Transformation

• 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.

Météo et prise en main

• Consultation de la météo, de l’historique et des statistiques.
• Configuration de la localisation météo avec un droit dédié.
• Collecte météo automatique avec les travaux planifiés Dolibarr correctement configurés.
• Guides Culture et Transformation intégrés.
• Démonstration anonymisée facultative, avec installation et nettoyage depuis la configuration.
• Interface et traductions en français et en anglais.

Prérequis

• 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.

PostgreSQL n’est pas pris en charge par les migrations du module. La compatibilité MySQL n’a pas été validée.

Modules Dolibarr requis

• Tiers.
• Produits.
• Catégories.
• Stocks.
• Lots / numéros de série.
• Agenda.
• Nomenclatures (BOM).
• Ordres de fabrication (MRP).
• Services.

Les dépendances supplémentaires de ces modules sont gérées par Dolibarr.

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

Télécharger le paquet module_dolicasta-1.2.0.zip, puis l’installer depuis :

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

Il est également possible d’extraire manuellement le dossier du module dans :

htdocs/custom/dolicasta/

Activer les dépendances nécessaires, puis le module DoliCasta.

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.

Aucune démonstration, récolte ou opération de stock n’est créée automatiquement.

Configuration

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.

• 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.

L’import et l’annulation TelePAC nécessitent le droit dédié Importer / annuler un import TelePAC ainsi que la lecture des parcelles.

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.

Après modification des permissions, les utilisateurs concernés doivent se déconnecter puis se reconnecter.

Données de démonstration

La configuration propose deux actions réservées à un administrateur interne :

• Installer les données de démonstration.
• Supprimer les données de démonstration.

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.

Mise à jour

Avant toute mise à jour, sauvegarder la base de données, les documents et les sources du module.

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 migrations ne réinitialisent pas les compteurs d’identifiants. La désactivation du module conserve les tables et les documents.

Origine du projet

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.

Cette expérience métier a guidé sa conception, tout en conservant une organisation utilisable dans d’autres activités agricoles.

Licence et prix

Gratuit et open source.

Licence GNU GPL version 3 ou ultérieure.

Auteur et éditeur

• Auteur : Gilles Claret.
• Éditeur : ProAudioGC.

Version et identifiant

• Version : 1.2.0.
• Identifiant du module : 438300.