Service Garage Werkstatt Reparatur

ServiceGarage

Ubersicht

ServiceGarage ist ein Dolibarr-Modul fur Kfz- und Zweirad-Werkstatten. Es erweitert Dolibarr um Reparaturauftrage, Werkstattplanung, Technikerverwaltung, VIN-Decodierung, Online-Kundensignatur, Fotoerfassung, fahrzeugorientierte PDF-Ausgaben und Synchronisationswerkzeuge mit den Standarddokumenten von Dolibarr.

Element	Wert
Modulname	ServiceGarage
Dokumentierte Version	2.1.6
Familie	CRM / Werkstatt / After-Sales
Herausgeber	K.S.I (K.Trc)
Herausgeber-Website	https://garage-atelier.serveur2ksi30.fr/
Kompatibilitat	Dolibarr 19.0 oder hoher
Mindestanforderung PHP	PHP 7.4 oder hoher
Lizenz	GNU GPLv3

Offizielle Links

K.S.I Module auf DoliStore: K.S.I modules on DoliStore

Zweck des Moduls

Das Modul deckt den kompletten Werkstattablauf rund um ein Fahrzeug oder einen Werkstattfall ab:

Reparaturauftrage anlegen und verwalten
Fahrzeugdaten wie Kennzeichen, VIN, Marke, Modell, Version, Kilometerstand und Erstzulassung speichern
Techniker und Planungsslots zuweisen
Nichtverfugbarkeiten von Technikern verwalten
Fahrzeuginformationen in Angebote, Kundenauftrage, Rechnungen und Interventionen synchronisieren
Kundensignaturen uber eine offentliche Seite erfassen
AGB und Fotoseiten bereitstellen
RAN, Ausrustung, Ausrustungsbenutzer und Material verwalten
Reparaturauftrage nach Referenz, Kennzeichen, VIN, Marke oder Modell suchen

Installation

Voraussetzungen

Eine funktionsfahige Dolibarr-Installation
Dolibarr 19.0+
PHP 7.4+
Schreibrechte auf `documents/servicegarage/`

Installationsschritte

Paket entpacken, sodass ein einzelnes Verzeichnis `servicegarage/` vorhanden ist.
Dieses Verzeichnis nach `htdocs/custom/` der Dolibarr-Installation kopieren.
Dateirechte fur die Dokumentverzeichnisse des Moduls prufen.
Zu Start -> Einrichtung -> Module/Anwendungen gehen.
Das Modul ServiceGarage aktivieren.

Speicherverzeichnisse

Das Modul erstellt und nutzt:

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

Update

Fur ein sicheres Update:

Datenbank sichern.
Verzeichnis `documents/servicegarage/` sichern.
Dateien in `htdocs/custom/servicegarage/` ersetzen.
Modul deaktivieren und erneut aktivieren, damit Schemachecks und Migrationen laufen konnen.

Berechtigungen

Das Modul definiert eigene Rechte fur:

Lesen, Erstellen, Bearbeiten und Loschen von Reparaturauftragen
Zugriff auf die Werkstattplanung
Technikerverwaltung
Modulkonfiguration
Lesen, Schreiben und Loschen von RAN
Lesen, Schreiben und Loschen von Ausrustungen
Lesen, Schreiben und Loschen von Ausrustungsbenutzern
Lesen, Schreiben und Loschen von Material
Werkzeuge zur Massenerstellung

Durch das Modul hinzugefugte Menus

Das Modul fugt ein Hauptmenu und mehrere linke Menus hinzu:

Reparaturauftragsliste
Neuer Reparaturauftrag
Planung
RAN-Liste und neuer RAN
Ausrustungsliste
Ausrustungsbenutzer
Materialliste
Fahrzeugliste nach Kunde
Kunden-Reparaturauftrage
Signaturverfolgung
Technikerliste
Technikerverwaltung
Technikerverfugbarkeit
Konfiguration
Fahrzeugkategorien
Dictionaries
Signaturprotokolle
Technische Dokumente

