Savmanager

# Savmanager Benutzerhandbuch

Savmanager ist ein Dolibarr-Modul zur Verwaltung von Service‑After‑Sales (SAV) Einsätzen.

## Neu (v1.0.1)
- PDF klarer und vollständiger: bessere Darstellung mit Ihren Daten und den Kundendaten.
- Einsatzort genauer: vollständige Adresse, hilfreiche Kontaktdaten (falls gepflegt) und optionale Notizen.
- Sie können einen Einsatz mit einem Projekt und/oder einem Ticket verknüpfen, um die Nachverfolgung zu erleichtern.
- Start/Ende (Datum und Uhrzeit) auf den PDFs: einfacher für Nachverfolgung, Abnahme und Archivierung.
- Unterschriftsfelder im Kunden‑PDF: praktisch für die Unterschrift vor Ort.
- Beträge flexibel: Beträge können im Kunden‑Dokument ausgeblendet werden.

## Überblick
- Einsätze mit Status, Priorität, Technikern und Orten verwalten.
- Kalenderansichten: Monat und Woche, mit Hinweis bei Einsätzen außerhalb der Arbeitszeiten.
- Farben und Anzeigegrenzen pro Kalenderzelle konfigurierbar.
- Mehrsprachig: FR, EN, DE, IT, ES.
- Zusätzliche Felder (Extrafields): unterstützt über die nativen Dolibarr‑Funktionen.

## Installation
1. Ordner `savmanager/` nach `htdocs/custom/` kopieren.
2. Modul in Dolibarr aktivieren: Start → Konfiguration → Module → Savmanager.
3. Auf die Savmanager‑Konfigurationsseite gehen und Optionen einstellen.

## Konfiguration
Savmanager → Admin → Konfiguration.
- Standardstatus: anfänglicher Status für neue Einsätze (änderbar).
- Kunde automatisch benachrichtigen: E‑Mail an den Kunden bei Statusänderung.
- Reparaturfrist (Tage): Anzahl Tage bis zur Warnung.
- Anzeigegrenzen im Kalender:
  - Wochenansicht: maximale sichtbare Elemente pro Zeitslot.
  - Monatsansicht: maximale sichtbare Elemente pro Tag (ein „Mehr“‑Link zeigt den Rest).
- Stil für „Mehr/Weniger“: Erscheinungsbild des Schalters (Link, Button, Badge, Icon). Option für eigene CSS‑Klasse.
- Statusfarben: Farbe pro Status (Entwurf, Validiert, In Bearbeitung usw.).
- Prioritätsfarben: Hintergrundfarbe für Normal, Dringend, Kritisch.
- Wochenansicht‑Zeiten: erste und letzte Stunde in der Wochen‑Rasteranzeige.
- Einsatz‑Arbeitszeiten (Hinweise): Zeitfenster, das als „Arbeitszeit“ für den Hinweisbanner gilt.

## Einen Einsatz anlegen
- Ein Drittunternehmen ist erforderlich. Ohne Drittunternehmen wird das Anlegen blockiert.
- Wichtige Felder: Produkt (optional), Seriennummer, Problemtyp, Priorität, Daten, Techniker, Ort.
- Speichern. Standardmäßig wird ein anfänglicher Status gesetzt (in der Konfiguration anpassbar).

## Bearbeitungsregeln
- Bearbeitung ist für alle Status möglich außer „Geschlossen“.
- Serverseitige Prüfung verhindert Aktualisierung, wenn Status = Geschlossen.

## Kalender
- Monatsansicht: zeigt Ereignisse mit Status‑Badge, Techniker‑Initialen und Stadt rechts ausgerichtet.
  - Wenn die Anzahl der Ereignisse die Tagesgrenze überschreitet, erscheint ein `+N`‑Badge und ein „Mehr“‑Link zeigt die ausgeblendeten Elemente.
- Wochenansicht: konfigurierbares Stundenraster.
  - Einsätze außerhalb der Stunden erscheinen in der Zeile „Ganztägig“.
  - Ein Banner listet Einsätze außerhalb der Arbeitszeiten der laufenden Woche.

## Banner außerhalb der Arbeitszeiten
- Gesteuert durch die in der Konfiguration festgelegten Einsatz‑Arbeitszeiten.
- Zeigt eine Warnung mit Zähler und Liste der betroffenen Einsätze.

## Übersetzungen
- Sprachdateien unter `savmanager/langs/` für FR, EN, DE, IT, ES.

## Support
Bitte geben Sie Rückmeldungen an Ihren Dolibarr‑Administrator.