KSIDol

Dolibarr-Integrator

Maßgeschneiderte Entwicklung

SaaS-Hosting

https://www.ksidol.io

support@ksidol.io

Service Garage – Werkstatt · Reparatur

Werkstatt-/Garagenverwaltung für Fahrzeuge Motorräder, Autos, Quads, Fahrräder ... in Dolibarr: Erstellen, Nachverfolgen und Verknüpfen mit Angeboten / Bestellungen / Rechnungen / Einsätzen, inkl. E‑Mail- und/oder SMS‑Versand über Send SMS. Unterschrift des Reparaturauftrags no eIDAS per QR‑Code auf einem Touch‑Gerät ...

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

= 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://dolibarr.ksi30.fr dolibarr.ksi30.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: [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]
* Herausgeber-Website: [https://dolibarr.ksi30.fr dolibarr.ksi30.fr]

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

Support

Autor: KSI — dolibarr@serveur2ksi30.fr

Mit Version 2.1.6 kann ein SAV direkt aus einem akzeptierten Angebot über das native Dolibarr-Menü Erstellen angelegt werden. Kundendaten, Produktinformationen und Angebotszeilen werden automatisch übernommen, um den Ablauf schneller und einfacher zu machen.