Zusatzlich gibt es Verknupfungen zu nativen Dolibarr-Bereichen:

Angebote
Kundenauftrage
Rechnungen
Interventionen

Detaillierter Funktionsumfang

1. Reparaturauftrage

Der Reparaturauftrag ist das zentrale Objekt des Moduls. Er kann unter anderem speichern:

OR-Referenz
Drittpartei
Kennzeichen
VIN / Seriennummer
Marke, Modell, Version und Typ
Kilometerstand
Erstellungsdatum
Geplanter Beginn und geplantes Ende
Zugewiesener Techniker
Status
Verknupfte Dokumente

Der Reparaturauftrag dient als Quelle fur die Fahrzeuginformationen in anderen Dolibarr-Dokumenten.

2. Werkstattplanung

Die Planungsseite bietet eine Kalenderansicht fur terminierte Reparaturauftrage. Sie ermoglicht:

Erstellen eines Reparaturauftrags aus einem ausgewahlten Zeitraum
Verschieben eines Termins im Kalender
Entfernen einer Planung
Filtern nach Status oder Techniker
Visualisierung von Technikerfarben und Sperrzeiten
Erkennung von Verfugbarkeitskonflikten
Vorschlage fur andere Slots oder andere verfugbare Techniker

3. Technikerverwaltung

Das Modul enthalt spezielle Werkzeuge fur:

Technikerverzeichnis
Anlegen und Bearbeiten von Technikern
Sperrzeiten bei Nichtverfugbarkeit
Konfliktvermeidung in der Planung
Optionale Google-Synchronisation pro Techniker

4. Dokumentensynchronisation

Eine zentrale Funktion ist die Synchronisation der Fahrzeuginformationen vom Reparaturauftrag in native Dolibarr-Dokumente.

Unterstutzte Ziele:

Angebote
Kundenauftrage
Rechnungen
Interventionen

Das Modul kann:

einen Importselektor mit aktuellen Reparaturauftragen derselben Drittpartei anzeigen
Fahrzeug-Extrafields in unterstutzte Dokumente ubertragen
Synchronisations-Snapshots speichern
verknupfte Informationen bei Link-Anderungen aktualisieren
Mehrfacheingaben von Fahrzeugdaten vermeiden

5. Offentlicher Signaturprozess

Das Modul stellt eine offentliche Signaturseite bereit, die ohne Dolibarr-Login erreichbar ist.

Der Ablauf umfasst:

sicheren Signaturlink
QR-Code fur mobile Gerate
Zusammenfassung des Reparaturauftrags
Erfassung des Namens des Unterzeichners
Zustimmung zu den AGB
Signaturfeld fur Maus oder Finger
Signaturprotokolle mit IP, Geratetyp und Zeitstempel
Abschlussseite nach erfolgter Signatur

6. Offentliche Fotoerfassung

Zusatzlich gibt es eine offentliche Fotoseite fur einen Fall. Damit kann man:

eine spezielle Seite per Smartphone oder Tablet offnen
mehrere Bilder aufnehmen oder hochladen
Fotos in den Fall- oder Kundenordner ubertragen
eine einfache Galerie zum Vorgang ansehen

7. VIN-Decodierung

Im VIN-Reiter kann der VIN-Anbieter konfiguriert werden.

Im aktuellen Code vorgesehene Anbieter:

VPIC
carVertical
Autorigin

Das Modul speichert API-URLs, API-Schlussel und bietet einen Test fur VIN-Abfragen im Setup.

8. RAN-Verwaltung

Das Modul enthalt einen eigenen RAN-Bereich. In der aktuellen Implementierung fungiert ein RAN als eindeutige Drittpartei-Akte, die zusammengehorende After-Sales-Elemente zentralisiert.

Wesentliche Punkte:

ein RAN pro Drittpartei
Kunden- und Lieferantenanwendung
Statushistorie
Beziehungen zu SAV / OR
Werkzeuge zur Dublettenzusammenfuhrung
Synchronisationswerkzeuge
Bereinigung verwaister Links und Diagnosen

