Service Garage – Officina · Riparazione

Gestione officina/garage per veicoli moto, auto, quad, bici... in Dolibarr: creazione, tracciamento e collegamenti a preventivi / ordini / fatture / interventi, con invio e‑mail e/o SMS tramite Send SMS. Firma dell’Ordine no eIDAS di Riparazione tramite codice QR su dispositivo touch...

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

= 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.

== 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:

Supporto

Autore: KSI — dolibarr@serveur2ksi30.fr

- La versione 2.1.6 consente di creare un SAV direttamente da un preventivo accettato, tramite il menu nativo Crea di Dolibarr. I dati del cliente, le informazioni del prodotto e le righe del preventivo vengono ripresi automaticamente per velocizzare la gestione.