Module Garage-atelier-réparation

ServiceGarage

Présentation

ServiceGarage est un module Dolibarr dédié aux ateliers de réparation automobile et deux-roues. Il étend Dolibarr avec des ordres de réparation, un planning d'atelier, la gestion des techniciens, le décodage VIN, des parcours de signature client, des pages de capture photo, des sorties PDF orientées véhicule et des outils de synchronisation avec les documents commerciaux natifs de Dolibarr. Un terminal de signature électronique KSIDol (appareil tactile, horodaté et archivé) est également disponible et compatible avec tous les modules KSIDol.

Élément	Valeur
Nom du module	ServiceGarage
Version documentée actuelle	24.0.0
Famille	CRM / Atelier / Service après-vente
Éditeur	KSIDol.io
Site de l'éditeur	https://www.ksidol.io
Compatibilité	Dolibarr 18.0 ou supérieur
Prérequis PHP	PHP 7.4 ou supérieur
Licence	GNU GPLv3

Liens officiels

• Vidéo de démonstration : ServiceGarage — démo (YouTube)
• Boutique : ksidol.io

• Page éditeur K.S.I sur DoliStore : Modules K.S.I sur DoliStore

Objectif principal du module

Le module est conçu pour permettre à un atelier de gérer l'ensemble du flux de service autour d'un véhicule ou d'un dossier d'équipement :

• créer et gérer des ordres de réparation
• enregistrer les données du véhicule telles que l'immatriculation, le VIN, la marque, le modèle, la version, le kilométrage et la date de première mise en circulation
• affecter un technicien et un créneau de planning
• gérer les disponibilités de l'atelier et les périodes de blocage des techniciens
• synchroniser les informations du véhicule vers les propositions, commandes clients, factures et interventions
• recueillir les signatures client depuis une page publique
• publier les conditions générales et des pages d'envoi de photos
• gérer les dossiers RAN, les équipements, les utilisateurs d'équipements et les matériels
• rechercher des ordres de réparation par référence, immatriculation, VIN, marque ou modèle

Installation

Prérequis

• Une installation Dolibarr fonctionnelle
• Dolibarr 18.0+
• PHP 7.4+
• Droits d'écriture sur l'espace de stockage `documents/servicegarage/`

Étapes d'installation

1. Décompressez le paquet de façon à obtenir un unique dossier `servicegarage/` à la racine de l'archive.
2. Copiez le dossier dans `htdocs/custom/` de votre installation Dolibarr.
3. Vérifiez les permissions du système de fichiers pour les répertoires de documents du module.
4. Allez dans Accueil -> Configuration -> Modules/Applications.
5. Activez le module ServiceGarage.

Répertoires de stockage créés

Le module crée et utilise des dossiers de données dédiés sous la racine des données Dolibarr :

• `servicegarage/`
• `servicegarage/documents/`
• `servicegarage/documents/temp/`

Mise à jour

Pour mettre à jour le module en toute sécurité :

1. Sauvegardez la base de données.
2. Sauvegardez le dossier `documents/servicegarage/`.
3. Remplacez les fichiers dans `htdocs/custom/servicegarage/`.
4. Dans Dolibarr, désactivez puis réactivez le module afin que les vérifications de schéma et les migrations s'exécutent.

Droits et permissions utilisateur

Le module déclare des droits dédiés pour :

• lire, créer, modifier et supprimer les ordres de réparation
• accéder au planning d'atelier
• configurer les techniciens
• accéder à la configuration du module
• lire, écrire et supprimer les RAN
• lire, écrire et supprimer les équipements
• lire, écrire et supprimer les utilisateurs d'équipements
• lire, écrire et supprimer les matériels
• outils de création en masse

En pratique, les administrateurs accordent généralement au moins :

• lecture/écriture des ordres de réparation
• planning
• configuration pour les responsables d'atelier
• droits sur les modules documents (propositions, commandes, factures et interventions) lorsque la synchronisation est nécessaire

Menus ajoutés par le module

Le module ajoute un menu principal et plusieurs menus de gauche :

