Service Garage Officina Riparazione

ServiceGarage

Presentazione

ServiceGarage e un modulo Dolibarr pensato per officine auto e due ruote. Estende Dolibarr con ordini di riparazione, pianificazione officina, gestione tecnici, decodifica VIN, firma cliente online, acquisizione foto, PDF orientati al veicolo e strumenti di sincronizzazione con i documenti standard di Dolibarr.

Elemento	Valore
Nome modulo	ServiceGarage
Versione documentata	2.1.6
Famiglia	CRM / Officina / Post-vendita
Editore	K.S.I (K.Trc)
Sito editore	https://garage-atelier.serveur2ksi30.fr/
Compatibilita	Dolibarr 19.0 o superiore
PHP minimo	PHP 7.4 o superiore
Licenza	GNU GPLv3

Link ufficiali

Moduli K.S.I su DoliStore: K.S.I modules on DoliStore

Obiettivo del modulo

Il modulo consente di gestire l'intero flusso di lavoro di un veicolo o di una pratica officina:

creare e seguire ordini di riparazione
memorizzare dati veicolo come targa, VIN, marca, modello, versione, chilometraggio e prima immatricolazione
assegnare un tecnico e una fascia di pianificazione
gestire indisponibilita dei tecnici
sincronizzare le informazioni veicolo in preventivi, ordini cliente, fatture e interventi
raccogliere la firma del cliente tramite pagina pubblica
pubblicare condizioni generali e pagine per caricamento foto
gestire RAN, attrezzature, utenti attrezzatura e materiali
cercare ordini di riparazione per riferimento, targa, VIN, marca o modello

Installazione

Requisiti

Una installazione Dolibarr funzionante
Dolibarr 19.0+
PHP 7.4+
Permessi di scrittura su `documents/servicegarage/`

Passi di installazione

Decomprimere il pacchetto ottenendo una singola cartella `servicegarage/`.
Copiare la cartella in `htdocs/custom/` della propria installazione Dolibarr.
Verificare i permessi sui percorsi documentali del modulo.
Andare in Home -> Configurazione -> Moduli/Applicazioni.
Attivare il modulo ServiceGarage.

Cartelle di archiviazione

Il modulo crea e usa:

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

Aggiornamento

Per aggiornare il modulo in sicurezza:

Eseguire un backup del database.
Eseguire un backup della cartella `documents/servicegarage/`.
Sostituire i file in `htdocs/custom/servicegarage/`.
Disattivare e riattivare il modulo per rilanciare controlli schema e migrazioni.

Permessi

Il modulo definisce permessi dedicati per:

lettura, creazione, modifica e cancellazione degli ordini di riparazione
accesso alla pianificazione officina
gestione tecnici
accesso alla configurazione del modulo
lettura, scrittura e cancellazione dei RAN
lettura, scrittura e cancellazione delle attrezzature
lettura, scrittura e cancellazione degli utenti attrezzatura
lettura, scrittura e cancellazione dei materiali
strumenti di creazione massiva

Menu aggiunti dal modulo

Il modulo aggiunge un menu principale e diversi menu laterali:

lista ordini di riparazione
nuovo ordine di riparazione
pianificazione
lista RAN e nuovo RAN
lista attrezzature
utenti attrezzatura
lista materiali
lista veicoli per cliente
ordini cliente officina
tracciamento firme
lista tecnici
amministrazione tecnici
disponibilita tecnici
configurazione
categorie veicolo
dizionari
log firme
documenti tecnici

Sono presenti anche scorciatoie verso le aree native Dolibarr:

preventivi
ordini cliente
fatture
interventi

Ambito funzionale dettagliato

1. Ordini di riparazione

L'ordine di riparazione e l'oggetto centrale del modulo. Puo memorizzare:

riferimento OR
terzo
targa
VIN / numero di serie
marca, modello, versione e tipo
chilometraggio
data apertura
date pianificate di inizio e fine
tecnico assegnato
stato
documenti collegati

L'OR e il record sorgente usato per alimentare i dati veicolo negli altri documenti Dolibarr.

2. Pianificazione officina

La schermata di pianificazione offre una vista calendario degli OR programmati. Consente di:

creare un OR da una selezione di fascia oraria
spostare un appuntamento nel calendario
rimuovere una pianificazione
filtrare per stato o tecnico
visualizzare colori tecnici e blocchi di indisponibilita
rilevare conflitti di disponibilita
suggerire una fascia alternativa o un altro tecnico disponibile

3. Gestione tecnici

Il modulo include strumenti specifici per:

rubrica tecnici
creazione e modifica tecnici
blocchi di indisponibilita
prevenzione conflitti in pianificazione
impostazioni opzionali di sincronizzazione Google per tecnico

4. Sincronizzazione documentale

Una funzione chiave del modulo e la sincronizzazione delle informazioni veicolo dall'OR verso i documenti nativi Dolibarr.

