Service Garage – Atelier · Réparation

Gestion d'un atelier / garage pour véhicules motos, voitures, quads, vélos... dans Dolibarr : création, suivi, et liaisons vers devis / commandes / factures / interventions, avec envoi par e-mail et/ou SMS via le module Send SMS. Signature no eIDAS de l'ordre de réparation par QR‑code, pour signer sur un appareil tactile...

DEMO: https://garage-atelier.serveur2ksi30.fr username: Login & password: Demo

= ServiceGarage =

== Presentation ==

'''ServiceGarage''' est un module Dolibarr destine aux ateliers automobiles et deux-roues. Il ajoute a Dolibarr la gestion des ordres de reparation, la planification atelier, la gestion des techniciens, le decodage VIN, la signature client en ligne, la prise de photos, des sorties PDF orientees vehicule et des outils de synchronisation avec les documents standards de Dolibarr.

== Objectif du module ==

Le module permet a un atelier de gerer tout le cycle de prise en charge d'un vehicule ou d'un dossier atelier :

* creation et suivi des ordres de reparation
* enregistrement des donnees vehicule comme l'immatriculation, le VIN, la marque, le modele, la version, le kilometrage et la date de premiere mise en circulation
* affectation a un technicien et a un creneau de planning
* gestion des indisponibilites techniciens
* synchronisation des informations vehicule dans les devis, commandes, factures et interventions
* collecte de la signature client depuis une page publique
* publication des CGV et des pages de prise de photos
* gestion des RAN, des equipements, des utilisateurs d'equipement et du materiel
* recherche des OR par reference, immatriculation, VIN, marque ou modele

== Installation ==

=== Prerequis ===

* Une instance Dolibarr fonctionnelle
* Dolibarr 19.0+
* PHP 7.4+
* Des droits d'ecriture sur `documents/servicegarage/`

=== Etapes d'installation ===

# Decompresser l'archive afin d'obtenir un repertoire unique `servicegarage/`.
# Copier ce repertoire dans `htdocs/custom/` de Dolibarr.
# Verifier les droits d'acces sur les repertoires de documents du module.
# Aller dans '''Accueil -> Configuration -> Modules/Applications'''.
# Activer le module '''ServiceGarage'''.

=== Repertoires de stockage ===

Le module cree et utilise notamment :

* `servicegarage/`
* `servicegarage/documents/`
* `servicegarage/documents/temp/`

== Mise a jour ==

Pour mettre a jour le module proprement :

# Sauvegarder la base de donnees.
# Sauvegarder le repertoire `documents/servicegarage/`.
# Remplacer les fichiers dans `htdocs/custom/servicegarage/`.
# Desactiver puis reactiver le module dans Dolibarr pour relancer les controles de schema et les migrations si necessaire.

== Permissions ==

Le module declare des droits dedies pour :

* lire, creer, modifier et supprimer les ordres de reparation
* acceder au planning atelier
* gerer les techniciens
* acceder a la configuration du module
* lire, creer, modifier et supprimer les RAN
* lire, creer, modifier et supprimer les equipements
* lire, creer, modifier et supprimer les utilisateurs d'equipement
* lire, creer, modifier et supprimer le materiel
* utiliser des fonctions de creation en masse

En pratique, un responsable atelier recoit generalement :

* lecture/ecriture OR
* acces planning
* acces configuration
* droits sur les modules devis, commandes, factures et interventions si la synchronisation documentaire est souhaitee

== Menus ajoutes par le module ==

Le module ajoute un menu principal ainsi que plusieurs entrees laterales :

* liste des ordres de reparation
* creation d'un OR
* planning
* liste RAN et creation d'un RAN
* liste des equipements
* utilisateurs d'equipement
* liste du materiel
* liste des vehicules client
* OR client
* suivi des signatures
* liste des techniciens
* administration technicien
* disponibilite technicien
* configuration
* categories de vehicules
* dictionnaires
* journaux de signature
* documents techniques

Le module ajoute aussi des raccourcis vers les zones Dolibarr natives :

* devis
* commandes client
* factures
* interventions

== Perimetre fonctionnel detaille ==

=== 1. Ordres de reparation ===

L'ordre de reparation est l'objet central du module. Il permet de stocker :

* la reference OR
* le tiers
* l'immatriculation
* le VIN / numero de serie
* la marque, le modele, la version et le type
* le kilometrage
* la date d'ouverture
* les dates de planification debut et fin
* le technicien affecte
* le statut
* les documents lies

L'OR sert de fiche source pour alimenter les autres documents Dolibarr avec les donnees vehicule.

=== 2. Planning atelier ===

Le planning atelier fournit une vue calendrier pour les OR planifies. Il permet de :

* creer un OR depuis une selection de plage horaire
* deplacer un rendez-vous dans le calendrier
* deprogrammer un rendez-vous
* filtrer par statut et par technicien
* visualiser les couleurs technicien et les blocages
* detecter les conflits de disponibilite
* proposer un autre creneau ou un autre technicien disponible

=== 3. Gestion des techniciens ===

Le module integre des outils de gestion technicien :

* annuaire des techniciens
* creation et modification des techniciens
* blocages d'indisponibilite
* prevention des conflits dans le planning
* parametres optionnels de synchronisation Google par technicien

=== 4. Synchronisation documentaire ===

Une des fonctions majeures du module est la synchronisation des informations vehicule depuis l'OR vers les documents standards de Dolibarr.

Documents pris en charge :

* devis
* commandes client
* factures
* interventions

