Module Gestion des véhicules: Difference between revisions

Jump to navigation Jump to search

Module Gestion des véhicules (view source)

Revision as of 09:14, 7 September 2026

14,984 bytes added ,  1 month ago
Documenter QUARTIX QWS v2, ajouter les captures anonymisées et relier les notices EN, IT, DE et ES.
VisualWikitext
(Présentation et guide d'utilisation du module Gestion des véhicules)
 
(Documenter QUARTIX QWS v2, ajouter les captures anonymisées et relier les notices EN, IT, DE et ES.)
Tag: 2017 source edit
 
Line 1: Line 1:
<!-- Titre de page suggéré : Module Gestion des véhicules et engins -->
[[en:Module Vehicle Management]]
<!-- Périmètre documentaire : version 1.0.0, branche main au commit 094fc89. -->
[[it:Modulo Gestione dei veicoli]]
<!-- Images : importer les fichiers JPEG du dossier wiki-1.0.0 en conservant leurs noms. -->
[[de:Modul Fahrzeugverwaltung]]
[[es:Módulo Gestión de vehículos]]
 
'''Gestion des véhicules et engins''' est un module externe pour Dolibarr permettant de centraliser le suivi d'un parc de véhicules routiers, d'utilitaires et d'engins. Il regroupe les caractéristiques du matériel, les affectations des conducteurs, les kilométrages, les consommations, les interventions, les assurances et les contrôles réglementaires.
'''Gestion des véhicules et engins''' est un module externe pour Dolibarr permettant de centraliser le suivi d'un parc de véhicules routiers, d'utilitaires et d'engins. Il regroupe les caractéristiques du matériel, les affectations des conducteurs, les kilométrages, les consommations, les interventions, les assurances et les contrôles réglementaires.


Le module permet également de relier les factures fournisseurs aux interventions et aux contrôles, puis de générer un dossier véhicule réunissant un récapitulatif PDF et une archive des documents associés.
Le module permet également de relier les factures fournisseurs aux interventions et aux contrôles, puis de générer un dossier véhicule réunissant un récapitulatif PDF et une archive des documents associés. L’intégration QUARTIX QWS v2 ajoute les estimations kilométriques, les synthèses d’utilisation, les positions, les trajets et leur visualisation sur carte.
 
Cette page comprend la présentation du module, son installation et sa '''notice d'utilisation illustrée'''. Les captures ont été réalisées les 5 et 7 septembre 2026 sur une instance de démonstration Dolibarr 24 avec Multicompany. Les adresses et plaques d’immatriculation sont floutées. Les valeurs affichées servent uniquement d'exemples ; elles ne constituent ni des réglages recommandés ni des références de consommation. Le thème et la version de Dolibarr peuvent faire varier la présentation.


Cette page comprend la présentation du module, son installation et sa '''notice d'utilisation illustrée'''. Les captures ont été réalisées le 5 septembre 2026 sur une instance de démonstration Dolibarr 24 avec Multicompany. Les valeurs affichées servent uniquement d'exemples ; elles ne constituent ni des réglages recommandés ni des références de consommation. Le thème et la version de Dolibarr peuvent faire varier la présentation.
Documentation actualisée le 7 septembre 2026. Le développement QUARTIX complète la version 1.0.0 ; les anciennes archives portant ce numéro peuvent ne pas l’inclure. Le logiciel fournit le français et l’anglais. Les traductions EN, IT, DE et ES de cette notice ne modifient ni les langues du logiciel ni le catalogue réglementaire français.


__TOC__
__TOC__
Line 182: Line 186:
Les exemples de référence permettent de vérifier le résultat attendu. Sur un parc existant, un changement impliquant la reprise des références doit suivre la procédure de migration proposée par le module.
Les exemples de référence permettent de vérifier le résultat attendu. Sur un parc existant, un changement impliquant la reprise des références doit suivre la procédure de migration proposée par le module.


[[File:LMDBVehicleManagement-1.0.0-15-modeles.jpg|thumb|center|1100px|Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.]]
[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.]]


