Service Garage Taller Reparación

ServiceGarage

Presentacion

ServiceGarage es un modulo Dolibarr pensado para talleres de automocion y de dos ruedas. Amplia Dolibarr con ordenes de reparacion, planificacion del taller, gestion de tecnicos, decodificacion VIN, firma del cliente en linea, captura de fotos, salidas PDF orientadas al vehiculo y herramientas de sincronizacion con los documentos estandar de Dolibarr.

Elemento	Valor
Nombre del modulo	ServiceGarage
Version documentada	2.1.6
Familia	CRM / Taller / Posventa
Editor	K.S.I (K.Trc)
Sitio del editor	https://garage-atelier.serveur2ksi30.fr/
Compatibilidad	Dolibarr 19.0 o superior
PHP minimo	PHP 7.4 o superior
Licencia	GNU GPLv3

Enlaces oficiales

Modulos K.S.I en DoliStore: K.S.I modules on DoliStore

Objetivo del modulo

El modulo permite gestionar todo el ciclo de trabajo de un vehiculo o expediente de taller:

crear y seguir ordenes de reparacion
guardar datos del vehiculo como matricula, VIN, marca, modelo, version, kilometraje y fecha de primera matriculacion
asignar un tecnico y una franja de planificacion
gestionar indisponibilidades de tecnicos
sincronizar informacion del vehiculo en presupuestos, pedidos, facturas e intervenciones
recoger la firma del cliente desde una pagina publica
publicar condiciones generales y paginas de carga de fotos
gestionar RAN, equipos, usuarios de equipo y material
buscar ordenes por referencia, matricula, VIN, marca o modelo

Instalacion

Requisitos

Una instancia Dolibarr operativa
Dolibarr 19.0+
PHP 7.4+
Permisos de escritura en `documents/servicegarage/`

Pasos de instalacion

Descomprimir el paquete para obtener un unico directorio `servicegarage/`.
Copiarlo dentro de `htdocs/custom/` de Dolibarr.
Verificar permisos sobre los directorios de documentos del modulo.
Ir a Inicio -> Configuracion -> Modulos/Aplicaciones.
Activar el modulo ServiceGarage.

Directorios de almacenamiento

El modulo crea y utiliza:

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

Actualizacion

Para actualizar el modulo de forma segura:

Hacer copia de la base de datos.
Hacer copia del directorio `documents/servicegarage/`.
Sustituir los archivos de `htdocs/custom/servicegarage/`.
Desactivar y volver a activar el modulo para relanzar controles de esquema y migraciones.

Permisos

El modulo define permisos especificos para:

leer, crear, modificar y eliminar ordenes de reparacion
acceder a la planificacion del taller
gestionar tecnicos
acceder a la configuracion del modulo
leer, crear, modificar y eliminar RAN
leer, crear, modificar y eliminar equipos
leer, crear, modificar y eliminar usuarios de equipo
leer, crear, modificar y eliminar material
usar herramientas de creacion masiva

Menus anadidos por el modulo

El modulo anade un menu principal y varios menus laterales:

lista de ordenes de reparacion
nueva orden de reparacion
planificacion
lista RAN y nuevo RAN
lista de equipos
usuarios de equipo
lista de material
lista de vehiculos por cliente
ordenes de cliente
seguimiento de firmas
lista de tecnicos
administracion de tecnicos
disponibilidad de tecnicos
configuracion
categorias de vehiculos
diccionarios
registros de firma
documentos tecnicos

Tambien se integran accesos rapidos hacia:

presupuestos
pedidos de cliente
facturas
intervenciones

Alcance funcional detallado

1. Ordenes de reparacion

La orden de reparacion es el objeto central del modulo. Puede almacenar:

referencia de la OR
tercero
matricula
VIN / numero de serie
marca, modelo, version y tipo
kilometraje
fecha de apertura
fecha de inicio y fin planificadas
tecnico asignado
estado
documentos vinculados

La OR actua como ficha fuente para propagar datos del vehiculo al resto de documentos Dolibarr.

2. Planificacion del taller

La pantalla de planificacion ofrece una vista calendario de las OR programadas. Permite:

crear una OR desde una seleccion de tiempo
mover una cita en el calendario
desprogramar una cita
filtrar por estado y tecnico
visualizar colores de tecnico y bloqueos
detectar conflictos de disponibilidad
sugerir otra franja u otro tecnico disponible

3. Gestion de tecnicos

El modulo integra herramientas especificas para:

directorio de tecnicos
creacion y edicion de tecnicos
bloqueos de indisponibilidad
prevencion de conflictos en planificacion
configuracion opcional de sincronizacion Google por tecnico

4. Sincronizacion documental

Una funcion clave del modulo es la sincronizacion de la informacion del vehiculo desde la OR hacia documentos nativos de Dolibarr.

