Module CRMap FR

CRMap

Présentation

CRMap est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinérant en copilote de tournée : une carte interactive de son portefeuille de prospects/clients directement dans Dolibarr, avec suivi des évènements terrain (visites, appels...), géocodage automatique des adresses et optimisation de tournée avec export vers Google Maps. Le module s'appuie exclusivement sur des services cartographiques gratuits (OpenStreetMap, Base Adresse Nationale) : aucun abonnement à une API tierce payante n'est nécessaire, ni pour la carte ni pour le géocodage.

Élément	Valeur
Nom du module	CRMap
Version documentée actuelle	1.9
Famille	GRC / Prospection terrain / Cartographie
Éditeur	BRiCK
Site de l'éditeur	https://justbrick.fr
Compatibilité	Dolibarr 18.0 ou supérieur
Prérequis PHP	PHP 8.1 ou supérieur (extension cURL recommandée)
Licence	GNU GPLv3

Objectif principal du module

Le module est conçu pour permettre à une équipe commerciale itinérante de préparer et réaliser ses tournées terrain directement depuis une carte :

• visualiser en un coup d'œil ses tiers (prospects et clients) sur une carte interactive, colorés selon l'ancienneté du dernier évènement enregistré
• filtrer la carte par nature de tiers, statut, nature du dernier évènement ou enseigne
• géocoder automatiquement par lots les adresses manquantes, sans service tiers payant
• construire une tournée en sélectionnant des points sur la carte, puis en obtenir un ordre de passage optimisé
• exporter cette tournée vers Google Maps en un clic, avec un format d'adresse fiable et configurable
• enregistrer un compte-rendu de visite ou un nouveau contact directement depuis la carte, sans repasser par la fiche tiers classique
• conserver l'historique complet des évènements par tiers, directement dans l'agenda natif Dolibarr

Le module reste fondé à 100 % sur les objets natifs de Dolibarr (tiers, agenda/évènements, catégories, droits utilisateurs) : rien n'est isolé dans une table dédiée, tout reste exploitable par le reste de Dolibarr.

Installation

Prérequis

• Dolibarr 18.0 ou supérieur
• PHP 8.1 ou supérieur, extension cURL recommandée (ou allow_url_fopen activé)
• Accès sortant HTTPS depuis le serveur vers api-adresse.data.gouv.fr (géocodage)
• Un navigateur récent côté utilisateur (la carte charge Leaflet, Leaflet.markercluster, Turf.js et axios depuis un CDN public)

Étapes d'installation

1. Décompressez l'archive pour obtenir un dossier crmap/.
2. Copiez ce dossier dans htdocs/custom/ de votre installation Dolibarr.
3. Activez le module depuis Accueil → Configuration → Modules/Applications : l'activation crée automatiquement les champs complémentaires nécessaires (latitude/longitude sur la fiche tiers, nature d'évènement sur l'agenda), aucune requête SQL manuelle n'est nécessaire.

Répertoires de stockage créés

Le module ne crée aucune table dédiée en base. Il utilise img/logos/ et img/logos-auto/ pour stocker respectivement les logos d'enseigne déposés manuellement et les logos récupérés automatiquement depuis le site web des tiers.

Mise à jour

La mise à jour s'effectue en remplaçant le dossier crmap/ par la nouvelle version (les données existantes ne sont jamais touchées par ce remplacement). Toutes les migrations de données nécessaires se déclenchent automatiquement, sans action de l'utilisateur, dès qu'une page du module est ouverte après la mise à jour. Une désactivation/réactivation du module est recommandée après une mise à jour majeure, pour que Dolibarr resynchronise proprement les libellés et permissions.

Droits et permissions utilisateur

L'accès au module s'appuie entièrement sur les droits natifs Dolibarr de la fiche Tiers (lecture/écriture), sans permission propre à configurer. Un utilisateur sans le droit natif « Voir les tiers non affectés » ne voit sur la carte que les tiers dont il est déclaré commercial, ce qui permet un cloisonnement commercial simple sans réglage supplémentaire.