• Liste des ordres de réparation
• Nouvel ordre de réparation
• Planning
• Liste des RAN et nouveau RAN
• Liste des équipements
• Utilisateurs d'équipements
• Liste des matériels
• Liste des véhicules par client
• Ordres de réparation du client
• Suivi des signatures
• Liste des techniciens
• Administration des techniciens
• Disponibilités des techniciens
• Configuration
• Catégories de véhicules
• Dictionnaires
• Journaux de signature
• Documents techniques

Il expose également des raccourcis vers les zones natives de Dolibarr pour :

• les propositions
• les commandes clients
• les factures
• les interventions

Périmètre fonctionnel détaillé

1. Ordres de réparation

Les ordres de réparation sont l'objet central du module. Un ordre de réparation peut enregistrer des informations d'atelier et de véhicule telles que :

• référence de l'ordre de réparation
• tiers
• numéro d'immatriculation
• VIN / numéro de série
• marque, modèle, version et type du véhicule
• kilométrage
• date d'ouverture
• dates de début et de fin planifiées
• technicien affecté
• statut
• documents commerciaux liés

L'ordre de réparation est l'enregistrement source utilisé pour alimenter les données du véhicule dans les autres documents Dolibarr.

2. Planning d'atelier

L'écran de planning offre une vue calendrier des ordres de réparation programmés. Il sert à :

• créer un ordre de réparation à partir d'une plage horaire sélectionnée
• déplacer une intervention dans le calendrier
• déprogrammer un rendez-vous
• filtrer par statut ou par technicien
• visualiser l'historique client, la couleur du technicien et les périodes bloquées
• détecter les conflits de techniciens et les créneaux indisponibles
• proposer des créneaux alternatifs ou d'autres techniciens disponibles

3. Gestion des techniciens

Le module contient des outils dédiés à la gestion des techniciens :

• annuaire des techniciens
• création et mise à jour des techniciens
• blocages de disponibilité des techniciens
• prévention des conflits dans le planning
• paramètres facultatifs de synchronisation Google Agenda par technicien

4. Synchronisation des documents

L'une des fonctions les plus utiles est la synchronisation des informations véhicule depuis un ordre de réparation vers les objets natifs de Dolibarr.

Les cibles prises en charge incluent :

• les propositions
• les commandes clients
• les factures
• les interventions

Le module peut :

• afficher un sélecteur d'import avec les ordres de réparation récents du même tiers
• injecter les extrafields véhicule dans les fiches de documents prises en charge
• conserver des instantanés des données synchronisées
• mettre à jour les informations liées lorsque les liens changent
• réutiliser les données de l'ordre de réparation sans ressaisir manuellement les métadonnées du véhicule

5. Parcours de signature publique

Le module fournit une page de signature publique qui peut être envoyée au client sans nécessiter de connexion Dolibarr.

Ce parcours comprend :

• un lien de signature sécurisé
• un QR code pour ouvrir la page sur un appareil mobile
• un récapitulatif de l'ordre de réparation
• la saisie du nom du signataire
• l'acceptation des conditions générales
• un pavé de signature au doigt ou à la souris
• des journaux de signature avec IP, type d'appareil et horodatage
• une page de confirmation après la signature

6. Capture photo publique

Le module fournit également une page photo publique pour un dossier. Elle permet au personnel de l'atelier ou aux clients de :

• ouvrir une page publique dédiée
• prendre ou envoyer plusieurs images depuis un téléphone ou une tablette
• transférer les photos dans le dossier client
• consulter une galerie simple liée au dossier

7. Décodage VIN

L'onglet de configuration VIN permet à l'atelier de configurer un fournisseur de décodage VIN.

Fournisseurs pris en charge dans la base de code actuelle :

• VPIC
• carVertical
• Autorigin

Le module peut enregistrer les URLs des fournisseurs et les clés d'API, et propose un formulaire de test VIN dans la page de configuration.

8. Gestion des RAN

Le module contient un domaine RAN dédié. Dans l'implémentation actuelle, un RAN agit comme un fichier tiers unique centralisant les éléments de service après-vente associés.

Points principaux :