===Configurer les dépenses des pleins et recharges===
===Configurer les dépenses des pleins et recharges===
Line 234: Line 238:
Le sélecteur de limite règle le nombre de lignes par page. Lorsqu'un partage multientité est actif, la colonne et le filtre '''Environnement''' permettent d'identifier l'entité d'origine.
Le sélecteur de limite règle le nombre de lignes par page. Lorsqu'un partage multientité est actif, la colonne et le filtre '''Environnement''' permettent d'identifier l'entité d'origine.


[[File:LMDBVehicleManagement-1.0.0-01-liste.jpg|thumb|center|1100px|Accès aux rubriques du module et recherche dans le parc de démonstration.]]
[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Accès aux rubriques du module et recherche dans le parc de démonstration.]]


===Créer un véhicule ou un engin===
===Créer un véhicule ou un engin===
Line 254: Line 258:
La fiche présente la référence, le libellé et un badge d'état, puis les caractéristiques techniques et la couverture d'assurance disponible. Les onglets donnent accès aux notes, documents, événements, affectations, kilométrages, consommations, contrôles et historique selon les droits.
La fiche présente la référence, le libellé et un badge d'état, puis les caractéristiques techniques et la couverture d'assurance disponible. Les onglets donnent accès aux notes, documents, événements, affectations, kilométrages, consommations, contrôles et historique selon les droits.


[[File:LMDBVehicleManagement-1.0.0-02-fiche.jpg|thumb|center|1100px|Extrait de la fiche d'un véhicule en service<span> </span>: caractéristiques, capacités et résumé d'assurance.]]
[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Extrait de la fiche d'un véhicule en service<span> </span>: caractéristiques, capacités et résumé d'assurance.]]


{| class="wikitable"
{| class="wikitable"
Line 285: Line 289:
Plusieurs affectations peuvent coexister, mais une seule peut être principale sur une même période. Pour terminer une affectation, ouvrir sa modification avec le crayon et renseigner sa fin et son état. Vérifier le résultat dans le tableau.
Plusieurs affectations peuvent coexister, mais une seule peut être principale sur une même période. Pour terminer une affectation, ouvrir sa modification avec le crayon et renseigner sa fin et son état. Vérifier le résultat dans le tableau.


[[File:LMDBVehicleManagement-1.0.0-04-affectations.jpg|thumb|center|1100px|Liste des affectations<span> </span>: conducteur, période, type, caractère principal et état.]]
[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Liste des affectations<span> </span>: conducteur, période, type, caractère principal et état.]]


===Ajouter ou corriger un relevé kilométrique===
===Ajouter ou corriger un relevé kilométrique===
Line 296: Line 300:
'''Un relevé créé par un plein ou une recharge se corrige depuis la fiche de cette consommation.''' L'icône d'information de la ligne le rappelle. Éviter d'ajouter un second relevé manuel pour corriger la même opération.
'''Un relevé créé par un plein ou une recharge se corrige depuis la fiche de cette consommation.''' L'icône d'information de la ligne le rappelle. Éviter d'ajouter un second relevé manuel pour corriger la même opération.


[[File:LMDBVehicleManagement-1.0.0-05-kilometrage.jpg|thumb|center|1100px|Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.]]
[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.]]


===Enregistrer un plein, une recharge ou un additif===
===Enregistrer un plein, une recharge ou un additif===
Line 323: Line 327:
Les unités restent distinctes<span> </span>: litres, kWh et kilogrammes ne s'additionnent pas. La colonne '''Intervalles exclus''' aide à repérer les intervalles non retenus dans les calculs. Les données de démonstration peuvent produire des pics volontairement atypiques ; elles n'illustrent pas la consommation normale du véhicule.
Les unités restent distinctes<span> </span>: litres, kWh et kilogrammes ne s'additionnent pas. La colonne '''Intervalles exclus''' aide à repérer les intervalles non retenus dans les calculs. Les données de démonstration peuvent produire des pics volontairement atypiques ; elles n'illustrent pas la consommation normale du véhicule.


[[File:LMDBVehicleManagement-1.0.0-07-synthese.jpg|thumb|center|1100px|Synthèse filtrable et premiers graphiques<span> </span>: les valeurs affichées proviennent d'un jeu de données de test.]]
[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Synthèse filtrable et premiers graphiques<span> </span>: les valeurs affichées proviennent d'un jeu de données de test.]]


===Enregistrer une intervention, une panne ou un incident===
===Enregistrer une intervention, une panne ou un incident===
Line 344: Line 348:
Vérifier ensuite la ligne dans '''Objets liés'''. Le lien de référence ouvre la facture. L'action de déliaison retire seulement l'association ; elle ne supprime ni la facture ni l'intervention.
Vérifier ensuite la ligne dans '''Objets liés'''. Le lien de référence ouvre la facture. L'action de déliaison retire seulement l'association ; elle ne supprime ni la facture ni l'intervention.


[[File:LMDBVehicleManagement-1.0.0-13-intervention-facture.jpg|thumb|center|1100px|Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.]]
[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.]]


==Notice — assurances et attestations==
==Notice — assurances et attestations==
Line 361: Line 365:
[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Extrait du formulaire de contrat<span> </span>: assureur, police, période et rattachement des véhicules.]]
[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Extrait du formulaire de contrat<span> </span>: assureur, police, période et rattachement des véhicules.]]


[[File:LMDBVehicleManagement-1.0.0-11-assurance.jpg|thumb|center|1100px|Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.]]
[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.]]


===Déposer et faire contrôler une attestation===
===Déposer et faire contrôler une attestation===
Line 389: Line 393:
Pour un équipement de levage, l'intervalle de VGP doit être choisi après qualification technique. Le formulaire ne doit pas servir à deviner une périodicité. Une information manquante doit être complétée à partir des documents du matériel.
Pour un équipement de levage, l'intervalle de VGP doit être choisi après qualification technique. Le formulaire ne doit pas servir à deviner une périodicité. Une information manquante doit être complétée à partir des documents du matériel.


[[File:LMDBVehicleManagement-1.0.0-09-qualification.jpg|thumb|center|1100px|Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.]]
[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.]]


===Lire l'échéancier===
===Lire l'échéancier===
Line 400: Line 404:
Les badges permettent de distinguer notamment une exigence '''À jour''' d'une exigence '''Échue'''. La date retenue est celle utilisée pour le suivi de l'exigence ; elle doit être lue avec la qualification et les documents correspondants.
Les badges permettent de distinguer notamment une exigence '''À jour''' d'une exigence '''Échue'''. La date retenue est celle utilisée pour le suivi de l'exigence ; elle doit être lue avec la qualification et les documents correspondants.


[[File:LMDBVehicleManagement-1.0.0-08-echeancier.jpg|thumb|center|1100px|Échéancier du parc de démonstration, avec dates retenues et états des exigences.]]
[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Échéancier du parc de démonstration, avec dates retenues et états des exigences.]]


===Enregistrer et valider un contrôle===
===Enregistrer et valider un contrôle===
Line 412: Line 416:
#Après validation, consulter l'exigence et son échéance actualisée.
#Après validation, consulter l'exigence et son échéance actualisée.


[[File:LMDBVehicleManagement-1.0.0-10-controle.jpg|thumb|center|1100px|Création d'un contrôle depuis une exigence<span> </span>: organisme, résultat, référence du procès-verbal et dates.]]
[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Création d'un contrôle depuis une exigence<span> </span>: organisme, résultat, référence du procès-verbal et dates.]]


Un contrôle validé est immuable. Pour corriger une erreur, utiliser l'annulation motivée et le remplacement prévus par le module. Pour une contre-visite, conserver le lien avec le contrôle concerné. Une facture peut être liée ou déliée sans réécrire les données réglementaires validées.
Un contrôle validé est immuable. Pour corriger une erreur, utiliser l'annulation motivée et le remplacement prévus par le module. Pour une contre-visite, conserver le lien avec le contrôle concerné. Une facture peut être liée ou déliée sans réécrire les données réglementaires validées.
Line 434: Line 438:
[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Bloc documentaire de la fiche<span> </span>: sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.]]
[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Bloc documentaire de la fiche<span> </span>: sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.]]


[[File:LMDBVehicleManagement-1.0.0-19-apercu-pdf.jpg|thumb|center|793px|Extrait de la première page d'un dossier PDF existant<span> </span>: identification et caractéristiques du véhicule.]]
[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Extrait de la première page d'un dossier PDF existant<span> </span>: identification et caractéristiques du véhicule.]]


Pour actualiser le dossier, relancer '''Générer'''. Les fichiers réservés au dossier ne doivent pas être remplacés manuellement. Les justificatifs des consommations et de leurs opérations diverses ne sont pas inclus dans l'archive. Les droits de lecture du véhicule et des factures fournisseurs restent requis pour consulter le dossier.
Pour actualiser le dossier, relancer '''Générer'''. Les fichiers réservés au dossier ne doivent pas être remplacés manuellement. Les justificatifs des consommations et de leurs opérations diverses ne sont pas inclus dans l'archive. Les droits de lecture du véhicule et des factures fournisseurs restent requis pour consulter le dossier.
Line 447: Line 451:
L'onglet '''Événements/Agenda''' présente les événements Agenda liés à l'objet. L'onglet '''Historique''' rassemble la chronologie métier disponible. Les deux vues répondent à des usages complémentaires.
L'onglet '''Événements/Agenda''' présente les événements Agenda liés à l'objet. L'onglet '''Historique''' rassemble la chronologie métier disponible. Les deux vues répondent à des usages complémentaires.


[[File:LMDBVehicleManagement-1.0.0-17-historique.jpg|thumb|center|1100px|Chronologie consolidée<span> </span>: interventions, relevés, consommations, assurances et affectations.]]
[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Chronologie consolidée<span> </span>: interventions, relevés, consommations, assurances et affectations.]]


===Importer ou exporter===
===Importer ou exporter===
Line 454: Line 458:


L'import des consommations est refusé lorsque la création d'opérations diverses est active. Un prix d'additif absent doit rester une cellule vide ; un zéro doit être conservé comme zéro.
L'import des consommations est refusé lorsque la création d'opérations diverses est active. Un prix d'additif absent doit rester une cellule vide ; un zéro doit être conservé comme zéro.
== Intégration de l’API QUARTIX ==
L’intégration utilise '''QUARTIX QWS v2''' en lecture seule pour compléter le suivi du parc. Elle récupère les estimations kilométriques, la dernière position, les synthèses d’utilisation et le journal des trajets. Les tracés sont chargés à la demande. Elle ne modifie ni le compte QUARTIX, ni les affectations de conducteurs dans Dolibarr.
=== Prérequis et droits ===
* Disposer d’un accès QWS fourni par QUARTIX, avec le code client, le login, le mot de passe et le '''nom d’application (APPLICATION NAME)'''. Faire confirmer l’accès aux données souhaitées, notamment aux tracés.
* Utiliser une distribution du module contenant cette intégration. Le développement décrit au 7 septembre 2026 complète la version 1.0.0 ; le numéro 1.0.0 seul ne garantit pas sa présence dans une ancienne archive.
* Vérifier dans '''Compatibilité''' la disponibilité de cURL, OpenSSL et du chiffrement natif avec la clé d’instance Dolibarr. La carte utilise le composant Leaflet fourni par Dolibarr.
* Activer les '''Travaux planifiés''' et leur exécution effective sur le serveur pour automatiser les imports.
* Attribuer explicitement les droits nécessaires : lecture des véhicules, consultation des positions GPS et synchronisation QUARTIX sont distinctes. L’utilisateur interne qui exécute les travaux doit aussi pouvoir gérer les relevés kilométriques. Le droit de synchronisation ne donne pas accès au GPS.
Les réglages et associations sont administrés dans l’environnement propriétaire. Les utilisateurs externes n’accèdent pas aux fonctions QUARTIX. Un véhicule partagé reste synchronisé par son propriétaire ; la consultation depuis une autre entité respecte les partages et les droits.
=== Configurer la connexion ===
# Après déploiement, désactiver puis réactiver le module pour enregistrer les tables, droits et travaux nécessaires. Les réglages existants sont conservés.
# Ouvrir la roue dentée du module, puis l’onglet '''QUARTIX'''.
# Saisir le code client, le login, le mot de passe et recopier exactement l’'''APPLICATION NAME''' fourni par QUARTIX. Un mot de passe laissé vide conserve celui enregistré.
# Confirmer l’'''interprétation des horodatages'''. Le mode '''Convention QWS''' respecte le décalage horaire explicite lorsqu’il est fourni et utilise sinon l’heure locale du véhicule. Les autres modes ne doivent être utilisés qu’après confirmation de la convention du compte.
# Confirmer auprès de QUARTIX l’unité des durées. Tant qu’elle n’est pas confirmée dans les réglages, les durées restent indisponibles ; elles ne sont pas transformées en zéros.
# Définir la '''Conservation des trajets (jours)''' selon le besoin. La valeur initiale est de 30 jours lorsqu’aucun réglage n’existe.
# Cliquer sur '''Enregistrer''', puis sur '''Tester la connexion et charger les véhicules'''. Le catalogue reçu permet d’associer les véhicules.
# Activer '''Synchronisation QUARTIX''' après configuration et vérifier les quatre travaux planifiés décrits ci-dessous.
Les identifiants et jetons sont propres à chaque environnement. Le mot de passe enregistré n’est pas réaffiché. Une modification des identifiants renouvelle l’authentification de l’environnement concerné.
=== Associer un véhicule et gérer un boîtier ===
# Depuis les réglages QUARTIX, sélectionner le véhicule Dolibarr puis son véhicule dans le catalogue QUARTIX.
# Confirmer son '''fuseau IANA''' et la '''date et heure réelles d’installation du boîtier''' sur ce véhicule. Le début de journée est issu du paramétrage QUARTIX.
# Enregistrer l’association, puis contrôler les premières valeurs dans l’onglet '''Utilisation QUARTIX''' de la fiche véhicule.
La date d’installation borne les nouveaux imports : aucune position ni estimation antérieure n’est importée ; les synthèses commencent à la première journée QUARTIX complète après installation. Les anciennes associations migrées sans date restent sans date inventée. Après modification du fuseau ou du début de journée dans QUARTIX, revoir l’association avant de reprendre les imports.
L’interrupteur de la ligne permet de '''suspendre''' puis de réactiver une association. L’action '''Dissocier''' propose deux cas à distinguer :
* '''Réaffectation du boîtier''' : conserver les imports de l’ancien véhicule avant d’associer le boîtier à un autre véhicule. Les tracés déjà chargés restent consultables jusqu’à expiration ; les nouvelles demandes de l’ancienne association sont arrêtées.
* '''Association erronée''' : supprimer définitivement les trajets, synthèses et estimations QUARTIX du véhicule. Lire la confirmation avant de valider.
Dans les deux cas, la dernière position est effacée et le boîtier redevient disponible. Les relevés manuels et ceux des pleins/recharges sont conservés. Une nouvelle association ne doit pas chevaucher des journées dont l’historique a été conservé sur le même véhicule.
=== Activer les quatre travaux planifiés ===
Les tâches sont installées '''désactivées''', avec une fréquence initiale de quinze minutes. Ouvrir les '''Travaux planifiés QUARTIX''' depuis les réglages, vérifier l’utilisateur d’exécution, activer les tâches puis contrôler leur dernier résultat.
{| class="wikitable"
! Travail !! Rôle
|-
| QUARTIX — dernières positions || Actualiser la dernière position, par lots de véhicules.
|-
| QUARTIX — kilométrage quotidien || Importer les estimations kilométriques, avec traitement quotidien des véhicules.
|-
| QUARTIX — utilisation et reprise historique || Importer les journées terminées et reprendre progressivement l’historique d’utilisation.
|-
| QUARTIX — journal des trajets || Relire la journée courante et les journées ouvertes, compléter l’historique, traiter les demandes de tracés et purger les trajets expirés.
|}
La fréquence de réveil n’est pas une garantie de mise à jour de toute la flotte en quinze minutes. Les lots, la taille du parc, le temps de réponse et les quotas QUARTIX influencent le délai réel. Une limitation de quota ou une indisponibilité applique un délai de reprise commun à l’environnement. Éviter de multiplier les tests de connexion pendant ce délai.
=== Lire les données du véhicule et le tableau de bord ===
L’onglet '''Utilisation QUARTIX''' du véhicule regroupe l’état de l’association et les informations importées accessibles. Le menu '''Tableau de bord''' donne une synthèse du parc avec filtres, indicateurs et graphiques natifs Dolibarr.
* '''Kilométrage''' : les valeurs importées sont des estimations QUARTIX, identifiées comme telles. Elles ne remplacent pas les relevés réels ni ceux des consommations. Une contradiction avec les relevés réels est signalée ; elle ne bloque pas leur saisie ou correction.
* '''Dernière position''' : elle nécessite le droit GPS. Vérifier sa date ; une position ancienne ne prouve ni une panne ni une immobilisation.
* '''Utilisation''' : distances, nombre de trajets, journées actives et couverture des journées renseignées. Les synthèses quotidiennes sont conservées douze mois. La journée en cours n’entre pas dans les synthèses terminées.
* '''Données manquantes''' : une journée inconnue est distinguée d’une journée renseignée sans activité. Les totaux ne portent que sur les journées renseignées.
* '''Tableau de bord''' : la période initiale couvre les trente journées terminées précédentes. Les totaux et l’évolution portent sur toute la sélection ; la comparaison par véhicule présente les vingt distances les plus élevées. Les lieux et liens GPS sont absents sans le droit correspondant.
L’affichage des données déjà importées ne déclenche pas de nouvel appel QWS. Les consommations restent calculées à partir de leurs relevés réels.
[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Synthèse quotidienne QUARTIX : couverture des journées, distances et nombre de trajets. Les durées restent indisponibles tant que leur unité n’est pas confirmée.]]
=== Consulter le journal des trajets ===
# Ouvrir l’onglet '''Trajets''' du véhicule avec le droit GPS.
# Choisir la période, initialement les sept derniers jours, puis appliquer les filtres utiles et lancer la recherche.
# Lire les départs, arrivées, distances et états. Utiliser les tris, la pagination et le sélecteur de colonnes pour adapter l’affichage.
# Vérifier la couverture des journées et la dernière synchronisation avant de conclure à l’absence de trajet.
Les horaires affichés suivent le fuseau de la session Dolibarr ; la journée de rattachement conserve le découpage QUARTIX du véhicule. Une arrivée provisoire n’est pas présentée comme une arrivée définitive.
'''Les trajets privés sont protégés.''' Seuls le jour et les distances sont conservés dans leur résumé : pas d’adresse, de coordonnées, d’horaire précis, de durée ou de tracé. La même protection s’applique lorsque les indications nécessaires de confidentialité manquent.
[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|Journal QUARTIX avec filtres de période et états des trajets. Les adresses sont floutées.]]
=== Afficher le tracé sur la carte ===
# Dans les réglages QUARTIX de l’environnement propriétaire, activer '''Consultation des tracés QUARTIX''' après vérification de l’accès QWS correspondant.
# Dans le journal, cliquer sur le pictogramme '''Voir le tracé''' d’un trajet non privé.
# Le dialogue affiche le tracé en cache ou déclenche son chargement si nécessaire. Le bouton '''Charger / actualiser le tracé''' permet une nouvelle demande lorsque le délai autorisé est écoulé.
# Pour un véhicule partagé, une demande non disponible attend le passage du travail '''Journal des trajets''' de l’environnement propriétaire.
La modale utilise le dialogue natif Dolibarr, sans historique de navigation ni barre de débogage intégrés. Les informations et avertissements restent affichés dans des blocs d’alerte ; ce ne sont pas des notifications éphémères.
La carte relie les points transmis par QUARTIX ; '''elle ne recalcule pas un itinéraire routier'''. Un trajet terminé dispose de marqueurs de départ et d’arrivée. La note '''Trajet en cours''' et l’absence d’arrivée définitive concernent uniquement les trajets encore ouverts. Un tracé absent ou comportant moins de deux points est signalé comme indisponible.
Un tracé terminé déjà en cache ne provoque pas de nouvel appel QUARTIX. Les nouvelles tentatives d’une même journée sont espacées d’au moins quinze minutes, sous réserve des quotas. La vérification périodique du dialogue relit le cache et les autorisations ; elle n’est pas un suivi GPS en direct.
Le fond de carte utilise OpenStreetMap par défaut, sans clé API, avec attribution visible. Un autre fournisseur peut être configuré par URL HTTPS et attribution. Le navigateur demande les tuiles de la zone affichée au fournisseur, sans lui envoyer les secrets QUARTIX. Une panne du fond de carte est signalée séparément d’une indisponibilité du tracé.
[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Tracé d’un trajet terminé dans la modale native, avec messages persistants. L’immatriculation et le fond de carte sont floutés pour protéger les lieux ; l’attribution cartographique est conservée.]]
=== Conservation et confidentialité ===
Les trajets et leurs tracés suivent la même durée de conservation. Réduire cette durée masque immédiatement les journées expirées ; le travail du journal supprime ensuite leurs données par lots. Augmenter la durée permet une reprise progressive des journées encore disponibles chez QUARTIX.
La purge du journal reste active lorsque seule la synchronisation est suspendue, à condition que le module et le travail '''Journal des trajets''' restent actifs. Désactiver le module ou ce travail arrête la purge. Les synthèses d’utilisation gardent leur conservation distincte de douze mois.
Les tracés en cache sont chiffrés. Un trajet reclassé privé ou devenu incompatible avec le journal ne doit plus afficher son ancien tracé. Les positions et parcours GPS ne sont pas exposés dans les documents, exports ou API du module. Aucun conducteur, score d’écoconduite ou détail de vitesse n’est importé par cette intégration.
=== Diagnostic QUARTIX ===
{| class="wikitable"
! Situation !! Vérification ou action
|-
| Le test de connexion échoue || Enregistrer tous les champs, notamment APPLICATION NAME. Relever l’étape et le statut HTTP affichés, sans diffuser les identifiants ni les réponses API brutes.
|-
| Les données n’arrivent pas || Vérifier l’association active, la synchronisation, la date d’installation, les droits du compte d’exécution et les quatre travaux planifiés. Une reprise historique demande plusieurs passages.
|-
| Les durées sont indisponibles || Faire confirmer leur unité auprès de QUARTIX puis la renseigner dans les réglages.
|-
| Le pictogramme de tracé manque || Vérifier le droit GPS, l’activation des tracés, la confidentialité du trajet et la durée de conservation.
|-
| La demande reste en attente || Vérifier le travail du journal et la synchronisation dans l’environnement propriétaire, ainsi que les délais de reprise.
|-
| La carte reste vide || Lire le message persistant : tracé absent/incomplet, session expirée, accès retiré ou fond de carte indisponible sont des situations différentes. Après mise à jour du module, recharger la page.
|-
| Les valeurs diffèrent de QUARTIX || Comparer le même véhicule, la même journée, le fuseau, le début de journée, la couverture et la date de synchronisation. Distinguer estimation kilométrique et relevé réel.
|}


==Questions fréquentes==
==Questions fréquentes==
Line 488: Line 625:
*vérifier les modèles documentaires et les travaux planifiés ;
*vérifier les modèles documentaires et les travaux planifiés ;
*régénérer les dossiers existants pour bénéficier de leur présentation finale ;
*régénérer les dossiers existants pour bénéficier de leur présentation finale ;
*vérifier les paramètres bancaires avant d'activer la création d'opérations diverses.
*vérifier les paramètres bancaires avant d'activer la création d'opérations diverses ;
*pour QUARTIX, enregistrer les accès, confirmer unités et fuseaux, associer les véhicules et activer les quatre travaux décrits ci-dessus.


Les nouveaux libellés Agenda s'appliquent aux événements futurs. Les historiques et contrôles validés ne sont pas réécrits.
Les nouveaux libellés Agenda s'appliquent aux événements futurs. Les historiques et contrôles validés ne sont pas réécrits.
Line 498: Line 636:
*La gestion commerciale des factures d'achat reste assurée par le module natif Factures fournisseurs.
*La gestion commerciale des factures d'achat reste assurée par le module natif Factures fournisseurs.
*Les rappels périodiques nécessitent une configuration opérationnelle des travaux planifiés et de l'envoi d'emails Dolibarr.
*Les rappels périodiques nécessitent une configuration opérationnelle des travaux planifiés et de l'envoi d'emails Dolibarr.
*L’export des tracés QUARTIX, les scores d’écoconduite et la modification automatique des affectations ne sont pas proposés.


==Sources et liens utiles==
==Sources et liens utiles==


*[https://github.com/mapiolca/lmdbvehiclemanagement Code source du module]
*[https://github.com/mapiolca/lmdbvehiclemanagement Code source du module]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentation de référence de la version présentée]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentation initiale de la version 1.0.0]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historique de la version 1.0.0]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historique de la version 1.0.0]
*[https://github.com/mapiolca Profil de l'auteur]
*[https://github.com/mapiolca Profil de l'auteur]
Mapiolca
82

edits

Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/67223"

Navigation menu