Menus ajoutés par le module

Le module ajoute une entrée de menu principal « CRMap » donnant accès à la carte interactive. Un lien « Aide » sur la carte ouvre un guide d'utilisation intégré, accessible à tout utilisateur du module (pas seulement aux administrateurs).

Périmètre fonctionnel détaillé

Carte interactive et marqueurs

Carte Leaflet plein écran (fond de carte Carto Voyager, OpenStreetMap) avec regroupement automatique des points proches (clustering), coloré selon le pire statut du groupe.

Logos sur les marqueurs

Repli automatique en cascade : logo d'enseigne envoyé depuis la configuration (upload direct, sans accès SSH/FTP) → à défaut, logo/photo natif déjà présent sur la fiche tiers Dolibarr → à défaut, logo récupéré automatiquement depuis le site web du tiers si l'option est activée (avec filtre qualité) → à défaut, initiale colorée du nom du tiers.

Statut et paliers de couleur

La couleur de chaque marqueur reflète l'ancienneté du dernier évènement enregistré, avec un nombre de paliers entièrement configurable (libellés et couleurs au choix de l'administrateur), encadrés par un palier « aucun évènement » et un palier « au-delà ».

Nature du dernier évènement

Un badge lettre sur chaque marqueur (et sur la fiche détaillée) indique la nature du dernier évènement (visite, appel, email...), indépendamment de la couleur. La liste des natures est entièrement configurable, y compris désactivable.

Filtres et calques

Filtres combinables : nature du tiers, statut par ancienneté, nature du dernier évènement, enseigne (basée sur les catégories Dolibarr existantes). Calques activables : départements, régions, secteurs personnalisés (gérés via un tableau d'administration dédié). Les choix sont mémorisés dans le navigateur d'une session à l'autre.

Fiche détaillée par tiers

Directement sur la carte : statut, badge de nature, téléphone cliquable, section « Évènements » (ajout + historique filtrable) et section « Contacts » (liste des personnes rattachées, ajout d'un nouveau contact), sans quitter la carte.

Géocodage automatique

Géocodage par lots des adresses manquantes via la Base Adresse Nationale (API officielle du gouvernement français, gratuite), interruptible à tout moment. Ne modifie jamais une coordonnée déjà renseignée manuellement.

Construction et optimisation de tournée

Sélection de points sur la carte (lettrés A, B, C... dans l'ordre de sélection), départ/arrivée facultatif avec autocomplétion ou géolocalisation, calcul d'un ordre de passage optimisé (plus proche voisin + amélioration locale 2-opt), export vers Google Maps en un clic. Le format transmis pour chaque étape (adresse du tiers, nom, ou coordonnées GPS) est configurable par l'administrateur.

Confidentialité commerciale

Un utilisateur sans le droit Dolibarr « Voir les tiers non affectés » ne voit que les tiers dont il est déclaré commercial — aucun réglage propre au module, entièrement basé sur les droits natifs.

Ergonomie mobile

Panneau de filtres et de construction de tournée en feuille superposée, zones tactiles agrandies, pensé pour une utilisation à une main entre deux rendez-vous.

Pages de configuration

Le module utilise une page de configuration unique (Accueil → Configuration → Modules/Applications → CRMap, onglet Paramètres), organisée en sections : couleurs des marqueurs et paliers, natures d'évènement, couleurs de fond, secteurs personnalisés, optimisation de tournée (dont le format d'export Google Maps), logos d'enseigne, logos automatiques, et géocodage.

Notice intégrée

Un lien « Aide » sur la carte ouvre un guide d'utilisation non technique intégré au module, décrivant l'ensemble des fonctions et accessible à tout utilisateur, pas seulement aux administrateurs.

Multilingue

L'interface est disponible en français et en anglais.