• un RAN par tiers
• cas d'usage client et fournisseur
• historique des statuts
• relations SAV / ordres de réparation liées
• outils de déduplication
• outils de synchronisation
• nettoyage des liens orphelins et diagnostics

9. Équipements, utilisateurs d'équipements et matériels

Au-delà des ordres de réparation de véhicules, le module gère également :

• les fiches d'équipements
• les utilisateurs d'équipements
• les matériels

Cela élargit le périmètre du module vers des flux de suivi du parc ou des actifs de l'atelier.

Pages de configuration

Onglet Général

L'onglet général inclut la configuration pour :

• le repli d'utilisation CDN pour les ressources du planning
• l'activation ou la désactivation du sélecteur d'import d'ordre de réparation
• le délai de planning par défaut en jours
• les règles de synchronisation du statut des documents
• les outils de réparation des menus
• le raccourci de diagnostic de la base de données
• les outils de déduplication et de synchronisation RAN

Onglet Catégories

Cet onglet gère les catégories de véhicules visibles dans les ordres de réparation.

Page Dictionnaires

La page des dictionnaires sert à gérer :

• les marques
• les modèles
• les versions
• les types
• les catégories
• les modèles par défaut

Onglet VIN

Cet onglet gère :

• le fournisseur VIN sélectionné
• l'URL de l'API du fournisseur
• la clé d'API du fournisseur si nécessaire
• le test de recherche VIN en direct

Onglet Signature

Cet onglet gère :

• l'activation de la fonction de signature
• la validation obligatoire en deuxième étape
• le rôle du signataire
• l'accès aux journaux de signature
• l'accès au suivi des signatures

Onglet Extrafields

Cet onglet est dédié aux extrafields véhicule propagés vers les documents Dolibarr. Il permet aux administrateurs de :

• désactiver les extrafields véhicule sur les fiches
• désactiver les extrafields véhicule sur les PDF
• configurer quels champs apparaissent sur chaque type de document pris en charge

Onglet Voix

Le code de configuration contient également des options de transcription vocale. Les paramètres actuels incluent :

• le mode de reconnaissance vocale du navigateur
• la configuration de la reconnaissance vocale Google
• la configuration de la transcription OpenAI
• les paramètres de langue et de prompt
• des actions de test dans la configuration

Intégration de la recherche

Le module enregistre une entrée de moteur de recherche pour les ordres de réparation. Les champs recherchables incluent :

• la référence de l'ordre de réparation
• le numéro d'immatriculation
• le VIN / numéro de série
• la marque
• le modèle

Notes techniques et d'intégration

Le code actuel du module enregistre :

• des hooks sur les fiches et listes de documents commerciaux
• une interface de triggers dédiée
• des ressources CSS et JavaScript
• des utilitaires d'installation et de mise à jour du schéma SQL
• des tables de stockage d'instantanés pour les charges utiles de documents synchronisés

Flux de travail type

1. Créez un ordre de réparation pour un véhicule client.
2. Renseignez les données du véhicule et les notes d'atelier.
3. Affectez un technicien et un créneau de planning.
4. Générez ou liez les documents commerciaux associés.
5. Importez les informations du véhicule dans les propositions, commandes, factures ou interventions si nécessaire.
6. Envoyez le lien de signature client ou le QR code.
7. Collectez éventuellement les photos du dossier.
8. Suivez les signatures et les données liées depuis les écrans d'administration.

Dépannage

Si quelque chose ne fonctionne pas comme prévu, vérifiez les points suivants :

• le module est activé
• l'utilisateur possède les droits ServiceGarage appropriés
• les modules documents tels que propositions, commandes, factures ou interventions sont également activés lorsqu'une synchronisation est attendue
• les répertoires de données Dolibarr sont accessibles en écriture
• les ressources FullCalendar sont disponibles localement ou via le repli configuré
• les pages publiques de signature et de photo ont été déployées correctement

Pour la maintenance administrative, la zone de configuration expose également :

• la réparation des menus
• les diagnostics de la base de données
• l'aperçu de déduplication RAN
• la synchronisation RAN
• les journaux de signature

Support

Pour le support, les mises à jour et les modules associés, référez-vous à :

• Modules K.S.I sur DoliStore