127 lines
5 KiB
Markdown
127 lines
5 KiB
Markdown
# Stundenzettel Modul für Dolibarr
|
|
|
|
**Version:** 1.1.0
|
|
**Autor:** Data IT Solution
|
|
**Kompatibilität:** Dolibarr 16.0+
|
|
**Lizenz:** GPL v3
|
|
|
|
## Beschreibung
|
|
|
|
Das Stundenzettel-Modul ermöglicht die Verwaltung von Stundenzetteln für Kundenaufträge in Dolibarr. Es bietet eine umfassende Dokumentation von Arbeitszeiten, verbrauchten Materialien, Mehraufwand und Notizen.
|
|
|
|
## Funktionen
|
|
|
|
### Kernfunktionen
|
|
|
|
- **Stundenzettel-Verwaltung**: Erstellen, Bearbeiten und Löschen von Stundenzetteln pro Auftrag und Datum
|
|
- **Leistungserfassung**: Zeiterfassung mit Start-/Endzeit und automatischer Dauerberechnung
|
|
- **Zeitüberlappungsprüfung**: Verhindert doppelte Zeitbuchungen auf demselben Stundenzettel
|
|
- **Produktverfolgung**: Dokumentation von verbrauchten Materialien aus dem Auftrag
|
|
- **Mehraufwand**: Erfassung zusätzlicher Produkte/Dienstleistungen, die nicht im Auftrag waren
|
|
- **Entfällt-Markierung**: Kennzeichnung von Produkten, die nicht verbaut werden müssen
|
|
- **Notizen**: Merkzettel und Notizen für den nächsten Termin
|
|
|
|
### Freigabe & Rechnungsstellung
|
|
|
|
- **Stundenzettel-Freigabe**: Sperren von Stundenzetteln nach Fertigstellung
|
|
- **Rechnungsübernahme**: Automatische Übernahme aller Produkte und Leistungen in eine Rechnung
|
|
- **Stunden-Modus**: Wahlweise Übernahme als Gesamtstunden oder pro Tag
|
|
|
|
### Integration
|
|
|
|
- **SubtotalTitle-Integration**: Unterstützung für Produktgruppen aus dem SubtotalTitle-Modul
|
|
- **Auftragsintegration**: Direkter Zugriff auf Stundenzettel über Aufträge
|
|
- **Kundenintegration**: Standard-Leistung pro Kunde konfigurierbar
|
|
|
|
## Installation
|
|
|
|
1. Modul-Ordner nach `/custom/stundenzettel/` kopieren
|
|
2. In Dolibarr einloggen
|
|
3. Unter **Einstellungen > Module/Anwendungen** das Modul "Stundenzettel" aktivieren
|
|
4. Das Modul erstellt automatisch:
|
|
- Erforderliche Datenbanktabellen
|
|
- Extrafeld "Auftragsbeschreibung" für Aufträge
|
|
- Extrafeld "Standard-Leistung" für Kunden
|
|
- Datenbank-View für Dienstleistungen
|
|
|
|
## Konfiguration
|
|
|
|
Die Moduleinstellungen finden Sie unter **Einstellungen > Module > Stundenzettel > Zahnrad-Symbol**:
|
|
|
|
| Einstellung | Beschreibung |
|
|
|-------------|--------------|
|
|
| **Zeiteingabe-Modus** | Dropdown (15-Minuten-Takt) oder Freitext (exakte Uhrzeit) |
|
|
| **Standard-Filter** | Welcher Filter in der Produktliste standardmäßig angezeigt wird |
|
|
| **Standard-Datum** | Aktuelles Datum oder Datum des letzten offenen Stundenzettels |
|
|
| **Stunden-Übernahme** | Gesamtstunden auf einer Zeile oder pro Tag eine Zeile |
|
|
|
|
### Standard-Leistung beim Kunden
|
|
|
|
Sie können beim Kunden (unter **Kunden > Kundenkarte**) eine Standard-Leistung (Dienstleistung) hinterlegen. Diese wird dann bei allen Stundenzetteln für diesen Kunden angezeigt und kann für die Rechnungsstellung verwendet werden.
|
|
|
|
## Datenbanktabellen
|
|
|
|
| Tabelle | Beschreibung |
|
|
|---------|--------------|
|
|
| `llx_stundenzettel` | Haupttabelle für Stundenzettel |
|
|
| `llx_stundenzettel_leistung` | Leistungen/Arbeitszeiten |
|
|
| `llx_stundenzettel_product` | Verbrauchte Produkte |
|
|
| `llx_stundenzettel_tracking` | Gesamtübersicht Mengen pro Auftrag |
|
|
| `llx_stundenzettel_note` | Notizen und Merkzettel |
|
|
| `llx_product_services` | View für Dienstleistungen (Extrafeld-Filter) |
|
|
|
|
## Extrafelder
|
|
|
|
| Feld | Element | Beschreibung |
|
|
|------|---------|--------------|
|
|
| `auftragsbeschreibung` | Auftrag | Zusätzliche Beschreibung für den Auftrag |
|
|
| `stundenzettel_status` | Auftrag | Status der Stundenzettel (0=Offen, 1=Freigegeben, 2=Abgerechnet) |
|
|
| `stundenzettel_default_service` | Kunde | Standard-Dienstleistung für Stundenzettel |
|
|
|
|
## Berechtigungen
|
|
|
|
| Berechtigung | Beschreibung |
|
|
|--------------|--------------|
|
|
| Lesen | Stundenzettel anzeigen |
|
|
| Erstellen/Bearbeiten | Stundenzettel erstellen und bearbeiten |
|
|
| Freigeben | Stundenzettel freigeben/sperren |
|
|
| Löschen | Stundenzettel löschen |
|
|
|
|
## Workflow
|
|
|
|
1. **Stundenzettel erstellen**: Über Auftrag > Stundenzettel-Tab
|
|
2. **Leistungen erfassen**: Arbeitszeiten mit Start-/Endzeit dokumentieren
|
|
3. **Produkte dokumentieren**: Verbrauchte Materialien aus dem Auftrag erfassen
|
|
4. **Mehraufwand hinzufügen**: Zusätzliche Produkte bei Bedarf
|
|
5. **Notizen erstellen**: Merkzettel für nächsten Termin
|
|
6. **Stundenzettel freigeben**: Nach Fertigstellung sperren
|
|
7. **In Rechnung übernehmen**: Automatische Rechnungserstellung
|
|
|
|
## Changelog
|
|
|
|
### Version 1.1.0
|
|
- Standard-Leistung beim Kunden hinterlegen (nur Dienstleistungen auswählbar)
|
|
- Stunden-Übernahme Modus (Gesamt oder pro Tag)
|
|
- Zeitüberlappungsprüfung für Leistungen
|
|
- Verbessertes Setup-Seitenlayout
|
|
- Datenbank-View für Dienstleistungs-Filter
|
|
|
|
### Version 1.0.0
|
|
- Initiale Version
|
|
- Grundlegende Stundenzettel-Verwaltung
|
|
- Leistungs- und Produkterfassung
|
|
- Mehraufwand und Entfällt-Funktionen
|
|
- Notizen-System
|
|
- Freigabe und Rechnungsübernahme
|
|
- SubtotalTitle-Integration
|
|
|
|
## Support
|
|
|
|
Bei Fragen oder Problemen wenden Sie sich an:
|
|
**Data IT Solution**
|
|
E-Mail: data@data-it-solution.de
|
|
Web: https://data-it-solution.de
|
|
|
|
## Lizenz
|
|
|
|
Dieses Modul steht unter der GNU General Public License v3. Siehe LICENSE-Datei für Details.
|