3
edits
Module CRMap FR: Difference between revisions
m
→CRMap
(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...") Tag: 2017 source edit |
m (→CRMap) |
||
| 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 | ||
|- | |- | ||
|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é== | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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à ». | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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. | ||
=== | ===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== | ||