9. Ausrustung, Ausrustungsbenutzer und Material

Zusatzlich zu Fahrzeug-Reparaturauftragen verwaltet das Modul auch:

Ausrustungen
Ausrustungsbenutzer
Material

Damit erweitert sich der Einsatz auf Fuhrpark- oder Asset-Workflows in der Werkstatt.

Konfigurationsseiten

Allgemein

Dieser Reiter konfiguriert:

CDN-Fallback fur Planungsressourcen
Aktivierung oder Deaktivierung des Reparaturauftrags-Importselektors
Standard-Planungsverzug in Tagen
Regeln fur Dokumentstatus-Synchronisation
Menu-Reparaturwerkzeuge
Schnellzugriff auf Datenbankdiagnose
RAN-Deduplizierung und Synchronisation

Kategorien

Hier werden Fahrzeugkategorien verwaltet, die in Reparaturauftragen sichtbar sind.

Dictionaries

Hier lassen sich verwalten:

Marken
Modelle
Versionen
Typen
Kategorien
Standard-PDF-Modell oder Template

VIN

Hier werden verwaltet:

aktiver VIN-Anbieter
API-URL
API-Schlussel falls erforderlich
VIN-Testabfrage

Signatur

Hier werden verwaltet:

Aktivierung der Signaturfunktion
verpflichtende Validierung in Schritt 2
Rolle des Unterzeichners
Zugriff auf Signaturprotokolle
Zugriff auf Signaturverfolgung

Extrafields

Dieser Reiter betrifft die in Dolibarr-Dokumente ubertragenen Fahrzeugfelder. Administratoren konnen:

Fahrzeugfelder auf Karten deaktivieren
Fahrzeugfelder auf PDFs deaktivieren
festlegen, welche Felder je Dokumenttyp sichtbar sind

Voice

Der Code enthalt ausserdem Sprachtranskriptionsoptionen mit:

Browsermodus
Google-Konfiguration
OpenAI-Konfiguration
Sprache und Prompt
Testaktionen im Setup

Integrierte Suche

Das Modul registriert einen Sucheinstieg fur Reparaturauftrage mit folgenden Feldern:

OR-Referenz
Kennzeichen
VIN / Seriennummer
Marke
Modell

Technische Hinweise und Integration

Das Modul registriert:

Hooks auf Karten und Listen kaufmannischer Dokumente
einen eigenen Trigger
CSS- und JavaScript-Assets
SQL-Installations- und Migrationshilfen
eine Snapshot-Tabelle fur synchronisierte Daten

Typischer Ablauf

Reparaturauftrag fur das Kundenfahrzeug anlegen.
Fahrzeugdaten und Werkstattinformationen erfassen.
Techniker und Zeitfenster zuweisen.
Benotigte kaufmannische Dokumente erzeugen oder verknupfen.
Fahrzeuginformationen bei Bedarf in Angebot, Auftrag, Rechnung oder Intervention importieren.
Signaturlink oder QR-Code an den Kunden senden.
Optional Fotos zum Fall erfassen.
Signaturen und verknupfte Daten in der Administration verfolgen.

Fehlerbehebung

Wenn etwas nicht wie erwartet funktioniert, sollten folgende Punkte gepruft werden:

das Modul ist aktiviert
der Benutzer besitzt die korrekten ServiceGarage-Rechte
Angebots-, Auftrags-, Rechnungs- und Interventionsmodule sind aktiv, wenn Synchronisation erwartet wird
Dolibarr-Datenverzeichnisse sind beschreibbar
FullCalendar-Ressourcen sind lokal vorhanden oder uber den konfigurierten Fallback erreichbar
offentliche Signatur- und Fotoseiten wurden korrekt bereitgestellt

Im Administrationsbereich stehen ausserdem bereit:

Menu-Reparatur
Datenbankdiagnose
Vorschau fur RAN-Deduplizierung
RAN-Synchronisation
Signaturprotokolle

Support

Fur Support, Updates und weitere Module:

K.S.I modules on DoliStore