Documentos soportados:

presupuestos
pedidos de cliente
facturas
intervenciones

El modulo puede:

mostrar un selector de importacion con las OR recientes del mismo tercero
inyectar campos de vehiculo en extrafields de documentos
guardar snapshots de sincronizacion
actualizar datos vinculados cuando cambian los enlaces
evitar la reintroduccion manual de datos del vehiculo

5. Firma publica

El modulo ofrece una pagina publica de firma accesible sin iniciar sesion en Dolibarr.

El flujo incluye:

enlace seguro de firma
codigo QR para abrir la pagina en movil o tableta
resumen de la OR
captura del nombre del firmante
aceptacion de condiciones generales
area de firma con dedo o raton
registros de firma con IP, dispositivo y fecha
pagina final de confirmacion

6. Captura de fotos

El modulo tambien ofrece una pagina publica para subir fotos del expediente. Permite:

abrir una pagina dedicada desde el movil
tomar o subir varias imagenes
transferir las fotos a la carpeta del caso o del cliente
consultar una galeria simple vinculada al expediente

7. Decodificacion VIN

La pestana VIN permite configurar el proveedor de decodificacion VIN.

Proveedores previstos en el codigo actual:

VPIC
carVertical
Autorigin

El modulo permite guardar URL API, claves API y probar un VIN desde la administracion.

8. Gestion RAN

El modulo contiene un dominio RAN. En la implementacion actual, un RAN funciona como expediente unico por tercero que centraliza elementos posventa relacionados.

Puntos principales:

un RAN por tercero
casos de cliente y proveedor
historial de estados
relaciones con SAV / OR
herramientas de fusion de duplicados
herramientas de sincronizacion
limpieza de enlaces huerfanos y diagnostico

9. Equipos, usuarios de equipo y material

Ademas de las OR de vehiculos, el modulo gestiona:

equipos
usuarios de equipo
material

Eso amplia el uso del modulo hacia seguimiento de parque o activos del taller.

Paginas de configuracion

Pestana General

Esta pestana permite configurar:

uso del fallback CDN para recursos del planning
activacion o desactivacion del selector de importacion de OR
retraso de planificacion por defecto en dias
reglas de sincronizacion de estado documental
herramientas de reparacion de menus
acceso al diagnostico de base
herramientas de deduplicacion y sincronizacion RAN

Pestana Categorias

Gestiona las categorias de vehiculo visibles en las OR.

Pagina Diccionarios

Permite gestionar:

marcas
modelos
versiones
tipos
categorias
plantilla o modelo PDF por defecto

Pestana VIN

Gestiona:

proveedor VIN activo
URL API
clave API cuando aplica
prueba de busqueda VIN

Pestana Firma

Gestiona:

activacion de la firma
validacion obligatoria en paso 2
rol del firmante
acceso a registros de firma
acceso al seguimiento de firmas

Pestana Extrafields

Esta pestana se dedica a los campos de vehiculo propagados a documentos Dolibarr. Permite:

desactivar campos en fichas
desactivar campos en PDFs
elegir que campos aparecen por tipo de documento

Pestana Voice

El codigo tambien incluye configuracion de transcripcion vocal con:

modo navegador
configuracion Google
configuracion OpenAI
idioma y prompt
acciones de prueba desde setup

Busqueda integrada

El modulo registra una entrada de busqueda para OR con los campos:

referencia OR
matricula
VIN / numero de serie
marca
modelo

Notas tecnicas e integracion

El modulo registra:

hooks en fichas y listas de documentos comerciales
un trigger dedicado
recursos CSS y JavaScript
instalacion SQL y ayudas de migracion
una tabla de snapshots para datos sincronizados

Flujo tipico

Crear una OR para el vehiculo del cliente.
Completar datos del vehiculo y notas de taller.
Asignar tecnico y franja horaria.
Generar o vincular los documentos comerciales necesarios.
Importar informacion del vehiculo a presupuesto, pedido, factura o intervencion si hace falta.
Enviar el enlace o QR de firma al cliente.
Opcionalmente recoger fotos del expediente.
Seguir firmas y datos vinculados desde la administracion.

Resolucion de problemas

Si algo no funciona como se espera, comprobar:

que el modulo esta activado
que el usuario tiene permisos correctos de ServiceGarage
que los modulos de presupuestos, pedidos, facturas e intervenciones estan activos si se espera sincronizacion
que los directorios de datos Dolibarr son escribibles
que los recursos FullCalendar estan disponibles en local o via fallback configurado
que las paginas publicas de firma y fotos se han desplegado correctamente

La administracion tambien ofrece:

reparacion de menus
diagnostico de base
vista previa de deduplicacion RAN
sincronizacion RAN
registros de firma

Soporte

Para soporte, actualizaciones y otros modulos relacionados: