Module CRMap FR - Revision history

BRiCK: /* CRMap */

2026-08-22T13:57:27Z

CRMap

← Older revision		Revision as of 13:57, 22 August 2026
Line 3:		Line 3:
	=CRMap=		=CRMap=
	==Présentation==		==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.		'''CRMap''' est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinérant en copilote de tournée<span> </span>: 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)<span> </span>: aucun abonnement à une API tierce payante n'est nécessaire, ni pour la carte ni pour le géocodage.
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
Line 22:		Line 22:
	\|-		\|-
	\|Site de l'éditeur		\|Site de l'éditeur
	\|[https://justbrick.fr ~~https://justbrick.fr]~~		\|https://justbrick.fr
	\|-		\|-
	\|Compatibilité		\|Compatibilité
Line 35:		Line 35:

	==Objectif principal du module==		==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 :		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<span> </span>:

	*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é		*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é
Line 45:		Line 45:
	*conserver l'historique complet des évènements par tiers, directement dans l'agenda natif Dolibarr		*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.		Le module reste fondé à 100 % sur les objets natifs de Dolibarr (tiers, agenda/évènements, catégories, droits utilisateurs)<span> </span>: rien n'est isolé dans une table dédiée, tout reste exploitable par le reste de Dolibarr.

	==Installation==		==Installation==
	===Prérequis===		===Prérequis===

	*Dolibarr 18.0 ou supérieur		*Dolibarr 18.0 ou supérieur
	*PHP 8.1 ou supérieur, extension cURL recommandée (ou <code>allow_url_fopen</code> activé)		*PHP 8.1 ou supérieur, extension cURL recommandée (ou <code>allow_url_fopen</code> activé)
Line 55:		Line 56:

	===Étapes d'installation===		===Étapes d'installation===

	#Décompressez l'archive pour obtenir un dossier <code>crmap/</code>.		#Décompressez l'archive pour obtenir un dossier <code>crmap/</code>.
	#Copiez ce dossier dans <code>htdocs/custom/</code> de votre installation Dolibarr.		#Copiez ce dossier dans <code>htdocs/custom/</code> de votre installation Dolibarr.
	#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.		#Activez le module depuis Accueil → Configuration → Modules/Applications<span> </span>: 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===		===Répertoires de stockage créés===
Line 72:		Line 74:

	==Périmètre fonctionnel détaillé==		==Périmètre fonctionnel détaillé==
	===1. Carte interactive et marqueurs===		===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.		Carte Leaflet plein écran (fond de carte Carto Voyager, OpenStreetMap) avec regroupement automatique des points proches (clustering), coloré selon le pire statut du groupe.

	===2. Logos sur les marqueurs===		===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.		Repli automatique en cascade<span> </span>: 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.

	===3. Statut et paliers de couleur===		===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à ».		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à ».

	===4. Nature du dernier évènement===		===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.		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.

	===5. Filtres et calques===		===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.		Filtres combinables<span> </span>: nature du tiers, statut par ancienneté, nature du dernier évènement, enseigne (basée sur les catégories Dolibarr existantes). Calques activables<span> </span>: 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.

	===6. Fiche détaillée par tiers===		===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.		Directement sur la carte<span> </span>: 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.

	===7. Géocodage automatique===		===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.		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.

	===8. Construction et optimisation de tournée===		===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.		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.

	===9. Confidentialité commerciale===		===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.		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.

	===~~10.~~ Ergonomie mobile===		===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.		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==		==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.		Le module utilise une page de configuration unique (Accueil → Configuration → Modules/Applications → CRMap, onglet Paramètres), organisée en sections<span> </span>: 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==		==Notice intégrée==

BRiCK: Created page with "Category:Modules complémentaires
=CRMap= ==Présentation== '''CRMap''' est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinér..."

2026-08-22T13:56:28Z

Created page with "Category:Modules complémentaires <br /> =CRMap= ==Présentation== '''CRMap''' est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinér..."

New page

[[Category:Modules complémentaires]]
<br />
=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.
{| class="wikitable"
|-
!Élément
!Valeur
|-
|Nom du module
|CRMap
|-
|Version documentée actuelle
|1.9
|-
|Famille
|GRC / Prospection terrain / Cartographie
|-
|Éditeur
|[https://justbrick.fr BRiCK]
|-
|Site de l'éditeur
|[https://justbrick.fr 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 <code>allow_url_fopen</code> activé)
*Accès sortant HTTPS depuis le serveur vers <code>api-adresse.data.gouv.fr</code> (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===
#Décompressez l'archive pour obtenir un dossier <code>crmap/</code>.
#Copiez ce dossier dans <code>htdocs/custom/</code> de votre installation Dolibarr.
#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 <code>img/logos/</code> et <code>img/logos-auto/</code> 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 <code>crmap/</code> 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é==
===1. 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.

===2. 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.

===3. 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à ».

===4. 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.

===5. 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.

===6. 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.

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

===8. 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.

===9. 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.

===10. 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.

Module CRMap FR - Revision history

BRiCK: /* CRMap */

BRiCK: Created page with "Category:Modules complémentaires =CRMap= ==Présentation== '''CRMap''' est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinér..."

BRiCK: Created page with "Category:Modules complémentaires
=CRMap= ==Présentation== '''CRMap''' est un module Dolibarr (éditeur BRiCK) qui transforme le smartphone d'un commercial itinér..."