Service Garage – Taller · Reparación

Gestión de taller/garaje para vehículos motos, coches, quads, bicicletas... en Dolibarr: creación, seguimiento y enlaces a presupuestos / pedidos / facturas / intervenciones, con envío por correo electrónico y/o SMS mediante Send SMS. Firma de la Orden no eIDAS de Reparación mediante código QR en un dispositivo táctil...

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

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

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

Soporte

Autor: KSI  — dolibarr@serveur2ksi30.fr

- La versión 2.1.6  permite crear un SAV directamente desde un presupuesto aceptado, desde el menú nativo Crear de Dolibarr. Los datos del cliente, la información del producto y las líneas del presupuesto se recuperan automáticamente para ahorrar tiempo y facilitar el trabajo