Le module peut :

* afficher un selecteur d'import des OR recents du meme tiers
* injecter les champs vehicule dans les extrafields des documents cibles
* memoriser des snapshots de synchronisation
* mettre a jour les donnees liees lors des changements de liaison
* eviter la ressaisie manuelle des donnees vehicule

=== 5. Signature publique ===

Le module propose une page publique de signature accessible sans connexion Dolibarr.

Le flux comprend :

* un lien securise de signature
* un QR code pour ouverture sur smartphone ou tablette
* un recapitulatif de l'OR
* la saisie du nom du signataire
* l'acceptation des conditions generales de vente
* une zone de signature au doigt ou a la souris
* des journaux de signature avec IP, type d'appareil et horodatage
* une page finale de validation

=== 6. Prise de photos ===

Le module propose egalement une page publique de prise de photos pour un dossier. Elle permet de :

* ouvrir une page dediee depuis un mobile
* prendre ou importer plusieurs images
* transferer les photos dans le dossier du client
* consulter une galerie simple rattachee au dossier

=== 7. Decodage VIN ===

L'onglet VIN permet de configurer le fournisseur de decodage VIN.

Fournisseurs actuellement prevus dans le code :

* VPIC
* carVertical
* Autorigin

Le module permet d'enregistrer les URL API, les cles API et de tester un VIN directement depuis la configuration.

=== 8. Gestion RAN ===

Le module embarque un domaine '''RAN'''. Dans l'etat actuel du code, un RAN agit comme un dossier tiers unique centralisant les elements SAV associes.

Points principaux :

* un RAN par tiers
* usage client et fournisseur
* historique des statuts
* liaisons avec les SAV / OR
* outils de dedoublonnage
* outils de synchronisation
* nettoyage des liens orphelins et diagnostics

=== 9. Equipements, utilisateurs d'equipement et materiel ===

Le module ne se limite pas aux vehicules et gere aussi :

* les equipements
* les utilisateurs d'equipement
* le materiel

Cela ouvre des usages de suivi de parc ou d'actifs atelier.

== Pages de configuration ==

=== Onglet General ===

Cet onglet permet de regler :

* l'usage du fallback CDN pour les ressources du planning
* l'activation ou non du selecteur d'import d'OR
* le delai de planification par defaut en jours
* les regles de synchronisation de statut documentaire
* les outils de reparation des menus
* le raccourci vers le diagnostic base
* les outils de dedoublonnage et de synchronisation RAN

=== Onglet Categories ===

Cet onglet gere les categories de vehicules visibles dans les OR.

=== Page Dictionnaires ===

Cette page permet de gerer :

* marques
* modeles
* versions
* types
* categories
* modele PDF / template par defaut

=== Onglet VIN ===

Cet onglet gere :

* le fournisseur VIN actif
* l'URL API
* la cle API si necessaire
* un test de recherche VIN

=== Onglet Signature ===

Cet onglet gere :

* l'activation de la signature
* la validation obligatoire a l'etape 2
* le role du signataire
* l'acces aux journaux de signature
* l'acces au suivi des signatures

=== Onglet Extrafields ===

Cet onglet est dedie aux champs vehicule propages vers les documents Dolibarr. Il permet de :

* desactiver l'affichage sur les fiches
* desactiver l'affichage sur les PDF
* choisir quels champs sont visibles sur chaque type de document pris en charge

=== Onglet Voice ===

Le code du module contient aussi une configuration de transcription vocale avec :

* mode navigateur
* configuration Google
* configuration OpenAI
* langue et prompt
* tests depuis l'administration

== Recherche integree ==

Le module enregistre une entree de recherche pour les OR avec les champs suivants :

* reference OR
* immatriculation
* VIN / numero de serie
* marque
* modele

== Notes techniques et integration ==

Le module enregistre notamment :

* des hooks sur les fiches et listes de documents commerciaux
* un trigger dedie
* des assets CSS et JavaScript
* des scripts d'installation et d'evolution SQL
* une table de snapshots pour les donnees synchronisees

== Workflow type ==

# Creer un OR pour le vehicule du client.
# Completer les donnees vehicule et les informations atelier.
# Affecter un technicien et un creneau.
# Generer ou lier les documents commerciaux utiles.
# Importer les donnees vehicule dans le devis, la commande, la facture ou l'intervention si besoin.
# Envoyer le lien ou le QR code de signature.
# Eventuellement collecter les photos du dossier.
# Suivre les signatures et les donnees liees dans les ecrans d'administration.

== Depannage ==

En cas de dysfonctionnement, verifier :

* que le module est actif
* que l'utilisateur dispose bien des droits ServiceGarage
* que les modules devis, commandes, factures et interventions sont actifs si la synchronisation est attendue
* que les repertoires de donnees Dolibarr sont accessibles en ecriture
* que les ressources FullCalendar sont disponibles en local ou via le fallback configure
* que les pages publiques de signature et de photo sont bien deployees

La zone d'administration expose aussi :

* la reparation des menus
* le diagnostic base
* la previsualisation du dedoublonnage RAN
* la synchronisation RAN
* les journaux de signature

== Support ==

Pour le support, les mises a jour et les autres modules lies :

Support

Auteur : KSI — dolibarr@serveur2ksi30.fr

- La version 2.1.6 permet de créer un SAV directement depuis un devis accepté, depuis le menu natif Créer de Dolibarr. Les informations client, produit et les lignes du devis sont reprises automatiquement pour gagner du temps et fluidifier le traitement.