KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

2026-10-19T16:08:50Z

Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

← Older revision		Revision as of 16:08, 19 October 2026
Line 32:		Line 32:
	\|GNU GPLv3		\|GNU GPLv3
	\|}		\|}
	==Link ufficiali==		== Link ufficiali ==
			* Video dimostrativo : [https://youtu.be/Gul4EPHPnpg ServiceGarage — demo (YouTube)]
			* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_servicegarage ServiceGarage su KSIDol]
			* Demo online : [https://www.ksidol.io/t/demo-garage/custom/servicegarage/or_card.php?id=1&mainmenu=servicegarage&leftmenu=servicegarage_or_list ServiceGarage — aprire la demo]
			* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/servicegarage.html ServiceGarage — consultare il manuale]
	*Moduli K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]		*Moduli K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]

KSI at 21:22, 17 March 2026

2026-03-17T21:22:59Z

← Older revision		Revision as of 21:22, 17 March 2026
Line 21:		Line 21:
	\|-		\|-
	\|Sito editore		\|Sito editore
	\|[https://garage-atelier.serveur2ksi30.fr/ ~~https://garage-atelier.serveur2ksi30.fr/]~~		\|https://garage-atelier.serveur2ksi30.fr/
	\|-		\|-
	\|Compatibilita		\|Compatibilita
Line 35:		Line 35:

	*Moduli K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]		*Moduli K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]
	*Sito editore: [https://dolibarr.ksi30.fr dolibarr.ksi30.fr]

	==Obiettivo del modulo==		==Obiettivo del modulo==
Line 339:		Line 338:

	*[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]		*[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]
	*[https://garage-atelier.serveur2ksi30.fr/ ~~https://garage-atelier.serveur2ksi30.fr/]~~		*https://garage-atelier.serveur2ksi30.fr/

KSI at 21:22, 17 March 2026

2026-03-17T21:22:23Z

← Older revision		Revision as of 21:22, 17 March 2026
Line 21:		Line 21:
	\|-		\|-
	\|Sito editore		\|Sito editore
	\|[https://~~dolibarr~~.~~ksi30~~.fr ~~dolibarr~~.~~ksi30~~.fr]		\|[https://garage-atelier.serveur2ksi30.fr/ https://garage-atelier.serveur2ksi30.fr/]
	\|-		\|-
	\|Compatibilita		\|Compatibilita
Line 339:		Line 339:

	*[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]		*[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]
	*[https://~~dolibarr~~.~~ksi30~~.fr ~~dolibarr~~.~~ksi30~~.fr]		*[https://garage-atelier.serveur2ksi30.fr/ https://garage-atelier.serveur2ksi30.fr/]

KSI: Created page with "
=ServiceGarage= ==Presentazione== '''ServiceGarage''' e un modulo Dolibarr pensato per officine auto e due ruote. Estende Dolibarr con ordini di riparazione, pianificaz..."

2026-03-17T21:13:42Z

Created page with "<br /> =ServiceGarage= ==Presentazione== '''ServiceGarage''' e un modulo Dolibarr pensato per officine auto e due ruote. Estende Dolibarr con ordini di riparazione, pianificaz..."

New page

<br />
=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.
{| class="wikitable"
|-
!Elemento
!Valore
|-
|Nome modulo
|ServiceGarage
|-
|Versione documentata
|2.1.6
|-
|Famiglia
|CRM / Officina / Post-vendita
|-
|Editore
|K.S.I (K.Trc)
|-
|Sito editore
|[https://dolibarr.ksi30.fr dolibarr.ksi30.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: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]
*Sito editore: [https://dolibarr.ksi30.fr dolibarr.ksi30.fr]

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

*[https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I modules on DoliStore]
*[https://dolibarr.ksi30.fr dolibarr.ksi30.fr]

Service Garage Officina Riparazione - Revision history

KSI: Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice

KSI at 21:22, 17 March 2026

KSI at 21:22, 17 March 2026

KSI: Created page with " =ServiceGarage= ==Presentazione== '''ServiceGarage''' e un modulo Dolibarr pensato per officine auto e due ruote. Estende Dolibarr con ordini di riparazione, pianificaz..."

KSI: Created page with "
=ServiceGarage= ==Presentazione== '''ServiceGarage''' e un modulo Dolibarr pensato per officine auto e due ruote. Estende Dolibarr con ordini di riparazione, pianificaz..."