View source for Service Garage Werkstatt Reparatur

<br />
=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.
{| class="wikitable"
|-
!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/ https://garage-atelier.serveur2ksi30.fr/]
|-
|Kompatibilitat
|Dolibarr 19.0 oder hoher
|-
|Mindestanforderung PHP
|PHP 7.4 oder hoher
|-
|Lizenz
|GNU GPLv3
|}
== Offizielle Links ==
* Demovideo : [https://youtu.be/Gul4EPHPnpg ServiceGarage — Demo (YouTube)]
* Modulseite : [https://www.ksidol.io/de/modules/detail?module=main_module_servicegarage ServiceGarage bei KSIDol]
* Online-Demo : [https://www.ksidol.io/t/demo-garage/custom/servicegarage/or_card.php?id=1&mainmenu=servicegarage&leftmenu=servicegarage_or_list ServiceGarage — Demo öffnen]
* Benutzerhandbuch : [https://www.ksidol.io/notices/ksidol_notice_de/servicegarage.html ServiceGarage — Handbuch lesen]
*K.S.I Module auf 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]

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

*[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]