Documenti supportati:

preventivi
ordini cliente
fatture
interventi

Il modulo puo:

mostrare un selettore di importazione con gli OR recenti dello stesso terzo
iniettare campi veicolo negli extrafield dei documenti supportati
memorizzare snapshot di sincronizzazione
aggiornare i dati collegati quando cambiano i link
evitare la reinserzione manuale dei dati veicolo

5. Firma pubblica

Il modulo offre una pagina pubblica di firma accessibile senza login Dolibarr.

Il flusso comprende:

link sicuro di firma
QR code per apertura da smartphone o tablet
riepilogo dell'OR
acquisizione nome firmatario
accettazione delle condizioni generali
area firma con dito o mouse
log firme con IP, tipo dispositivo e data
pagina finale di conferma

6. Acquisizione foto

Il modulo propone anche una pagina pubblica per il caricamento foto del dossier. Permette di:

aprire una pagina dedicata da mobile
scattare o caricare piu immagini
trasferire le foto nella cartella del caso o del cliente
consultare una piccola galleria collegata al dossier

7. Decodifica VIN

La scheda VIN consente di configurare il provider di decodifica VIN.

Provider previsti nel codice attuale:

VPIC
carVertical
Autorigin

Il modulo permette di memorizzare URL API, chiavi API e testare un VIN direttamente dalla configurazione.

8. Gestione RAN

Il modulo include un dominio RAN. Nell'implementazione attuale, il RAN agisce come pratica unica per terzo che centralizza gli elementi post-vendita collegati.

Punti principali:

un RAN per terzo
uso cliente e fornitore
storico stati
collegamenti con SAV / OR
strumenti di deduplicazione
strumenti di sincronizzazione
pulizia link orfani e diagnostica

9. Attrezzature, utenti attrezzatura e materiali

Oltre agli OR veicolo, il modulo gestisce anche:

attrezzature
utenti attrezzatura
materiali

Questo amplia l'uso del modulo verso gestione parco o asset di officina.

Pagine di configurazione

Scheda Generale

Questa scheda consente di configurare:

uso del fallback CDN per le risorse del planning
attivazione o disattivazione del selettore import OR
ritardo di pianificazione predefinito in giorni
regole di sincronizzazione dello stato documentale
strumenti di riparazione menu
collegamento rapido alla diagnostica database
strumenti RAN di deduplicazione e sincronizzazione

Scheda Categorie

Gestisce le categorie veicolo visibili negli ordini di riparazione.

Pagina Dizionari

Permette di gestire:

marche
modelli
versioni
tipi
categorie
modello PDF / template predefinito

Scheda VIN

Gestisce:

provider VIN attivo
URL API
chiave API se necessaria
test ricerca VIN

Scheda Firma

Gestisce:

attivazione firma
convalida obbligatoria al passaggio 2
ruolo del firmatario
accesso ai log firme
accesso al monitoraggio firme

Scheda Extrafields

Questa scheda e dedicata ai campi veicolo propagati verso i documenti Dolibarr. Consente di:

disattivare i campi nelle schede
disattivare i campi nei PDF
scegliere quali campi mostrare per ciascun tipo documento supportato

Scheda Voice

Il codice contiene anche una configurazione di trascrizione vocale con:

modalita browser
configurazione Google
configurazione OpenAI
lingua e prompt
azioni di test dall'amministrazione

Ricerca integrata

Il modulo registra una voce di ricerca per gli OR con i campi:

riferimento OR
targa
VIN / numero di serie
marca
modello

Note tecniche e integrazione

Il modulo registra:

hook sulle schede e liste dei documenti commerciali
un trigger dedicato
asset CSS e JavaScript
installazione SQL e helper di migrazione
una tabella snapshot per i dati sincronizzati

Flusso tipico

Creare un OR per il veicolo del cliente.
Compilare dati veicolo e note officina.
Assegnare tecnico e fascia oraria.
Generare o collegare i documenti commerciali necessari.
Importare le informazioni veicolo in preventivo, ordine, fattura o intervento quando serve.
Inviare al cliente link o QR code di firma.
Facoltativamente raccogliere foto del dossier.
Monitorare firme e dati collegati dalle schermate amministrative.

Risoluzione problemi

Se qualcosa non funziona come previsto, verificare:

che il modulo sia attivo
che l'utente abbia i corretti permessi ServiceGarage
che i moduli preventivi, ordini, fatture e interventi siano attivi se ci si aspetta sincronizzazione
che le cartelle dati Dolibarr siano scrivibili
che le risorse FullCalendar siano disponibili in locale o tramite fallback configurato
che le pagine pubbliche di firma e foto siano state distribuite correttamente

L'area amministrativa espone anche:

riparazione menu
diagnostica database
anteprima deduplicazione RAN
sincronizzazione RAN
log firme

Supporto

Per supporto, aggiornamenti e altri moduli correlati: